Installation

Diese Seite behandelt, was Verité zum Laufen benötigt, die optionalen Plugins, mit denen es zusammenarbeiten kann, und was beim ersten Start geschieht. Für die Download-Schritte und einen kurzen Überblick siehe die Startseite. Das Material hier geht tiefer auf Anforderungen, Abhängigkeiten und das Verhalten beim ersten Start ein.

Anforderungen

Verité zielt auf moderne Minecraft-Server und ihre gängigen Forks ab.

Verité liefert keinen separaten Build pro Plattform über die für deinen Server passende Version hinaus. Installiere die richtige Datei für deine Minecraft-Version und Serversoftware, lege sie in das Verzeichnis plugins/ und starte neu.

Auf jeder Minecraft-Version außerhalb des unterstützten Bereichs deaktiviert sich Verité beim Start und protokolliert die laufende Version zusammen mit dem unterstützten Bereich. Verité 1.2.8 ist das letzte Release für Minecraft 1.19 bis 1.21.5.

Laufzeitbibliothek

Verité speichert seine Daten in einer eingebetteten H2-Datenbank. H2 ist in der plugin.yml als Plugin-Bibliothek deklariert:

libraries:
  - com.h2database:h2:2.4.240

Dein Server löst diese Bibliothek beim Laden automatisch auf und lädt sie in einen isolierten Bibliotheks-Class-Loader herunter. Es ist kein manueller Download erforderlich. Wenn die Bibliothek nicht aufgelöst werden kann, deaktiviert sich Verité selbst, anstatt ohne Speicher zu laufen, also beobachte die Konsole beim ersten Start.

Die Datenbank läuft im eingebetteten Dateimodus ohne Netzwerk-Socket. Sie wird auf der Seite Datenschutz und Daten weiter beschrieben.

Optionale Abhängigkeiten

Verité deklariert vier optionale Abhängigkeiten:

softdepend: [floodgate, PlaceholderAPI, LuckPerms, Skript]

Eine optionale Abhängigkeit ist niemals erforderlich. Wenn eines dieser Plugins vorhanden ist, lädt der Server es vor Verité, damit die passende Funktion aktiviert werden kann. Wenn es fehlt, läuft Verité normal und die Funktion existiert einfach nicht.

Erster Start

Beim ersten Laden bereitet Verité seinen eigenen Datenordner unter plugins/Verite/ vor. Während dieses ersten Starts wird es:

• Den Plugin-Datenordner erstellen.
• Die eingebettete H2-Datenbank (verite.mv.db) in diesem Ordner öffnen und sie erstellen, falls sie fehlt.
• Die Standard-config.yml schreiben.
• Die Chatfilter-Ressourcen in einen Unterordner filter/ bereitstellen.
• Befehle, Listener und Integrationen für alle installierten optionalen Abhängigkeiten registrieren.

Beobachte die Konsole während dieses ersten Starts. Bestätige, dass Verité lädt und dass keine Warnungen oder Fehler erscheinen, die auf ein Konfigurations- oder Kompatibilitätsproblem hinweisen.

Konsolenausgabe

Verité färbt seine Konsolenmeldungen ein, damit Fehler sich von gewöhnlichen Startmeldungen abheben. Fehler erscheinen rot, Erfolge grün und Zählwerte in der Markenfarbe von Verité. Jede Meldung trägt das Präfix [Verité].

Farbe wird nur hinzugefügt, wenn die Konsole sie darstellen kann. Verité prüft in dieser Reihenfolge:

Ist Farbe deaktiviert, werden die Meldungen als reiner Text geschrieben, ohne zurückbleibende Escape-Sequenzen, sodass Protokolldateien lesbar bleiben.

Zwei Systemeigenschaften überschreiben die Erkennung, falls Sie ein Ergebnis erzwingen müssen:

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

Die erste schaltet Farbe vollständig aus (oder ein). Die zweite behält Farbe bei, wechselt aber von 24 Bit auf die einfache 16-Farben-Palette. Das lohnt sich, wenn Ihre Konsole statt Farbe seltsame Zeichen anzeigt.

Module

Verité ist aus drei Modulen aufgebaut, die jeweils unabhängig in der config.yml umgeschaltet werden. Alle drei sind standardmäßig aktiviert. Deaktiviere ein Modul, indem du sein enabled-Flag auf false setzt; der Rest des Plugins läuft weiter.

chat.filter:
  enabled: true

moderation:
  enabled: true

vanish:
  enabled: true

Konfigurations-Auto-Update

Wenn Verité aktualisiert wird, kann es neue Schlüssel an deine bestehende config.yml anhängen, damit du deine Einstellungen nicht verlierst. Dies wird im Abschnitt general gesteuert:

general:
  auto.update.config: true

Wenn dies aktiviert ist, werden neue Konfigurationsschlüssel, die in einem späteren Release hinzugefügt wurden, automatisch in deine Datei eingefügt. Dies umgeht keine Tokenizer-Updates, die separat behandelt werden.

Die Chatfilter-Ressourcendateien (die .eve-Dateien) haben ihren eigenen Schalter, der standardmäßig aus ist:

chat.filter:
  auto.update.eve: false