config.yml reference
Every key in the LavaRises config.yml, with defaults and what it actually changes.
plugins/LavaRises/config.yml holds the global settings. Arenas live in arenas.yml, profiles and kits in kits.yml, and every message in messages_tr.yml.
Top level
| Key | Default | Meaning |
|---|---|---|
locale | tr | Which message file to load (messages_<locale>.yml) |
storage | YAML | Statistics backend |
performance
| Key | Default | Meaning |
|---|---|---|
blocks-per-tick | 1500 | Total cell budget converted to lava per tick. A 192×192 layer is 36,864 cells, so 1500 finishes a layer in about 25 ticks. Recommended range 500 – 5000. On Folia this budget is split across chunk slices and each slice runs on its own region thread. |
chunk-preload-concurrency | 4 | How many chunk requests are in flight while the arena is preparing |
static-lava | true | Engine-placed lava does not flow, so a layer never triggers thousands of fluid updates. Lava a player pours themselves is unaffected. |
debug-metrics | false | Print a measurement line to console after each layer (cells / changed / duration) |
gameplay
| Key | Default | Meaning |
|---|---|---|
reconnect-seconds | 30 | How long a disconnected competitor counts as temporarily offline. The match will not end as “one player left” during this window. |
restore-previous-state | true | Give the player back their previous location and inventory when they leave |
fire-resistance-max-seconds | 15 | Fire Resistance would neutralise lava damage entirely, so its duration is clipped inside an arena. 0 disables the limit. |
water-protection-height | 2 | Water cannot be placed more than this many blocks above the lava level — stops players freezing the flood permanently |
late-join | DENY | DENY or SPECTATE for players arriving after the start |
drop-on-death | true | Drop a dead competitor’s items |
ending-seconds | 10 | Delay between announcing the winner and resetting the arena |
banned-items | ELYTRA, TOTEM_OF_UNDYING, ENDER_PEARL, CHORUS_FRUIT, RESPAWN_ANCHOR | Items that cannot be used inside an arena |
world-isolation
| Key | Default | Meaning |
|---|---|---|
chat | true | Chat is only visible inside the same arena world |
hide-non-arena-players | true | Arena players and outsiders are hidden from each other, tab list included. Players in the same world always see each other. |
Notifications, titles, action bars and sounds are always arena-scoped — see Multi-arena & isolation.
ui
| Key | Default |
|---|---|
scoreboard | true |
boss-bar | true |
action-bar | true |
lava
| Key | Default | Meaning |
|---|---|---|
protected-materials | OBSIDIAN, CRYING_OBSIDIAN, ANCIENT_DEBRIS | Never converted to lava. Bedrock and barriers are always protected. |
extra-replaceable | SNOW, VINE, LILY_PAD | Extra blocks the AIR_LIKE mode is allowed to flood |
map-generator
Applies to the VOLCANIC_BASIN generator. Everything is deterministic and seed-bound.
| Key | Default | Meaning |
|---|---|---|
spawn-count | 24 | How many spawn candidates to produce |
coal-veins-per-chunk | 2 | Coal veins per chunk |
coal-vein-min / max | 4 / 9 | Coal vein size |
iron-veins-per-chunk | 2 | Iron veins per chunk |
iron-vein-min / max | 3 / 7 | Iron vein size |
copper-veins-per-chunk | 1 | Copper veins per chunk |
copper-vein-min / max | 3 / 8 | Copper vein size |
gold-chance-per-chunk | 0.30 | Gold is rare and low |
gold-max-y | 44 | Gold ceiling |
diamond-chance-per-chunk | 0.07 | Diamond is very rare |
diamond-max-y | 36 | Diamond ceiling — below the lava start level |
tree-chunk-chance | 0.60 | Chance a chunk gets trees |
tree-max-per-chunk | 4 | Tree cap per chunk |
food-chunk-chance | 0.30 | Chance a chunk gets food |
structure-chunk-chance | 0.09 | Chance a chunk gets a small structure |
map-quality
Thresholds used by /lr admin map report.
| Key | Default | Meaning |
|---|---|---|
min-safe-spawns | 16 | Minimum valid spawn points |
max-rich-poor-ratio | 1.5 | Richest vs poorest quadrant |
min-high-ground-blocks | 400 | Standable area at Y ≥ 118 |
max-dominant-high-ground-share | 0.60 | Share of high ground one region may own |
max-wood-distance | 24 | Longest walk from a spawn to wood |
min-upward-routes | 2 | Distinct climbable routes out of the basin |
Next: FAQ.