Troubleshooting
Common Economy issues and fixes.
| Symptom | Likely cause | Fix |
|---|---|---|
| Commands say Economy is disabled | EconomyConfig.enabled is false. | Enable Economy in /dashboard/<guildId>/economy and save. |
| Daily, work, or crime says to come back later | The matching cooldown timestamp is still inside 22h, 60m, or 90m. | Wait for the remaining duration shown by the command. |
| A shop role item cannot be bought because the user already owns it | The buyer already has the linked role. | Choose a different item or remove the role before testing. |
| Purchase refunded | Discord rejected adding the reward role. | Move the bot's highest role above the reward role and confirm Manage Roles. |
| Balance card falls back to an embed | Canvas rendering failed, often from an invalid remote image or font/rendering issue. | Reset or save the card layout again. The command still shows balances in the fallback embed. |
Insufficient funds are checked late
Gamble, pay, and shop commands read the current wallet inside a transaction. A user may see insufficient funds even if an earlier screen or autocomplete looked affordable.