Setting Up Your Server Economy

Before you start

There is no switch that turns the economy on. A server has an economy as soon as it has a shop with something in it and a player who has linked their Discord account — which is exactly what this guide gets you to.

You need a GameGrid account with permission to change the server (account owner, administrator, or server manager for that server), and you need to be able to invite a bot to your Discord server.

Palworld only: install UE4SS and PalDefender first, from Game Tools → UE4SS on the Palworld server, and restart. Nothing will deliver until that is done.

Valheim only: nothing to install. The GameGrid Bridge goes in automatically on every start. If the server has not been started since it was created, start it once.

Step 1 — Get the Discord bot into your server

Your players buy through the GameGrid Discord bot, so it has to be in your Discord server before anything else is useful.

Invite it from the Discord Bot page, then run /setup api-key:<your key> in your Discord server. Creating the key is covered in API Keys.

The key needs the economy:read and economy:write scopes for players to browse and buy, and economy:admin for the admin commands (/award, /refund, /shop-admin, /economy-stats, /economy-setup and /economy-config). A key without them fails with a scope error however the Discord roles are set. See API Scopes.

If you run more than one server, set which one the commands mean: /config default-server <server-id>, or bind a channel to a server with /config channel-server.

Give your members access with /config role <role> Read Only. Read Only is enough for /balance, /daily, /shop, /buy, /link, /unlink and /my-transactions, and /help-economy needs no access level at all. Most things that change the economy need Full Access — the exceptions are /economy-setup and /economy-config, which only the person who ran /setup and the Discord server's owner can use.

Step 2 — Load the item list

Open your server, click Economy in the sidebar, and go to the Shop tab.

Click Scan Game Items. The platform reads the list of items your server actually has and loads them into the catalog. It reads a different place on every game — 7 Days to Die's item definitions, the Minecraft server's own jar plus any mods you have installed, Palworld's item dump, Valheim's running item database — and it takes a few seconds.

Start the server first if you can. Every game gets a more complete list from a running server, and on Minecraft and Valheim some items can only be confirmed while it is up.

The count in the message is how many items were loaded. If it comes back short or empty, see The Item Catalog and Shop.

Step 3 — Price a few items

Nothing is for sale until it has a price. In the Shop tab, find an item, type a number in its Price box, and press Enter or click away. That saves it and puts it in the shop.

The In Shop column turns to Yes for anything that is on sale. The Enabled tick is how you take something off sale without losing its price — untick it and the item stays in the list but disappears from /shop.

Use the search box and the category dropdown rather than paging through thousands of rows, and the No Price quick filter to see what you have not done yet.

Start with ten or twenty items. A shop of five hundred is harder for your players to read than a curated one, and you can always add more.

Step 4 — Name your currency

You can do this in either place, and both now take effect.

On the panel: Economy → Overview → Currency Settings → Edit. The panel reports back the name the server actually stored, so a rename that did not take is shown as an error rather than as a success.

In Discord: /economy-config currency-name:Gold, replacing Gold with whatever you want. Only the person who ran /setup and the Discord server's owner can run it.

The name is at most 32 characters and appears in every bot reply and everywhere on the Economy Manager. The default is Coins.

The starting balance for a new wallet defaults to 0. It is shown on the Overview tab and by /economy-config, but the only way to change it today is the Customer API — PUT /servers/<id>/economy/config with startingBalance, scope economy:admin. Once it is set, every wallet created by /link starts with that amount.

Step 5 — Tell your players to link

Post this, or something like it, in your Discord server: run /link, read the code the bot sends you by direct message, then type !link and that code in the game's chat while you are on the server. The code lasts ten minutes.

Their wallet is created the moment the link is verified. Until then they are not in the Wallets tab.

Linking has to come first. A player who has not linked can run /shop, but /buy is refused with "No wallet found — player must link via Discord /link first", because linking is what creates the wallet there is nothing to charge without.

The full flow, and what to do when it does not work, is in Linking Discord Accounts to In-Game Players.

Step 6 — Make one real purchase

Do this yourself before you announce anything. Link your own account, join the server, and use /award on your own Discord user for enough currency to buy something, then /buy it.

Watch the Transactions tab. A working purchase shows a green tick (✓) in the Delivery column within a few seconds.

An hourglass (⏳) means the delivery is in progress and should clear almost immediately. A ↻ means the purchase is paid for and waiting for the player or the server, and is being retried for you. A red cross (✗) means it gave up and wants a Retry or a Refund.

Check the item is actually in your inventory in game. A tick means the platform believes it delivered; on Minecraft that belief is verified against your inventory, and on 7 Days to Die it is not.

Optional — auto-earn and the chat bridge

On the Overview tab, Auto-Earn Settings → Configure turns on automatic rewards and sets the amounts. The form only offers the rewards your game can actually pay, so what you see there is what will work — see Per-game economy support for the full table, and Wallets, Awards and Auto-Earn for how each one is measured.

/chat-link #channel mirrors in-game chat into a Discord channel and sends that channel's messages back into the game. It is separate from the economy but uses the same connection to your server. See Discord Chat Bridge.

If you want one shared wallet across several of your servers, see Sharing One Economy Across Servers.