Content generated with AI — it may contain mistakes.

ExyliaStaff/GuidesUpdated in v1.8.0

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.

Page 4 of 389 min read

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.staff and exyliastaff.staffmode. Without both, /staff is 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-mode in plugins/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:

  1. If another plugin holds you in an activity (a match, an event), you get "Finish what you are doing first" and nothing changes.
  2. Whether you were already vanished is remembered.
  3. Your inventory is saved and the session row is written, before anything touches you.
  4. 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-mode sidebar shows.
  5. If auto-vanish is on and you were visible, you vanish silently.
  6. 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.

SlotItemLeft clickRight click
0Clock TELEPORTJump to the block you look atPhase through the wall
1Lime or gray dye VANISHToggle vanish
3Music disc RANDOM PLAYERTeleport to a random player
5Book INSPECTEnder chest of the player you look atInventory of the player you look at
7Netherite axe PUNISHOpen the punishment menu for the player you look at
8Packed ice FREEZEFreeze or unfreeze the player you look at
9Ender eye SPECTATORSpectator view
12Blaze powder REPORTSOpen reports
14Turtle helmet HELPOPOpen help requests
17Barrier EXITLeave staff mode
27Diamond or iron pickaxe MININGOpen suspicious minersToggle mining alerts
28Writable book STAFF CHATToggle staff chat
29Glowstone or gray glass X-RAYToggle x-ray vision
30Bell or iron bars GLOBAL CHATCycle global chat
31Spider eye INVISIBLESToggle seeing invisible players
32Phantom membrane or feather AUTO VANISHToggle always joining vanished (/vanish auto)
34Your head STAFF ONLINEOpen the staff list
35Written book YOUR LOGRun /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.

Change the hotbar

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#

CommandWhat it doesPermission
/staffEnter 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 spectatorSwitch between spectator view and normal staff mode. The way back when spectator hides the hotbar.exyliastaff.staffmode
PermissionWho has itWhat it allows
exyliastaff.staffAdmins (op)Marks a player as staff: alerts, seeing vanished players, staff chat. Losing it ends a staff session.
exyliastaff.staffmodeAdmins (op)Enter and leave staff mode.
exyliastaff.staffmode.othersAdmins (op)Toggle staff mode for another player.
Configuration (modules/staffmode/config.yml)
plugins/ExyliaStaff/modules/staffmode/config.yml
yaml
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
KeyDefaultWhat it does
gamemodeADVENTUREGame mode on duty: SURVIVAL, ADVENTURE, CREATIVE or SPECTATOR. An unknown value falls back to adventure. Creative always allows flight.
flytrueAllow flight.
invulnerabletrueNo damage taken, no mob targeting.
auto-vanishtrueVanish on enter. Needs the vanish module.
restore-vanishtrueUnvanish on exit when the player was visible before entering.
exit-on-quitfalseEnd the session on quit instead of resuming it on the next join.
restore-locationtrueTeleport back to where the session began, even on another server of the network.
block.*all truepickup, block-break, block-place, item-damage, hunger: what staff cannot do.
nametag-colorAQUAColour of the name as seen by other staff. Empty for none.
scoreboardtrueShow the staff-mode sidebar. Needs the scoreboard module.
hide-coordinatesfalseHide 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