Economy and Chat Bridge Discord Commands
Every economy, kit and chat-bridge slash command: what each one does, what access it needs, and who can see the reply.
How to read this
These are the GameGrid Discord bot's economy and chat commands. They work the same on every game that has an economy, and none of them names a game.
Two gates apply to all of them. The first is the ability each command needs, which a member holds through their Discord roles โ granted with /permissions grant or a preset such as member or moderator (see Discord Bot Permissions & Security). A member with several roles holds everything those roles grant together. The second is the scopes on the API key you linked with /setup: the player commands need economy:read and economy:write, and the admin ones need economy:admin. No role grant gets past a key that lacks the scope; the bot refuses with a scope error.
Almost every command takes an optional server-id. Without one, the bot uses the server bound to the channel, then the guild default. If neither is set it says so and names all three ways to fix it. /buy, /kits show and /kits claim require it, because the item and kit suggestions need the server first. /help-economy needs no server at all, and /chat-unlink takes none, because a Discord server has only one chat bridge.
Everything here needs /setup to have been run in your Discord server first.
Player commands (the `member` preset)
| Command | What it does | Who sees the reply |
|---|---|---|
/balance | Your balance, in the currency this server calls it. | Private to you |
/daily | Claims your daily login bonus, once per calendar day. If it is already claimed, auto-earn is off, or the bonus is zero, the bot says which. | Private to you |
/shop [category] [search] | The items on sale with their prices and item ids, up to 25 at a time, with the categories and their counts. The category option suggests your own shop's categories as you type. | The whole channel |
/buy <server-id> <item> [quantity] | Buys an item. Quantity is 1 to 100 and defaults to 1, and it means how many of that shop row you are buying. The item option suggests your shop's items as you type, but you can type any name: it is matched by exact item id, then exact display name, then a unique partial match, and an ambiguous name is refused with the candidates rather than guessed at. The reply names the cost, the new balance and the delivery state. | Private to you |
/link | Starts linking your Discord account to your in-game character. The bot sends a seven-character code by direct message, or shows it in a private reply if your DMs are closed. Type !link CODE in the game's chat within ten minutes to finish. | Private to you |
/unlink | Removes your link. Your wallet and balance are kept. | Private to you |
/my-transactions | Your 25 most recent transactions with amounts, reasons and delivery states. | Private to you |
/kits list [server-id] | Every kit on the server, its price, and how many claims you have left. A kit you cannot claim right now is still listed, with the reason. | Private to you |
/kits show <server-id> <kit> | Exactly what is in one kit. | Private to you |
/kits claim <server-id> <kit> | Claims a kit with your own currency and delivers its items the way /buy does. If the delivery fails you are refunded. Needs economy:write. | Private to you |
/help-economy | This list, in Discord. No ability needed and it works before anything is configured. | Private to you |
Shop and currency (the `moderator` preset)
| Command | What it does | Who sees the reply |
|---|---|---|
/shop-admin | Manages the shop from Discord. Set action: to add, remove, list or edit. add takes the game's own asset name (the id, not the display name) and a price; edit changes a price or a category on something already in the shop; remove takes it out; list shows what is there. For remove and edit the item option suggests items already in your shop. An edit with neither a price nor a category is refused rather than reported as a change. | The channel |
/award <user> <amount> [reason] | Adds currency to a user's wallet. The amount must be 1 or more โ Discord refuses a negative before the command is sent. To take currency away, use the Award button on the panel's Wallets tab, which accepts a negative amount. Needs economy:admin. | The channel, and your log channel if you have set one |
/refund <transaction-id> [reason] | Credits a purchase back. It does not remove the item from the player's inventory. Transaction ids come from /my-transactions or the panel. Needs economy:admin. | The channel |
/economy-earn [setting] [value] | With no options, shows the rewards your game can pay and what they are set to. With them, changes one: enabled takes true or false, the rest take a number. A reward your game cannot pay is refused with the reason instead of being stored. The daily login bonus and the Discord activity rewards are set on the panel, not here. | Private to you |
Read Wallets, Awards and Auto-Earn before relying on /economy-earn.
Status and links (the `moderator` preset)
| Command | What it does | Who sees the reply |
|---|---|---|
/economy-stats | The economy's figures for this server. Needs economy:admin. | The channel |
/economy-links | Every Discord-to-character link on this server. Needs the economy.admin.links ability, so the key needs economy:admin (and economy:read to read the list). | Private to you |
/economy-link-remove <user> | Removes one user's link. Needs economy:admin. | The channel |
Setup and configuration (setup user or Discord server owner only)
These two answer to their own rule rather than to an ability: only the person who ran /setup and the Discord server's owner can use them. Not administrators, and not a role holding every ability.
/economy-setup โ there is no switch to turn the economy on, so this reports what is actually there: the currency, how many shop items exist, how many players have linked, whether auto-earn is on, and a short list of what to do next. It is the fastest way to see why something is not working. Private to you.
/economy-config [currency-name] โ with no option, shows the currency, the starting balance, the auto-earn state and the link count. With currency-name, renames the currency (up to 32 characters). You can also rename it on the panel, at Economy โ Overview โ Currency Settings. Private to you.
Chat bridge (the `moderator` preset)
/chat-link #channel โ mirrors in-game chat into that channel and sends the channel's messages back into the game. Both chat commands need the chat.link ability, which the bot only lets a role use while the key carries console:read.
It checks before it promises. If the game has no chat channel the platform can read, it refuses and says so rather than linking a channel that would stay empty. If the server simply is not answering right now, it saves the link and tells you nothing will appear until it does. If the API key cannot read chat, it names the scopes the key needs.
/chat-unlink โ removes the link. It takes no server-id, because a Discord server has only one chat bridge. Both are visible to the channel.
Full details, including what your Discord server needs for the Discord-to-game direction to work, are in Discord Chat Bridge.
Who can see what
Private to the person who ran it: /balance, /daily, /buy, /kits, /link, /unlink, /my-transactions, /help-economy, /economy-setup, /economy-config, /economy-earn, /economy-links โ and every refusal, from every command, including "you do not have permission".
Visible to the channel: /shop, /shop-admin, /award, /refund, /economy-stats, /economy-link-remove, /chat-link, /chat-unlink.
The split is deliberate: what somebody bought for themselves is theirs, and an action taken on a shared server is something the channel should be able to see. /economy-links is the exception on the admin side: it lists who plays as whom, so it is private too.
The rest of the bot's commands โ servers, console, backups, settings and the others โ are in Discord Bot Commands.