Skip to content

Staff Mode

This content is for 2.0.0 (Beta). Switch to the latest version for up-to-date documentation.

Staff Mode isolates staff members from ordinary gameplay, preventing accidental or deliberate item drops, damage, or world tampering, while granting rapid moderation tools.

Toggle Staff Mode using:

Terminal window
/staff

When a staff member enters Staff Mode, NookureStaff enforces strict gameplay boundaries:

  1. Inventory Preservation:
    • The player’s survival inventory, armor, and offhand items are safely saved into memory and cleared.
    • Configured staff items from items.yml are loaded into the player’s hotbar.
    • When exiting Staff Mode, the original inventory is restored down to the exact NBT data and slot locations.
  2. Item & Inventory Lock:
    • Dropping items (PlayerDropItemEvent) is cancelled.
    • Picking up items (EntityPickupItemEvent) is cancelled.
    • Swapping offhand items and moving items in inventories are cancelled.
  3. Damage & Entity Protection:
    • Staff members cannot take damage from any source (PvP, fall, environmental).
    • Staff members cannot attack entities or players.
    • Hostile monsters ignore staff members and will not target them (EntityTargetLivingEntityEvent).
  4. Environment & Spawners:
    • Monster spawners do not activate in the proximity of vanished staff members (Paper 1.21+).
    • Advancement criterion grants are blocked.
    • Food level changes (hunger loss) are cancelled.

Staff members can inspect chests, barrels, shulker boxes, and ender chests without triggering open/close animations or chest creaking sounds.

  • Configurable in config.yml: staffMode.silentChestOpen: true.

When exiting Staff Mode, staff members can automatically be teleported back to the exact location they were at prior to enabling staff mode.

  • Configurable in config.yml: staffMode.teleportToPreviousLocation: true.
  • Staff mode automatically applies Night Vision so staff can inspect dark caves or unlit builds.
  • Additional potion effects (e.g., Speed, Jump Boost) can be specified under staffMode.customPotionEffects.

Staff members receive real-time telemetry on their action bar showing:

  • Vanish status ({vanished})
  • Current chat destination channel ({staffChat})
  • Real-time server TPS ({tps})
  • Toggle permission: nookure.staff.actionbar

To prevent abuse or accidental command executions (e.g. running economy or gameplay commands while in staff mode), commands can be restricted in staff-mode-blocked-commands.yml:

staff-mode-blocked-commands.yml
blockedCommands:
- "pay"
- "trade"
- "ah"
- "auction"
- "tpa"
- "tpahere"
message: "<red>You cannot execute this command while in Staff Mode!</red>"

Staff administrators can bypass blocked commands by holding the permission:

nookure.staff.mode.commands.bypass