Lobby PvP
Opt-in sword fights in the lobby, the kit and how players get their hotbar back, zones, tops, streak rewards and the repeat-kill window.
Lobby PvP (pvp) is opt-in. A player holds the sword, a short countdown runs, and the fighting kit goes
on. Only two players in that state can hurt each other. Their own things are kept safe in an ExyliaLib stay
and come back exactly: on putting the sword away, death, quitting, leaving the lobby, switching the module
off, or after a crash.
How a fight goes
- Every player in the lobby has a sword in the reserved hotbar slot (
sword-slot, default 4). - Holding it for
equip-seconds(3) puts the kit on; a boss bar counts down, with a quiet tick each second. - Hitting or being hit by another fighter starts a combat tag of
tag-seconds(10), during which the sword cannot be put away. - Staying off the sword for
unequip-seconds(3) takes the kit off. - After dying, a fighter respawns at
respawn(the lobby spawn when its world is empty) and gets their things back.
Zones are boxes where the kit goes on when walking in and off when walking out, placed from
/lobbyadmin → Lobby PvP.
Settings
| Key | Default | What it does |
|---|---|---|
top-command | [pvptop] | Labels of the command that opens the kills top. |
permission | empty | Permission needed to fight. Empty is everyone. exylialobby.pvp in plugin.yml is also declared, default true. |
equip-seconds / unequip-seconds / tag-seconds | 3 / 3 / 10 | The three timers above. The first two take decimals (0.5); 0 is at once. |
countdown-sounds | tick, finish, cancel | Sounds of the countdown, heard by that player only, as NAME|volume|pitch. Blank plays nothing. |
sword-slot | 4 | Sword slot when the hotbar module is off; with it on, its sword-slot is used. |
sword-material | WOODEN_SWORD | The sword every player holds. |
quit-counts | true | Quitting in combat counts as a death for the quitter and a kill for their opponent. |
kit | iron armor and sword | helmet, chestplate, leggings, boots, weapon; any item a menu accepts. Empty leaves a slot free. |
respawn | unset | Where a fighter respawns. |
top-refresh-seconds / board-rows | 30 / 5 | Refresh of the tops and rows of the hologram board. |
board | unset | Where the top hologram stands . |
streak-rewards | none | Rewards by kill streak: a console command (%player_name% works) or item:MATERIAL:amount. Items go to ExyliaLib's reward queue when the inventory is full. |
zones | none | The boxes described above. |
repeat-kill-window | 5m | See below. |
The repeat-kill window
Killing the same player again within repeat-kill-window counts no kill, no streak and no reward (their
death still counts), so two accounts farm nothing. Quitting in combat never pays a streak reward either.
Staff commands
/lobbyadmin pvp setspawn sets the fighters' respawn where you stand and /lobbyadmin pvp setboard places
the top hologram. Kills, deaths and streak are stored in the database (lobby_pvp_stats) and covered by
/exylialib wipe. Placeholders: %lobby_pvp_...%.
Something missing on this page? Tell us on Discord