Commands

Staff tools

modules/staff.yml

The file holds no settings of its own: everything staff-related is a per-command rule or a permission.

Command Permission
/tp <target> or /tp <who> <target> chorus.staff.tp
/tphere <player> chorus.staff.tphere
/tppos <x> <y> <z> [world] [player] chorus.staff.tppos
/tpall chorus.staff.tpall
/vanish chorus.staff.vanish
/gamemode <mode> [player] chorus.staff.gamemode
/gmc /gms /gma /gmsp chorus.staff.gamemode plus the mode
/freeze <player> chorus.staff.freeze
/sudo <player> <command> chorus.staff.sudo
/lockdown <on|off> [reason] chorus.staff.lockdown
/tempfly <player> <minutes> chorus.staff.tempfly
/note <add|list|clear> <player> [text] chorus.staff.note
/stafflog [player] chorus.staff.log

Game modes#

Each mode also needs its own permission, so a rank can have creative without spectator:

chorus.staff.gamemode.creative
chorus.staff.gamemode.survival
chorus.staff.gamemode.adventure
chorus.staff.gamemode.spectator

Changing somebody else needs chorus.staff.gamemode.others.

/gmc, /gms, /gma and /gmsp already know what they do, so their first argument is a player name rather than a mode.

Vanish#

/vanish hides you from other players. chorus.staff.vanish.see keeps a player able to see anyone vanished.

Vanish is reapplied when either side reconnects, so a staff member who relogs does not suddenly appear, and a player who joins does not see somebody who was already hidden.

Freeze#

Frozen players cannot move, teleport or run commands. /msg and /reply stay open so they can answer whoever froze them.

The freeze survives a reconnect, because logging out is the first thing anybody tries.

chorus.staff.freeze.exempt protects the holder. Every freeze and unfreeze goes in the staff log.

Lockdown#

/lockdown on Maintenance, back in an hour
/lockdown off

Closes the door to everyone without chorus.staff.lockdown.bypass.

Nobody already on the server is thrown out, and it is not remembered across a restart: coming back up already closed, with nobody having said so, is how a server stays empty all evening by accident.

Sudo#

Runs a command as somebody else, with their permissions rather than yours. A command they could not have typed themselves is refused.

chorus.staff.sudo.exempt protects the holder. Every use goes in the staff log.

Temporary flight#

/tempfly Notch 30

Flight that runs out. It survives a reconnect and is taken away when the time is up, wherever the player is. Every use goes in the staff log.

Notes#

/note add Notch Warned about the spawn area
/note list Notch
/note clear Notch

A line about a player for whoever deals with them next. Works on somebody who has logged off. Clearing needs chorus.staff.note.clear.

The staff log#

# config.yml
staff-log:
  enabled: true
  keep-days: 60
  page-size: 10

Reads back what staff have been doing: freezes and unfreezes, /sudo, /lockdown, /tempfly, notes and every /eco.

/stafflog             everything, newest first
/stafflog Notch       only what was done to or by one player

keep-days: 0 keeps entries for ever. page-size maximum is 50.

The staff log is not touched by /chorus purge. It is a record of what staff did, not data belonging to the player it was done to.

Also useful to staff#

These live in other modules but are worth knowing about here:

Command Where Permission
/invsee /ecsee utility chorus.utility.invsee, .ecsee
/restore items chorus.items.restore.view
/clearinventory <player> items chorus.items.clearinventory.others
/whois /seen players chorus.players.whois, .seen
/socialspy chat chorus.chat.spy
/sweep world chorus.world.sweep
/chorus debug core chorus.admin

Permissions#

Permission Effect
chorus.staff.tp /tp
chorus.staff.tphere /tphere
chorus.staff.tppos /tppos
chorus.staff.tpall /tpall
chorus.staff.vanish /vanish
chorus.staff.vanish.see Keeps seeing players who are vanished
chorus.staff.gamemode The game mode commands
chorus.staff.gamemode.others On another player
chorus.staff.gamemode.survival .creative .adventure .spectator One mode each
chorus.staff.freeze /freeze
chorus.staff.freeze.exempt Cannot be frozen
chorus.staff.sudo /sudo
chorus.staff.sudo.exempt Cannot be sudoed
chorus.staff.lockdown /lockdown
chorus.staff.lockdown.bypass Logs in during a lockdown
chorus.staff.tempfly /tempfly
chorus.staff.note /note add and /note list
chorus.staff.note.clear /note clear
chorus.staff.log /stafflog