Currency System
AtomicBot includes a fully automated, database-driven currency system. Each guild can rename this however they like – for this guide we’ll just call it “currency”.
Earn
Players earn currency automatically from normal gameplay: kills, playtime, battlepass progress and more.
Spend
Spend currency on kits, shop items, gambling, ZORP extensions, personal recyclers and whatever else you decide to sell.
Control
Everything is stored in the database. Admins can grant, remove, wipe or let balances carry through wipes.
How Players Earn Currency
Earnings are handled automatically by AtomicBot. You choose the values, the bot does the math.
- Player Kills – reward PvP.
- NPC Kills – reward PvE grinders.
- Playtime Tracking – hourly/interval payouts.
- Battlepass Progress – bonus currency on level-ups.
- Gambling Wins – risk vs reward via the gambling system.
- Admin Commands – manual rewards, events, compensation.
What Currency Can Buy
The shop is fully database-driven per guild. You decide what exists and what it costs.
- Kits & Loadouts – sell starter, PvP or farming kits.
- Shop Items – any item you want to offer (weapons, components, etc.).
- Gambling System – slots / games that pay out currency.
- ZORP Extensions – sell extra protection time or perks.
- Personal Recycler Access – monetize convenience features.
- Custom Server Perks – anything unique to your cluster.
All pricing is set per guild, so two servers using AtomicBot can have completely different economies.
Admin Controls & Wipes
Currency is stored in AtomicBot’s MySQL database and is fully under your control.
- Per-Player Balances – tracked and updated by the bot.
- Grant / Remove – admins can add or take away currency at any time.
- Wipe Behavior – choose to reset balances each wipe, or let them persist.
- Custom Prices – every shop item’s price is configurable per guild.
- Database-Driven – no hard-coded configs; everything comes from the DB.
If you’re unsure how to structure your economy, start small and adjust prices based on player feedback.
Currency Commands
These commands control every part of your server’s economy. All currency actions are logged
in your database, and only players with the Bot Admin Role (stored in
guild_servers.admin_role_id) can run administrator-level commands.
Admin Commands
Add Currency to a Player
/addcurrency <user> <amount>
Gives currency to a specific player. Ideal for rewards, refunds, or events.
Global Reward
/addservercurrency <amount>
Gives currency to every linked player on the server.
Set Currency Name
/setconfig economy currency <name>
Changes the name of your server's currency (e.g., Credits, Coins, Tokens).
Set Kill Reward
/setconfig economy killreward <amount>
Controls how much currency players earn per player kill.
Random Winner
/luckyduck
Picks a random player from your linked database. Used for events, giveaways, and draws.
Player Commands
Check Balance
/stats currency /balance
Shows the player’s current currency balance.
Transfer Currency
/transfer <user> <amount>
Lets players trade currency with each other.
Daily Reward
/daily
Allows players to claim a daily bonus. Cooldown tracked in the database.
Highscores
/playtimerewards highscores <type> <limit>
Types: Playtime, Currency
Limit: how many players to display (e.g., 10 = Top 10)
Player Shop
/shop
The shop system is fully database-driven. Each guild can customize:
- Kits & Emotes
- ZORP Extensions
- Personal Recycler
- VIP Upgrades
- Server-branded items
- Anything an admin wants to add
Prices, availability, and descriptions are entirely controlled via your database.
Need help tuning your economy or shop prices for your server style? Hop into the dev Discord and we’ll help you theorycraft.
Open Dev Discord