Documentation
TunnelVision est un outil de modération : il affiche des scores de suspicion, des pseudos et des coordonnées. Cette page explique qui peut s'en servir, comment accorder l'accès à votre équipe (modérateurs, administrateurs, staff) avec votre plugin de permissions, et ce que cet accès ouvre exactement.
Une seule permission contrôle toute la commande /tunnelvision : tunnelvision.admin. Les opérateurs (op) et la console l'ont d'office. Pour vos modérateurs, ajoutez ce nœud à leur groupe dans votre plugin de permissions, quel qu'il soit : TunnelVision utilise le système de permissions standard de Bukkit.
tunnelvision.adminLe plugin déclare une seule permission, qui donne accès à toutes les sous-commandes de /tunnelvision (score, suspects, rapports 3D, menu, rattrapage, logs). Il n'y a pas encore de permission plus fine par sous-commande.
| Qui | Accès par défaut |
|---|---|
| Console du serveur | Oui toujours |
Opérateurs (/op) | Oui sauf si vous la leur retirez explicitement (voir plus bas) |
| Tous les autres joueurs | Non la commande n'apparaît même pas dans leur liste de commandes ni dans l'auto-complétion |
Un joueur sans la permission qui tape la commande obtient « Unknown or incomplete command » : c'est voulu, un outil de modération n'a pas à être visible des joueurs.
TunnelVision s'appuie sur le système de permissions standard de Bukkit : n'importe quel plugin de permissions compatible Paper ou Spigot fonctionne. Le seul élément propre à TunnelVision est le nœud tunnelvision.admin ; les commandes exactes sont celles de votre plugin (cherchez celle qui « ajoute une permission à un groupe »).
tunnelvision.admin, avec la valeur « vrai », au groupe ou rang de vos modérateurs. Si vos administrateurs héritent de ce groupe, ils l'obtiennent automatiquement ; sinon, ajoutez-la aussi à leur groupe./tunnelvision dans l'auto-complétion et /tunnelvision status doit lui répondre. La plupart des plugins de permissions ont aussi une commande pour tester un nœud sur un joueur.Pas besoin de redémarrer le serveur : les plugins de permissions appliquent le changement immédiatement. Si la commande n'apparaît pas encore dans l'auto-complétion du joueur, une simple reconnexion suffit.
Seuls les opérateurs et la console ont accès. Vous pouvez donner l'accès avec /op <pseudo>, mais c'est déconseillé pour un modérateur : le statut d'opérateur ouvre toutes les commandes du serveur (mode créatif, /give, /stop…), pas seulement TunnelVision. Un plugin de permissions permet de n'accorder que ce qui est nécessaire.
La permission ouvre tout : réservez-la aux personnes qui prennent réellement des décisions de modération. Notre recommandation :
| Rôle | Accès | Pourquoi |
|---|---|---|
| Fondateur, administrateur | Oui | Gère aussi les opérations de maintenance (rattrapage, logs). |
| Modérateur | Oui | Enquête sur les suspicions de x-ray : score, suspects, rapport 3D. |
| Helper, guide, assistant, staff à l'essai | Non | Les rapports affichent des pseudos et coordonnées réels. Préférez un accès temporaire si besoin. |
| Builder, animateur, développeur | Non | Aucun besoin de modération. |
| Joueurs | Non | Un joueur qui voit les suspects saurait qui est surveillé. |
Le score de TunnelVision est une aide au tri, jamais une preuve. Quel que soit le rôle, une sanction doit suivre une vérification humaine : voir pourquoi le score ne doit pas bannir.
Toutes ces commandes sont couvertes par tunnelvision.admin. La dernière colonne signale celles qui méritent de la prudence.
| Commande | Rôle | Point d'attention |
|---|---|---|
/tunnelvision status | État du plugin et des synchros, erreurs récentes. | Aucun. |
/tunnelvision score <joueur> [fenêtre] | Score de suspicion d'un joueur sur une période. | Aucun. |
/tunnelvision suspects [fenêtre] | Sessions les plus suspectes, triées. | Révèle qui est suspecté. |
/tunnelvision render <début> <fin> | Rapport 3D HTML de la période. | Pseudos et coordonnées réels par défaut (report.identify-by-default) ; --anonymize pour une version anonymisée. |
/tunnelvision render … --host | Publie le rapport sur un lien partageable. | Toute personne qui a le lien peut le consulter, jusqu'à son expiration ou sa révocation. |
/tunnelvision menu | Interface graphique en jeu. | Mêmes rapports que render. |
/tunnelvision backfill [--restart] | Rapatrie l'historique manquant vers le service. | Opération longue ; --restart repart du début. |
/tunnelvision verbose <canal> on|off | Active les logs console d'un sous-système. | Modifie config.yml. |
Le détail de chaque réglage cité est dans la page configuration.
Supprimez le nœud tunnelvision.admin du groupe ou du joueur auquel vous l'aviez ajouté.
Cas particulier des opérateurs : supprimer le nœud ne suffit pas, un op retrouve l'accès par défaut. Pour le lui retirer, il faut interdire explicitement la permission : valeur « faux », ou nœud préfixé d'un tiret (-tunnelvision.admin) selon votre plugin.
| Symptôme | Cause probable et solution |
|---|---|
| « Unknown or incomplete command » | Le joueur n'a pas la permission. Vérifiez son groupe et les permissions de ce groupe dans votre plugin de permissions. |
| « Permission manquante : tunnelvision.admin » | Même cause. Sur un réseau, vérifiez aussi que la permission s'applique bien à ce serveur. |
| La permission est accordée mais refusée quand même | Une interdiction (valeur « faux » ou -tunnelvision.admin) héritée d'un autre groupe l'emporte. Cherchez-la dans les groupes parents du joueur. |
| La commande n'apparaît pas dans l'auto-complétion | Le joueur doit se reconnecter après l'ajout de la permission. |
Non. N'importe quel plugin de permissions compatible Paper ou Spigot convient : TunnelVision utilise le système de permissions standard de Bukkit. Sans plugin de permissions, seuls les opérateurs et la console y ont accès.
Non. Les plugins de permissions appliquent le changement immédiatement ; au pire, le joueur se reconnecte pour voir la commande dans l'auto-complétion.
score sans donner l'accès à render ?Pas encore : une seule permission couvre toutes les sous-commandes. Si vous avez besoin de ce découpage, dites-le-nous sur Discord.
* a-t-il accès ?Oui, avec les plugins de permissions qui gèrent les jokers (* ou tunnelvision.*) : ils incluent tunnelvision.admin.
Une question sur les droits de votre équipe : Discord · contact@tunnelvision.fr.