Content generated with AI — it may contain mistakes.

ExyliaEvents/HelpUpdated in v1.11.0

Frequently asked questions

The questions that come up most, answered from the code.

Page 20 of 255 min read

The plugin does not start#

Check the console for ExyliaLib: it is required, and so is Paper 1.21.1 or newer (Folia 1.21.4 or newer). FastAsyncWorldEdit is optional. See Installation.

The event will not start#

The setup screen lists what is missing. A configuration needs a lobby spawn, a spectator spawn, at least one spawn point and complete bounds, and it needs to be enabled. If all of that is set, the limits max-events-total, max-events-waiting and max-events-per-player in config.yml can refuse a start, as can a start cooldown: see Configuration. More in Common problems.

Pillars of Fortune says it needs more spawn points#

It gives each player their own pillar, so it needs as many spawn points as max-players. Lower the maximum or add spawn points; the message says how many you have and how many are needed.

The arena is not restored between games#

Save the schematic from the setup screen. Restoring pastes event_bounds_<id> back over the bounds, and without that file there is nothing to paste.

Do I lose my events when I update the plugin? Where are they stored?#

No. Event configurations (arenas, settings, kits, rewards) and each server's main lobby live in the database set in plugins/ExyliaEvents/database.yml, by default embedded H2, so replacing the jar leaves them in place. The arena schematics are the exception: each event_bounds_<id>.schem lives on the server's disk in plugins/ExyliaEvents/schematics/, so keep that folder when you update or move the server.

Moving to another server or database

A second server pointed at the same database gets the configurations but still needs those .schem files to restore or clone an arena. Older installs may still have some in schematics/regions/, which is read too. Before a risky change, /eventsadmin export dumps every table into plugins/ExyliaEvents/dumps/. See Installation.

Brackets, Sumo or Build Battle only run one match#

They clone the arena into the temporary world, and cloning needs the schematic too. Check the console: when the copies cannot be made it says so, and the event falls back to the configuration's own spawns.

Spleef or TNT Run does nothing when I break a block#

Those types look for specific materials. Spleef breaks SNOW_BLOCK; TNT Run removes a floor block only when there is TNT directly beneath it. The full list is in Arenas.

Players are not eliminated when they fall#

Most falling games eliminate on contact with WATER, not on the void. Put water under the arena.

A player cannot join, and says they are busy#

Events share a claim registry with the other Exylia plugins. A player in an FFA arena, a practice queue or the sandbox is held by that plugin and cannot be pulled into an event until they leave it. See Installation.

Only some players can join my event#

The sign-up list is probably open for that configuration. /eventsadmin inscriptions close <id> lifts it. See Sign-ups.

Players in one world cannot join#

world-restrictions in config.yml. BLACKLIST refuses the listed worlds, WHITELIST allows only them, and exyliaevents.world.bypass ignores the rule.

Commands are blocked inside an event#

That is command-whitelist, on by default. Add what you need to the list, or grant exyliaevents.bypass.blocked-commands to staff.

Rewards were not given#

Two causes. reward-commands.only-on-random-events set to true means the global commands only run for automatically started events. And a player who was offline at the end has their rewards queued instead — they arrive on their next join.

Is TAB required?#

No. Sidebars work without it, and the games that hide names do it through a scoreboard team instead. With TAB installed, TAB hides and restores those names, and a player leaving an event gets their normal TAB scoreboard back.

Can events run at the same time?#

Yes, subject to max-events-total. With player-isolation on, the default, everybody in an event is hidden from everybody outside it, so two arenas near each other do not show each other's games.

Starting from the console gives a different event than starting in game#

Same configuration, different kit. With two or more kits, a player starting it picks the kit from a menu; the console cannot, so the event starts with no kit and CTF-style types fall back to their default-kit gear. Keep a single kit in the configuration to get the same result from both. See Kits.

Players cannot choose their kit#

By design: the kit is one per event, picked by whoever starts it, and everybody gets the same one. There is no per-player kit selector. Brackets and Tournament can draw a random kit per round or per match instead — see Event types · Kit mode.

Players cannot choose their team#

Check that team-selector-enabled is true in the configuration and that the players actually joined the event, not only the server lobby. The selector is a compass in the last hotbar slot: a lobby-item, hotbar or per-world inventory plugin writing to that slot removes it. Picking a team also needs exyliaevents.team.choose, which everyone has unless a server denies it; a player without it is placed by the balancer.

A rank should only be able to host some events#

Give it exyliaevents.start.<configId> for each of them rather than exyliaevents.start. See Commands and permissions.

Does it work on Folia?#

Yes, on Folia 1.21.4 or newer. On Folia the temporary world arena copies go into is created through the Worlds plugin, because Bukkit's own world creation is not available there.

Where do I get support?#

On the Exylia Discord. Licences are handled there too.

Something missing on this page? Tell us on Discord