RS-Economy documentation · v2.0.0
Configuration
Every setting in rs_economy-common.toml, with its default and what it does.
The config lives at config/rs_economy/rs_economy-common.toml. It is created on first start, commented, and identical on NeoForge and Fabric.
Most settings also have an in-game command (see Commands). If you edit the file by hand and a change does not seem to apply, restart the server.
#Updates never overwrite it
Your values stay. A new release adds new keys with their defaults and leaves what you set alone.
#[general]
| Key | Default | What it does |
|---|---|---|
currency |
"Coins" |
name of the currency, shown everywhere |
leaderboard_status |
true |
enable /leaderboard for players |
daily_reward_min |
100 |
smallest daily reward |
daily_reward_max |
500 |
largest daily reward |
number_compact |
true |
show large numbers as 1.5k, 2.5M |
number_compact_threshold |
1000 |
the number from which shortening starts (1 to 2,147,483,647) |
Shortening keeps three significant digits: 1k, 1.23k, 12.3k, 123k, 1M. Below the threshold, and when it is off, numbers print in full. The suffixes come from format.units in the locale files, so each player sees them in their own language.
#[bounty]
| Key | Default | What it does |
|---|---|---|
bounty_status |
true |
enable bounties |
bounty_min_amount |
100.0 |
smallest single placement |
bounty_expiry_hours |
0 |
hours until a bounty lapses; 0 is never |
bounty_refund_on_expiry |
true |
refund contributors when a bounty expires or is removed |
bounty_announce |
true |
broadcast new bounties anonymously |
bounty_announce_threshold |
500.0 |
only broadcast from this total; 0 always announces |
#[trade]
| Key | Default | What it does |
|---|---|---|
trade_status |
true |
enable /trade |
trade_expiry_seconds |
60 |
seconds before an offer lapses; 0 is no timeout (0 to 86,400) |
#[shop]
| Key | Default | What it does |
|---|---|---|
shop_status |
true |
enable sign shops |
shop_protect_container |
true |
only the owner and admins can open or break the chest |
shop_max_per_player |
0 |
shops per player; 0 is unlimited |
shop_allow_sell_above_buy |
false |
allow shops that pay more than they charge |
shop_trade_feedback |
true |
confirm trades over the hotbar |
If you turn off
shop_protect_container, the stock is only as safe as the protection plugin or mod you run instead.
#[coin]
| Key | Default | What it does |
|---|---|---|
coin_status |
true |
enable /withdraw and /deposit |
coin_silver_status |
true |
allow silver coins |
coin_gold_status |
true |
allow gold coins |
coin_value |
1.0 |
value of one silver coin (0.01 to 1e12) |
coin_gold_value |
100.0 |
value of one gold coin |
#[villager]
| Key | Default | What it does |
|---|---|---|
villager_coins_status |
false |
pay villager and wandering trader trades in coins instead of emeralds |
villager_emerald_value |
10.0 |
what one emerald is worth in coin units. Capped, see Coins |
#[scoreboard]
| Key | Default | What it does |
|---|---|---|
scoreboard_status |
true |
master switch |
scoreboard_default_visible |
true |
visible for players who never toggled it |
scoreboard_allow_player_toggle |
true |
players may use /scoreboard_toggle |
scoreboard_title |
"" |
custom title; empty uses the translated one |
scoreboard_lines |
["blank","balance","rank","bounty","blank","footer"] |
line ids, top to bottom |
scoreboard_update_interval |
40 |
ticks between refreshes (1 to 12,000) |
scoreboard_show_scores |
false |
show the red score numbers |
#Example
A hard-money survival server with a small daily reward, no villager coins, and shop limits:
[general]
currency = "Silver"
daily_reward_min = 20
daily_reward_max = 60
[shop]
shop_max_per_player = 5
[bounty]
bounty_expiry_hours = 72
bounty_refund_on_expiry = true
[villager]
villager_coins_status = falseSomething missing or wrong? Tell us on Discord. This documentation describes v2.0.0.
