Skip to content

Staff Mode

Staff Mode is a dedicated moderation state, not a single toggle. When a staff member enters it with /staffmode, their survival inventory is swapped out for a hotbar of moderation gadgets, they go invisible, and — depending on config — they gain flight and night vision. Leaving staff mode restores their normal inventory and state exactly as it was.

The whole feature lives in the staff module. It is a staff-mode-only module: it exists purely to give moderators a self-contained on-duty toolkit.

How Staff Mode Works

/staffmode flips you between "playing" and "on duty":

Entering staff mode:
  1. Your real inventory is saved to the database
  2. It is replaced by the gadget hotbar
  3. Vanish / flight / night vision apply (per config)

Leaving staff mode:
  1. The gadget hotbar is cleared
  2. Your saved inventory is restored, untouched

Because your survival items are stored server-side while you're on duty, they survive relogs and restarts and can't be lost by fumbling the gadget bar.

Loadouts are DB-backed

The inventory saved when you enter staff mode is persisted in the database, so it is safe across restarts and world rollbacks — you always get your real items back.

The Gadget Hotbar

Entering staff mode gives you a hotbar of interaction gadgets. Each can be turned off in config, so you ship only the tools your team should carry.

Gadget What it does
Vanish Toggle your invisibility on and off
Examine Inspect a player's inventory / ender chest
Freeze Pin a player in place for questioning
Compass Teleport / navigate to players
Follow Shadow a target player's movement

Gadget set is config-driven

The gadgets above are the ones exposed by the module's gadgets { } block (vanish, examine, freeze, compass, follow). Set any to false to drop it from the hotbar.

Commands

Command What it does Permission
/staffmode [player] Enter / leave staff mode (loadout swap + gadgets + vanish) uxmessentials.staff.mode
/staffchat <message> Send to the staff-only chat channel (alias sc) uxmessentials.staff.chat
/stafflist Open the online-staff GUI (vanish-aware; click a head to teleport) uxmessentials.staff.list

Staff chat is a private channel for the team. Who receives it is set by the staff-chat.receive-node config key, so you can point it at your existing staff permission group. /stafflist shows who's on duty — it is vanish-aware (so hidden staff still appear to other staff) and each head is clickable to teleport straight to that person.

Alerts & Flight

  • Flight — flight-on-enter grants creative flight the moment you go on duty, so you can move freely while moderating.
  • Alerts — the module surfaces staff-relevant notifications to on-duty moderators, keeping the team aware of events worth a look.

How This Differs From /vanish

The presence module ships a plain /vanish (uxmessentials.vanish.use) — a standalone invisibility toggle and nothing more. Staff mode is a whole mode on top of that:

/vanish (presence) /staffmode (staff)
Invisibility Yes Yes (on enter)
Swaps your inventory No Yes — gadget loadout
Restores inventory on exit n/a Yes
Gadget hotbar No Yes
Flight / night vision on enter No Optional (config)
Intended for Quick hide Full on-duty moderation

Use /vanish to slip out of sight for a moment; use /staffmode to actually go on duty. (Note /stafflist here is the staff-mode roster GUI; the presence module's separate /staff command simply lists online staff to anyone allowed to see it.)

Permissions

Node Default Grants
uxmessentials.staff.mode op Enter / leave staff mode
uxmessentials.staff.chat op Send in staff chat
uxmessentials.staff.list op Open the staff-list GUI
uxmessentials.module.staff op Reload / inspect the module

Key Settings

# modules/staff/config.conf
enabled = true
vanish-on-enter = true
flight-on-enter = true
night-vision-on-enter = true

gadgets {
  vanish  = true
  examine = true
  freeze  = true
  compass = true
  follow  = true
}

staff-chat { receive-node = "..." }   # permission that receives staff chat

Tips & Gotchas

Staff mode ≠ vanish alone

Leaving staff mode restores your saved inventory. Don't rely on /vanish (which doesn't touch your inventory) when you mean to go fully on duty, and don't stack the two carelessly — enter staff mode to moderate, exit it to play.

  • The gadget hotbar replaces whatever you were holding; that's why the real inventory is saved first. Always exit staff mode (don't just log out mid-session) to be sure your items come back cleanly.
  • Point staff-chat.receive-node at your existing staff group so new moderators get the channel automatically when they're added to the group.
  • Turn off gadgets your team shouldn't have (e.g. leave follow off if you don't want silent shadowing) — the hotbar only shows enabled gadgets.

Next Steps