Configuration
A tour of config.yml, every option with its default, and how updates merge new options in.
Everything lives in one file, plugins/StealABrainRot/config.yml. Every option has a plain English comment above it in the file itself. This page lists them all with their defaults, points out the ones people change first, and links to the page that explains each feature properly.
When the plugin updates, new options merge into your existing config on their own, with your values and comments kept. That is what config-version at the top is for, so leave it alone. The flip side: if an update changes the default of an option you already have, you keep your old value until you change it yourself.
Applying changes
| Change | How to apply it |
|---|---|
| Most options | /brainrot admin reload |
Anything under storage | Full server restart |
arenas.yml edits | /brainrot admin reloadarenas, with nobody on a base |
/brainrot admin reload re-reads the config, the language file, mob tiers, events, achievements, cosmetics and the economy setting. It also re-reads arenas.yml, but only when nobody is on a base, so a live game is never disturbed.
Options people change first
| Option | Default | Why change it |
|---|---|---|
game.game-duration | -1 | Seconds per round. -1 means no rounds, the game just runs |
game.starting-money | 500 | Faster or slower early game |
bases.max-per-arena | 6 | How many bases an arena can have |
bases.protection-duration | 60 | Longer shields mean safer bases and less stealing |
mobs.spawn-interval | 7 | Lower means more mobs on the runway |
mobs.sell-percent | 50 | Refund when a player sells a mob (0 = nothing back, -1 = selling off) |
teams.enabled | false | Turn on team mode |
economy.mode | internal | vault to use real server money |
tiers.<n>.cost / income | varies | Your whole economy balance |
Every option
Editing the mob tiers
Each entry under tiers is one mob type. You can rename, reprice and add new tiers (9 and up) freely:
tiers:
5:
name: "Rizz Dragon"
entity: RAVAGER # vanilla mob used as the body
cost: 35000.0
income: 3500.0 # money per second when secured
weight: 3 # spawn chance compared to the other tiers
speed: 0.6 # walk speed multiplier
rarity: LEGENDARY # COMMON, UNCOMMON, RARE or LEGENDARY, colors the name
model: "" # ModelEngine model id, or "" for the vanilla mob
ability: income-burst # optional: income-burst, aura, heavy, escape
event: "" # optional: an event id, so it only spawns during that eventweight is a share, not a percentage. The five always-on tiers have weights of 30, 30, 25, 12 and 3 (100 in total), so tier 5 spawns 3 times in every 100. Add a tier with weight 50 and every other tier gets rarer. Event-only tiers are left out of this normal roll and use their event's exclusive-chance instead.
Crate mob rewards are picked from the RARE and LEGENDARY tiers, so keep at least one of each if you want that reward to hand out mobs.
The scoreboard
The sidebar has three layouts, one per phase, all under scoreboard.phases:
no-base: joined but has not claimed a base yetplaying: owns a basespectator: watching as a ghost
Lines are plain text with these placeholders:
| Placeholder | Shows |
|---|---|
%player% | The player's name |
%money% | Current balance |
%income% | Money earned per second, with every boost applied |
%mobs% / %max_mobs% | Secured mobs, and the slot count including upgrades |
%base% | Their base number, or - |
%shield% | Shield time left, or INACTIVE |
%steals% / %deaths% | This session's steals and deaths |
%time% | Time in the game (mm:ss) |
%queue% | Spectator queue position, or - |
%rebirths% | How many times they have rebirthed |
%team% | Their team number and teammates, or - |
%round% | Time left in a timed round, WAITING, or ∞ with no clock |
%event% | The special event running right now, or - |
%arena% | Which arena they are in |
An empty "" line is a blank spacer row. The default playing layout now includes rebirths, the round and the event. If you are upgrading from an older build, config-version: 7 merges the new default and runs a one-time scoreboard patch on start. A phase list you never edited is swapped for the new default, and one you did edit gets the missing lines appended (up to 15). The no-base phase shows Round too.
Colors everywhere
Any text the plugin shows (messages, scoreboard, holograms) accepts & codes, hex (&#FF8800), gradients, rainbow text and a 125 color named palette. The full reference is on Colors & Formatting.