Staff Workflow

Last updated Oct 4, 2026

Staff Workflow

How staff use SoapsAdmin during a normal shift: go on duty, inspect a player, work reports and tickets, then leave duty cleanly.

Go on duty

  1. /sa staffmode (soapsadmin.staffmode). Swaps to the duty inventory and staff tools from staff.yml.
  2. Optional on enable: vanish, flight, locked inventory, forced gamemode (see staff.yml → staffmode).
  3. Hotbar tools (defaults): player actions, punish history, freeze, spectate, jail, vanish toggle, teleport to, dashboard, server health.
  4. Tool clicks still need the matching /sa permission (for example freeze needs freeze permission). Staff mode alone is not a free pass.

Config: staff.yml. Module: staff-mode. Reload: /sa reload staff.

Inspect a player

  1. /sa playerinfo <player> or shift + right-click when player.yml → playerinfo.right-click is true.
  2. From the panel: invsee, endersee, spectate, freeze, notes, alts, punish history.
  3. Punishment history: left-click opens the case, right-click rolls back when you have permission.

See Mail and Player Info.

Reports and tickets

Reports (player reports another player):

  1. Player: /sa report <player> <reason>.
  2. Staff: /sa reports → claim → resolve. Reassignment messaging shows when you take another staff member's claim.

Tickets (support queue):

  1. Player or staff: create from /sa ticket / the tickets GUI.
  2. Staff: reply, assign (soapsadmin.ticket.assign), reopen, close. Shift-click delete or /sa ticket delete when allowed.
  3. Closed tickets show a clear CLOSED state. Offline creators can receive mail when staff respond or close.

Details: Moderation.

Admin cockpit

/sa admin (soapsadmin.admin) shows live server pulse:

  • TPS and maintenance state
  • Staff online
  • Open reports and tickets (with counts on buttons where configured)
  • Warn-escalation flag

Use it as the landing pad before opening queues, MOTD, announcements, or other admin panels.

Leave duty

  1. /sa staffmode again to restore the survival inventory.
  2. Spectate ends if the target quits (you are restored and notified). Do not leave yourself in SPECTATOR after a disconnect.
  3. /sa staffrollcall lists who is AFK, vanished, or in staff mode.