Frequently asked questions
Short answers about ExyliaStaff: requirements, vanish levels, punishments, alerts, two-factor and upgrades, each with a link to the full guide.
Each answer is short and links to the guide that has the whole story. For a problem that needs steps, see Common problems.
Does ExyliaStaff need PacketEvents?#
No, it is optional. Without it the plugin loads, but staff mode, x-ray vision and reveal stay off. Vanish, freeze and inspect fall back to plain Bukkit paths, and replays are saved but cannot be watched. See Installation.
The plugin does not start#
ExyliaLib is listed as soft only so the loader can install it, but the plugin needs it to run. Check it is in plugins/, then read the console. See Installation.
A module shows as failed#
A module throws on enable when, for example, its table cannot be created. The console has the reason, the module keeps its commands off, and the next start retries. /staffadmin modules shows the state of each. A module that only needs PacketEvents stays off instead of failing: see the first question.
Staff cannot see each other while vanished#
A viewer needs exyliastaff.vanish.see and a level at least the vanished player's. With no exyliastaff.vanish.level.<n> node everybody is level 0 and sees everybody. Give an admin exyliastaff.vanish.level.3 and only staff at level 3 or above see them. See Vanish.
A player was frozen and then logged out#
With persist-on-quit on, the default, they come back frozen on whichever server they join, and staff are told they are back, as long as they return within 10 minutes of logging out. New in v1.9.0 With it off, they rejoin free. Staff on every server are told they logged out, and quit-commands in modules/freeze/config.yml may already have punished them. See Freeze.
The ladder skipped a step, or did not escalate#
The ladder counts punishments this plugin recorded for the same reason id within ladder-reset-days (30 by default). A ban typed straight into the ban plugin, or a different reason, does not count. See Punishments.
The punishment command did nothing#
With engine: commands the template of the step's type runs as the console with %player%, %duration%, %reason% and %staff%, and the duration is passed as written in the ladder. Check that the command exists for your ban plugin and reads 7d the way you wrote it. "No command for TEMPBAN" means the type has no template in commands. See Punishments.
Alerts do not reach staff on another server#
Cross-server delivery needs Redis in ExyliaLib's database.yml, with a distinct server-id per server. /staffadmin redis says whether this server is connected. Without Redis every channel still delivers locally. See Installation.
Mining alerts are quiet even though a player is suspicious#
A staff member receives them only with exyliastaff.mining.alerts and alerts on, which leaving staff mode turns off. /mining on turns them back on. A warning is announced once and never repeated on the timer. See Mining.
A staff member lost staff mode with "You lost permission"#
exyliastaff.staff or exyliastaff.staffmode was removed while they were online. The plugin notices within five seconds. See Staff mode.
Can staff approve their login from Discord?#
Yes, with ExyliaLink and the staff member's Minecraft and Discord accounts linked. See Two-factor.
How do I get alerts for alternate accounts of banned players?#
Link the network to Exylia Staff Web and keep the alts module on. Staff with exyliastaff.alts are told when someone sharing an address with a banned account joins.
My edit to a menu vanished#
Since 1.4.0 it does not: menus and hotbars are yours, and a release only adds what they are missing. Check that you edited the folder of the language in use: language in config.yml picks lang/<language>/, and default follows ExyliaLib's language. See Languages.
Where did /exyliastaff and the admin panel go#
The in-game panel moved to Exylia Staff Web in 1.4.0. The audit is still recorded in game, and /notes reads and writes a staff member's file. Since 1.5.0 the technical command is /staffadmin, which replaces /exyliastaff and /es. Since 1.8.0 a player typing /staffadmin gets a small hub for modules, settings and reload. See Commands.
Where did /staffadmin wipe go#
It was removed in 1.8.0. ExyliaLib's /exylialib resetplayer <player> ExyliaStaff @account @history removes what it removed, and more, with a dump first. See Commands.
Another plugin needs /tp or /top#
List the names in disabled-commands in config.yml and restart. The rest of the module keeps working, and /stafftp and /stafftop stay. See Configuration and Teleport.
Is there a staff chat prefix character, or a claim button for reports?#
Neither exists. Staff chat is a toggle or /sc <message>; reports are resolved or dismissed, and several staff may look at the same one. See Staff chat and Reports.
Something missing on this page? Tell us on Discord