ZeroDev Sentinel Doku

ZeroDev Sentinel: Installation und Nutzung

ZeroDev Sentinel ist eine serverseitige Anti-Cheat-Resource für FiveM. Sie zeichnet auf, was der Server sieht, bewertet es mit Regeln, die sich in klaren Sätzen selbst erklären, und gibt deinem Staff die Beweise, bevor jemand bestraft wird. Sie startet auf der Schutzstufe Watch: Sie protokolliert und bestraft niemanden, bis du dich anders entscheidest. Diese Anleitung behandelt Version 0.1.2 auf ESX-, QBCore-, Qbox- und Standalone-Servern.

Für ZeroDev Sentinel 0.1.223 Min. LesezeitAktualisiert am

1. Voraussetzungen

  • OneSync an (set onesync on in der server.cfg). Die Resource gibt OneSync als Abhängigkeit an, daher startet FXServer sie ohne OneSync nicht.
  • Ein FXServer-Artifact, das Node-22-Skripte ausführt (jedes aktuell empfohlene Artifact; das Manifest verlangt node_version '22'). Node übernimmt Hashing, Kompression, Dateilisten und die Web-Route für Einsprüche.
  • Optional: oxmysql. Damit speichert Sentinel seine Daten in deiner Datenbank und legt beim ersten Start seine eigenen Tabellen an. Es gibt keine SQL-Datei zum Importieren. Ohne oxmysql liegt alles im eigenen Key-Value-Store der Resource.
  • Optional: pma-voice, um den Voice-Chat eines Spielers über die Konsole oder das Browser-Panel mitzuhören.

Das Framework spielt nur für zwei Dinge eine Rolle: die Geld- und Item-Spur (Geld und Items, die kein Shop, Job oder Skript ausgezahlt hat, Belohnungsschleifen, Rollbacks) und wer dein Staff ist (ACE-Gruppen, die jedes Framework nutzt). Erkennung, Fälle, Clips, die Konsole, das Browser-Panel, Discord und der Owner-Desk funktionieren auf jedem Framework gleich.

2. Installation in fünf Minuten

Nichts braucht SQL, für den ersten Start ist keine Config-Änderung nötig, und keine andere Resource wird verändert.

Schritt 1: Ordner nach resources legen

Kopiere den Ordner zerodev_sentinel in deinen resources-Ordner. Behalte genau diesen Ordnernamen: Die Guard-Datei meldet an zerodev_sentinel, und sentinel:guard warnt dich, wenn der Ordner anders heißt.

Schritt 2: In server.cfg eintragen

Starte sie nach oxmysql und deinem Framework, damit Speicher und Geld-Spur sie beim Start finden. Die genaue Reihenfolge für dein Framework steht in Abschnitt 3.

Schritt 3: Server starten

Die Konsole gibt eine Startbox und einen einmaligen Owner-Code aus. Jede Zeile der Box ist eine echte Prüfung; die letzte Zeile sagt READY oder NOT READY mit der Anzahl der Probleme (Abschnitt 15).

Schritt 4: Owner-Platz übernehmen

Verbinde dich mit dem Server und gib /sentinel owner <code> im Chat ein. Jetzt hast du den Owner-Platz (Abschnitt 4).

Schritt 5: Owner-Desk öffnen

Drück im Spiel F7 (oder gib sentinel:console in F8 ein) und öffne OWNER. Das Blatt First run zeigt, was erledigt ist und was nicht: Discord, Clip-Speicher, dein Staff und seine Berechtigungen. Jede Zeile hat einen Button. Spiel dann ein paar Tage auf Watch, lies auf dem Blatt Right now, was Sentinel gefunden hat, und stell die Schutzstufe am selben Desk auf Recommended (Abschnitt 6).

3. Dein Framework

Sentinel findet Framework und Inventory beim Start selbst. Es gibt nichts einzustellen. sentinel:trail in der Server-Konsole zeigt, welchen Adapter es gewählt hat.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Geld und Items: werden aus ESX' eigenen Server-Events gelesen (Kontogeld hinzugefügt, entfernt oder gesetzt; Inventory-Items hinzugefügt oder entfernt; Items von Spieler zu Spieler gegeben, mit beiden Seiten verknüpft). Ein Rollback nutzt ESX' eigene Spieler-Methoden und liest das Ergebnis zurück.
  • ESX mit ox_inventory: Geld wird genauso verfolgt. In diesem Modus melden die Item-Methoden von ESX keine Ergebnisse, daher entscheidet Sentinel nur anhand des Zurücklesens.
  • Staff: Gib deinen Admins die ACE-Berechtigung (Abschnitt 5). ESX' eigenes group.admin funktioniert als ACE-Gruppe, wenn du die Zeile dafür hinzufügst.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Geld: wird aus QBCores Event für Geldänderungen gelesen (hinzufügen, entfernen und setzen, mit Grund). Ein Verlust und ein gleich großer Gewinn im selben Moment werden als Überweisung verknüpft, weil QBCore kein eigenes Überweisungs-Event hat.
  • Items: Mit ox_inventory werden Items über dessen Hooks verfolgt. Mit qb-inventory werden Item-Änderungen nicht verfolgt (der Payload seines Listeners ist nicht dokumentiert), aber ein Rollback kann Items trotzdem über die dokumentierten Exports von qb-inventory verschieben.
  • Staff: Die Berechtigungsgruppen von QBCore sind ACE-Gruppen (group.admin, group.god). Füge die ACE-Zeilen aus Abschnitt 5 hinzu.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Geld: wird aus dem Event für Geldänderungen von Qbox gelesen; Kontostände werden mit den eigenen Exports von qbx_core zurückgelesen. Geld, das für einen Offline-Charakter (per citizen id) geändert wird, löst kein Event aus und steht daher nicht in der Spur.
  • Items: Qbox nutzt ox_inventory, und Sentinel verfolgt dessen Items über die Hooks von ox_inventory. Items, die für Framework-Geld stehen, bleiben dem Framework-Teil überlassen.
  • Staff: ACE-Gruppen, wie bei QBCore.

Standalone (kein Framework)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Alles außer der Geld- und Item-Spur funktioniert: Bewegung, Welt, Events, Köder-Events, Godmode, State Bags, Waffen, Fälle, Clips, Replay, Konsole, Panel, Discord, Rollen und Bans.
  • Mit ox_inventory und ohne Framework werden Items über ox_inventory verfolgt.
  • Speicher: der Key-Value-Store oder oxmysql, wenn du es vorher startest.

Prüfen, ob es läuft

  • sentinel:health: noch einmal die Startbox. Jede Zeile ist eine echte Prüfung; READY heißt, dass nichts fehlt.
  • sentinel:diag: warum Speicher, Adapter und Stufe gewählt wurden, jede Regel mit ihren Zählern und die letzten Entscheidungen.
  • sentinel:trail: der aktive Adapter für Geld und Items und die letzten Änderungen eines Spielers.

Im automatischen Speichermodus nutzt Sentinel oxmysql nur, wenn oxmysql bereits gestartet ist (es wartet bis zu 15 Sekunden, während oxmysql startet); startet oxmysql später, nutzt es den Key-Value-Store.

4. Erster Start: der Owner-Platz

Der erste Start gibt in der Server-Konsole einen Einmalcode aus, der 30 Minuten gilt (sentinel:owner code gibt einen neuen aus). Verbinde dich und gib /sentinel owner <code> ein: Der Platz wird an deinen Account gebunden und der Code verfällt.

Nur der Owner-Platz kann Schlüssel, Schutzstufe, Rollen und Berechtigungen ändern. sentinel:owner reset in der Server-Konsole gibt den Platz frei, falls du ihn auf einen anderen Account übertragen musst.

5. Staff und Berechtigungen

Am Owner-Desk unter STAFF: einen Spieler wählen, der online ist, eine Rolle wählen, GRANT drücken. Vier Rollen sind dabei:

Rolle Kann, ab Werk
Support Fälle sehen, Meldungen bearbeiten, die Dienstkarte
Moderator wie Support, plus Replays, Kick und Quarantäne
Admin wie Moderator, plus Aufdecken, Entlasten, Live-Ansicht, Ban-Anträge, Einsprüche
Senior admin wie Admin, plus ein Ban, der sofort gilt

Die Berechtigungen bestimmst du. Jede Rolle ist eine Liste von Schaltern, die du ändern kannst. Erstelle eigene Rollen aus einer Kopie (zum Beispiel "Trial mod"), benenne jede Rolle um und gib einer einzelnen Person einen zusätzlichen Schalter oder nimm ihr einen weg, ohne ihre Rolle zu ändern. Als gefährlich markierte Schalter (sofortiger Ban, Voice-Chat mithören, Einstellungen, Staff-Verwaltung) verlangen einen zweiten Klick. Jede Änderung wird ins Staff-Protokoll geschrieben, sodass du immer siehst, wer was geändert hat.

ACE funktioniert weiterhin für Server, die es schon nutzen, und wird bei jeder Prüfung gelesen:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Berechtigung Rolle, die sie gibt
sentinel.admin Admin (Senior admin, bis der Owner-Platz übernommen ist) und jeder sentinel:*-Befehl im Spiel
sentinel.staff Moderator; Bewegungsregeln werten die eigene Bewegung eines Staff-Mitglieds als erklärt

Einige Befehle (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) sind als eingeschränkt registriert: Im Spiel brauchen sie zusätzlich command.<name>. Die übliche Zeile add_ace group.admin command allow deckt das ab. Die Server-Konsole kann jeden Befehl ausführen.

6. Die Schutzstufe

Ein Schalter am Owner-Desk (OWNER, PROTECTION), außerdem sentinel:level in der Server-Konsole und Config.Protection in config/config.lua. Was du am Desk einstellst, wird gespeichert und hat nach einem Neustart Vorrang vor der Config-Zeile.

  • Watch: Jede Regel beobachtet und schreibt auf, was sie getan hätte; niemand wird alarmiert, und niemandem passiert etwas. In der Zwischenzeit lernt Sentinel, was auf deinem Server normal ist: Der Event-Beobachter (Raten und Form jedes Events) und die Join-Prüfung lernen nur auf Watch; Grenzen für Entities, Kampf und Geld lernen weiter aus sauberem Spiel.
  • Recommended: Jede Regel ist live. Der Staff bekommt Alarme mit den Beweisen, und ein Fall wird eröffnet. Sentinel bestraft nie von selbst; dein Staff entscheidet.
  • Strict: wie Recommended, und ein hoher Score setzt den Spieler in Quarantäne, bis der Staff draufschaut; ein Befund auf Beweisniveau (Tier A: ein Köder-Event wurde ausgelöst, eine gefälschte Anfrage) reiht zusätzlich einen Ban für die Ban-Welle ein.

Unter dem Schalter listet der Desk jede Regel mit ihrem Zustand und woher dieser Zustand kommt. Dort kannst du eine einzelne Regel auf Live oder Shadow festsetzen, wenn dein Server das braucht (zum Beispiel eine Regel, die immer wieder eines deiner eigenen Skripte markiert); eine state-Zeile in Config.Rules setzt sie in der Config-Datei fest und hat Vorrang vor dem Desk.

Eine sinnvolle Reihenfolge:

  1. Watch für ein paar Tage normales Spiel.
  2. Lies, was die Regeln getan hätten: das Blatt Right now, sentinel:diag rules (die Spalte shadow zählt, wie oft eine Regel gewertet hätte) und sentinel:diag decisions 100.
  3. Setze jede Regel auf Shadow fest, die jemanden markiert hat, dem du vertraust, und sag uns Bescheid.
  4. Wechsle auf Recommended. Der Staff sieht jetzt Fälle und Beweise; niemand wird automatisch bestraft.
  5. Strict, wenn du dem vertraust, was Recommended dir zeigt.

Jederzeit zurück: Watch am Desk oder sentinel:level watch.

7. Die Staff-Konsole (F7)

Drück F7 im Spiel (oder gib sentinel:console in F8 ein). Jeder Spieler kann die Taste in den Spieleinstellungen ändern (Key Bindings, FiveM). Esc schließt sie.

  • Right now sagt in klaren Worten, was auf deinem Server passiert: wer wie eine Bedrohung aussieht und warum, was bewiesen wurde, was erklärt wurde (ein Revive, ein Teleport eines eigenen Scripts) und was dich braucht. Jeder relevante Spieler bekommt eine Zeile: was er getan hat, was es wahrscheinlich ist, wie sicher Sentinel ist (Unusual, Suspicious, Very likely, Proven), was Sentinel schon getan hat und einen nächsten Schritt.
  • Fallakten: offene Fälle zuerst, jeweils mit Befund, Beweisen, Bildschirmclips, dem Siegel (ob die Hash-Kette des Falls noch stimmt) und den Tasten REVEAL, QUARANTINE, CLEAR und BAN (CLEAR und BAN verlangen einen zweiten Druck).
  • Dienstkarte: Online-Spieler auf einem 3D-Modell der Insel. Das Gelände wird vom Spiel des ersten Staff-Mitglieds vermessen und in data/map/ gespeichert.
  • Play replay schließt die Konsole und spielt den Vorfall in einer privaten Welt ab; mit Backspace kommst du zurück.
  • Owner (nur Owner-Platz): First run, Protection, Keys, Staff, Internal affairs und Server check.

Befehle im Spiel gibst du in F8 ohne Schrägstrich ein oder im Chat mit Schrägstrich (/sentinel:diag).

8. Das Browser-Panel

Derselbe Desk im Webbrowser, wenn du nicht im Spiel bist:

  • auf dem Server-PC: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (der Port ist dein Server-Port, standardmäßig 30120)
  • von anderswo: http://<server address>:<port>/zerodev_sentinel/panel/ oder deine eigene HTTPS-Adresse davor

Anmelden. Nutze einen Einmalcode: Gib /sentinel panel im Spiel ein (der Code wird nur dir angezeigt und gilt einmal, für 5 Minuten) oder führe sentinel:panel <id or account> in der Server-Konsole aus. Eine Sitzung dauert 8 Stunden; SIGN OUT und END ALL MY SESSIONS beenden sie. Deine Rolle und deine Schalter gelten im Browser genau wie im Spiel.

Live-Ansicht. Staff mit dem Schalter für die Live-Ansicht kann über das Panel oder die Konsole den Bildschirm jedes Online-Spielers ansehen. Auf der Festplatte wird nichts gespeichert, außer du drückst Save to case.

Mithören. Um den Voice-Chat dieses Spielers mitzuhören, brauchst du den Schalter fürs Mithören (standardmäßig nur der Owner) und pma-voice. Der Ton läuft über dein eigenes Spiel, also sei im Spiel auf demselben Server.

Jede Live-Ansicht und jedes Mithören wird ins Staff-Protokoll und in den Fall des Spielers geschrieben, und Spieler erfahren beim ersten Join, dass Staff zusehen und mithören darf (der Aufzeichnungshinweis, Config.Notice).

9. Fälle, Quarantäne, Kick, Ban und Einsprüche

Wenn etwas gefunden wird, nennt Right now den Spieler in Klartext: was er getan hat, wie sicher Sentinel ist und was es dagegen getan hat. Öffne den Fall, um die Beweise zu sehen (Positionen, mit SHA-256 versiegelte Bildschirmclips, ein 3D-Replay), und nutze die Tasten:

  • REVEAL: zeigt die Identifier des Spielers.
  • QUARANTINE: verschiebt den Spieler aus der echten Welt in einen privaten Routing-Bucket, bis Staff sich das ansieht. sentinel:release <server id> holt ihn zurück.
  • CLEAR: kein Cheat; schließt den Fall und stoppt seinen vorgemerkten Ban.
  • KICK: vom Server, mit einem Grund, den der Spieler liest.
  • BAN: über die Ban Wave, mit einem Einspruchscode.

Die Ban Wave. Bans, auch ein in der Konsole gedrücktes BAN, werden für die Ban Wave vorgemerkt und nur auf Strict ausgeführt, standardmäßig zu einem zufälligen Zeitpunkt 2 bis 24 Stunden später (Config.Actions). sentinel:wave listet sie auf, sentinel:wave now <account> führt einen sofort aus, sentinel:wave cancel <account> bricht ihn ab.

Einsprüche. Ein gebannter Spieler sieht in der Ablehnungsmeldung einen Einspruchscode (8 Buchstaben und Ziffern). Er kann nicht joinen, um Einspruch einzulegen, also erreicht dich der Einspruch von außerhalb des Spiels:

  1. Über deinen Staff. Der Spieler schickt den Code an deinen Staff (ein Discord-Ticket, eine Mail). Ein Staff-Mitglied trägt ihn mit sentinel:appeal <code> <text> ein.
  2. Über die Web-Route. Sentinel antwortet unter der eigenen Adresse deines Servers: http://<server address>:<port>/zerodev_sentinel/appeal. Es nimmt nur einen POST mit JSON { "code": "...", "text": "...", "contact": "optional" } an (Text 10 bis 2000 Zeichen), ist also für ein Formular auf deiner Website gedacht, nicht als Seite, zu der du Spieler schickst. Jede angenommene Anfrage bekommt dieselbe Antwort, 202 "received", egal ob der Code zu einem Ban passt oder nicht. Zu viele Anfragen von einer Adresse (5 in 10 Minuten) oder insgesamt (30 pro Minute) bekommen 429. Hinter deinem eigenen HTTPS-Reverse-Proxy setzt du set sentinel_http_proxy true, damit die Limits die Adresse des Besuchers zählen.

Der Ablehnungstext sagt nicht, wo man Einspruch einlegt. Sag es den Spielern in deinen Regeln oder schreib deinen eigenen Text mit deinem Link in Config.Bans.message (behalte das %s, daraus wird der Code), zum Beispiel 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Staff entscheidet in der Konsole oder mit sentinel:decide <case or code> accept|reject [note]. Accept hebt jeden aktiven Ban dieses Accounts oder Falls auf und bricht einen vorgemerkten Wave-Ban ab; reject behält den Ban bei. Eine Entscheidung ist endgültig und wird ins Fallprotokoll geschrieben. sentinel:appeals listet die offenen auf.

10. Meldungen und interne Kontrolle

Spieler-Reports. Jeder Spieler kann /report <server id> <what happened> eingeben, um einen Spieler oder ein Staff-Mitglied zu melden. Die letzten zwei Minuten rund um beide Spieler werden in einem Fall gespeichert. Staff schließt einen Report als erledigt, kein Verstoß, kein Beweis oder Duplikat. Reports über Staff gehen nur an den Owner.

Interne Kontrolle (nur Owner, am Owner-Desk): was jedes Staff-Mitglied getan hat und was einen Blick braucht (Vergaben an sich selbst, Verstecken im Kampf, Bans ohne Fall, Teleports zu Spielern). Ein wöchentlicher Fairness-Bericht wird nach data/reports/ geschrieben; sentinel:staff report schreibt ihn sofort. Nichts im Staff-Protokoll bestraft Staff.

11. Eine Resource schützen

Ganz ohne Einrichtung beobachtet Sentinel jedes Event, das Spieler an deine Scripts senden können, und bewertet den Spieler. Es kann nicht verhindern, dass der Handler einer anderen Resource läuft. Um einen schlechten Aufruf zu stoppen, bevor ein Script läuft, füge diesem Script den Guard hinzu.

  1. sentinel:audit listet die Events jeder gestarteten Resource auf, die Clients auslösen können, eingestuft danach, was ihre Handler tun (zum Beispiel ein Handler, der Geld mit einem vom Client gewählten Betrag gibt). Damit entscheidest du, welche Resources du zuerst schützt.
  2. sentinel:guard <resource> gibt die Zeile aus, die du hinzufügen musst, und die server_scripts der Resource, wie sie dann aussehen würden. Die Guard-Zeile muss das erste Server-Script sein. Der Befehl gibt nur aus; er ändert keine Datei.

lua server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }

  1. Starte diese Resource neu. sentinel:guard <resource> sagt jetzt "guarded since ...". sentinel:guard allein listet jede geschützte Resource auf.
  2. Füge Regeln mit sentinel:patch hinzu. Solange eine Resource keine Regeln hat, lässt ihr Guard jeden Aufruf durch, außer Aufrufe von Spielern in Quarantäne, die jeder Guard verwirft. Beispiel: höchstens 3 Käufe in 10 Sekunden, ein Item-Name mit bis zu 32 Zeichen und eine Menge von 1 bis 10; ein abgelehnter Aufruf zählt als Beweis ("hard": true):

text sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}

Für einen Framework-Callback schreibst du callback:<name> als Event: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> listet die Regeln einer Resource auf; sentinel:patch <resource> <event> off entfernt eine.

Der Guard bearbeitet nie Dateien und ändert nie, was ein Handler empfängt. Er ist schlichtes, lesbares Lua in guard/guard.lua.

12. Schlüssel für Discord und Clip-Speicher

Am einfachsten geht es am Owner-Desk unter KEYS: Füge jeden Wert ein und drück SAVE. Schlüssel werden nur auf dem Server gespeichert; der Desk und jede Antwort sagen nur "set" und zeigen einen Schlüssel nie wieder an.

Zeile am Desk Was es ist Oder in der server.cfg (nutze set, nie setr)
Discord-Bot-Token ein Bot, den du unter discord.com/developers erstellt und auf deinen Server eingeladen hast set sentinel_discord_token "..."
Discord-Server-ID Rechtsklick auf deinen Server, Copy Server ID (Entwicklermodus an) set sentinel_discord_guild "..."
Alert-Kanal-ID wo Fälle gepostet werden, mit Buttons für deinen Staff set sentinel_discord_channel "..."
Einspruchs-Kanal-ID wo Einsprüche gepostet werden set sentinel_discord_appeals "..."
FiveManage-Schlüssel ein Media-Key von fivemanage.com; Clips werden dorthin hochgeladen set sentinel_fivemanage_key "..."
Clip-Webhook statt FiveManage: ein Discord-Webhook, der die Clips empfängt set sentinel_clip_webhook "..."
Clip-Speicher fivemanage, discord, off oder automatic (der erste, der gesetzt ist) set sentinel_clip_storage "..."

Ein Schlüssel in der server.cfg hat Vorrang vor dem Desk, und der Desk zeigt das an. Discord-Buttons folgen denselben Rollen und Schaltern wie die Konsole. Ohne all das bleiben Fälle und Clips auf deinem Server (data/), und Konsole und Panel zeigen sie an.

Die einfacheren Webhook-Alerts funktionieren weiterhin: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" oder sentinel:webhook set <url> in der Server-Konsole. sentinel:webhook test sendet eine Testnachricht; sentinel:webhook zeigt den Status, ohne jemals die URL auszugeben; sentinel:webhook clear entfernt die gespeicherte.

13. Was jede Regel erkennt

Jede Regel schreibt einen klaren Satz, wenn sie auslöst, und sagt, was sie gesehen und was sie ausgeschlossen hat. Bevor eine Regel gegen jemanden zählt, prüft Sentinel die Gründe, die es erklären würden (ein Respawn, ein Revive, eine Staff-Aktion, eines deiner eigenen Scripts, das Spieler bewegt oder bezahlt). Ein erklärter Befund wird protokolliert und nie gewertet.

  • Tier A ist ein Beweis: etwas, das nur ein Cheat tut (ein Köder-Event, das kein echtes Script aufruft, eine gefälschte Anfrage).
  • Tier B ist stark: Ein Staff-Mitglied sollte es sich ansehen. Allein öffnet es nur dann einen Fall, wenn zwei verschiedene Familien übereinstimmen oder dieselbe sich wiederholt.
  • Tier C ist schwach: Es erhöht den Score und handelt nie allein.

Bewegung

Regel Erkennt Erklärt durch Tier
teleport Ein Sprung von über 150 m (oder 3x so weit wie möglich) zwischen zwei Messungen Spawn, Respawn oder Revive, Wechsel des Routing-Buckets, Staff, das Teleport-Event deines Scripts B
foot_speed Zu Fuß über 12 m/s für 1.5 s rennen, ohne zu fallen, ohne Ragdoll Spawn, Respawn, Staff, dein Script B
air_float Bewegung trotz Freeze (Noclip); "Fallen", ohne herunterzukommen (Fly); schnelle Bewegung per Koordinaten, während das Spiel sagt, dass der Spieler stillsteht (Speed-Menüs) Spawn, Respawn, Staff, dein Script B
foot_rise Zu Fuß 3 s lang senkrecht schneller als 4 m/s nach oben klettern Spawn, Respawn, Staff, dein Script B
vehicle_speed Ein Fahrzeug über 1.3x der höchsten Geschwindigkeit, die seine Klasse auf deinem Server erreicht Staff, dein Script B

Welt

Regel Erkennt Erklärt durch Tier
entity_blocked Spawnen eines Modells, das du blockiert hast deine Scripts, die es spawnen B
entity_rate / entity_model_rate Spawnen von weit mehr Entities (oder einem Modell) pro Minute, als Spieler und Scripts es tun deine Spawn-Scripts B
entity_untrusted Entities, die ein Client erstellt hat, ohne dass ein Script sie spawnt deine Spawn-Scripts B
entity_disguised Eine Häufung desselben Ambient-Ped-Modells um einen Spieler (ein Menü, das seine Spawns als Verkehr tarnt) Spawn, Respawn, Bucket-Wechsel B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Explosionen, die die gehaltene Waffe nicht erzeugen kann, zu viele, unsichtbare oder weit vom Spieler entfernt die Explosionen deiner Scripts B
projectile_weapon / projectile_rate Projektile, die die Waffe nicht abfeuern kann, oder zu viele B
ptfx_rate Fluten von Partikeleffekten (ein häufiger Crash- und Lag-Angriff) B
fire_rate Feuer, die schneller gelegt werden, als es eine Waffe erlaubt B

Kampf

Regel Erkennt Tier
damage_plausibility Schaden über dem möglichen Wert der Waffe B
hit_range Treffer von jenseits der Reichweite der Waffe B
shot_rate / kill_rate Schneller schießen, als die Waffe kann; Kills pro Minute weit über dem, was auf deinem Server üblich ist B
silent_aim Treffer, wo der Spieler nicht hingezielt hat, wiederholt B
aim_stats / aim_stats_backed Headshot-Anteil und Snap-Winkel weit außerhalb der Spieler deines Servers, über 30+ Kämpfe C (B mit einer anderen Familie)
esp_los_backed Wiederholtes Zielen auf Spieler, die laut den Zeugen hinter Wänden verborgen sind C bis B

Events und Anfragen

Regel Erkennt Tier
bait_event Aufruf eines platzierten Events, das kein echtes Script nutzt (Cheat-Menüs suchen danach und lösen es aus) A
bait_statebag / statebag_write Schreiben von State Bags, die nur der Server schreiben sollte (sich selbst zum Admin machen, Godmode-Flags), oder von übergroßen A / B
events_before_ready / _trap Events, die gesendet werden, bevor der Spieler überhaupt gespawnt ist (vor dem Joinen injiziert) B / A
event_rate / event_shape Ein Event, das weit schneller als normal aufgerufen wird oder mit Argumenten, die anders aufgebaut sind als die normalen Aufrufe auf deinem Server B
event_flood 500+ Aufrufe in 10 s; beim eigenen Overflow-Kick von FiveM werden die häufigsten Events aufgelistet B
guard_rule / guard_hard Verstoß gegen eine Regel, die du für ein geschütztes Event gesetzt hast (Betrag, Rate, Entfernung) B / A

Wirtschaft

Regel Erkennt Tier
money_nowhere / item_nowhere Geld oder Items, die kein Shop, Job oder Script ausgegeben hat (Dev-Events, geleakte Shop-Verkäufe) B
economy_repeat Ein Belohnungs- oder Job-Event, das 10-mal in 30 s ausgezahlt wurde (Farmen durch Aufrufen in einer Schleife) B
money_jump / money_rate Ein plötzlicher Sprung im Kontostand oder eine Auszahlungsrate weit über dem, was auf deinem Server üblich ist B
economy_trap Einlösen einer platzierten Belohnung, die kein echter Job auszahlt A
weapon_not_owned Eine Waffe halten, die das Inventory nie ausgegeben hat B

Das Spiel des Spielers (Zeuge)

Regel Erkennt Tier
godmode Der Server sieht den Spieler 30 s lang als unverwundbar (keine gemeinsame Safe Zone) B
witness_backed Anzeichen aus dem Spiel, die von der eigenen Sicht des Servers gestützt werden (Godmode, Unsichtbarkeit, keine Kollision) B
witness_bait Das Spiel beantwortet eine Prüfung, von der es nichts wissen dürfte A
witness_tamper Sentinels eigene Prüfungen im Spiel wurden gehookt oder verändert B

Identität und Dateien

Regel Erkennt Tier
ban_fingerprint Ein gebannter Spieler ist mit einem neuen Account zurück (Hardware-Tokens, Identifier, Browser-Fingerprint) A / flag
young_account Ein brandneuer Account (erhöht nur das Gewicht) C
scanner_error / too_large Resources, die der Script-Scanner nicht lesen konnte, oder übergroße Dateien, die einen Blick wert sind info

Was keine Regel verspricht

Sentinel bewertet, was der Server sehen kann und was das Spiel eines Spielers meldet. Es liest keine anderen Programme auf dem PC eines Spielers, und kein Anti-Cheat kann versprechen, dass jeder Cheat erkannt wird. Jeder Befund kommt mit seinen Beweisen, damit dein Staff auf Grundlage von Fakten entscheidet.

14. Befehle und Konfiguration

Jeder Befehl steht auf der Befehlsseite und jeder Config-Key auf der Konfigurationsseite, beide direkt aus der Resource generiert. Die, die du am häufigsten nutzt:

Befehl Was sie macht
/sentinel owner <code> den Owner-Platz im Spiel mit dem Code aus der Konsole übernehmen
/sentinel panel ein einmaliger Anmeldecode für das Browser-Panel (nur Staff)
/report <server id> <what happened> ein beliebiger Spieler meldet einen Spieler oder ein Staff-Mitglied
sentinel:health noch einmal die Startbox
sentinel:diag was Sentinel entschieden hat und warum
sentinel:level watch\|recommended\|strict die Schutzstufe ändern und speichern
sentinel:wave die Banns, die für die Ban Wave vorgemerkt sind
sentinel:appeals die offenen Einsprüche
sentinel:audit die riskanten Events jeder gestarteten Resource
sentinel:guard <resource> die Zeile, die eine Resource schützt
sentinel:advisor die FiveM-Einstellungen, die du auf deinem Server ändern solltest

Die Config-Dateien in config/ (config.lua, protection.lua, watch.lua) und die Übersetzungen in config/locales/ sind offen für dich, ebenso die Framework-Adapter in bridge/ und die Guard-Datei in guard/. Halte sie als gültiges Lua und starte zerodev_sentinel nach einer Änderung neu. Für den ersten Start musst du nichts in der Config ändern.

15. Die Startbox und der Härtungsberater

Kurz nachdem der Speicher bereit ist, gibt Sentinel eine Box in der Serverkonsole aus. Eine FAIL-Zeile heißt, dass Sentinel nicht richtig arbeiten kann; eine WARN-Zeile heißt, dass es mit Einschränkungen arbeitet (zum Beispiel Beweise ohne Digests). Mit sentinel:health gibst du sie jederzeit erneut aus.

Zeile Was sie prüft Wenn sie nicht OK ist
Build Die Version und das Build-Label aus der fxmanifest.lua. -
OneSync Die Convar onesync. Sentinel liest Positionen, Entities und Game-Events über OneSync. onesync in der server.cfg auf on setzen
Laufende Kopien Wie viele Kopien der Resource gestartet sind, egal wie ihr Ordner heißt. Muss 1 sein. nur eine Kopie von Sentinel behalten; den anderen Ordner stoppen
Speicher Welcher Speicher gewählt wurde (mysql oder kvp) und ob er bereit ist. siehe sentinel:diag storage
Beweis-Ordner Ein Test-Schreiben und -Lesen in data/archive innerhalb der Resource. den Ordner data/archive in der Sentinel-Resource anlegen und sicherstellen, dass der Server hineinschreiben kann
SHA-256 Ob node/util.js antwortet; es erstellt für jedes Beweisstück einen Fingerabdruck. Beweise werden ohne Digests gespeichert; in der Konsole nach einem Node-Fehler schauen
Schutz Die Schutzstufe, ihr Modus und woher sie kommt. -
Regeln Wie viele Regeln live sind und wie viele im Shadow-Modus. -

Nach der Startbox gibt der Berater die FiveM-Einstellungen aus, die du auf deinem Server ändern solltest (mit Config.Advisor.atStartup = false erscheint er nur bei sentinel:advisor). Für jede Einstellung zeigt er den aktuellen Wert, den empfohlenen, was sie blockiert, was sie kaputt machen könnte und die Zeile zum Kopieren. Er liest die Werte nur; er ändert die server.cfg nie. Teste eine Zeile auf deinem Server, bevor du sie behältst.

16. Sprachen und was aufgezeichnet wird

Die Texte für Spieler und Staff kommen aus config/locales/<code>.lua, 25 Sprachen in diesem Build. Config.Locale wählt die Sprache; mit Config.GameLanguage = true liest ein Spieler, dessen Spiel in einer von GTA angebotenen Sprache läuft, Sentinel im Spiel in dieser Sprache.

Sentinel behält für jeden Spieler etwa die letzten zwei Minuten an Positionen und Events im Speicher (Config.Recorder) und schreibt sie in ein Archiv in data/archive/, wenn ein Fall geöffnet wird oder der Staff sentinel:save nutzt. Während einer Prüfung fordert es vom Spiel des Verdächtigen Bildschirm-Clips an (Abschnitte von 20 Sekunden) und speichert sie in data/clips/. Es speichert die Identifier, die FiveM dem Server gibt (eine IP-Adresse wird aufgezeichnet, aber standardmäßig nie genutzt, um eine Verbindung abzulehnen), und, wenn Discord läuft, die Discord-ID. Beim ersten Join bekommt jeder Spieler einen kurzen Hinweis in seiner Sprache, dass der Server das Spielgeschehen aufzeichnet und dass der Staff zusehen und mithören kann (Config.Notice = false schaltet ihn ab; sag es den Spielern dann in deinen Regeln). Erwähne es auch in deiner Datenschutzerklärung.

Alte Archive und Clips werden in diesem Build nicht automatisch gelöscht: Leere data/archive/ und data/clips/ selbst, wenn du sie nicht mehr brauchst.

Mit oxmysql liegen die Daten von Sentinel in den Tabellen zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report und zds_trail. Ohne oxmysql liegen dieselben Daten im Key-Value-Speicher der Resource (Schlüssel, die mit zds: beginnen). Banns werden immer auch in den Key-Value-Speicher gespiegelt, damit sie greifen, während die Datenbank down ist.

17. Aktualisieren

Neue Versionen erscheinen auf demselben Keymaster-Asset. Sentinel bewahrt seine Beweise in seinem eigenen Ordner auf, also bevor du es ersetzt:

  1. Sichere im Ordner zerodev_sentinel die Ordner config/ und data/ (Archive, Clips, Reports, gelernte Baselines) und, mit oxmysql, die zds_-Tabellen.
  2. Stopp den Server, ersetze den Ordner zerodev_sentinel durch den neuen (behalte den Ordnernamen) und leg deinen Ordner data/ zurück. Übertrage die Einstellungen, die du geändert hast, in die neuen Config-Dateien, statt alte Dateien darüberzukopieren.
  3. Starte den Server und lies die Startbox (sentinel:health).

Lies vor dem Update die Release Notes der neuen Version im Changelog.

18. Deinstallieren

  1. Entferne die Guard-Zeile aus jeder Resource, die du geschützt hast (sentinel:guard listet sie auf), und starte diese Resources neu. Mach das zuerst: Die Guard-Datei ist weg, sobald der Ordner weg ist.
  2. Entferne ensure zerodev_sentinel und die Zeilen sentinel.admin / sentinel.staff aus der server.cfg und stopp dann die Resource. Wenn sentinel:lockdown den Entity-Lockdown geändert hat, stellt das Stoppen von Sentinel den ursprünglichen Modus wieder her.
  3. Lösche den Ordner zerodev_sentinel. Damit wird data/ mit allen Archiven, Clips und Reports entfernt, also kopiere vorher alles heraus, was du behalten willst.
  4. Mit oxmysql löschst du die in Abschnitt 16 aufgeführten zds_-Tabellen, wenn du die Banns und Fälle nicht mehr willst. Die Key-Value-Einträge bleiben im Speicher des Servers unter dem Namen der Resource und tun ohne sie nichts.

Sentinel schreibt nur in seinen eigenen Ordner, seine Datenbanktabellen und seinen Key-Value-Speicher. Es ändert keine anderen Resources und nicht die server.cfg.

Häufig gestellte Fragen

Bannt oder kickt Sentinel jemanden von selbst?

Nicht auf Watch oder Recommended. Es startet auf Watch, wo es nur loggt, was es getan hätte. Auf Recommended bekommt der Staff die Beweise und entscheidet. Nur auf Strict setzt ein hoher Score einen Spieler in Quarantäne, bis der Staff draufschaut, und ein Fund auf Beweisniveau merkt einen Bann für die Ban Wave vor.

Brauche ich eine Datenbank?

Nein. Mit oxmysql speichert Sentinel seine Daten in deiner Datenbank und legt beim ersten Start seine eigenen Tabellen an; es gibt keine SQL-Datei zum Importieren. Ohne oxmysql liegt alles im eigenen Key-Value-Speicher der Resource.

Läuft es auf QBCore und Qbox?

Ja. Erkennung, Fälle, Clips, die Konsole, das Browser-Panel, Discord und der Owner-Desk sind auf jedem Framework gleich. Die Geld- und Item-Spur hat einen eigenen Adapter für ESX, QBCore, Qbox und ox_inventory.

Wie gebe ich meinen Admins Zugriff?

Am Owner-Desk unter STAFF: einen Spieler wählen, der online ist, eine Rolle wählen, GRANT drücken. Oder weiter ACE nutzen: sentinel.admin gibt Admin und sentinel.staff gibt Moderator.

Kann ein gebannter Spieler Einspruch einlegen?

Ja. Die Ablehnungsmeldung zeigt einen Einspruchscode. Der Spieler schickt ihn an deinen Staff, der ihn mit sentinel:appeal erfasst, oder deine Website sendet ihn an die Einspruchs-Route von Sentinel. Der Staff nimmt ihn in der Konsole oder mit sentinel:decide an oder lehnt ihn ab.

Sieht es Cheat-Programme auf dem PC eines Spielers?

Nein. Sentinel beurteilt, was der Server sehen kann und was das Spiel eines Spielers meldet. Es liest keine anderen Programme auf dem PC eines Spielers.

Ist das Mithören im Voice-Chat fertig?

Es braucht pma-voice und den Mithör-Schalter (standardmäßig nur für den Owner) und spielt über dein eigenes Spiel ab.

Was sehen Spieler?

Beim ersten Join einen kurzen Hinweis in ihrer Sprache, dass der Server das Spielgeschehen aufzeichnet und dass der Staff zusehen und mithören kann (Config.Notice). Für einen sauberen Spieler ändert sich sonst nichts.

Aus dem Englischen übersetzt. Wenn etwas hier von der englischen Seite abweicht, gilt die englische Seite. English