Getting started

Introduction

What ExyliaWarzone is, its five modules, the admin hub, what it needs and how this documentation is organised.

ExyliaWarzone fills your combat areas with things worth fighting over, all built and edited in game: supply drops falling from the sky on a parachute, power-ups to grab, loot chests that refill themselves, zones that put themselves back, and duel rooms that seal shut behind two fighters. No resource pack and no WorldEdit commands: every crate, zone, chest and room is made from a menu.

It is a premium plugin, installed through a licence loader. See Installation.

What is included

Five modules, each switched on or off in config.yml, and the flags their areas carry. Turn off what your map does not need.

Supply drops

Crates on a parachute, announced with a beam and a boss bar, locked for a moment after landing. Tiers with their own odds and loot, envoys that drop several at once on a timetable.

Power-ups

Spinning items at fixed points or anywhere in an area. The first player to walk into one takes its potion effects and rewards.

Loot chests

Any chest or barrel refilled from a template's loot table on a cooldown, with a hologram counting down.

Regen zones

Areas saved once and pasted back on a fixed timer with a warning, or once nobody has touched them for a while.

Duel rooms

Enclosed rooms where a fight starts when enough players walk in: the border closes, the last one standing is paid and the room rebuilds.

Region flags

PvP, building, block lists, temporary blocks, drops, fall damage and keep inventory for every zone and room.

One hub

/warzoneadmin opens the admin hub: a card per module, each saying whether it runs (Enabled, Disabled, or the plugin it is missing), and a Settings card that opens every setting of every module in a menu. Each module also has its own command to jump straight to its editor, such as /supplydropsadmin or /duelroomsadmin, so a builder can be given one module without the rest.

Built for real servers

Folia. Every crate, power-up, chest, zone and room runs on the thread of the region it is in.
Networks. Everything is stored in the database database.yml points at. Supply drop tiers and loot chest templates are shared by every server on it; envoys, zones, chests and rooms belong to the server they were made on.
Rewards are never lost. What does not fit in a full inventory is kept and handed over on the player's next join. Money, experience and items from power-ups and duel rooms go through ExyliaLib's boosters.
Players choose. Supply drop and duel announcements can be muted by each player in /settings.
Six languages. English, Spanish, French, Portuguese, Russian and Turkish ship with the plugin.

Requirements

Requirement	Detail
Server	Paper 1.21.1 or newer, or Folia 1.21.4 or newer.
Java	21.
ExyliaLib	Required, 1.481.0 or newer; installed by the loader.
PacketEvents	Required by ExyliaLib; power-ups and the world-border overlay of a sealed duel room are drawn with it.
Optional	FastAsyncWorldEdit (faster schematics; ExyliaLib's own engine works without it), PlaceholderAPI, ExyliaEconomy or Vault, ExyliaSurvivalCore (statistics).

Coming from ExyliaSurvivalCore

These five modules used to live in ExyliaSurvivalCore. ExyliaWarzone reads the same tables and copies the old schematics, so what you built comes along. See Moving from ExyliaSurvivalCore.

How to read this documentation

Start with Installation and First steps. The pages under Modules explain each module and its editor; Server covers region flags, other plugins and moving from ExyliaSurvivalCore. The Reference section lists every command, permission, placeholder and configuration key, and the one API event.

Something missing on this page? Tell us on Discord