📜 Commands¶
This page documents the live Magikal bot command inventory.
Commands are grouped by feature area, not just by raw command namespace, so related commands are easier to find.
How to use this page
Use the table of contents on the right to jump to a feature area.
Click a command group chip to jump to that command group inside the feature area.
Source¶
Latest export used:
/home/magikalbot/magikal-bot/_exports/commands-20260419-125951.json
Generated at:
20260419-125951
Bot user:
Magikal bot#3881
Keep commands synced
This page should be regenerated after adding, removing, renaming, or changing command permissions.
Use the live bot owner command:
!dump_commands
Then regenerate this docs page from the newest _exports/commands-*.json file.
Summary¶
| Type | Count |
|---|---|
| Prefix/text commands | 101 |
| Slash commands in raw export | 263 |
| Slash entries after docs duplicate filter | 146 |
| Prefix commands needing category review | 0 |
| Slash entries needing category review | 45 |
Duplicate filtering
The raw slash export may include grouped subcommands twice.
Example: /tickets/add-option may also appear as /add-option in the raw export.
The docs generator keeps the grouped command where the duplicate is obvious.
Feature areas¶
🤖 Core Bot & Help¶
General bot info, help panels, staff handbook, and quick utility commands.
| Command type | Count |
|---|---|
| Prefix/text commands | 17 |
| Slash entries | 13 |
Prefix/text commands — 17 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!commands |
BasicCommandsCog | `` | yes | List all available commands. Usage: !commands |
!healthcheck |
BasicCommandsCog | `` | no | Quick bot self-test (admin/owner only). Shows latency, prefix, loaded cogs, and key channel perms. |
!help |
BasicCommandsCog | [command_name] |
no | Magikal Bot help (prefix entry). Usage: !help → summary help (member / staff-aware) !help |
!info |
BasicCommandsCog | `` | no | Show information about the bot. Usage: !info |
!map |
BasicCommandsCog | [city] |
no | Show a city map. Usage: !map <lorville |
!map area18 |
BasicCommandsCog | `` | no | Show the Area18 map. |
!map list |
BasicCommandsCog | `` | no | List available city maps. |
!map lorville |
BasicCommandsCog | `` | no | Show the Lorville map. |
!map newbabbage |
BasicCommandsCog | `` | no | Show the New Babbage map. |
!map orison |
BasicCommandsCog | `` | no | Show the Orison map. |
!ping |
BasicCommandsCog | `` | no | Check bot latency and response time. Usage: !ping |
!reloadcog |
BasicCommandsCog | <target> |
no | Reload a cog by short name or full module path, or 'all'. Examples: !reloadcog basic !reloadcog bot.cogs.moderation !reloadcog all |
!settings |
BasicCommandsCog | `` | no | Show Star Citizen performance setup guide. |
!slashcommands |
BasicCommandsCog | `` | no | List all registered slash commands. Usage: !slashcommands |
!synccommands |
BasicCommandsCog | `` | no | Sync slash commands to the server (Admin only). Usage: !synccommands |
!whoami |
BasicCommandsCog | [command_name] |
no | Debug your detected permission level. Optionally explain if |
!whoami_public |
BasicCommandsCog | [command_name] |
no | Public-safe permission/debug info. Usage: !whoami_public [command] Shows your detected level and, if a command is provided, whether it should be visible in help for you and whether you can run it right now. |
/handbook — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/handbook |
command | Post the Magikal Staff Handbook (concise). | <Permissions value=32> |
/help — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help |
command | Quick slash help. Use /help_panel for the full help centre. | None |
/help_admin_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_admin_panel |
command | Post the Admin help panel. | None |
/help_events_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_events_panel |
command | Post the Events help panel. | None |
/help_finance_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_finance_panel |
command | Post the Finance help panel. | None |
/help_helper_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_helper_panel |
command | Post the Helper (general staff) help panel. | None |
/help_moderator_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_moderator_panel |
command | Post the Moderator help panel. | None |
/help_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_panel |
command | Post a role-aware help panel with buttons (or static embed). | <Permissions value=32> |
/help_public_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_public_panel |
command | Post the Public help panel. | None |
/help_recruitment_panel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_recruitment_panel |
command | Post the Recruitment help panel. | None |
/help_role — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_role |
command | Show help for a specific staff role/capability. | None |
/info — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/info |
command | About the bot: stats & features (Admin only). | None |
/ping — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/ping |
command | Check bot latency | None |
🛡️ Moderation¶
Moderation, automod, modlog, and server safety commands.
| Command type | Count |
|---|---|
| Prefix/text commands | 23 |
| Slash entries | 0 |
Prefix/text commands — 23 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!ban |
ModerationCog | <member> [delete_days=1] [reason] |
no | Ban a member or user from the server. Usage: !ban @member [delete_days] [reason] delete_days: Number of days of messages to delete (0-7) |
!clearwarns |
ModerationCog | <member> [reason=No reason provided] |
no | Clear warnings for a member using privacy-first storage. Privacy Design: - Removes pseudonymous warning data from ConfigStorage - Action is logged for accountability but no user details stored Usage: !clearwarns @member [reason] |
!kick |
ModerationCog | <member> [reason] |
no | |
!lock |
ModerationCog | [channel] [reason=Channel locked] |
no | Lock a channel: - Text: deny @everyone send_messages - Voice: deny @everyone connect - Thread: set locked=True NEW: Supports temporary locks: add 'for |
!pgb |
ModerationCog | <count> [reason=Bulk cleanup: bot messages] |
yes | |
!pgm |
ModerationCog | <count> [reason=Bulk cleanup: my messages] |
yes | |
!pgs |
ModerationCog | <message_id> <count> [reason=Bulk cleanup: since message] |
yes | Short alias for !purge since. |
!pgu |
ModerationCog | <member> <count> [reason=Bulk cleanup: user messages] |
yes | Short alias for !purge user. Usage: !pgu @member |
!purge |
ModerationCog | <count> [reason=Bulk message cleanup] |
no | Bulk delete tools for the current channel. Usage ────── !purge user @member |
!purge bots |
ModerationCog | <count> [reason=Bulk cleanup: bot messages] |
no | Delete up to |
!purge me |
ModerationCog | <count> [reason=Bulk cleanup: my messages] |
no | Delete up to |
!purge since |
ModerationCog | <message_id> <count> [reason=Bulk cleanup: since message] |
no | Delete up to |
!purge user |
ModerationCog | <member> <count> [reason=Bulk cleanup: user messages] |
no | Delete up to |
!quarantine |
ModerationCog | <member> [duration] [reason] |
no | Place a member into quarantine for the given duration (default: 1h). Usage ────── !quarantine @member [duration] !config quarantine set #channel • Bot must have Manage Roles and sit above the quarantine role. Options ─────── • Duration accepts: 30s / 15m / 2h / 3d / 1w (formats like 7d are valid). • Add --nodm to avoid DMing the user. |
!slowmode |
ModerationCog | [args...] |
no | Set channel slowmode via seconds or human times (5m / 2h / 1h30m / off). NEW: You can add 'for |
!softban |
ModerationCog | <member> [reason=Softban] |
no | Ban then immediately unban a user to purge recent messages. Deletes ~1 day of messages (Discord cap up to 7 days). |
!timeout |
ModerationCog | <member> <duration> [reason=No reason provided] |
no | Timeout a member for a specified duration. Usage: !timeout @member 1h30m [reason] Duration format: 1d2h30m (days, hours, minutes) |
!unban |
ModerationCog | <user> [reason=No reason provided] |
no | Unban a user from the server. Usage: !unban user_id [reason] |
!unlock |
ModerationCog | [channel] [reason=Channel unlocked] |
no | Unlock a channel: - Text: clear @everyone send_messages overwrite - Voice: clear @everyone connect overwrite - Thread: set locked=False Usage: !unlock !unlock #channel Reason text... |
!unquarantine |
ModerationCog | <member> [reason=Quarantine lifted] |
no | Remove quarantine from a member. Usage ────── !unquarantine @member [reason] Aliases: !uq, !rel |
!untimeout |
ModerationCog | <member> [reason=No reason provided] |
no | Remove timeout from a member. Usage: !untimeout @member [reason] |
!warn |
ModerationCog | <member> [reason] |
no | Warn a member for rule violations using privacy-first pseudonymous storage. Privacy Design: - Uses HMAC-based pseudonymous identifier (PID) instead of raw user ID - Stores warn count in ConfigStorage, not database - No persistent storage of user IDs, usernames, or personal data Usage: !warn @member [reason] |
!warnings |
ModerationCog | [member] |
no | View warning count for a member using privacy-first storage. Privacy Design: - Only shows current warn count, not historical details - Uses pseudonymous identifier internally - No access to specific warning reasons or timestamps Usage: !warnings [@member] |
🎫 Tickets & Recruitment¶
Ticket panels, recruitment applications, Q&A, and recruitment configuration.
| Command type | Count |
|---|---|
| Prefix/text commands | 1 |
| Slash entries | 14 |
Command groups: /tickets
Prefix/text commands — 1 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!reopen_qna |
TicketsCog | `` | no | Staff: resend the Q&A button+modal for the ticket author. |
/tickets — 13 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/tickets |
group | Ticket administration | None |
/tickets/add-option |
command | Add a recruitment option (admin only). | <Permissions value=16> |
/tickets/list-options |
command | List current recruitment options (admin only). | <Permissions value=16> |
/tickets/post-support-about |
command | Post a static 'About Support' embed to explain how tickets work. | <Permissions value=16> |
/tickets/remove-option |
command | Remove a recruitment option (admin only). | <Permissions value=16> |
/tickets/reopen-qna |
command | Repost the Quick Q&A button for the current recruitment ticket (staff only). | <Permissions value=32> |
/tickets/set-dm-on-close |
command | Enable/disable DMing the ticket opener when a ticket is closed. | <Permissions value=32> |
/tickets/set-nick-sync |
command | Turn on/off nickname sync to RSI handle on Approve. | <Permissions value=32> |
/tickets/set-org |
command | Set the RSI org page URL (and optional image) used in recruitment UI. | <Permissions value=32> |
/tickets/set-ping |
command | Set ping roles for Support and Recruitment panels. | <Permissions value=16> |
/tickets/set-targets |
command | Set panel channels and target categories for tickets. | <Permissions value=16> |
/tickets/show-org |
command | Show the configured RSI org URL and image used in recruitment UI. | <Permissions value=32> |
/tickets/show-ping |
command | Show current ping roles for panels. | <Permissions value=16> |
/tickets/show-targets |
command | Show panel channels and target categories. | <Permissions value=16> |
🔊 Temp VC¶
Temporary voice channel setup, ownership, panel controls, and voice helpers.
| Command type | Count |
|---|---|
| Prefix/text commands | 10 |
| Slash entries | 0 |
Prefix/text commands — 10 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!tempvc |
TempVCV2Cog | `` | no | |
!tempvc addlobby |
TempVCV2Cog | <category> <name> |
no | Create a persistent 'Create a VC' voice lobby under a category and store it. Usage: !tempvc addlobby |
!tempvc afk |
TempVCV2Cog | `` | no | AFK auto-move controls. |
!tempvc afk off |
TempVCV2Cog | `` | no | |
!tempvc afk on |
TempVCV2Cog | `` | no | |
!tempvc afk set |
TempVCV2Cog | <minutes> |
no | |
!tempvc afk status |
TempVCV2Cog | `` | no | |
!tempvc dellobby |
TempVCV2Cog | <id_or_name> |
no | |
!tempvc listlobbies |
TempVCV2Cog | `` | no | |
!tempvc setup |
TempVCV2Cog | <panel_channel> |
no |
🚀 Star Citizen: Ships, Market, Items & UEX¶
Ship lookup, UEX market data, items, weapons, commodities, refinery, and related config.
| Command type | Count |
|---|---|
| Prefix/text commands | 0 |
| Slash entries | 29 |
Command groups: /commodity /item /itemcfg /market /refinery /refinerycfg /ship /shipcfg /weapon
/commodity — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/commodity |
command | Commodity kiosks: 15-day averages and best terminals to buy/sell. | None |
/item — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/item |
command | Item info card (compact stats + DPS + More details). | None |
/itemcfg — 9 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/itemcfg |
group | Manage /item cache | <Permissions value=32> |
/itemcfg/clear_cache |
command | Clear /item cache (file + memory) | None |
/itemcfg/refresh |
command | Force-refresh a single item into cache. | None |
/itemcfg/stats |
command | Show /item cache stats | None |
/itemcfg/uuid_export |
command | Export the current UUID registry as a file. | None |
/itemcfg/uuid_list |
command | List UUID entries (use starts_with to filter). | None |
/itemcfg/uuid_remove |
command | Remove a name from the UUID registry. | None |
/itemcfg/uuid_set |
command | Set or update a single name->UUID mapping. | None |
/itemcfg/uuid_show |
command | Show the UUID mapping for a name. | None |
/itemcfg/uuid_sync |
command | Seed/refresh the UUID registry from DE-wiki (fallback: scunpacked). | None |
/market — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/market |
command | UEX: player-to-player listings (14-day stats, best offers). | None |
/refinery — 4 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/refinery |
group | UEX refinery data | None |
/refinery/audits |
command | Recent community audits for a commodity. | None |
/refinery/capacities |
command | Top/lowest refineries by capacity for a commodity. | None |
/refinery/methods |
command | Refining methods and their ratings (yield/cost/speed). | None |
/refinery/yields |
command | Top refineries by yield bonus for a commodity. | None |
/refinerycfg — 2 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/refinerycfg |
group | Manage refinery caches | <Permissions value=32> |
/refinerycfg/reload |
command | Preload refinery datasets into cache. | None |
/refinerycfg/stats |
command | Show refinery cache counts (from filecache). | None |
/ship — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/ship |
command | Search UEX vehicles: manufacturer, crew, cargo, buy locations. | None |
/shipcfg — 5 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/shipcfg |
group | Configure who can use /ship | None |
/shipcfg/addrole |
command | Allow a role to use /ship in this server. | None |
/shipcfg/list_status |
command | Show /ship autocomplete list status. | None |
/shipcfg/listroles |
command | Show roles that can use /ship here. | None |
/shipcfg/refresh_list |
command | Force-refresh the UEX vehicles list used for /ship autocomplete. | None |
/shipcfg/removerole |
command | Remove a role from the /ship allowlist. | None |
/weapon — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/weapon |
command | Weapon info card (same as /item) with in-game shop locations. | None |
🛰️ Star Citizen: RSI & AI¶
RSI profile/status tools and Star Citizen AI assistant commands.
| Command type | Count |
|---|---|
| Prefix/text commands | 0 |
| Slash entries | 8 |
Command groups: /ai /rsi /rsi_status /scai
/ai — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/ai |
command | Ask Magikal-bot's AI assistant a question (staff only). | None |
/rsi — 2 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/rsi |
group | Star Citizen profile tools | None |
/rsi/preview |
command | Preview RSI profile (Moderator only, ephemeral) | None |
/rsi/profile |
command | Show RSI profile for a handle | None |
/rsi_status — 2 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/rsi_status |
group | RSI Status feed settings (admin only). | <Permissions value=8> |
/rsi_status/setchannel |
command | Set the channel that will receive RSI Status updates. | None |
/rsi_status/test |
command | Post a test message to confirm the configured channel. | None |
/scai — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/scai |
command | Ask the Magikal Star Citizen AI helper a question. | None |
👋 Welcome & Onboarding¶
Welcome messages, rules, visitor flow, and introduction setup.
| Command type | Count |
|---|---|
| Prefix/text commands | 12 |
| Slash entries | 12 |
Command groups: /welcome
Prefix/text commands — 12 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!welcome |
Welcome | `` | no | |
!welcome cta |
Welcome | <rules_channel> [accept_message_id] [body] |
no | Posts a bold CTA card + a Link button to the rules. If accept_message_id is provided (ID or jump link), the button opens that exact message. |
!welcome disable |
Welcome | `` | no | |
!welcome enable |
Welcome | `` | no | |
!welcome message |
Welcome | <channel> [rules_channel] [rules_message_id] |
no | Launches a big modal where an admin writes the welcome title/body using placeholders. Bot renders them and posts a clean embed to channel, with an optional 'Open Rules' link button. Supported placeholders: {guild}, {guild.name}, {member}, {member.name}, {member.mention}, {rules}, {rules.mention}, {now_uk} |
!welcome rules |
Welcome | <channel> [add_accept_button=True] |
no | Opens a large modal where an admin pastes rules. Bot will post a clean rules embed to channel. |
!welcome set-channel |
Welcome | <channel> |
no | |
!welcome set-intros-channel |
Welcome | <channel> |
no | |
!welcome set-intros-message |
Welcome | <text> |
no | |
!welcome set-visitor-role |
Welcome | [role] |
no | |
!welcome status |
Welcome | `` | no | |
!welcome test |
Welcome | `` | no | Preview the new CTA-style welcome card (ephemeral). It will try to link to a rules channel automatically: - First channel named exactly 'rules', else - first text channel containing 'rule' in the name. If none found, shows the card without a link button. |
/welcome — 11 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/welcome |
group | Welcome message tools | None |
/welcome/cta |
command | Post a welcome CTA with a button to #rules or a specific rules message. | None |
/welcome/disable |
command | Disable welcome messages | None |
/welcome/enable |
command | Enable welcome messages | None |
/welcome/message |
command | Create a welcome embed via modal (supports {placeholders}) and post it. | None |
/welcome/rules |
command | Create a rules embed via modal and post it. | None |
/welcome/set-channel |
command | Set a specific channel for welcome messages | None |
/welcome/set-intros-channel |
command | Set the channel where the bot will tag newcomers after they accept the rules. | None |
/welcome/set-intros-message |
command | Set the plain welcome message posted in #introductions. Placeholders: {mention}, {server} | None |
/welcome/set-visitor-role |
command | Set the role to grant when users accept the rules. | None |
/welcome/status |
command | Show welcome config | None |
/welcome/test |
command | Preview the welcome CTA card here (ephemeral). | None |
🎭 Roles, Autoroles & Reaction Roles¶
Autoroles, reaction roles, role/capability setup, and role assignment tools.
| Command type | Count |
|---|---|
| Prefix/text commands | 10 |
| Slash entries | 7 |
Prefix/text commands — 10 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!rr |
Reaction Roles | `` | no | Reaction role commands. |
!rr bulkremove |
Reaction Roles | <message_id> [emojis...] |
no | Remove several emojis at once from one message. |
!rr clear |
Reaction Roles | <message_id> |
no | Remove ALL mappings for a single message: !rr clear |
!rr clearall |
Reaction Roles | [confirmation] |
no | Remove ALL reaction-role mappings in this server. |
!rr edit |
Reaction Roles | <message_id> |
no | Open the wizard in edit mode for an existing RR message. |
!rr keep |
Reaction Roles | <message_id> [emojis_to_keep...] |
no | Keep only the listed emojis for a message; remove all others. |
!rr list |
Reaction Roles | `` | no | List all reaction roles. |
!rr prune |
Reaction Roles | `` | no | Remove mappings whose messages no longer exist (deleted/cleaned). |
!rr remove |
Reaction Roles | <message_id> [emoji] |
no | Remove reaction-role mapping(s) from storage. !rr remove |
!rr setup |
Reaction Roles | `` | no | Start reaction role setup. |
/autorole — 1 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/autorole |
group | Configure autoroles for this server | None |
/autorole/config |
command | Set or show the autorole configuration | <Permissions value=268435456> |
/roles — 4 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/roles |
group | Configure capability→role mapping | None |
/roles/clear |
command | Clear a capability role | <Permissions value=8> |
/roles/export |
command | Export mapping as JSON | <Permissions value=8> |
/roles/set |
command | Set a role for a capability | <Permissions value=8> |
/roles/show |
command | Show current role mapping | <Permissions value=8> |
📅 Events¶
Discord events, event signups, event roles, rosters, and event admin tools.
| Command type | Count |
|---|---|
| Prefix/text commands | 0 |
| Slash entries | 8 |
Command groups: /event_cancel /event_cover /event_list /event_modal /events
/event_cancel — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/event_cancel |
command | Cancel an upcoming event. | None |
/event_cover — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/event_cover |
command | Add or replace a scheduled event's cover image. | None |
/event_list — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/event_list |
command | List upcoming scheduled events. | None |
/event_modal — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/event_modal |
command | Open a 2-step form to create a scheduled event. | None |
/events — 3 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/events |
group | Create & manage rich events | None |
/events/create |
command | Create a rich event with roles/slots. | None |
/events/reassign |
command | (Events Manager only) Move a member to a different role for this event. | None |
/events/repair |
command | (Events Manager only) Re-attach buttons to an event message. | None |
⭐ XP & Ranks¶
XP, rank cards, leaderboards, voice XP, rank roles, and XP admin tools.
| Command type | Count |
|---|---|
| Prefix/text commands | 0 |
| Slash entries | 6 |
Command groups: /xp
/xp — 5 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/xp |
group | XP & ranks | None |
/xp/card |
command | Generate your XP rank card image. | None |
/xp/diag_members |
command | Debug member resolution for XP. | None |
/xp/my |
command | Show your XP, level, and title. | None |
/xp/top |
command | Leaderboard | None |
/xp/topcard |
command | Banner-style image with the top members. | None |
💰 Banking¶
Treasury, loans, repayments, ledger, and finance tools.
| Command type | Count |
|---|---|
| Prefix/text commands | 0 |
| Slash entries | 14 |
/bank — 7 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/bank |
group | Org banking (treasury, settings) | None |
/bank/deposit |
command | Add funds to the org treasury (Admin only) | None |
/bank/logtest |
command | Post a test message to the configured finance log (Admin only) | None |
/bank/me |
command | See your balance and open loans | None |
/bank/set |
command | Update banking settings (Admin only) | None |
/bank/settings |
command | View banking settings (Admin only) | None |
/bank/treasury |
command | Show treasury balance and recent entries (Finance Manager only) | None |
/bank/withdraw |
command | Remove funds from the org treasury (Admin only) | None |
/loan — 5 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/loan |
group | Request and manage loans | None |
/loan/approve |
command | Approve a requested loan (Finance Manager only) | None |
/loan/list |
command | List loans by status (Finance Manager only) | None |
/loan/repay |
command | Record a repayment (Finance Manager only) | None |
/loan/repay_request |
command | Tell Finance you've sent aUEC (posts to the finance log for staff to verify) | None |
/loan/request |
command | Request a loan from the org | None |
🧰 Embeds & Tools¶
Embed tools, general configuration helpers, and utility setup commands.
| Command type | Count |
|---|---|
| Prefix/text commands | 23 |
| Slash entries | 6 |
Command groups: /embed
Prefix/text commands — 23 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!config |
Admin & Config | `` | no | Bot configuration management commands. Usage: !config |
!config backup |
Admin & Config | `` | no | Backups are not applicable for Postgres-backed config. |
!config export |
Admin & Config | `` | no | Export guild configuration as JSON (Postgres-backed). |
!config modlog |
Admin & Config | [action] [target] |
no | Configure moderation log routing (3 buckets) for this guild. Usage: !config modlog show !config modlog enable !config modlog disable !config modlog set main #channel !config modlog set actions #channel !config modlog set events #channel !config modlog set alerts #channel !config modlog set voice #channel !config modlog test |
!config prefix |
Admin & Config | [prefix] |
no | Set or reset the guild's command prefix (Postgres-backed). • !config prefix |
!config prune |
Admin & Config | `` | no | Comprehensive cleanup of invalid configuration data (Postgres-backed). Currently removes reaction-role mappings whose role no longer exists. |
!config quarantine |
Admin & Config | [action] [target] |
no | Configure quarantine: a locked channel + role. |
!config rsi |
Admin & Config | [flag] [state] |
no | Toggle RSI-related features for this guild. Usage: !config rsi lookup on |
!config stats |
Admin & Config | `` | no | Show configuration storage statistics. |
!config validate |
Admin & Config | `` | no | Validate configuration integrity (reaction roles, basic checks). |
!config-automod |
Admin & Config | `` | no | Show automod status and key thresholds. |
!config-automod allowdomain |
Admin & Config | <domain> |
no | Add an allowlisted domain. |
!config-automod denydomain |
Admin & Config | <domain> |
no | Add a denylisted domain. |
!config-automod exemptchannel |
Admin & Config | <channel> |
no | Exempt a channel from automod. |
!config-automod exemptrole |
Admin & Config | <role_name> |
no | Exempt a role name (case-insensitive). |
!config-automod set |
Admin & Config | <key> <value> |
no | Set a threshold/flag. Keys: burst_channels, burst_window_sec, dup_window_sec, dup_min_msgs, dup_min_ratio, attach_max, attach_window_sec, timeout_minutes, act_timeout_on_burst, act_timeout_on_dup, delete_on_match |
!config-automod test |
Admin & Config | <text> |
no | Dry-run a message against domain rules (no deletion). Usage: !config-automod test |
!config-automod toggle |
Admin & Config | <onoff> |
no | Enable/disable automod. Usage: !config-automod toggle on |
!config-automod unexemptchannel |
Admin & Config | <channel> |
no | Remove a channel exemption. |
!config-automod unexemptrole |
Admin & Config | <role_name> |
no | Remove a role exemption (case-insensitive). |
!config-automod unlistdomain |
Admin & Config | <domain> [action] |
no | Remove a domain (optionally only from one action). Usage: !config-automod unlistdomain |
!forget |
Admin & Config | <member> |
no | Purge pseudonymous warn data for a specific user. This command removes all warning data associated with a user while maintaining privacy by using pseudonymous identifiers. Usage: !forget @user |
!prune-warns |
Admin & Config | <days> |
no | Not implemented yet for Postgres-backed warns. |
/embed — 5 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/embed |
group | Create and send rich embed messages | None |
/embed/editor |
command | Open a live editor panel with preview. | None |
/embed/modal |
command | Open a form to craft an embed and post it. | None |
/embed/quick |
command | Send an embed with options (no modal). | None |
/embed/set-image |
command | Send an embed with a file attachment as the main image. | None |
/embed/set-thumbnail |
command | Send an embed with a file attachment as the thumbnail. | None |
🩺 Diagnostics & Owner Tools¶
Diagnostics, command dumps, audits, health checks, and owner/admin troubleshooting tools.
| Command type | Count |
|---|---|
| Prefix/text commands | 5 |
| Slash entries | 3 |
Command groups: /diag /help_audit
Prefix/text commands — 5 command(s)
| Command | Cog | Signature | Hidden | Description |
|---|---|---|---|---|
!diag |
DiagCommands | `` | no | |
!diag commands |
DiagCommands | `` | no | Export command inventory (prefix + slash) to CSV (attachment). |
!dump_commands |
CommandDump | `` | no | Export prefix+slash commands to _exports/commands- |
!redis_smoke |
StorageDiagnostics | `` | no | Write a short-lived test key to Redis and show stats (owner only). |
!storage |
StorageDiagnostics | `` | no | Show active storage backends and sizes (owner only). |
/diag — 1 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/diag |
group | Diagnostics (Admin only) | None |
/diag/commands |
command | Export command inventory (prefix + slash) to CSV (attachment). | <Permissions value=8> |
/help_audit — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/help_audit |
command | Admin: Audit loaded slash commands and export a permission-gated help JSON. | <Permissions value=32> |
❓ Other / Needs Review¶
Commands that were not confidently categorised and should be reviewed.
| Command type | Count |
|---|---|
| Prefix/text commands | 0 |
| Slash entries | 45 |
Command groups: /delete /itemdebug /itemdebug_dew /marketcfg /recruit-config /scai_help /xpconfig
/delete — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/delete |
command | Delete an event and its signup post. | None |
/itemdebug — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/itemdebug |
command | DEBUG: show exactly what stats were parsed from the wiki. | None |
/itemdebug_dew — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/itemdebug_dew |
command | DEBUG: show DE-wiki fields for an item (UUID → JSON). | None |
/marketcfg — 5 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/marketcfg |
group | Manage /market caches | <Permissions value=32> |
/marketcfg/build_index |
command | Build unified index (items + commodities) from UEX. | None |
/marketcfg/gate_add |
command | Allow a role to use a namespace (/market, /item, /commodity, /refinery). | <Permissions value=32> |
/marketcfg/gate_list |
command | Show the current role allowlist for a namespace. | <Permissions value=32> |
/marketcfg/gate_remove |
command | Remove a role from a namespace allowlist. | <Permissions value=32> |
/marketcfg/reload_index |
command | Reload index from file into cache (Manage Server). | None |
/recruit-config — 9 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/recruit-config |
group | Configure recruitment storage and Q&A | None |
/recruit-config/qa-add |
command | Add a question | None |
/recruit-config/qa-edit |
command | Edit a question | None |
/recruit-config/qa-list |
command | List current Q&A questions | None |
/recruit-config/qa-move |
command | Reorder a question to a new 1-based position | None |
/recruit-config/qa-remove |
command | Remove a question | None |
/recruit-config/qa-reset-defaults |
command | Restore the recommended 4-question set | None |
/recruit-config/remove-member |
command | Mark a member as Removed (updates their application record) | None |
/recruit-config/set-access-mode |
command | Applicant access after Approve (until Finalise) | None |
/recruit-config/set-log-channel |
command | Set the channel where permanent applications are posted | None |
/scai_help — 1 command(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/scai_help |
command | Post a help embed explaining how to use the Magikal Star Citizen AI. | None |
/xpconfig — 24 command(s), 1 group(s)
| Command | Type | Description | Default permissions |
|---|---|---|---|
/xpconfig |
group | Configure XP (admins) | None |
/xpconfig/card_bg |
command | Set the rank card background image (upload). | None |
/xpconfig/card_colors |
command | Set rank card colours. | None |
/xpconfig/card_logo |
command | Set crest/logo for the rank card (top-right). | None |
/xpconfig/disable |
command | Disable XP here | None |
/xpconfig/enable |
command | Enable XP here | None |
/xpconfig/grant |
command | Grant XP to a member | None |
/xpconfig/icon_set |
command | Upload a PNG icon for a rank title (used on cards). | None |
/xpconfig/icons_seed |
command | Create default PNG icons for all ranks (for cards). | None |
/xpconfig/icons_status |
command | Show which rank icons exist/missing. | None |
/xpconfig/members_exclude_add |
command | Exclude a member from earning | None |
/xpconfig/members_exclude_remove |
command | Remove member from exclusion | None |
/xpconfig/pid_migrate_all |
command | Convert all legacy XP member IDs in this server to the new HMAC PIDs (atomic, merge-safe). | None |
/xpconfig/ranks_interval |
command | Set fixed level interval for rank titles (and start level). | None |
/xpconfig/reset |
command | Reset a member’s XP | None |
/xpconfig/roles_backfill |
command | Give the base XP rank role to everyone (visual-only). | None |
/xpconfig/roles_emojis_sync |
command | Rename all XP rank roles to include (or remove) the rank emoji. | None |
/xpconfig/roles_setup |
command | Create visual-only roles for all rank titles. | None |
/xpconfig/roles_sync |
command | Re-scan and fix missing rank roles. | None |
/xpconfig/set_award |
command | Set award range (min/max) | None |
/xpconfig/set_cooldown |
command | Cooldown seconds between awards | None |
/xpconfig/set_min_length |
command | Minimum message length to earn XP | None |
/xpconfig/voice_enable |
command | Enable or disable Voice XP. | None |
/xpconfig/voice_rate |
command | Set Voice XP tick interval and XP per tick. | None |
/xpconfig/voice_rules |
command | Tune Voice XP eligibility rules. | None |
Regeneration workflow¶
-
Run the live owner command in Discord:
!dump_commands -
Confirm the newest export exists:
cd /home/magikalbot/magikal-bot ls -lt _exports | head -20 -
Regenerate this docs page from the newest JSON export.
-
Build and deploy the docs.
Categorisation rule¶
Commands should be grouped by how admins actually think about the feature, not only by raw command namespace.
Examples:
/ship,/shipcfg,/item,/weapon,/market, and/refinerybelong together under Star Citizen / UEX.- ticket and recruitment commands belong together.
- RSI and AI commands belong together if they support Star Citizen questions/lookups.
Rule¶
Commands documentation should come from the live bot command tree, then be grouped into useful feature areas.