Mode staff

Le module staffmode donne au staff un mode de travail dédié : inventaire mis de côté, outils dans la hotbar, invisibilité et protections. Fichiers : config/staffmode.yml, staffmode/modes.yml, staffmode/modules.yml, staffmode/custom-modules.yml.

Entrer en mode staff

/staff [-mode=<nom>]      alias /modestaff, /staffmode
/sfly                     activer ou couper le vol en mode staff

À l’entrée, l’inventaire, la position, la vie, la faim, l’expérience, les effets et le mode de jeu du staff sont sauvegardés de façon persistante (même en cas de crash ou d’arrêt du serveur).
Le mode de plus haut poids dont le staff a la permission est appliqué : items de la hotbar, vanish, vol, invincibilité, vision nocturne…
À la sortie, l’état sauvegardé est rendu et le staff revient à son point d’entrée (option original-location).

/staff -mode=<nom> force un mode précis ; il faut cobaltstaff.mode.specific et la permission du mode. Avec restore-on-shutdown: true, les staff sortent proprement du mode à l’arrêt du serveur ou au rechargement du plugin.

Modes et héritage

Les modes sont décrits dans staffmode/modes.yml. Le mode default est obligatoire ; les autres en héritent (extends) et ne redéfinissent que ce qui change.

Guide:
  extends: default
  permission: cobaltstaff.mode.guide
  weight: 10
  items:
    compass: 0
    random-teleport: 1
    examine: 4
    details: 5
    reports: 7
    counter: 8

Modo:
  extends: Guide
  permission: cobaltstaff.mode.modo
  weight: 20
  items:
    vanish: 2
    freeze: 3
    cps: 6
    follow: 9        # 9-35 = inventaire
    spectate: 10

Modes fournis : Guide, Modo, SuperModo, Responsable, Admin et Enquete (poids -1 : jamais choisi automatiquement, utilisé par les enquêtes).

Options d’un mode

Option	Effet
`block-manipulation`	Casser et poser des blocs
`inventory-interaction`	Déplacer les items de son inventaire (les items staff restent bloqués)
`silent-chest-interaction`	Modifier les coffres ouverts en silencieux (avec `cobaltstaff.mode.silent-chest-interaction`)
`item-drop`, `item-pickup`	Jeter, ramasser
`vanish-type`, `vanish-on-enter`	Type de vanish (`TOTAL`, `LIST`, `PLAYER`, `NONE`) et vanish à l’entrée
`staff-see-staff-in-mode`	Les staff en mode staff se voient entre eux, même en vanish
`invincible`, `damage`	Ne prend pas de dégâts, peut en infliger
`hunger-loss`	Perd de la faim
`flight`, `creative`, `night-vision`	Vol, créatif, vision nocturne
`original-location`	Retour au point d’entrée à la sortie
`enable-on-login`	Entre en mode staff à la connexion
`disable-on-logout`	Quitte le mode à la déconnexion (sinon il est restauré à la reconnexion)
`disable-on-world-change`	Quitte le mode en changeant de monde
`allowed-worlds`	Mondes autorisés (`[]` = tous)
`enable-commands`, `disable-commands`	Commandes lancées à l’entrée et à la sortie (`%player%`, `%mode%`)
`initial-item-states`	État des items à bascule à l’entrée (ex. `vanish: on`)
`items`	`<id>: <emplacement>` (0-8 = barre, 9-35 = inventaire, -1 = retirer un item hérité)

Items de la hotbar

Id	Action
`compass`	Propulse le staff dans la direction visée
`random-teleport`	Téléportation vers un joueur au hasard ou à tour de rôle (`random-teleport.mode` : `RANDOM` ou `ROTATION`)
`vanish`	Bascule le vanish (item allumé ou éteint)
`hub`	Ouvre le hub staff
`counter`	Liste du staff en ligne, clic = téléportation
`freeze`	Gèle ou dégèle le joueur visé
`cps`	Lance un test de CPS sur le joueur visé
`examine`	Ouvre l’inventaire du joueur visé
`follow`	S’attache au joueur visé
`details`	Ouvre la fiche du joueur visé
`spectate`	Observe le joueur visé
`reports`	Ouvre la gestion des reports ; affiche le nombre de reports en attente

Matériaux et permissions se règlent dans staffmode/modules.yml. Un item peut être un item Nexo.

Items personnalisés

staffmode/custom-modules.yml permet de créer vos propres outils :

Type	Action
`COMMAND_STATIC`	Commande lancée en tant que le staff (clic dans le vide)
`COMMAND_DYNAMIC`	Commande lancée en tant que le staff sur le joueur visé
`COMMAND_CONSOLE`	Commande lancée par la console, avec ou sans joueur visé
`ITEM`	Simple item, sans action

Exemple fourni, un ban rapide qui demande la raison au chat puis une confirmation :

ban-rapide:
  type: COMMAND_DYNAMIC
  material: blaze_rod
  enchanted: true
  permission: cobaltstaff.bans.tempban
  command: "tempban %clicked% 1d %input%"
  require-input: true
  input-prompt: staffmode.custom.ban-rapide.saisie
  confirmation: GUI        # CHAT, GUI ou NONE
  confirmation-message: staffmode.custom.ban-rapide.confirmation

Variables : %clicker% (le staff), %clicked% (le joueur visé), %input% (la saisie).

Vanish

/vanish [TOTAL|LIST|PLAYER] [joueur] [enable|disable]     alias /v, /invisible

Invisible en jeu et absent de la liste des joueurs (tab). Type par défaut.

Les staff ayant cobaltstaff.vanish.see voient les joueurs vanish.
Mettre un autre joueur en vanish demande cobaltstaff.vanish.others.<type>.
Options (vanish dans config/staffmode.yml) : garder le vanish à la reconnexion, faux messages de connexion et de déconnexion, rappel par bossbar ou barre d’action, coffres silencieux, mobs qui ignorent le joueur, invincibilité, vision nocturne, blocage des plaques de pression…
Les joueurs vanish sont masqués de la complétion des commandes (commands.hide-vanished-in-tab).

Spectate

/spec [joueur]       alias /spectate, /observer

Le staff passe en spectateur collé au joueur ; sans argument, il revient à sa position d’origine (spectate.return-to-location).

Freeze

/freeze <joueur> [-T<lieu>] [-S] [-H<n>]      alias /geler
/fc [id|joueur] <message>                     canal freeze

Un joueur gelé ne peut plus bouger. Options du freeze :

Argument	Effet
`-T<lieu>`	Téléporte d’abord le joueur vers un lieu prédéfini
`-S`	Retire son armure (rangée dans l’inventaire)
`-H<n>`	Règle sa vie à `n` %

Titre, sous-titre, son et rappel périodique ; fenêtre « prompt » optionnelle qui se rouvre tant que le joueur est gelé.
Canal freeze : une discussion s’ouvre automatiquement entre le joueur gelé et le staff (/fc), et se ferme au dégel.
Commandes autorisées pendant le freeze : freeze.allowed-commands (par défaut msg, r, tell, w).
Déconnexion : le freeze est conservé à la reconnexion, et des commandes peuvent être lancées (logout-commands), par exemple un ban automatique.
cobaltstaff.freeze.bypass protège un joueur du freeze.

Liste du staff et hub

/personnel     staff en ligne et son état      alias /stafflist, /listestaff
/staffhub      hub staff                        alias /hubstaff

/personnel liste le staff connecté (permission cobaltstaff.member) avec son mode et son vanish ; un staff vanish que vous ne voyez pas apparaît « absent » (vanish.show-away).

Le hub staff regroupe en un menu les accès vers les reports, enquêtes, bans, mutes, warns, appels, joueurs, mineurs, zones protégées, lieux staff, personnel et journal d’audit. Chaque bouton (emplacement, matériau, commande, permission) se configure dans hub.buttons.

Contextes LuckPerms

Si LuckPerms est présent, CobaltStaff fournit les contextes cobaltstaff:staffmode, cobaltstaff:vanished et cobaltstaff:frozen (true/false). Vous pouvez ainsi donner une permission uniquement en mode staff :

/lp group moderateur permission set minecraft.command.gamemode true cobaltstaff:staffmode=true