Install: FiveM resource and Minecraft pluginInstallation: FiveM-Ressource und Minecraft-Plugin

0. Verify the archive0. Paket prüfen

The bundle contains Ward Core, the FiveM resource and the Minecraft plugin, built from tracked source. Every file inside is listed with its SHA-256 in MANIFEST.sha256. Verify the extracted tree before using it:Das Paket enthält Ward Core, die FiveM-Ressource und das Minecraft-Plugin, gebaut aus dem versionierten Quellcode. Jede Datei darin ist mit ihrem SHA-256 in MANIFEST.sha256 gelistet. Prüfen Sie den entpackten Baum, bevor Sie ihn verwenden:

cd nightward && shasum -a 256 -c MANIFEST.sha256

Default posture: closedStandardhaltung: geschlossen

Ward Core boots in detect mode and refuses to select enforce mode unless WARD_ALLOW_ENFORCE=1 is set separately from the mode itself. In detect mode the agents only flag; no ban, kick or other gameplay-changing action runs. Keep it that way until you have reviewed your own flags on your own players.Ward Core startet im Erkennungsmodus und wählt den Durchsetzungsmodus nur, wenn WARD_ALLOW_ENFORCE=1 zusätzlich zum Modus selbst gesetzt ist. Im Erkennungsmodus markieren die Agenten nur; es erfolgt kein Bann, Kick oder anderer Eingriff ins Spiel. Lassen Sie es dabei, bis Sie Ihre eigenen Meldungen bei Ihren eigenen Spielerinnen und Spielern selbst geprüft haben.

StepsSchritte

1. Ward Core (backend and operator dashboard)Ward Core (Backend und Betreiber-Dashboard)

   Needs Node.js 18 or newer. No npm packages. Set these config keys as environment variables and start it:Benötigt Node.js 18 oder neuer. Keine npm-Pakete. Diese Konfigurationsschlüssel als Umgebungsvariablen setzen und starten:

   cd ward-core
   WARD_INGEST_SECRET='<at least 24 random characters>' \
   WARD_ADMIN_TOKEN='<at least 24 random characters>' \
   NIGHTWARD_LICENSE_KEY='<your APLU- key>' \
   NIGHTWARD_LICENSE_URL='<the validation URL supplied with your key>' \
   WARD_MODE=detect WARD_ALLOW_ENFORCE=0 \
   node src/server.js

   Open http://<host>:8788/ and paste the admin token. Ward Core binds 0.0.0.0:8788 by default and ships no TLS of its own; put it behind your own reverse proxy, TLS and firewall, or set WARD_HOST and WARD_PORT. Health check: GET /api/health. Without a valid licence key the service still boots but answers telemetry with 402 until the key validates. No public validation hostname is published at the time of this build; use the URL supplied with your key. Ward Core also serves /customer.html, the licence-holder page of the Nightward licence authority (the service your key validates against); your own Ward Core holds no licences of its own, so on your instance that page reports no active key, and your operator dashboard is /.Öffnen Sie http://<host>:8788/ und fügen Sie das Admin-Token ein. Ward Core bindet standardmäßig an 0.0.0.0:8788 und bringt kein eigenes TLS mit; stellen Sie es hinter Ihren eigenen Reverse-Proxy, TLS und Firewall, oder setzen Sie WARD_HOST und WARD_PORT. Statusprüfung: GET /api/health. Ohne gültigen Lizenzschlüssel startet der Dienst trotzdem, beantwortet Telemetrie aber mit 402, bis der Schlüssel gültig ist. Zum Zeitpunkt dieses Builds ist kein öffentlicher Prüfungs-Host veröffentlicht; verwenden Sie die mit Ihrem Schlüssel gelieferte URL. Ward Core liefert außerdem /customer.html, die Lizenznehmer-Seite der Nightward-Lizenzautorität (der Dienst, gegen den Ihr Schlüssel geprüft wird); Ihr eigenes Ward Core führt selbst keine Lizenzen, daher meldet diese Seite auf Ihrer Instanz keinen aktiven Schlüssel, und Ihr Betreiber-Dashboard ist /.

2. FiveM agentFiveM-Agent

   Copy nightward-fivem/ into your server's resources/ as nightward. Edit config.lua: set ServerId, WardCoreUrl, and IngestSecret (must equal WARD_INGEST_SECRET above). Add ensure nightward last in server.cfg so the integrity watch sees the full resource list.Kopieren Sie nightward-fivem/ als nightward in die resources/ Ihres Servers. Bearbeiten Sie config.lua: ServerId, WardCoreUrl und IngestSecret setzen (muss dem obigen WARD_INGEST_SECRET entsprechen). Fügen Sie ensure nightward als letzte Zeile in server.cfg ein, damit die Integritätsprüfung die vollständige Ressourcenliste sieht.

3. Minecraft agent (Paper)Minecraft-Agent (Paper)

   Copy nightward-mc/dist/Nightward-0.1.0.jar into plugins/ of each Paper backend. Start once to create plugins/Nightward/config.yml, set server-id, ward-core-url and ingest-secret, then restart. /nightward status shows licence, mode and tracked count. The jar was compiled to Java 17 bytecode against paper-api 1.21.4-R0.1-SNAPSHOT; its source is in nightward-mc/src next to its pom.xml.Kopieren Sie nightward-mc/dist/Nightward-0.1.0.jar in die plugins/ jedes Paper-Backends. Einmal starten, um plugins/Nightward/config.yml zu erzeugen, dann server-id, ward-core-url und ingest-secret setzen und neu starten. /nightward status zeigt Lizenz, Modus und Anzahl beobachteter Spieler. Die Jar wurde als Java-17-Bytecode gegen paper-api 1.21.4-R0.1-SNAPSHOT gebaut; der Quellcode liegt in nightward-mc/src neben der pom.xml.

How to verify it runsSo prüfen Sie, ob es läuft

• GET http://<host>:8788/api/health returns {"ok":true,"ready":true,"mode":"detect", ...}.GET http://<host>:8788/api/health liefert {"ok":true,"ready":true,"mode":"detect", ...}.
• The FiveM server console prints [nightward] licensed (tier ...), mode=detect once the resource reaches Ward Core, or an explicit unlicensed warning if it cannot.Die FiveM-Server-Konsole zeigt [nightward] licensed (tier ...), mode=detect, sobald die Ressource Ward Core erreicht, sonst eine ausdrückliche Warnung, dass keine Lizenz vorliegt.
• In Minecraft, /nightward status shows the licence state, current mode and tracked player count.In Minecraft zeigt /nightward status den Lizenzstatus, den aktuellen Modus und die Anzahl beobachteter Spieler.
• The operator dashboard at http://<host>:8788/, opened with your admin token, lists connected servers, players and recent flags.Das Betreiber-Dashboard unter http://<host>:8788/, geöffnet mit Ihrem Admin-Token, listet verbundene Server, Spieler und jüngste Meldungen.

How to uninstallSo deinstallieren Sie