Tableau de bord

Le tableau de bord est une page web permettant de gérer votre serveur depuis l'extérieur du jeu. Il affiche les sanctions actives et les joueurs connectés, vous permet de rechercher n'importe quel joueur et d'agir sur lui, et expose toutes les clés de config.yml sous forme de formulaire modifiable.

Il est facultatif. Verité fonctionne exactement de la même façon, que vous l'ouvriez ou non.

Comment l'ouvrir

Exécutez /verite dashboard en jeu. Verité répond avec un lien privé et un raccourci cliquable.

[Verité] Your dashboard is ready. [Click here] to open it, or click the link below:
https://verite.gg/dashboard/<key>

Le lien est propre à cette session. Toute personne qui le possède peut voir les données chargées au départ, traitez-le donc comme un mot de passe et ne le collez pas dans le chat public.

Approuver une connexion

Ouvrir le lien ne suffit pas à contrôler quoi que ce soit. Lorsque la page se connecte, tous les joueurs disposant de verite.admin reçoivent un message dans le chat :

[Verité] A dashboard window has connected. If it was you, [click here] to trust the session.

Cliquez dessus, ou exécutez /verite dashboard trust <code> avec le code affiché sur la page. Tant que la session n'est pas approuvée, la page ne peut afficher que les données chargées au départ ; elle ne peut rien lire d'autre ni effectuer de modifications.

Une fois approuvé, le navigateur est mémorisé. Une nouvelle connexion depuis le même navigateur ignore l'étape d'approbation pendant 30 jours. La confiance est enregistrée par administrateur : approuver votre propre navigateur n'approuve celui de personne d'autre.

Délais d'expiration

Chaque partie d'une session expire de son côté.

Un lien expiré ne peut pas être réactivé. Exécutez /verite dashboard à nouveau pour en obtenir un neuf.

Ce que vous pouvez faire

Aperçu affiche le nombre de joueurs, les TPS, la mémoire, le temps de fonctionnement, combien de joueurs sont invisibles et qui est connecté. Cliquez sur un joueur connecté pour l'ouvrir.

Joueurs est l'endroit où se font les recherches. Saisissez un nom ou un UUID. Les noms qui ne sont jamais venus sur votre serveur sont résolus via Mojang, vous pouvez donc bannir quelqu'un avant sa première connexion. Sélectionner un joueur ouvre un panneau avec son historique de sanctions, ses noms et adresses connus, et les commandes ci-dessous.

Les sanctions émises depuis le tableau de bord sont enregistrées à votre propre nom, et non sur un compte générique, de sorte que /history et /staffhistory les attribuent correctement.

Sanctions répertorie tout ce qui est actif, avec un champ de recherche qui filtre par joueur, motif, membre du staff ou type.

Paramètres expose toutes les clés de config.yml.

Modifier la configuration

Chaque clé s'affiche selon son type : une liste déroulante pour vrai et faux, un champ numérique pour les nombres et un champ texte pour tout le reste. Modifier une valeur fait apparaître Enregistrer et Annuler.

L'enregistrement écrit directement dans config.yml la seule ligne que vous avez modifiée. Vos commentaires, lignes vides, indentation et guillemets sont conservés, et rien d'autre dans le fichier n'est touché. Une copie du fichier précédent est conservée sous le nom config.yml.bak.

Verité recharge ensuite sa propre configuration. Le serveur n'est pas redémarré et personne n'est déconnecté.

Certaines clés ne prennent effet qu'au redémarrage, exactement comme si vous aviez modifié le fichier à la main. Les principales sont celles qui activent les modules (chat.filter.enabled, moderation.enabled, vanish.enabled) et les deux options de mise à jour automatique.

Héberger vous-même

general.dashboard.url pointe vers le site qui sert le tableau de bord. N'y touchez pas, sauf si vous hébergez votre propre copie.

general:
  dashboard.url: "https://verite.gg"

Fonctionnement

Utile à savoir si vous hésitez à autoriser cela sur votre réseau.

Le plugin et le navigateur génèrent chacun leur propre paire de clés et signent chaque message qu'ils envoient. Les deux extrémités vérifient chaque message reçu, et tout ce qui échoue à la vérification de signature est ignoré et journalisé. Le relais intermédiaire transporte le trafic mais ne peut pas le falsifier.

Votre serveur envoie un instantané à l'ouverture de la session. Ensuite, la page demande ce dont elle a besoin et votre serveur pousse les changements au fil de l'eau, ce qui maintient la page à jour sans interrogation répétée.

Rien n'atteint votre serveur si la session n'a pas d'abord été approuvée en jeu. Chaque approbation, chaque message rejeté et chaque modification effectuée depuis le tableau de bord sont écrits dans la console avec le nom de l'administrateur responsable.

Le plugin ne détient aucun identifiant de base de données. Il communique avec l'API du site, qui les conserve côté serveur.