Installation

Cette page couvre ce dont Verité a besoin pour fonctionner, les plugins facultatifs avec lesquels il peut cohabiter, et ce qui se passe lors de son premier démarrage. Pour les étapes de téléchargement et un bref aperçu, voir la page d’accueil. Le contenu ici approfondit les exigences, les dépendances et le comportement au premier démarrage.

Exigences

Verité vise les serveurs Minecraft modernes et leurs forks courants.

Verité ne livre pas une build distincte par plateforme au-delà de la version appropriée à votre serveur. Installez le bon fichier pour votre version Minecraft et votre logiciel serveur, placez-le dans le répertoire plugins/, puis redémarrez.

Sur toute version de Minecraft hors de la plage prise en charge, Verité se désactive au démarrage et consigne la version en cours avec la plage prise en charge. Verité 1.2.8 est la dernière version pour Minecraft 1.19 à 1.21.5.

Bibliothèque d’exécution

Verité stocke ses données dans une base de données H2 embarquée. H2 est déclarée comme bibliothèque de plugin dans plugin.yml :

libraries:
  - com.h2database:h2:2.4.240

Votre serveur résout et télécharge automatiquement cette bibliothèque au chargement, dans un chargeur de classes de bibliothèque isolé. Aucun téléchargement manuel n’est requis. Si la bibliothèque ne peut pas être résolue, Verité se désactive plutôt que de fonctionner sans stockage, alors surveillez la console au premier démarrage.

La base de données fonctionne en mode fichier embarqué, sans socket réseau. Elle est décrite plus en détail sur la page Confidentialité et données.

Dépendances facultatives

Verité déclare quatre dépendances facultatives :

softdepend: [floodgate, PlaceholderAPI, LuckPerms, Skript]

Une dépendance facultative n’est jamais requise. Lorsque l’un de ces plugins est présent, le serveur le charge avant Verité afin que la fonctionnalité correspondante puisse s’activer. En son absence, Verité fonctionne normalement et la fonctionnalité n’existe simplement pas.

Premier démarrage

La première fois que Verité se charge, il prépare son propre dossier de données dans plugins/Verite/. Lors de ce premier démarrage, il va :

• Créer le dossier de données du plugin.
• Ouvrir la base de données H2 embarquée (verite.mv.db) dans ce dossier, en la créant si elle est absente.
• Écrire le config.yml par défaut.
• Déployer les ressources du filtre de chat dans un sous-dossier filter/.
• Enregistrer les commandes, les écouteurs et les intégrations pour toutes les dépendances facultatives installées.

Surveillez la console pendant ce premier démarrage. Confirmez que Verité se charge et qu’aucun avertissement ou erreur pointant vers un problème de configuration ou de compatibilité n’apparaît.

Sortie console

Verité colore ses messages de console afin que les échecs se distinguent des lignes de démarrage ordinaires. Les erreurs apparaissent en rouge, les réussites en vert et les décomptes dans la couleur de marque de Verité. Chaque message est préfixé par [Verité].

La couleur n'est ajoutée que si la console peut l'afficher. Verité vérifie, dans cet ordre :

Lorsque la couleur est désactivée, les messages sont écrits en texte brut, sans laisser de codes d'échappement, afin que les fichiers journaux restent lisibles.

Deux propriétés système remplacent la détection si vous devez forcer un résultat :

-Dverite.console.colour=false
-Dverite.console.truecolour=false

La première désactive (ou active) entièrement la couleur. La seconde conserve la couleur mais passe du 24 bits à la palette de base de 16 couleurs, ce qui vaut la peine d'être essayé si votre console affiche des caractères parasites au lieu de couleurs.

Modules

Verité est constitué de trois modules, chacun activé indépendamment dans config.yml. Les trois sont activés par défaut. Désactivez un module en réglant son flag enabled sur false ; le reste du plugin continue de fonctionner.

chat.filter:
  enabled: true

moderation:
  enabled: true

vanish:
  enabled: true

Mise à jour automatique de la configuration

Lorsque Verité se met à jour, il peut ajouter de nouvelles clés à votre config.yml existant afin que vous ne perdiez pas vos réglages. Ceci est contrôlé dans la section general :

general:
  auto.update.config: true

Avec ceci activé, les nouvelles clés de configuration ajoutées dans une version ultérieure sont fusionnées automatiquement dans votre fichier. Cela n’outrepasse pas les mises à jour du tokenizer, qui sont gérées séparément.

Les fichiers de ressources du filtre de chat (les fichiers .eve) ont leur propre interrupteur, désactivé par défaut :

chat.filter:
  auto.update.eve: false