Reference
Command reference
Every command KeyBot provides. Commands your members use are staying exactly as they are. The eleven server-management commands are being retired, and this page says which ones and what replaces them.
- Nothing your members use is changing.
/claim,/keys,/pools,/docs,/info, and/inviteare staying. - Neither grant command is changing.
/grantand/grantroleare staying. - Eleven management commands are being removed and their features now live in the dashboard.
Member commands
Anyone in the server can run these. They are not changing and are not being removed.
| Command | Options | What it does |
|---|---|---|
/claim | pool | Claim a key from a public pool. Checks bans, required roles, and the per-member limit first. The reply is only visible to the person who ran it. |
/keys | none | List every key you have claimed, across every server, grouped by game. Works only in KeyBot's direct messages, not in a server. |
/pools | none | Page through this server's pools with their game, visibility, key type, claim limit, stock, and required roles. |
/info | none | Bot version and useful links. |
/invite | none | The link to add KeyBot to another server. Works in servers and in DMs. |
/docs | none | A link to this documentation. |
Moderator commands
For handing keys out by hand. These are staying. They are not part of the move to the dashboard.
| Command | Options | Who can run it | What it does |
|---|---|---|---|
/grant | user, pool | The pool's moderator roles | Send one key from the pool to a member by direct message. Respects the pool's keys-per-member limit. The pool must have at least one moderator role configured. |
/grantrole | role, pool | Manage Server | Give one key to every member holding a role, after a confirmation showing the member count against the stock available. Does not check the per-member limit. |
Management commands, being removed
All of these require the Manage Server permission.
| Command | Options | What it does | Now in the dashboard under |
|---|---|---|---|
/create | simple with name, game, key_type, private, amount, or builder for a step-by-step version | Create a pool. | Pools |
/edit | pool, option (name, game, privacy, amount, key type) | Change one setting on a pool. | Pools |
/delete | pool | Delete a pool, with a confirmation. Its keys and pool bans go with it. | Pools |
/pool info | pool | Detailed view of one pool, including stock and whether a low-stock warning has been sent. | Pools |
/import | pool, keys (file attachment) | Bulk load keys into a pool from a file. | Keys |
/export | pool | Download the pool's unclaimed keys as a .txt file. | Keys |
/lookup | user or key | Find every key a member claimed here, or trace a single key back to whoever has it. | Keys |
/bans | add pool|guild, remove pool|guild, list [pool] | Ban and unban members from one pool or from the whole server, and list current bans. | Bans |
/role | add, remove, each with pool and role | Manage the roles required to claim from a pool. | Roles |
/mod | pool add, pool remove, set, disable | Manage a pool's moderator roles. The server-wide set and disable subcommands are legacy and do not affect who can grant keys. | Roles |
/channels | set or remove, with type of logs or warnings | Choose where import and grant logs go, and where low-stock warnings go. Setting a channel posts a test message into it first, so a permission problem shows up immediately. | Settings |
Why they are going
Slash commands are a poor fit for management work. Editing a pool means one command per field, a ban list has to be paged through twenty at a time, and a long key file is awkward to attach and impossible to review before it lands. The dashboard shows the whole picture at once and lets you check what you are about to do before you do it.
Claiming, by contrast, belongs in Discord. That is where your members already are, and it is one command that does one thing. So the member-facing commands stay, and the grant commands stay with them, because handing a key to someone you are already talking to should not mean opening a browser.