Invisibilité du personnel (Veritévoiler)

Veritévoiler est l’invisibilité du personnel de Verité. Elle permet à un membre du personnel de devenir invisible aux joueurs ordinaires afin qu’il puisse observer une situation en toute discrétion, puis réapparaître lorsqu’il a terminé. L’invisibilité est plus que cacher un corps : elle fait aussi taire les petits indices qui révéleraient autrement un membre du personnel caché, tels que les pas, les particules, le chat, la présence dans la liste des serveurs, et les messages d’arrivée ou de départ.

Le composant est activé par défaut. Un membre du personnel l’active avec la commande vanish. Pour la commande elle-même et qui peut l’exécuter, voir la Référence des commandes. Pour chaque nœud de permission nommé sur cette page, voir la Référence des permissions. Pour les clés de configuration exactes et leurs valeurs par défaut, voir la section vanish décrite sous Interrupteurs de fonctionnalités.

Activer et désactiver l’invisibilité

Un membre du personnel exécute la commande vanish pour se cacher, et l’exécute de nouveau pour réapparaître. Une personne disposant de la bonne permission peut aussi cacher ou révéler un autre joueur en le nommant. L’état d’invisibilité est mémorisé : un membre du personnel caché qui se déconnecte, ou lorsque le serveur redémarre, revient toujours caché.

Tant qu’il est caché, un membre du personnel est retiré de la vue de chaque joueur qui n’est pas autorisé à le voir. Les joueurs qui sont autorisés à voir le personnel caché continuent de voir le membre du personnel normalement.

Niveaux d’invisibilité

L’invisibilité est à paliers, de sorte que le personnel senior peut se cacher même du personnel junior. Chaque membre du personnel a un palier d’invisibilité, tiré de la permission verite.vanish.level.<n> la plus élevée qu’il détient (par exemple verite.vanish.level.3). Un observateur ne peut voir un membre du personnel caché que lorsqu’il détient la permission verite.vanish.see et que son propre palier est au moins aussi élevé que celui du membre du personnel caché.

Cela signifie qu’un membre du personnel d’un palier supérieur reste invisible pour un membre d’un palier inférieur, tandis que des paliers égaux ou supérieurs peuvent se voir mutuellement. Lorsqu’aucune permission de palier n’est présente, tout le monde partage le palier zéro, de sorte que la permission see seule décide qui peut voir qui.

Ce dont un membre du personnel invisible est caché

Tant qu’un membre du personnel est caché, Verité dissimule les traces qui le révéleraient autrement. Chacune d’elles peut être activée ou désactivée individuellement.

Les joueurs et le personnel qui sont autorisés à voir le membre du personnel caché, ainsi que le membre du personnel caché lui-même, continuent d’entendre, de voir et de recevoir tout normalement.

Le faux message de départ

C’est le cœur anti-évitement de l’invisibilité. Lorsqu’un membre du personnel se cache, le serveur peut diffuser un message de départ d’apparence normale afin que tout le monde croie que ce membre du personnel s’est déconnecté, alors qu’en réalité il reste en ligne et observe. Un contrevenant qui ne se tenait bien que parce que le personnel était présent peut alors déraper devant quelqu’un qu’il ne peut pas voir. Lorsque le membre du personnel caché redevient visible, il réapparaît simplement sans message.

Ceci est contrôlé par l’interrupteur fake.message. Lorsqu’il est désactivé, aucun faux message de départ n’est affiché.

Avantages d’observateur (effets)

Au moment où un membre du personnel se cache, il reçoit un ensemble d’avantages de confort qui facilitent l’observation sans le trahir. Les avantages qui s’appliquent dépendent à la fois de l’interrupteur de configuration correspondant et des permissions du membre du personnel.

La vision nocturne est un véritable effet de potion, car le client lui-même éclaire la vue, de sorte que sa petite icône de statut est le seul marqueur à l’écran inévitable. Elle est appliquée sans particules ni scintillements. Quelle que soit la vision nocturne que le membre du personnel possédait déjà, elle est mémorisée dans un stockage durable avant que l’effet d’invisibilité ne soit appliqué, de sorte qu’elle survit à un redémarrage. Lorsque le membre du personnel redevient visible, son corps redevient solide, la vision nocturne d’invisibilité est retirée, et son effet d’origine est restauré exactement tel qu’il était, ou laissé désactivé s’il n’en avait aucun.

La résistance au feu et la respiration aquatique ne sont délibérément pas accordées comme effets, puisqu’un membre du personnel caché ne subit déjà aucun dégât de feu, de lave ou de noyade et garde une barre d’air pleine, de sorte que ces effets ne seraient qu’un encombrement pur à l’écran. Lorsque le membre du personnel réapparaît, le vol n’est conservé que s’il détient verite.vanish.fly.keep, ou s’il est en mode créatif ou spectateur.

Outils d’observateur

Au-delà des avantages ci-dessus, un membre du personnel caché dispose de plusieurs outils pour inspecter une situation. Chacun a son propre interrupteur de configuration.

• Bascule spectateur par double accroupissement (gamemode) : tant qu’il est caché, appuyer deux fois rapidement sur accroupissement fait passer le membre du personnel en mode spectateur pour flotter à travers les murs et observer, et un nouveau double accroupissement le ramène à son mode précédent. Les deux pressions doivent survenir dans une courte fenêtre.
• Ouverture silencieuse de conteneur (silent.container) : faire un clic droit sur un coffre, un tonneau, un shulker ou un autre conteneur l’ouvre sans animation de couvercle, sans son ni décompte d’ouverture qui prévendrait les joueurs proches. Faire un clic droit sur un coffre de l’Ender ouvre le propre coffre de l’Ender du membre du personnel.
• Inspection de l’inventaire d’un joueur (inventory.inspect) : s’accroupir et faire un clic droit sur un autre joueur ouvre une vue en direct de ce qu’il transporte. Le joueur inspecté ne voit jamais l’interaction.
• Vue fantôme (ghost) : pour un observateur autorisé à voir un pair caché, le membre du personnel caché est montré comme une figure translucide de style spectateur plutôt que d’être entièrement invisible. C’est un simple recouvrement visuel par observateur ; il ne change jamais le véritable mode de jeu du membre du personnel. Sur une version de serveur que cela ne peut pas résoudre, l’observateur voit simplement le membre du personnel entièrement caché à la place.

Rappel dans la barre d’action

Tant qu’il est caché, un petit message persistant indiquant que le membre du personnel est invisible est affiché juste au-dessus de sa barre d’accès rapide et maintenu à jour. Cela prévient l’erreur courante d’un membre du personnel qui oublie qu’il est invisible et agit comme si les autres joueurs pouvaient le voir. Seuls les joueurs cachés voient ce rappel. Il est contrôlé par l’interrupteur actionbar.

Interrupteurs de fonctionnalités

Chaque partie de l’invisibilité ci-dessus peut être activée ou désactivée individuellement sans désactiver le composant entier. Les interrupteurs résident sous vanish.features dans config.yml, et chacun est activé par défaut. Réglez vanish.enabled sur false pour désactiver entièrement le composant.

vanish:
  enabled: true
  features:
    fake.message: true
    actionbar: true
    self.view: true
    fly: true
    invulnerability: true
    effects: true
    gamemode: true
    ride.entity: true
    silent.container: true
    inventory.inspect: true
    server.ping: true
    ghost: true
    prevent.chat: true
    prevent.pickup: true
    prevent.drop: true
    prevent.interact: true
    prevent.block.break: true
    prevent.block.place: true
    prevent.target: true
    prevent.damage: true
    prevent.food: true
    prevent.buckets: true
    prevent.advancement: true
    prevent.projectiles: true
    muffle.sounds: true
    muffle.particles: true

Placeholders PlaceholderAPI

Lorsque PlaceholderAPI est installé, l’état d’invisibilité peut être lu depuis les listes d’onglets, les tableaux de score et les configurations de chat sans code, sous l’identifiant verite.

Lorsque PlaceholderAPI n’est pas installé, ces placeholders n’existent tout simplement pas et rien d’autre n’est affecté.

Intégration à la tab de TAB

Dans la tab vanilla, un membre du staff caché est déjà retiré de la liste pour quiconque ne peut pas le voir, car Verité le cache via la gestion de visibilité standard. Le populaire plugin TAB reconstruit toutefois la tab lui-même et rajouterait sinon le membre du staff caché. Lorsque TAB est installé, Verité s’enregistre auprès de la propre intégration d’invisibilité de TAB, de sorte que TAB sait quels joueurs sont cachés et quels observateurs peuvent les voir, et TAB tient sa tab à jour avec l’invisibilité. Aucune configuration n’est nécessaire ; l’intégration est enregistrée automatiquement lorsque TAB est présent et ne fait rien lorsqu’il est absent. Les anciennes versions de TAB qui n’exposent pas cette intégration sont ignorées, auquel cas TAB peut afficher le staff invisible sur sa tab jusqu’à sa mise à jour.

Pour les développeurs

L’invisibilité expose deux moyens pour un autre plugin de réagir aux changements d’état d’invisibilité :

• Un événement annulable déclenché avant qu’un changement d’état d’invisibilité d’un joueur ne survienne, de sorte qu’un plugin peut opposer un veto à une invisibilité ou à un retour à la visibilité (par exemple, refuser l’invisibilité dans un monde spécifique).
• Un rappel léger qui se déclenche immédiatement après un changement d’état d’invisibilité, pour les plugins qui ont seulement besoin d’être avertis lorsqu’il se produit.

Pour la surface publique destinée aux développeurs, voir l’API développeur.