Skip to content
Rosti Studios

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:

TOML
[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 = false

Something missing or wrong? Tell us on Discord. This documentation describes v2.0.0.