Tutorial / Settings
Economy
Server money settings: economy on/off, currency, cents, starting money, bank interest, cash dropping, player store limits and money lost on death.
What it does
This is the Economy page in the Settings category. It holds the server-wide rules for money. It is not the Economy panel in the Economy category, which lists players' money and the stores on the map.
Here you switch the toolbox economy on or off and set the currency. You also set starting money, bank interest, where players may open their bank, cash dropping and giving, and how much of the wallet falls out on death.
With DarkRP, DarkRP's money is the wallet, and DarkRP pays salaries and starting money. Banks, stores and ATMs still work.
Where to find it
Q menu > KGX's Admin Toolbox > Settings > Economy.
Only superadmins can change these settings. Others see them greyed out, with the note "Only superadmins can change these settings."
The panel
Checkboxes take effect as soon as you click them. Sliders take effect when you click Apply the numbers above. The currency takes effect when you click Apply currency.
| Option | What it does | Default | Range |
|---|---|---|---|
| Economy on (wallet, bank, cash, stores, ATMs) | Switches the whole toolbox economy. | On | - |
| Currency (v3.6.21) | Pick one: US Dollar ($), Euro (€), British Pound (£), Japanese Yen (¥), Canadian Dollar (C$), Australian Dollar (A$), Mexican Peso (MX$), Brazilian Real (R$), Russian Ruble (RUB), Indian Rupee (Rs.), Swiss Franc (CHF), Chinese Yuan (CN¥), Bitcoin (BTC), Credits, Coins, Gold, Gems, Tokens, Bucks, Bottle caps, Chips, or Custom. Picking one sets the symbol, where it goes and its name in words. A line under it shows how amounts look and read. | US Dollar | - |
| Custom currency (symbol or name): | Your own text shown with every amount, e.g. zorkmids. Up to 16 characters. |
$ |
- |
| Apply custom currency | Saves the custom currency. An empty box becomes $. |
- | - |
| Currency after the number (100 credits instead of $100) | Puts the currency after the amount. | Off | - |
| Cents: money has two decimals ($12.50) | Wallets, banks, !give, bank transfers, dropped cash, taxes and fees, interest, the treasury and the Money Log keep cents (v3.6.20.2). Every money box takes cents too (v3.6.20.3): the money settings on this page and on Paychecks, Taxes & Treasury, Jobs, Money Log, Money Printers, Police & Crime and Notes & Mail, store and shipment prices, loadout prices, money sources and the money tools. Off: whole amounts; a balance with cents loses them (rounded down) the next time it changes, and prices saved with cents are charged whole (they keep their cents for when it is on again). Never with DarkRP money. | Off | - |
| Starting money (once, new players) | Given once, on a player's first join. | 500 | 0-1,000,000 |
| Forget empty accounts after (days away, 0 = never) | Removes saved accounts with 0 in wallet and bank of players gone this long. | 180 | 0-3,650 |
| Bank interest % per period (0 = off) | Percent added to online players' banks each period. | 0 | 0-10 (2 decimals) |
| Interest period (minutes) | Minutes between interest payments. | 60 | 1-1,440 |
| Players can open their bank anywhere with !bank | Off: only at a bank or ATM. | On | - |
| Players can drop cash (!dropmoney) and give money (!give) | Allows physical cash and handing money over. | On | - |
| Stores made by players only sell what players may spawn (no admin-only weapons or entities) | Limits stores made with the Store Maker by non-admins. | On | - |
Death
| Option | What it does | Default | Range |
|---|---|---|---|
| Wallet % dropped as cash on death (0 = none) | That share of the wallet falls out as a cash pile where the player died (two decimals, e.g. 2.5). | 0 | 0-100 |
| Admins also drop money and their backpack when they die | Off: toolbox admins keep everything. | Off | - |
| Apply the numbers above | Saves every slider on this page. | - | - |
How to use it
Pick a currency
- Open Currency and pick one, for example Euro (€). It applies at once; the line under it shows "€1,234" and "One Thousand Two Hundred Thirty-Four Euros and 00/100".
- For your own, type it in Custom currency, for example
zorkmids, and click Apply custom currency. - Tick Currency after the number so amounts read "100 zorkmids".
Use cents
- Tick Cents: money has two decimals.
- Type amounts with cents, for example
!give 12.50or 2.25 in the bank window. The bank window shows the amount in words under the box. - Settings and prices take cents too: for example Starting money 99.99, a paycheck of 12.50 (Settings > Paychecks) or a store item for 4.99. Pages opened before you ticked Cents show two decimals after a rejoin (or
spawnmenu_reloadin the console). - Untick it to go back to whole amounts.
Add bank interest
- Set Bank interest % per period to, for example, 1.
- Set Interest period (minutes) to, for example, 30.
- Click Apply the numbers above. Online players get the interest and a message every period.
Make death cost money
- Set Wallet % dropped as cash on death to, for example, 25.
- Click Apply the numbers above.
- Leave Admins also drop money... off if staff should keep their money.
Settings and commands
| Setting | Default | Range |
|---|---|---|
kgxat_economy |
1 | 0-1 |
kgxat_currency |
$ |
text |
kgxat_currency_preset |
usd | a currency id, or custom |
kgxat_currency_suffix |
0 | 0-1 |
kgxat_money_cents |
0 | 0-1 |
kgxat_start_money |
500 | 0-1,000,000 |
kgxat_economy_prune_days |
180 | 0-3,650 |
kgxat_bank_interest |
0 | 0-10 |
kgxat_bank_interest_minutes |
60 | 1-1,440 |
kgxat_bank_anywhere |
1 | 0-1 |
kgxat_cash_drop |
1 | 0-1 |
kgxat_store_owner_limits |
1 | 0-1 |
kgxat_death_money |
0 | 0-100 |
kgxat_death_admins |
0 | 0-1 |
kgxat_money_hud |
1 | 0-1, per player (client): show your wallet on screen |
Player chat commands:
| Command | What it does |
|---|---|
!money, !wallet, !balance |
Show your wallet and bank. |
!bank, !atm |
Open your bank (needs Players can open their bank anywhere). |
!dropmoney <amount>, !dropcash <amount> |
Drop a cash pile in front of you. Not with DarkRP. |
!give <amount> |
Give money to the player you look at, within 150 units. Not with DarkRP. |
Console versions: kgxat_money, kgxat_bank, kgxat_dropmoney <amount>, kgxat_givemoney <amount>.
Tips and limits
- Money is saved by SteamID in
data/kgx_admin_toolbox/economy.json. - Empty accounts are only removed when the map loads.
- Starting money is not given with DarkRP.
- Interest is paid only to players online. Without cents it is rounded down, so a bank too small to earn 1 gets nothing; with cents it is kept to the nearest cent.
- The chat commands only work while the economy is on.
- One cash drop is at most 2,000,000,000. Jailed or dead players cannot drop cash.
- Deaths in a match drop no money.
- Paychecks have their own page: Settings > Paychecks. Backpack settings are in Settings > Backpack & Storage.