Events | Advance GUI, Kit Editor v1.1

ZenEvents

Battle Royale, Boat Race, and Lava Rising event plugin for Minecraft practice servers.

Overview

ZenEvents lets players host events using points earned from kills and playtime.

• /event opens the main GUI.
• /event kiteditor opens the kit editor menu directly.
• /event help shows command help.
• Battle Royale uses selectable kits.
• Boat Race is kitless.
• Lava Rising is a survival climb mode with delayed PvP and shrinking border.

Requirements

• Java 16+
• Spigot/Paper 1.16 - 1.21.x
• WorldEdit/FAWE (arena schematic regen)

Installation

1. Build or download ZenEvents.jar
2. Put it in plugins/
3. Start server once
4. Configure files in plugins/ZenEvents/

Quick Setup

1. Set Lobby


2. Create Arenas

Battle Royale:


Boat Race:


Lava Rising:


Build your climb/survival arena inside the selected region. Lava will rise from the arena bottom during the match.

3. Create and Enable a Kit


Build the kit in your inventory, then save:


Enable it for Battle Royale:


Core Flow

Battle Royale:

1. Host: /event host battleroyal
2. Players join
3. Host selects kit: /event kit <name>
4. Host starts: /event start

Boat Race:

1. Host: /event host boatrace
2. Players join
3. Host starts: /event start

Lava Rising:

1. Host: /event host lavarising
2. Players join
3. Host starts: /event start
4. Short countdown, event becomes active
5. After lavarising.delay-before-rise-seconds, lava starts rising from arena min Y
6. PvP enables after configured delay
7. Border shrinks like Battle Royale

Commands

Player

| Command | Description |
|---|---|
| /event | Open main event GUI |
| /event kiteditor | Open kit editor menu directly |
| /event help | Show help |
| /event join | Join current event |
| /event leave | Leave current event |
| /event points | Check points |
| /event host-help [mode] | Hosting guide |
| /event kit <kitname> | Select kit as host, or customize kit |

Hoster

| Command | Description |
|---|---|
| /event host battleroyal | Host Battle Royale |
| /event host boatrace | Host Boat Race |
| /event host lavarising | Host Lava Rising |
| /event start | Start hosted event |

Admin Arena

| Command | Description |
|---|---|
| /event arena battleroyal <name> | Create BR arena |
| /event arena boatrace <name> | Create Boat Race arena |
| /event arena lavarising <name> | Create Lava Rising arena |
| /event arena corner1 <name> | Set corner 1 |
| /event arena corner2 <name> | Set corner 2 |
| /event arena spawnpoint <name> | Set arena spawnpoint |
| /event arena save <name> | Re-save schematic |
| /event arena delete <name> | Delete arena |
| /event arena list | List arenas |

Admin Kit

| Command | Description |
|---|---|
| /event kit create <kitname> | Start creating new kit |
| /event kit setinv <kitname> | Save your inventory into kit |
| /event kit give <kitname> | Give kit to yourself |
| /event kit delete <kitname> | Delete kit from all modes |
| /event kit deleteeditedkits <kitname> | Delete all player edits for that kit |
| /event kit event-mode <kitname> <mode> | Enable kit in event mode |

Notes:

• create has no name tab-complete intentionally.
• setinv/delete/give/deleteeditedkits do tab-complete kit names.
• A kit can be enabled in multiple modes.
• Only kits enabled for the active event mode can be selected in that event.

Other Admin

| Command | Description |
|---|---|
| /event points set <player> <amount> | Set points |
| /event points add <player> <amount> | Add points |
| /event points remove <player> <amount> | Remove points |
| /event setlobby | Set lobby spawn |
| /event reload | Reload configs |

Permissions

| Permission | Description |
|---|---|
| zenevents.use | Player usage |
| zenevents.host.battleroyal | Host BR |
| zenevents.host.boatrace | Host Boat Race |
| zenevents.host.lavarising | Host Lava Rising |
| zenevents.earn.kill | Earn points from kills |
| zenevents.earn.playtime | Earn points from playtime |
| zenevents.admin | Full admin |
| zenevents.admin.arena | Arena admin |
| zenevents.admin.kit | Kit admin |
| zenevents.admin.reload | Reload |
| zenevents.points.admin | Points admin |

Files

• config.yml - Main settings
• messages.yml - All messages
• menus/main.yml - Main /event GUI
• menus/kiteditor.yml - Kit editor selector GUI
• menus/kit_customization.yml - Live kit customization control menu (leave/reset/save)
• arenas.yml - Arena data
• kits.yml - Event/admin kits
• playerkits.yml - Player custom kits
• playerdata.yml - Player points
• schematics/ - Arena schematics

Lava Rising Host Notes

• Uses normal arena setup commands only (/event arena lavarising ...).
• Players are teleported at start, then spread to unique safe random spots at countdown end.
• Lava rising timing/speed/load are configurable per mode:

- lavarising.delay-before-rise-seconds
- lavarising.rise-layers-per-second
- lavarising.blocks-per-tick
- PvP starts disabled, auto-enables after:
- lavarising.pvp-enable-delay-seconds
- Border uses the same system/settings as Battle Royale.

Rewards And Titles

- Rewards are per-mode and toggleable:
- <mode>.reward: true/false
- <mode>.reward-cmd:
- Winner placeholders in reward commands:
- %winner%
- %winner_uuid%
- Event titles/subtitles are configurable in config.yml:
- battleroyal.titles.start.title/subtitle
- boatrace.titles.start.title/subtitle
- lavarising.titles.start.title/subtitle
- lavarising.titles.lava-rising.title/subtitle
- lavarising.titles.pvp-enabled.title/subtitle

Placeholders

| Placeholder | Description |
|---|---|
| %zenevents_points% | Player points |
| %zenevents_in_event% | In event true/false |
| %zenevents_event_type% | Current event type |
| %zenevents_event_players% | Current participants |
| %zenevents_event_state% | inactive/lobby/active |