Getting started

Introduction

What ExyliaEvents is, the fifty-one minigames it registers, and how the docs are laid out.

ExyliaEvents is a minigame event system. It registers 51 event types — forty-three games and eight team variants — and each one is a real, separate game with its own rules, its own settings screen, its own scoreboard and its own messages.

An event configuration is one arena of one type: its lobby, its spawns, its bounds, its settings, its kits and its rewards. You can have as many as you like, and several can run at the same time. Everything is created from /eventsadmin, and configurations live in the database rather than in a file.

What it covers

51 event types

From TNT Run and Spleef to CS:GO, Capture the Flag, Murder Mystery, Block Morph Hunt and Mace Roulette.

Team games

Fourteen types split players into teams, with eight colours and a team selector.

Gauntlets

Several events back to back with the same players, points per stage and a champion at the end.

Arena cloning

Brackets and Build Battle paste copies of your arena into a generated void world so matches and plots run side by side.

Sign-ups

Open a list, let staff add players, and start an event only those players may join.

Random events

A timer that starts a random configured event when enough players are online.

Stats and rewards

Kills, deaths, wins and games played, globally and per event, with offline-safe rewards.

Requirements

Requirement	Detail
Server	Paper 1.21 or newer. Folia supported.
Java	21
Required dependencies	`ExyliaLib`, `FastAsyncWorldEdit`, `packetevents`
Optional dependencies	`PlaceholderAPI`, `ViaVersion`, `Worlds`, `WorldGuard`, Apollo or Feather, `TAB`, `floodgate`

FastAsyncWorldEdit is required, not optional

Arena schematics are how an arena is restored after a game and how Brackets and Build Battle clone themselves. Without FAWE the plugin does not start.

Where things live

Thing	Where
Event configurations, arenas, settings, rewards	Database (`event_configurations`)
Kits, loot tables, sign-ups, pending rewards	Database
Player statistics, global and per event	Database
Language, timers, limits, cooldowns, music	`config.yml`
Sidebars, one per event type	`lang/<code>/scoreboards.yml`
Every message, boss bar and title, and each type's name, description and category	`lang/<code>/messages.yml`
Build Battle themes	`lang/<code>/buildbattle-themes.yml`
Trivia questions	`lang/<code>/trivia-questions.yml`
Gauntlet series	Database (`event_gauntlets`)
Menu layouts	`lang/<code>/menus/`

Menus, messages and sidebars ship in English, Spanish, Portuguese and French, and follow the language set in ExyliaLib — see Configuration · language.

How to read this documentation

Getting started

Installing, and one arena running from the panel.

Configuring

Arenas, the type catalogue, teams and kits, rewards.

Systems

How a game flows, sign-ups, statistics and what is drawn on screen.

Reference

Commands, placeholders, every configuration key, the API and the FAQ.

Something missing on this page? Tell us on Discord