Configuration
The keys most servers change and a map of every config file
MoneyRace ships lean, so most servers change only a few keys. Every key in every file has a one line comment above it. After editing, run /moneyrace admin reload.
Prefer clicking
The setup wizard (/moneyrace admin setup) sets the mode, team size, starting balance, team vaults and which main events are on. The admin menu (/moneyrace admin menu) has pages for money, teams, events, season and settings.
Start here
These are in config.yml.
| Key | What it does |
|---|---|
mode | SEASON for a public server, EVENT for an admin run event |
economy.starting-balance | Money every new player starts with (1000) |
teams.max-size | Players per team (6) |
kill.type, kill.tier-values, kill.bounty-values | How much a kill takes |
economy.provider | MONEYRACE runs its own economy, EXTERNAL uses another Vault economy plugin |
storage.type | SQLITE needs nothing, MYSQL for networks |
Keys set to AUTO follow the mode. For example teams.player-create: AUTO means players can make teams in SEASON mode but not in EVENT mode.
Mode defaults
| Key | SEASON | EVENT |
|---|---|---|
teams.player-create | true | false |
teams.auto-solo | true | false |
vault.enabled set to AUTO | true | false |
teams.score | Vault balance when vaults are on, member balances otherwise | Member balances |
tiers.source, kill.value-source | BOUNTY | TIER |
teams.lock-after-days | applies | ignored |
vault.enabled ships as false, so team vaults stay off until you set it to true or AUTO.
config.yml sections
| Section | What is in it |
|---|---|
language, server-name | Which lang file to use, and the server name shown in messages |
mode | SEASON or EVENT |
storage | SQLite file name, table prefix and the MySQL login. See Storage |
economy | Provider, currency symbol and names, number format, starting balance, late joiner bonus and max balance. See Money and economy |
pay, banknotes | Smallest payment, and the smallest and largest banknote |
kill | Kill money type and values, mint mode, combat credit and the anti farm checks. See Kill money |
balance | Catch up bonuses and the final week multiplier. See Catch up bonuses |
teams | Who creates teams, size, name rules, invites, friendly fire, chat shortcut, join lock, team score, nametags, colours and the team roll. See Teams and trust |
tiers, bounty | Where the tier comes from, and which streaks and ranks give bounty levels |
trust | How many players one player can trust |
draft | Draft timers, bid limits and payments. See EVENT mode and the draft |
leaderboard | Refresh time (30 seconds) and page size (10) |
commands | Turn on /pay, /bal, /baltop and /withdraw with short-aliases |
vault | The team vault add-on |
main-events | Defaults shared by all main events |
season, progression | See Seasons |
rituals, insurance | The rituals add-on and the Insurance Charm keep percent |
hud | Action bar, grace and season bossbars, optional sidebar and tab header, and tab names |
holograms | See Holograms |
setup | Whether admins get the setup wizard reminder |
The HUD
The action bar with balance, team and tier is on. Players can switch it off with /moneyrace hud. The sidebar and tab header are off by default, so turn on hud.sidebar.enabled and hud.tab.enabled if you want them. Their lines come from the lang file.
If TAB or another plugin already styles names, set teams.nametags.enabled: false and hud.player-list-name.enabled: false.
Other files
| File | What is in it |
|---|---|
events.yml | World events (timer, reveal, one section per event), capture point settings with per point overrides, altar settings and the request pool, the main event scheduler and one section per main event with prizes and rules |
items.yml | The banknote, wand, event kits, vault and decoy blocks, and ritual items with their recipes. Supports item models on 1.21.4 and newer and custom model data before that |
menus.yml | Layout, titles, slots and items of every menu. It is safe to restyle, but keep the button keys |
lang/*.yml | Every message players see. See Messages and language |
data/ | Draft stage and captains, season state, progression overrides and setup state. Not meant for hand editing |
menus.yml breaks
If a menu looks wrong after editing, delete menus.yml and run /moneyrace admin reload to get the default back.
Updating the plugin
Each file has a version key at the top. When a new release adds keys, config.yml and events.yml get them added and any key you deleted comes back. Your values stay. Unknown keys are removed from config.yml, except under teams.colors and season.rewards, where your own entries are kept.
menus.yml and items.yml only merge new entries when their version goes up, and never restore ones you removed. The bundled en_US, fr_FR and es_ES files update the same way as config.yml.
Admin made data like arenas, teams, banknotes and saved inventories live in the database, so updating never touches them.