Documentation
KeyBot
KeyBot hands out game keys in your Discord server. You load keys into pools, decide who can take one and how many, and members claim them for themselves. Everything that happens is recorded, so you always know who got what.
What it does
- Pools. Every batch of keys lives in a named pool with its own game, key type, claim limit, and role rules. A server can run as many pools as it likes, side by side.
- Bulk import. Upload a
.txt,.csv, or.jsonfile and the whole batch goes in at once. Keys the pool already has are skipped. - Self-serve claiming. Members run
/claimand get their key privately. Role gates, per-member limits, and bans are all checked first. - Manual grants. Moderators can hand a key to one person with
/grant, or to everyone holding a role with/grantrole. - Stock warnings. Point KeyBot at a channel and it tells you when a pool falls to ten percent, and again when it runs out.
- A dashboard. Pools, keys, bans, roles, and channels are all managed from the web, signed in with your Discord account.
Quick start
- Add KeyBot to your server
Use the invite link. It asks only for Send Messages, Embed Links, and Attach Files.
- Create a pool and load your keys
Give the pool a name and a game, choose Steam or custom keys, set how many each member may claim, then upload your key file.
- Tell your members to run /claim
They pick the pool from the autocomplete list and KeyBot replies with their key, visible only to them.
Each step is covered in full on Getting started.
Where to go next
Getting startedFrom an empty server to a working giveaway.PoolsEvery pool setting and what it changes.Importing keysFile formats, duplicates, and limits.Claiming keysWhat members see and what can block a claim.ModerationBans, mod roles, and manual grants.Command referenceEvery command, with what is changing.