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
  1. 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".
  2. For your own, type it in Custom currency, for example zorkmids, and click Apply custom currency.
  3. Tick Currency after the number so amounts read "100 zorkmids".
Use cents
  1. Tick Cents: money has two decimals.
  2. Type amounts with cents, for example !give 12.50 or 2.25 in the bank window. The bank window shows the amount in words under the box.
  3. 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_reload in the console).
  4. Untick it to go back to whole amounts.
Add bank interest
  1. Set Bank interest % per period to, for example, 1.
  2. Set Interest period (minutes) to, for example, 30.
  3. Click Apply the numbers above. Online players get the interest and a message every period.
Make death cost money
  1. Set Wallet % dropped as cash on death to, for example, 25.
  2. Click Apply the numbers above.
  3. 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.

Back to Settings

Type to search every tool, panel, setting, FAQ answer and release.