Staff
An on-duty mode that swaps a moderator's inventory for a gadget hotbar and hands it back on exit.
/staffmode flips a moderator between playing and being on duty. Entering saves their real inventory to the
database, replaces it with the gadget hotbar, and applies vanish, flight and night vision as configured; leaving
clears the gadgets and restores the saved inventory untouched. Because the saved items live server-side they
survive a relog, a restart and a world rollback.
Module staff · enabled by default · modules/staff/config.conf
Commands
| Command | What it does | Permission |
|---|---|---|
/staffchat (/sc) | Send a message on the staff channel. | uxmessentials.staff.chat |
/stafflist | List who is currently online and on staff. | uxmessentials.staff.list |
/staffmode | Toggle staff mode. | uxmessentials.staff.mode |
Permissions
| Node | Default | Grants |
|---|---|---|
uxmessentials.module.staff | op | Hot-reload / inspect the staff module (staff mode, its loadout and staff chat). |
uxmessentials.staff.chat | op | /staffchat (alias /sc) to send and receive lines on the staff-only chat channel. |
uxmessentials.staff.list | op | /stafflist to open the online-staff GUI (vanish-aware) and click a head to teleport to that staff member. |
uxmessentials.staff.mode | op | /staffmode [player] to flip into staff mode: your real loadout is saved and swapped for the gadget hotbar (and you vanish); leaving restores it. The EXAMINE gadget opens a player's inventory. |
Settings
| Key | Default | What it does |
|---|---|---|
vanish-on-enter | true | Whether entering staff mode also vanishes the staff member. Honoured when the presence module is enabled; with presence off this does nothing (no second vanish state is kept). |
flight-on-enter | true | Whether entering staff mode grants flight. The player's real pre-mode flight allowance is captured, so leaving reverts it exactly; a survival player loses the granted flight, a creative one keeps theirs. Staff need uxmessentials.playerstate.fly.allworlds to keep this flight in configured no-fly worlds. |
night-vision-on-enter | true | Whether entering staff mode grants night vision. It is cleared along with the rest of the in-mode effects when the player's real loadout is restored on exit. |
gadgets.vanish.enabled | true | VANISH: right-click to toggle your own vanish (presence module). |
gadgets.vanish.slot | 0 | VANISH: right-click to toggle your own vanish (presence module). |
gadgets.vanish.material | "SLIME_BALL" | VANISH: right-click to toggle your own vanish (presence module). |
gadgets.vanish.name | "<accent>ᴠᴀɴɪꜱʜ</accent>" | VANISH: right-click to toggle your own vanish (presence module). |
gadgets.examine.enabled | true | EXAMINE: right-click to pick an online player and open their inventory (playerstate module). |
gadgets.examine.slot | 1 | EXAMINE: right-click to pick an online player and open their inventory (playerstate module). |
gadgets.examine.material | "BOOK" | EXAMINE: right-click to pick an online player and open their inventory (playerstate module). |
gadgets.examine.name | "<accent>ᴇxᴀᴍɪɴᴇ</accent>" | EXAMINE: right-click to pick an online player and open their inventory (playerstate module). |
gadgets.freeze.enabled | true | FREEZE: right-click a player to freeze or unfreeze them (moderation module; honours the exempt node and is audit-logged). |
gadgets.freeze.slot | 2 | FREEZE: right-click a player to freeze or unfreeze them (moderation module; honours the exempt node and is audit-logged). |
gadgets.freeze.material | "PACKED_ICE" | FREEZE: right-click a player to freeze or unfreeze them (moderation module; honours the exempt node and is audit-logged). |
gadgets.freeze.name | "<accent>ꜰʀᴇᴇᴢᴇ</accent>" | FREEZE: right-click a player to freeze or unfreeze them (moderation module; honours the exempt node and is audit-logged). |
gadgets.compass.enabled | true | COMPASS: right-click to open a navigator and pick an online player to teleport to, or right-click a player directly to go straight to them (teleport module). |
gadgets.compass.slot | 3 | COMPASS: right-click to open a navigator and pick an online player to teleport to, or right-click a player directly to go straight to them (teleport module). |
gadgets.compass.material | "COMPASS" | COMPASS: right-click to open a navigator and pick an online player to teleport to, or right-click a player directly to go straight to them (teleport module). |
gadgets.compass.name | "<accent>ɴᴀᴠɪɢᴀᴛᴏʀ</accent>" | COMPASS: right-click to open a navigator and pick an online player to teleport to, or right-click a player directly to go straight to them (teleport module). |
gadgets.follow.enabled | true | FOLLOW: right-click a player to start (or stop) continuously following them; following ends automatically when either of you leaves or you exit staff mode (teleport module not required; it uses a direct teleport). |
gadgets.follow.slot | 4 | FOLLOW: right-click a player to start (or stop) continuously following them; following ends automatically when either of you leaves or you exit staff mode (teleport module not required; it uses a direct teleport). |
gadgets.follow.material | "LEAD" | FOLLOW: right-click a player to start (or stop) continuously following them; following ends automatically when either of you leaves or you exit staff mode (teleport module not required; it uses a direct teleport). |
gadgets.follow.name | "<accent>ꜰᴏʟʟᴏᴡ</accent>" | FOLLOW: right-click a player to start (or stop) continuously following them; following ends automatically when either of you leaves or you exit staff mode (teleport module not required; it uses a direct teleport). |
follow.interval-ticks | 10 | The FOLLOW gadget re-teleports a following staff member onto their target on this interval (in ticks; 20 ticks is one second). |
staff-chat.receive-node | "uxmessentials.staff.chat" | The permission node identifying the staff-chat audience: every online holder of this node receives staff chat. Defaults to the same node that gates sending, so anyone who can send also receives. |
Placeholders
| Placeholder | Renders |
|---|---|
%uxmessentials_staff_count% | The same connected-staff count, under the spelling a config may prefer. |
%uxmessentials_staff_mode% | Whether the player is in staff mode (yes/no). |
%uxmessentials_staff_online% | How many staff members are connected. |
Notes
- Staff mode is not
/vanish. Vanish is a standalone invisibility toggle that never touches an inventory; staff mode is a whole mode built on top of it. Enter staff mode to moderate, leave it to play, and do not stack the two carelessly. - Always leave staff mode rather than logging out in it, so the saved inventory comes back cleanly.
- The hotbar only shows the gadgets you enable. Leave
followoff if silent shadowing is not something your team should have. - Point
staff-chat.receive-nodeat the group you already use so a new moderator joins the channel by being added to that group rather than by a second grant. - Alerts are opt-in per staff member, so a moderator can go on duty without subscribing to every notice.
Related: Moderation, Vanish, Security
Was this page helpful?