Introduction
What ExyliaEvents is, what you need to run it and what you will have working in ten minutes.
ExyliaEvents runs minigame events on your server: 54 event types (forty-six games and eight team variants), each with its own rules, settings screen, scoreboard and messages. In about ten minutes you can have one arena open and players inside it.
An event configuration is one arena of one type: its lobby, spawns, bounds, settings, kits and 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, not in a file.
Before you start#
| You need | Detail |
|---|---|
| Server | Paper 1.21.1 or newer, or Folia 1.21.4 or newer. |
| Java | 21 |
| Required | ExyliaLib, installed before the first boot. |
| Optional | FastAsyncWorldEdit, PlaceholderAPI, packetevents, ExyliaPracticeCore, ExyliaProxyUtils, Worlds, WorldGuard and others, listed in Installation. |
Arena schematics restore an arena after a game and let Brackets, Sumo and Build Battle clone themselves. With FAWE installed they go through it; without it, ExyliaLib's built-in engine saves and pastes the same .schem files, so adding or removing FAWE never means saving arenas again.
Steps#
Install
Put ExyliaEvents.jar and ExyliaLib in plugins/ and start the server. See Installation.
Open the panel
Run /eventsadmin and set the main lobby, where players return when they leave an event.
Create an event
Pick a type, build its arena and open it. Your first event walks through every click.
Tune it
Settings, kits and rewards per event: Arenas, Teams, kits and loot, Rewards.
Check that it works#
Run /events as a player. You should see your event listed and, once it is open, be able to join it and land in its lobby. If nothing shows up, see Common problems.
Going further#
From TNT Run and Spleef to CS:GO, Capture the Flag, Murder Mystery, Block Morph Hunt and Mace Roulette.
Team gamesFourteen types split players into teams, with eight colours and a team selector.
GauntletsSeveral events back to back with the same players, points per stage and a champion at the end.
Arena cloningBrackets, Sumo and Build Battle paste copies of your arena into a temporary void world so matches and plots run side by side.
Sign-upsOpen a list, let staff add players, and start an event only those players may join.
Random eventsA timer that starts a random configured event when enough players are online.
Stats and rewardsKills, deaths, wins and games played, globally and per event, with offline-safe rewards.
Where things live
| Thing | Where |
|---|---|
| Event configurations, arenas, settings, rewards | Database (event_configurations) |
| Kits, loot tables, sign-ups, pending rewards | Database |
| Gauntlet series | Database (event_gauntlets) |
| 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 |
| Menu layouts | lang/<code>/menus/ |
Menus, messages and sidebars ship in English, Spanish, Portuguese and French (Russian and Turkish folders also exist) and follow the language set in ExyliaLib: see Configuration · language and Messages and languages.
Something missing on this page? Tell us on Discord