Match flow & profiles

The five phases

1. Lobby. Players run /lr join <arena> and wait in your hub. When min-players is reached the countdown starts (countdown-seconds, default 30). Everyone is teleported into a freshly generated arena world.

2. Grace. No PvP. This is the gathering phase — mine, chop, eat, build up to the ledges. Length is grace-seconds (480 by default, or whatever the profile overrides it to).

3. Rise. The lava level steps up by blocks-per-rise every interval-seconds, from lava-start-y toward lava-end-y. The safe ground shrinks from the bottom up.

4. PvP. Weapons go live, either a fixed number of seconds after the rise begins or the moment the lava reaches a given Y level.

5. Sudden death. If the match drags on, the world border shrinks from border-size down to final-border-size over shrink-seconds, forcing the survivors together. max-match-seconds is the hard ceiling.

When one player is left, the winner is announced and the arena resets after ending-seconds. The match world is unloaded and deleted.

Profiles

A profile sets the pacing and the starting kit. Pick one per arena with profile: in arenas.yml, or switch at runtime with /lr admin setprofile <id> <classic|quick|chaos>.

Profile	Grace	Rise interval	PvP after	Starting kit
classic	480 s	5 s	60 s	none — gather everything yourself
quick	180 s	4 s	45 s	stone pickaxe, stone axe, 8 steak, 32 planks, water bucket
chaos	180 s	4 s	45 s	the quick kit + a random helper item every 90 s

Chaos mode

With chaos.enabled: true the plugin hands each surviving player one random helper item on the interval-seconds beat. The same player never receives the same item twice in a row.

Kits

Kits live in kits.yml under profiles.<name>.items:

items:
  - material: STONE_PICKAXE
    amount: 1
    slot: 0                     # AUTO | 0-35 | HELMET | CHESTPLATE | LEGGINGS | BOOTS | OFFHAND
    name: "<color:#38c1fc>Pickaxe</color>"   # MiniMessage
    lore:
      - "<gray>Starter tool</gray>"
    enchantments:
      unbreaking: 2

Anti-exploit rules

These are the defaults in config.yml under gameplay: — all of them are tunable.

• Banned items — ELYTRA, TOTEM_OF_UNDYING, ENDER_PEARL, CHORUS_FRUIT and RESPAWN_ANCHOR cannot be used inside an arena.
• Fire Resistance is capped — potions would otherwise make lava harmless, so their duration is clipped to fire-resistance-max-seconds (15) inside an arena.
• Water walls are limited — you cannot place water more than water-protection-height blocks (2) above the current lava level, so nobody can permanently freeze the flood.
• Build ceiling — nothing can be built above build-max-y.
• Static lava — lava the engine places does not flow, so a rising layer never spawns thousands of fluid updates. Lava a player pours themselves behaves normally.

Joining, leaving and disconnects

• late-join is DENY by default; set it to SPECTATE to let latecomers watch.
• A player who disconnects mid-match is held as temporarily offline for reconnect-seconds (30). The match will not declare a winner during that window.
• On leaving, dying or the server restarting, the player’s previous location and inventory are restored (restore-previous-state: true). Eliminated players are moved into spectator mode.

Next: Multi-arena & isolation.