Introduction
What ExyliaLib is, the modules it ships, and the rules it is built on.
ExyliaLib is the shared library every Exylia plugin depends on. It is installed once on the server and never shaded into a plugin: one copy, one class, one cache.
It is not a grab-bag of helpers. It is dozens of modules with one guiding rule — the server should do as little work as possible. Where something can be a packet instead of real server state, the library sends the packet: sidebars, holograms, nametags and boss bars never create a scoreboard team or an armour stand.
| Java | 21 |
| API | Paper 1.21.4 |
| Runs on | Paper and Purpur 1.21.1 and newer, Folia 1.21.4 and newer, from one build. See Server versions |
| Version documented here | 1.476.2 |
What it gives a plugin#
A YAML file declared as a Java record, generated from it, and migrated when it changes shape.
Menus in YAMLPaginated lists, templates, conditions, live values and clicks bound to actions — no menu code.
One schedulerThe same call runs on Spigot and on Folia's region threads.
Records in a databaseH2, MySQL, MariaDB, PostgreSQL or MongoDB behind one repository, never blocking.
Everything on screenSidebars, holograms, nametags and client waypoints, all as packets.
Players, onceOne claim registry so two minigames cannot hold the same player.
Edited from the browserEvery plugin's settings, messages and menus, edited on the web and applied in game.
The full list, with what each module is for, is in Module index.
Three rules worth knowing before reading further#
Read once, render per viewer#
An item, a menu and a sidebar are definitions compiled when a file loads, and drawn per player
afterwards. Parsing is the expensive half and happens once; drawing is cheap and happens constantly.
That split is why Item is not an ItemStack and UiDefinition is not an open window.
A value is text unless you say otherwise#
Anything substituted into a message, an item or a menu row is inserted as literal text by
default. A player named {error}X shows those characters rather than repainting the line.
withFormatted is the other door, for values a server owner wrote — a rank display written
{highlight}&lMVP.
The question is never what type the value is. It is whose value it is.
A broken part is reported, not fatal#
A mistyped enchantment becomes a dead button and a line in the console; the other fifty buttons keep working. A file that does not describe a menu at all throws, because guessing would hide the mistake.
Shading would put one copy of the scoreboard library, the skull cache and the placeholder registry inside every plugin. With one installed copy there is one cache to warm, one registry to look in, and a placeholder registered by one plugin is visible to the next.
What depends on it#
Every Exylia plugin: ExyliaFFA, ExyliaCapture, ExyliaEvents, ExyliaPracticeCore and the rest. They
list it under softdepend only so the loader that installs it can load first; none of them runs
without it.
Install PacketEvents next to the library: the packet features (screens, HUD, overlays, per-viewer displays) need it. The library lists it as a soft dependency, so without it those features stay off and the console says so.
Some modules lean on optional plugins and say so when they are missing rather than failing quietly — PlaceholderAPI for exposing placeholders outside the server, Vault or PlayerPoints for economy, a clan plugin for clans.
For the server owner#
The library is also what a server owner configures once for every Exylia plugin: the
language of the whole network, the colour palette, updates
that keep every Exylia plugin current, the review of changed defaults
after an update, the web editor and the staff log. All of it is under
/exylialib.
Something missing on this page? Tell us on Discord