Economy and Chat Bridge Discord Commands
The nineteen economy and chat-bridge slash commands: 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 bot access level a member holds through their Discord roles — No Access, Read Only, Console Access, Full Access — set with /config role. The second is the scopes on the API key you linked with /setup: the economy commands need economy:read and economy:write, and the admin ones need economy:admin. Full Access with a key that lacks the scope still fails, 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. The two exceptions are /help-economy, which needs no server at all, and /chat-unlink, because a Discord server has only one chat bridge.
Everything here needs /setup to have been run in your Discord server first.
Player commands (Read Only)
| 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 <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 |
/help-economy | This list, in Discord. No access level needed and it works before anything is configured. | Private to you |
Shop and currency (Full Access)
| 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 (Full Access)
| 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 economy:read. | The whole channel |
/economy-link-remove <user> | Removes one user's link. Needs economy:admin. | The channel |
/economy-linkspublishes who plays as whom to everybody who can read the channel. Run it somewhere your members cannot see if that matters to your community.
Setup and configuration (setup user or Discord server owner only)
These two answer to their own rule rather than to an access level: only the person who ran /setup and the Discord server's owner can use them. Not administrators, not Full Access holders.
/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 (Full Access)
/chat-link #channel — mirrors in-game chat into that channel and sends the channel's messages back into the game.
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, /link, /unlink, /my-transactions, /help-economy, /economy-setup, /economy-config, /economy-earn — and every refusal, from every command, including "you do not have permission".
Visible to the channel: /shop, /shop-admin, /award, /refund, /economy-stats, /economy-links, /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.
The rest of the bot's commands — servers, console, backups, settings and the others — are in Discord Bot Commands.