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.
1. Voraussetzungen
- OneSync an (
set onesync onin 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 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
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.adminfunktioniert als ACE-Gruppe, wenn du die Zeile dafür hinzufügst.
QBCore
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
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_corezurü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)
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:
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:
- Watch für ein paar Tage normales Spiel.
- 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) undsentinel:diag decisions 100. - Setze jede Regel auf Shadow fest, die jemanden markiert hat, dem du vertraust, und sag uns Bescheid.
- Wechsle auf Recommended. Der Staff sieht jetzt Fälle und Beweise; niemand wird automatisch bestraft.
- 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:
- Ü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. - Ü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 duset 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.
sentinel:auditlistet 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.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' }
- Starte diese Resource neu.
sentinel:guard <resource>sagt jetzt "guarded since ...".sentinel:guardallein listet jede geschützte Resource auf. - Füge Regeln mit
sentinel:patchhinzu. 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:
- Sichere im Ordner
zerodev_sentineldie Ordnerconfig/unddata/(Archive, Clips, Reports, gelernte Baselines) und, mit oxmysql, diezds_-Tabellen. - Stopp den Server, ersetze den Ordner
zerodev_sentineldurch den neuen (behalte den Ordnernamen) und leg deinen Ordnerdata/zurück. Übertrage die Einstellungen, die du geändert hast, in die neuen Config-Dateien, statt alte Dateien darüberzukopieren. - Starte den Server und lies die Startbox (
sentinel:health).
Lies vor dem Update die Release Notes der neuen Version im Changelog.
18. Deinstallieren
- Entferne die Guard-Zeile aus jeder Resource, die du geschützt hast (
sentinel:guardlistet sie auf), und starte diese Resources neu. Mach das zuerst: Die Guard-Datei ist weg, sobald der Ordner weg ist. - Entferne
ensure zerodev_sentinelund die Zeilensentinel.admin/sentinel.staffaus der server.cfg und stopp dann die Resource. Wennsentinel:lockdownden Entity-Lockdown geändert hat, stellt das Stoppen von Sentinel den ursprünglichen Modus wieder her. - Lösche den Ordner
zerodev_sentinel. Damit wirddata/mit allen Archiven, Clips und Reports entfernt, also kopiere vorher alles heraus, was du behalten willst. - 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.