Common problems
Fixes for the problems server owners hit most: a menu that does not open, players getting a chest instead of a screen, a sidebar that does not show and placeholders left as text.
Find your symptom, then follow the fix. Start by running /screensadmin check: it lists mistakes in your files with file:line:col.
The plugin does not start#
The console names what is missing. ExyliaLib and packetevents are required. The loader installs ExyliaLib for you and a fresh install needs one more restart; the licence key goes in loader.yml, license_key. See Installation.
A menu does not open, or its command does not exist#
- Run
/screensadmin list. If the menu is not there, it is in the wrong folder (screens/for.html,menus/orspatial/for.yml) or has a mistake:/screensadmin checksays which. - Files are read again within two seconds of being saved. Changes to
config.ymlneed/screensadmin reload. - The command comes from the menu's
commandandaliases, not from the file name.
Players get a chest menu, not the screen#
That is the fallback working. A player gets it when their client cannot draw the screen (Bedrock, or Java older than 1.20.2; 3D menus need 1.21.4), when the menu's min-client is newer than their client, or when they chose chest windows in /settings and follow-player-style is on in config.yml. See Opening and fallbacks.
"You cannot open this screen"#
The menu has a permission the player lacks. See Permissions.
The sidebar, HUD or boss bar does not show#
- In the shipped
scoreboards.ymlthemainentry hasenabled: false. Set it totrue. - The HUD design is drawn only for Java 1.20.2 or newer players who keep Show HUD on in
/settings. Everybody else sees the vanilla sidebar or boss bar written under it, so write both. - Only the entry with the highest
prioritywhosewhen,permissionandworldshold shows.
See HUD, sidebar and boss bars.
A placeholder shows as text#
Install PlaceholderAPI. %player_...% placeholders also need its Player expansion. %exyliascreens_data_<key>% is empty until a menu saves that key. See Placeholders.
An example menu I deleted does not come back#
That is intended. plugins/ExyliaScreens/.examples-written lists what was written. Delete a line from it to get that example again.
check says a screen is heavy for players' games#
The screen draws many pictures or elements and slows the client. Use fewer or smaller <img>, bodies and background pictures. ExyliaScreens already draws it at lower detail when it can.
Something missing on this page? Tell us on Discord