Staffmode

🛠️ Staff Mode Configuration

The Staff Mode system allows you to create multiple staff modes with different permissions, settings, and behaviors. To create a new mode, copy the configuration file, rename it, and adjust the options as needed.

name: staffmode
permission: easystaff.modes.staff
weight: 1
gamemode: survival
invulnerable: true
pvp: false
block-place: false
block-break: false
item-pickup: false
item-drop: false
silent-chest: true
inventory: false
enable-commands: []
disable-commands: []
vanished: true
chat: true
flight: true
items:
  compass: 1
  freeze: 2
  vanish: 3
  worldedit: 4

---

⚙️ Options

Below is a breakdown of all available configuration options for a staff mode:

• name The name of the staff mode (displayed to staff when toggled).

• permission The permission node required to toggle this mode.

• weight Determines priority if a player has access to multiple modes. The mode with the highest weight will be selected automatically.

• gamemode The gamemode to apply when this mode is enabled (survival, creative, adventure, etc.).

• invulnerable Whether the player can take damage while in staff mode (true or false).

• pvp Whether the player can engage in PvP combat.

• block-place Whether the player can place blocks.

• block-break Whether the player can break blocks.

• item-pickup Whether the player can pick up items.

• item-drop Whether the player can drop items.

• silent-chest If enabled, opening chests will suppress the animation and sound.

• inventory Whether the player can interact with their inventory.

• vanished If enabled, the player will be vanished when this mode is active.

• chat Determines if the player can send chat messages while in this mode.

• flight Whether the player can fly while in staff mode.

• items A list of items to be given to the player when they enter the mode. Each item is assigned to a specific inventory slot (slots start at 1).

---

🔁 Enable/Disable Commands

You can configure commands that are automatically executed when a player enables or disables staff mode:

Format

Each command entry can be either:

• A console command

• A player command

Examples

enable-commands:
  - "console: msg %player% You are now in staff mode."
  - "player: gmc"

disable-commands:
  - "console: msg %player% Staff mode disabled."
  - "player: gms"

Use %player% as a placeholder for the player’s name.