Use staff mode
Go on duty with a saved inventory, a hotbar of tools and the spectator view, and come back to exactly where you were.
Staff mode puts you on duty: ExyliaStaff saves your inventory and position, gives you a hotbar of staff tools and the staff game mode, and puts everything back when you leave. This page covers entering, the hotbar, what staff cannot do while on duty and the module's settings.
Before you start#
- Give the player
exyliastaff.staffandexyliastaff.staffmode. Without both,/staffis refused. See Permissions. - Staff mode needs PacketEvents to draw the hotbar. Without it the module stays off and the console says why. Vanish, freeze and inspect still run (see their pages).
- The module switch is
modules.staff-modeinplugins/ExyliaStaff/config.yml.
Steps#
Go on duty
Run /staff (aliases /staffmode and /mod). Your inventory is saved, your hotbar fills with tools, and a title and a sound confirm it.
Use the tools
Point at a player and click the item: the Packed ice freezes them, the Book inspects them, the Netherite axe opens the punishment menu. The full list is below.
Leave
Click the Barrier in slot 17, or run /staff again or /staff off. Your inventory, game mode, health and position come back.
To put another player on or off duty, use /staff on <player> or /staff off <player> (needs exyliastaff.staffmode.others).
Check that it works#
Run /staff. You should see the title STAFF MODE, a hotbar full of tools and the staff sidebar. Run /staff again: your own items return. Relog while on duty and rejoin: you get "Staff session resumed" with the time you have been on duty.
What entering does#
The session is a row in the database, so it survives a relog and follows you to another server that shares the database. It is also what the staff log counts. In order:
- If another plugin holds you in an activity (a match, an event), you get "Finish what you are doing first" and nothing changes.
- Whether you were already vanished is remembered.
- Your inventory is saved and the session row is written, before anything touches you.
- The staff game mode, flight and invulnerability apply, health and food fill, the hotbar and the uniform appear, other staff see your name coloured, and the
staff-modesidebar shows. - If
auto-vanishis on and you were visible, you vanish silently. - The enter effect plays.
While on duty you are left out of every cosmetic plugin built on ExyliaLib and count as a watcher for every mode that isolates players, so a match or an event does not hide the server from you.
Leaving, relogs and servers#
Leaving deletes the session row first, then restores your armour, game mode, flight, health, hunger and, with restore-location on, your position. Vanish is turned off if you were visible before entering and restore-vanish is on. Staff chat, x-ray vision, mining alerts and open inventory mirrors close with the session.
Losing exyliastaff.staff or exyliastaff.staffmode while online is noticed within five seconds and ends the session with "You lost permission for staff mode".
exit-on-quit is off by default: quitting keeps the session and your next join, on any server with the same database, resumes it. A /stop keeps every session for the same reason. A session whose saved inventory is gone is deleted, and a saved inventory with no session is restored silently, so a crash never leaves a staff member in the uniform.
The hotbar#
Each tool shows only while its module is on and only to players with its permission. The tool checks the permission again when pressed, so a rank without /freeze cannot freeze from the hotbar either. Nothing in the hotbar or the armour slots ever enters your real inventory.
| Slot | Item | Left click | Right click |
|---|---|---|---|
| 0 | Clock TELEPORT | Jump to the block you look at | Phase through the wall |
| 1 | Lime or gray dye VANISH | Toggle vanish | |
| 3 | Music disc RANDOM PLAYER | Teleport to a random player | |
| 5 | Book INSPECT | Ender chest of the player you look at | Inventory of the player you look at |
| 7 | Netherite axe PUNISH | Open the punishment menu for the player you look at | |
| 8 | Packed ice FREEZE | Freeze or unfreeze the player you look at | |
| 9 | Ender eye SPECTATOR | Spectator view | |
| 12 | Blaze powder REPORTS | Open reports | |
| 14 | Turtle helmet HELPOP | Open help requests | |
| 17 | Barrier EXIT | Leave staff mode | |
| 27 | Diamond or iron pickaxe MINING | Open suspicious miners | Toggle mining alerts |
| 28 | Writable book STAFF CHAT | Toggle staff chat | |
| 29 | Glowstone or gray glass X-RAY | Toggle x-ray vision | |
| 30 | Bell or iron bars GLOBAL CHAT | Cycle global chat | |
| 31 | Spider eye INVISIBLES | Toggle seeing invisible players | |
| 32 | Phantom membrane or feather AUTO VANISH | Toggle always joining vanished (/vanish auto) | |
| 34 | Your head STAFF ONLINE | Open the staff list | |
| 35 | Written book YOUR LOG | Run /stafflog |
The two-item entries show one item or the other from a placeholder such as %staff_vanished%, so the hotbar redraws itself when the state flips. Right clicking a chest with an empty hand opens it silently.
The four armour pieces are drawn on your client over whatever you really wear, so a session that ends anywhere leaves no staff gear behind.
lang/<language>/modules/staffmode/hotbar.yml is yours to edit. A release only adds what your file is missing, so new tools reach your hotbar without undoing your layout. A default that changed on something you edited waits in /exylialib updates.
Going further#
Spectator view#
/staff spectator (or /staff spec, or the Ender eye) switches to real spectator mode, to fly through walls and follow a player. Switching it off puts the staff game mode back. Flight is kept across world changes while on duty.
What staff cannot do#
Always: damage anything (including with projectiles), drop, move or swap items, write creative slots. Settable under block in the module config: pick up items, break blocks, place blocks, wear tools down, lose hunger. Mobs never target a staff member while invulnerable is on. The hotbar's x-ray and reveal toggles refuse a staff member without exyliastaff.xrayvision or exyliastaff.reveal.
What the world does not notice#
Vanish hides the body and staff mode takes its hands off the world, yet the game would still react to you in between. While you are vanished or in staff mode:
- The night does not wait for you: you are not counted for sleeping.
- No mobs spawn and no spawner spins around you, and no phantoms come for your sleepless nights.
- Arrows and other projectiles fly through you instead of stopping in mid-air.
- Experience orbs are left for the players around you.
- A sculk sensor does not hear your steps.
- Carrying Bad Omen through a village starts no raid.
- Nothing lands in your statistics or advancements, so no chat line announces what somebody nobody can see just unlocked. Play time and distances still count.
The server list counts and names only who the tab list shows: vanished players are taken out of the player count and the sample.
Hide your coordinates on F3#
With hide-coordinates on, a staff member's own debug screen stops drawing their position, the block they look at and the chunk they stand in, so a stream or a screenshot does not give away where they are watching from. It is vanilla's reduced debug info sent to that player alone, and it returns after a death or a world change. A client mod can still read the coordinates. It is off by default: leave it off where staff read coordinates to do their job, such as following an x-ray report.
Commands and permissions#
| Command | What it does | Permission |
|---|---|---|
/staff | Enter or leave staff mode. | exyliastaff.staffmode |
/staff on [player] | Enter staff mode. With a player name, put them in it (needs staffmode.others). | exyliastaff.staffmode |
/staff off [player] | Leave staff mode, or take another player out of it. | exyliastaff.staffmode |
/staff toggle [player] | Switch staff mode on or off. | exyliastaff.staffmode |
/staff spectator | Switch between spectator view and normal staff mode. The way back when spectator hides the hotbar. | exyliastaff.staffmode |
| Permission | Who has it | What it allows |
|---|---|---|
exyliastaff.staff | Admins (op) | Marks a player as staff: alerts, seeing vanished players, staff chat. Losing it ends a staff session. |
exyliastaff.staffmode | Admins (op) | Enter and leave staff mode. |
exyliastaff.staffmode.others | Admins (op) | Toggle staff mode for another player. |
Configuration (modules/staffmode/config.yml)
gamemode: ADVENTURE
fly: true
invulnerable: true
auto-vanish: true
restore-vanish: true
exit-on-quit: false
restore-location: true
block:
pickup: true
block-break: true
block-place: true
item-damage: true
hunger: true
nametag-color: AQUA
scoreboard: true
hide-coordinates: false| Key | Default | What it does |
|---|---|---|
gamemode | ADVENTURE | Game mode on duty: SURVIVAL, ADVENTURE, CREATIVE or SPECTATOR. An unknown value falls back to adventure. Creative always allows flight. |
fly | true | Allow flight. |
invulnerable | true | No damage taken, no mob targeting. |
auto-vanish | true | Vanish on enter. Needs the vanish module. |
restore-vanish | true | Unvanish on exit when the player was visible before entering. |
exit-on-quit | false | End the session on quit instead of resuming it on the next join. |
restore-location | true | Teleport back to where the session began, even on another server of the network. |
block.* | all true | pickup, block-break, block-place, item-damage, hunger: what staff cannot do. |
nametag-color | AQUA | Colour of the name as seen by other staff. Empty for none. |
scoreboard | true | Show the staff-mode sidebar. Needs the scoreboard module. |
hide-coordinates | false | Hide the staff member's own position from their F3 screen. |
Hotbar actions are written staff:<name>; commands as player: <cmd>, console: <cmd> or player-proxy: <cmd>. Clicks can be left, right, shift_left, shift_right, drop, swap, middle and more. A command pressed on a player reads them as %target% (their name) and %target_uuid%, so right: player: inspect %target% opens another plugin's inspector on whoever was clicked. Slots go from 0 to 35, plus offhand, helmet, chestplate, leggings and boots; an entry tagged module: <id> only shows while that module is on, and one with permission: only to players holding it.
Messages live in lang/<language>/modules/staffmode/messages.yml: enabled, disabled, already-enabled, already-disabled, enabled-other and disabled-other (%target%), permission-lost, session-removed, session-resumed (%time%), disabled-by-module, spectator-on, spectator-off, busy (%activity%, %plugin%) and effects.enter / effects.exit (title, sound and more, played on entering and leaving). Colours and message syntax are explained in ExyliaLib colours and messages.
Placeholders: %staff_staffmode_status% (true while in a session), %staff_staffmode_time% (session time as a clock), %staff_staffmode_spectator%, %staff_mode% and %staff_in_mode%. See Placeholders.
Something missing on this page? Tell us on Discord