Docs van ZeroDev Sentinel
ZeroDev Sentinel: installatie en gebruik
ZeroDev Sentinel is een server-side anticheat-resource voor FiveM. Het legt vast wat de server ziet, beoordeelt dat met regels die zichzelf in gewone zinnen uitleggen, en geeft je staff het bewijs voordat iemand gestraft wordt. Het start op het beschermingsniveau Watch: het logt en straft niemand tot jij iets anders kiest. Deze handleiding behandelt versie 0.1.2 op ESX-, QBCore-, Qbox- en standalone-servers.
1. Vereisten
- OneSync aan (
set onesync onin server.cfg). De resource geeft OneSync op als dependency, dus FXServer start hem niet zonder OneSync. - Een FXServer-artifact dat Node 22-scripts draait (elk actueel aanbevolen artifact; het manifest vraagt om
node_version '22'). Node doet het hashen, de compressie, het oplijsten van bestanden en de webroute voor bezwaren. - Optioneel: oxmysql. Daarmee bewaart Sentinel zijn gegevens in je database en maakt het bij de eerste start zijn eigen tabellen aan. Er is geen SQL-bestand om te importeren. Zonder oxmysql staat alles in de eigen key-value-store van de resource.
- Optioneel: pma-voice, om vanuit de console of het browserpaneel mee te luisteren met de voicechat van een speler.
Het framework telt maar voor twee dingen: het geld- en itemspoor (geld en items die geen shop, job of script heeft uitbetaald, beloningslussen, rollbacks) en wie je staff is (ACE-groepen, die elk framework gebruikt). Detectie, cases, clips, de console, het browserpaneel, Discord en de owner desk werken op elk framework hetzelfde.
2. Installatie in vijf minuten
Niets heeft SQL nodig, voor de eerste start hoef je de config niet aan te passen, en er wordt geen andere resource gewijzigd.
Stap 5: Open de owner desk
Druk in de game op F7 (of typ sentinel:console in F8) en open OWNER. Het blad First run toont wat klaar is en wat niet: Discord, clipopslag, je staff en hun rechten. Elke regel heeft één knop. Speel daarna een paar dagen op Watch, lees op het blad Right now wat Sentinel gevonden heeft, en zet het beschermingsniveau op dezelfde desk op Recommended (sectie 6).
3. Je framework
Sentinel vindt het framework en de inventory zelf bij het starten. Er valt niets in te stellen. sentinel:trail in de serverconsole laat zien welke adapter het gekozen heeft.
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- Geld en items: gelezen uit de eigen server-events van ESX (accountgeld toegevoegd, verwijderd of ingesteld; inventory-items toegevoegd of verwijderd; items van speler naar speler gegeven, met beide kanten gekoppeld). Een rollback gebruikt de eigen spelermethodes van ESX en leest het resultaat terug.
- ESX met ox_inventory: geld wordt op dezelfde manier gevolgd. In deze modus melden de itemmethodes van ESX geen resultaat, dus beslist Sentinel alleen op basis van het teruglezen.
- Staff: geef je admins het ACE-recht (sectie 5). De eigen
group.adminvan ESX werkt als ACE-groep wanneer je de regel daarvoor toevoegt.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- Geld: gelezen uit het money-change-event van QBCore (toevoegen, verwijderen en instellen, met de reden). Een verlies en een even grote winst op hetzelfde moment worden als overboeking gekoppeld, omdat QBCore geen eigen overboekingsevent heeft.
- Items: met ox_inventory worden items gevolgd via de hooks daarvan. Met qb-inventory worden itemwijzigingen niet gevolgd (de payload van de listener is niet gedocumenteerd), maar een rollback kan items wel verplaatsen met de gedocumenteerde exports van qb-inventory.
- Staff: de rechtengroepen van QBCore zijn ACE-groepen (
group.admin,group.god). Voeg de ACE-regels uit sectie 5 toe.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- Geld: gelezen uit het money-change-event van Qbox; saldo's worden teruggelezen met de eigen exports van
qbx_core. Geld dat voor een offline personage wordt gewijzigd (via citizen id) vuurt geen event af en staat dus niet in het spoor. - Items: Qbox gebruikt ox_inventory, en Sentinel volgt de items via de hooks van ox_inventory. Items die voor frameworkgeld staan, worden aan het frameworkdeel overgelaten.
- Staff: ACE-groepen, net als op QBCore.
Standalone (geen framework)
set onesync on
ensure zerodev_sentinel- Alles behalve het geld- en itemspoor werkt: beweging, wereld, events, lokaas-events, godmode, state bags, wapens, cases, clips, replay, console, paneel, Discord, rollen en bans.
- Met ox_inventory en zonder framework worden items gevolgd via ox_inventory.
- Opslag: de key-value-store, of oxmysql als je die eerst start.
Controleren of het werkt
sentinel:health: het opstartvak opnieuw. Elke regel is een echte controle; READY betekent dat er niets ontbreekt.sentinel:diag: waarom opslag, adapters en niveau gekozen zijn, elke regel met zijn tellers, en de laatste beslissingen.sentinel:trail: de geld- en itemadapter die in gebruik is, en de laatste wijzigingen van één speler.
In de automatische opslagmodus gebruikt Sentinel oxmysql alleen als oxmysql al gestart is (het wacht tot 15 seconden terwijl oxmysql opstart); start oxmysql later, dan gebruikt het de key-value-store.
4. Eerste start: de eigenaarsplek
De eerste start print een eenmalige code in de serverconsole, 30 minuten geldig (sentinel:owner code print een nieuwe). Join en typ /sentinel owner <code>: de plek wordt aan je account gekoppeld en de code vervalt.
Alleen de eigenaarsplek kan sleutels, het beschermingsniveau, rollen en rechten wijzigen. sentinel:owner reset in de serverconsole maakt de plek vrij als je hem naar een ander account moet verhuizen.
5. Staff en rechten
Op de owner desk, STAFF: kies een online speler, kies een rol, druk op GRANT. Er zitten vier rollen bij:
| Rol | Kan, standaard |
|---|---|
| Support | cases bekijken, meldingen afhandelen, de dienstkaart |
| Moderator | als Support, plus replays, kick en quarantaine |
| Admin | als Moderator, plus onthullen, vrijpleiten, live meekijken, banverzoeken, bezwaren |
| Senior admin | als Admin, plus een ban die meteen ingaat |
De rechten kies jij. Elke rol is een lijst schakelaars die je kunt aanpassen. Maak je eigen rollen vanuit een kopie (bijvoorbeeld "Trial mod"), geef elke rol een andere naam, en geef één persoon een extra schakelaar of neem er een af zonder zijn rol te wijzigen. De schakelaars die als gevaarlijk gemarkeerd zijn (meteen bannen, meeluisteren met voicechat, instellingen, staffbeheer) vragen om een tweede druk. Elke wijziging komt in het stafverslag, dus je ziet altijd wie wat heeft gewijzigd.
ACE werkt nog steeds voor servers die het al gebruiken, en wordt bij elke controle gelezen:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| Recht | Rol die het geeft |
|---|---|
sentinel.admin |
Admin (Senior admin tot de eigenaarsplek geclaimd is) en elk sentinel:*-commando in de game |
sentinel.staff |
Moderator; bewegingsregels behandelen de eigen beweging van een staflid als verklaard |
Een paar commando's (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) zijn als restricted geregistreerd: in de game hebben ze ook command.<name> nodig. De gangbare regel add_ace group.admin command allow dekt dat. De serverconsole kan elk commando uitvoeren.
6. Het beschermingsniveau
Eén schakelaar op de owner desk (OWNER, PROTECTION), daarnaast sentinel:level in de serverconsole en Config.Protection in config/config.lua. Wat je op de desk instelt, wordt opgeslagen en gaat na een herstart voor op de configregel.
- Watch: elke regel kijkt mee en schrijft op wat hij gedaan zou hebben; niemand krijgt een alert en er gebeurt niemand iets. Ondertussen leert Sentinel wat normaal is op je server: de event-observer (frequentie en vorm van elk event) en de joincontrole leren alleen op Watch; de limieten voor entities, gevechten en geld blijven leren van eerlijk spel.
- Recommended: elke regel is live. Staff krijgt alerts met het bewijs, en er wordt een case geopend. Sentinel straft nooit uit zichzelf; je staff beslist.
- Strict: zoals Recommended, en een hoge score zet de speler in quarantaine tot staff ernaar kijkt; een bevinding op bewijsniveau (Tier A: een lokaas-event is afgevuurd, een vervalste request) zet daarnaast een ban in de wachtrij voor de ban wave.
Onder de schakelaar toont de desk elke regel met zijn status en waar die status vandaan komt. Zet daar één regel vast op Live of Shadow als je server dat nodig heeft (bijvoorbeeld een regel die steeds een van je eigen scripts markeert); een state-regel in Config.Rules zet hem vast in het configbestand en gaat voor op de desk.
Een verstandige volgorde:
- Watch voor een paar dagen normaal spel.
- Lees wat de regels gedaan zouden hebben: het blad Right now,
sentinel:diag rules(de kolom shadow telt hoe vaak een regel gescoord zou hebben) ensentinel:diag decisions 100. - Zet elke regel die iemand markeerde die je vertrouwt vast op Shadow, en laat het ons weten.
- Schakel naar Recommended. Staff ziet nu cases en bewijs; niemand wordt automatisch gestraft.
- Strict zodra je vertrouwt op wat Recommended je laat zien.
Op elk moment terug: Watch op de desk, of sentinel:level watch.
7. De staffconsole (F7)
Druk in de game op F7 (of typ sentinel:console in F8). Elke speler kan de toets wijzigen in de instellingen van de game (Key Bindings, FiveM). Esc sluit hem.
- Right now vertelt in gewone woorden wat er op je server gebeurt: wie eruitziet als een bedreiging en waarom, wat bewezen is, wat verklaard is (een revive, de eigen teleport van een script) en wat jou nodig heeft. Elke speler die ertoe doet krijgt één rij: wat hij deed, wat het waarschijnlijk is, hoe zeker Sentinel is (Unusual, Suspicious, Very likely, Proven), wat Sentinel al gedaan heeft en één volgende stap.
- Case files: open cases eerst, elk met de bevinding, het bewijs, schermclips, het zegel (of de hashketen van de case nog klopt) en de knoppen REVEAL, QUARANTINE, CLEAR en BAN (CLEAR en BAN vragen om een tweede druk).
- Dienstkaart: online spelers op een 3D-model van het eiland. Het terrein wordt opgemeten door de game van het eerste staflid en bewaard in
data/map/. - Play replay sluit de console en speelt het incident af in een privéwereld; druk op Backspace om terug te gaan.
- Owner (alleen de eigenaarsplek): First run, Protection, Keys, Staff, Internal affairs en Server check.
Commando's in de game typ je in F8 zonder slash, of in de chat met een slash (/sentinel:diag).
8. Het browserpaneel
Dezelfde desk in een webbrowser, voor als je niet in de game bent:
- op de server-pc:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(de poort is je serverpoort, standaard 30120) - van elders:
http://<server address>:<port>/zerodev_sentinel/panel/, of je eigen HTTPS-adres ervoor
Inloggen. Gebruik een eenmalige code: typ /sentinel panel in de game (de code wordt alleen aan jou getoond, werkt één keer, 5 minuten lang), of voer sentinel:panel <id or account> uit in de serverconsole. Een sessie duurt 8 uur; SIGN OUT en END ALL MY SESSIONS beëindigen hem. Je rol en schakelaars gelden in de browser precies zoals in de game.
Live meekijken. Staff met de schakelaar voor live meekijken kan vanuit het paneel of de console het scherm van elke online speler bekijken. Er wordt niets op schijf bewaard, tenzij je op Save to case drukt.
Meeluisteren. Meeluisteren met de voicechat van die speler vereist de schakelaar voor meeluisteren (standaard alleen de eigenaar) en pma-voice. Het geluid speelt via je eigen game, dus zit in de game op dezelfde server.
Elk live meekijken en elk meeluisteren wordt in het stafverslag en in de case van de speler geschreven, en spelers krijgen bij hun eerste join te horen dat staff mag meekijken en meeluisteren (de opnamemelding, Config.Notice).
9. Cases, quarantaine, kick, ban en bezwaren
Als er iets gevonden wordt, noemt Right now de speler in gewone taal: wat hij deed, hoe zeker Sentinel is en wat het eraan gedaan heeft. Open de case om het bewijs te zien (posities, schermclips verzegeld met SHA-256, een 3D-replay) en gebruik de knoppen:
- REVEAL: toont de identifiers van de speler.
- QUARANTINE: zet de speler uit de echte wereld in een privé routing bucket tot staff ernaar kijkt.
sentinel:release <server id>haalt hem terug. - CLEAR: geen cheat; sluit de case en stopt de ban die ervoor in de wachtrij staat.
- KICK: van de server, met een reden die de speler te lezen krijgt.
- BAN: via de ban wave, met een bezwaarcode.
De ban wave. Bans, ook een BAN die in de console is ingedrukt, worden in de wachtrij gezet voor de ban wave en alleen op Strict uitgevoerd, standaard op een willekeurig moment 2 tot 24 uur later (Config.Actions). sentinel:wave toont ze, sentinel:wave now <account> voert er meteen één uit, sentinel:wave cancel <account> annuleert hem.
Bezwaren. Een gebande speler ziet een bezwaarcode in de weigeringsmelding (8 letters en cijfers). Hij kan niet joinen om bezwaar te maken, dus het bezwaar bereikt je van buiten de game:
- Via je staff. De speler stuurt de code naar je staff (een Discord-ticket, mail). Een staflid legt hem vast met
sentinel:appeal <code> <text>. - Via de webroute. Sentinel antwoordt op het eigen adres van je server:
http://<server address>:<port>/zerodev_sentinel/appeal. Het accepteert alleen een POST met JSON{ "code": "...", "text": "...", "contact": "optional" }(tekst van 10 tot 2000 tekens), dus het is bedoeld voor een formulier op je website, niet als pagina om spelers naartoe te sturen. Elk geaccepteerd verzoek krijgt hetzelfde antwoord, 202 "received", of de code nu bij een ban hoorde of niet. Te veel verzoeken vanaf één adres (5 in 10 minuten) of in totaal (30 per minuut) krijgen 429. Zet achter je eigen HTTPS-reverse proxyset sentinel_http_proxy true, zodat de limieten het adres van de bezoeker tellen.
De weigeringstekst zegt niet waar je bezwaar kunt maken. Vertel het spelers in je regels, of schrijf je eigen tekst met je link in Config.Bans.message (laat de %s staan, die wordt de code), bijvoorbeeld 'You are banned. Appeal at discord.gg/yourserver with code %s'.
Staff beslist in de console of met sentinel:decide <case or code> accept|reject [note]. Accept heft elke actieve ban van dat account of die case op en annuleert een wave-ban in de wachtrij; reject houdt de ban. Een beslissing is definitief en wordt in het caselog geschreven. sentinel:appeals toont de openstaande.
10. Meldingen en internal affairs
Meldingen van spelers. Elke speler kan /report <server id> <what happened> typen om een speler of een staflid te melden. De laatste twee minuten rond beide spelers worden in een case opgeslagen. Staff sluit een melding af als afgehandeld, geen overtreding, geen bewijs of duplicaat. Meldingen over staff gaan alleen naar de eigenaar.
Internal affairs (alleen de eigenaar, op de owner desk): wat elk staflid deed en waar iemand naar moet kijken (toekenningen aan zichzelf, verstoppen tijdens gevechten, bans zonder case, teleports naar spelers). Elke week wordt een eerlijkheidsrapport naar data/reports/ geschreven; sentinel:staff report schrijft het meteen. Niets in het stafverslag straft staff.
11. Een resource beveiligen
Zonder enige setup observeert Sentinel elk event dat spelers naar je scripts kunnen sturen en beoordeelt het de speler. Het kan niet voorkomen dat de handler van een andere resource draait. Om een foute aanroep te stoppen voordat een script draait, voeg je de guard toe aan dat script.
sentinel:audittoont de events van elke gestarte resource die clients kunnen triggeren, ingedeeld naar wat hun handlers doen (bijvoorbeeld een handler die geld geeft met een bedrag dat de client kiest). Gebruik dit om te bepalen welke resources je eerst beveiligt.sentinel:guard <resource>print de regel die je moet toevoegen en de server_scripts van de resource zoals ze er dan uitzien. De guard-regel moet het eerste server script zijn. Het commando print alleen; het wijzigt geen enkel bestand.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Herstart die resource.
sentinel:guard <resource>zegt nu "guarded since ...".sentinel:guardzonder meer toont elke beveiligde resource. - Voeg regels toe met
sentinel:patch. Zolang een resource geen regels heeft, laat de guard elke aanroep door, behalve aanroepen van spelers in quarantaine, die elke guard laat vallen. Voorbeeld: hoogstens 3 aankopen in 10 seconden, een itemnaam van maximaal 32 tekens en een aantal van 1 tot 10; een geweigerde aanroep telt als bewijs ("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}
Schrijf voor een framework-callback callback:<name> als event: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> toont de regels van een resource; sentinel:patch <resource> <event> off verwijdert er één.
De guard bewerkt nooit bestanden en verandert nooit wat een handler ontvangt. Het is gewone, leesbare Lua in guard/guard.lua.
12. Sleutels voor Discord en clipopslag
De makkelijkste manier is de owner desk, KEYS: plak elke waarde en druk op SAVE. Sleutels worden alleen op de server bewaard; de desk en elk antwoord zeggen alleen "set" en tonen een sleutel nooit meer.
| Regel op de desk | Wat het is | Of in server.cfg (gebruik set, nooit setr) |
|---|---|---|
| Discord-bottoken | een bot die je op discord.com/developers hebt gemaakt en op je server hebt uitgenodigd | set sentinel_discord_token "..." |
| Discord-server-ID | klik met rechts op je server, Copy Server ID (ontwikkelaarsmodus aan) | set sentinel_discord_guild "..." |
| ID van het alertkanaal | waar cases worden gepost, met knoppen voor je staff | set sentinel_discord_channel "..." |
| ID van het bezwarenkanaal | waar bezwaren worden gepost | set sentinel_discord_appeals "..." |
| FiveManage-sleutel | een mediasleutel van fivemanage.com; clips worden daarheen geüpload | set sentinel_fivemanage_key "..." |
| Clip-webhook | in plaats van FiveManage: een Discord-webhook die de clips ontvangt | set sentinel_clip_webhook "..." |
| Clipopslag | fivemanage, discord, off of automatic (de eerste die is ingesteld) | set sentinel_clip_storage "..." |
Een sleutel in server.cfg wint van de desk, en de desk meldt dat. Discord-knoppen volgen dezelfde rollen en schakelaars als de console. Zonder een van deze blijven cases en clips op je server (data/) en tonen de console en het paneel ze.
De eenvoudigere webhook-alerts werken nog steeds: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" of sentinel:webhook set <url> in de serverconsole. sentinel:webhook test stuurt een testbericht; sentinel:webhook toont de status zonder ooit de URL te printen; sentinel:webhook clear verwijdert de opgeslagen URL.
13. Wat elke regel vangt
Elke regel schrijft een gewone zin wanneer hij afgaat, met wat hij zag en wat hij uitsloot. Voordat een regel tegen iemand telt, controleert Sentinel de redenen die het zouden verklaren (een respawn, een revive, een actie van staff, een van je eigen scripts die spelers verplaatst of betaalt). Een verklaarde bevinding wordt gelogd en telt nooit mee in de score.
- Tier A is bewijs: iets wat alleen een cheat doet (een lokaas-event dat geen echt script aanroept, een vervalst verzoek).
- Tier B is sterk: een staflid moet ernaar kijken. Op zichzelf opent het alleen een case als twee verschillende families het eens zijn, of als dezelfde zich herhaalt.
- Tier C is zwak: het telt op bij de score en handelt nooit alleen.
Beweging
| Regel | Vangt | Verklaard door | Tier |
|---|---|---|---|
| teleport | Een sprong van meer dan 150 m (of 3x wat mogelijk is) tussen twee metingen | spawn, respawn of revive, wissel van routing bucket, staff, het teleport-event van je script | B |
| foot_speed | Te voet harder rennen dan 12 m/s gedurende 1.5 s, zonder te vallen, zonder ragdoll | spawn, respawn, staff, je script | B |
| air_float | Bewegen terwijl bevroren (noclip); "vallen" zonder naar beneden te komen (fly); snel bewegen via coördinaten terwijl de game zegt dat de speler stilstaat (speedmenu's) | spawn, respawn, staff, je script | B |
| foot_rise | Te voet 3 s lang recht omhoog klimmen, sneller dan 4 m/s | spawn, respawn, staff, je script | B |
| vehicle_speed | Een voertuig boven 1.3x het snelste dat zijn klasse op je server haalt | staff, je script | B |
Wereld
| Regel | Vangt | Verklaard door | Tier |
|---|---|---|---|
| entity_blocked | Een model spawnen dat je hebt geblokkeerd | je scripts die het spawnen | B |
| entity_rate / entity_model_rate | Veel meer entities (of één model) per minuut spawnen dan spelers en scripts doen | je spawnscripts | B |
| entity_untrusted | Entities gemaakt door een client zonder script dat ze spawnt | je spawnscripts | B |
| entity_disguised | Een golf van hetzelfde ambient-pedmodel rond één speler (een menu dat zijn spawns vermomt als verkeer) | spawn, respawn, wissel van bucket | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Explosies die het vastgehouden wapen niet kan maken, te veel, onzichtbare, of ver weg van de speler | de explosies van je scripts | B |
| projectile_weapon / projectile_rate | Projectielen die het wapen niet kan afvuren, of te veel | B | |
| ptfx_rate | Een stortvloed aan particle-effecten (een veelgebruikte crash- en lag-aanval) | B | |
| fire_rate | Branden die sneller worden gestart dan welk wapen ook toelaat | B |
Gevechten
| Regel | Vangt | Tier |
|---|---|---|
| damage_plausibility | Schade boven de mogelijke waarde van het wapen | B |
| hit_range | Treffers van buiten het bereik van het wapen | B |
| shot_rate / kill_rate | Sneller vuren dan het wapen kan; kills per minuut ver boven je server | B |
| silent_aim | Treffers waar de speler niet op richtte, herhaaldelijk | B |
| aim_stats / aim_stats_backed | Aandeel headshots en snap-hoeken ver buiten de spelers van je server, over 30+ gevechten | C (B met een andere familie) |
| esp_los_backed | Herhaald richten op spelers die volgens de getuigen achter muren verborgen zijn | C tot B |
Events en requests
| Regel | Vangt | Tier |
|---|---|---|
| bait_event | Een geplant event aanroepen dat geen echt script gebruikt (cheatmenu's zoeken deze op en vuren ze af) | A |
| bait_statebag / statebag_write | State bags schrijven die alleen de server zou mogen schrijven (jezelf admin maken, godmode-flags), of te grote | A / B |
| events_before_ready / _trap | Events verstuurd voordat de speler zelfs maar gespawnd is (geïnjecteerd vóór het joinen) | B / A |
| event_rate / event_shape | Een event dat veel sneller dan normaal wordt aangeroepen, of met argumenten die anders zijn opgebouwd dan de normale aanroepen op je server | B |
| event_flood | 500+ aanroepen in 10 s; bij de eigen overflow-kick van FiveM worden de meest aangeroepen events vermeld | B |
| guard_rule / guard_hard | Een regel breken die je op een beveiligd event hebt ingesteld (bedrag, frequentie, afstand) | B / A |
Economie
| Regel | Vangt | Tier |
|---|---|---|
| money_nowhere / item_nowhere | Geld of items die geen shop, job of script heeft uitgedeeld (dev-events, gelekte shopverkopen) | B |
| economy_repeat | Een beloning- of job-event dat 10 keer in 30 s is uitbetaald (farmen door het in een lus aan te roepen) | B |
| money_jump / money_rate | Een plotselinge sprong in het saldo of een uitbetalingstempo ver boven je server | B |
| economy_trap | Een geplante beloning opeisen die geen echte job uitbetaalt | A |
| weapon_not_owned | Een wapen vasthouden dat de inventory nooit heeft gegeven | B |
De game van de speler (getuige)
| Regel | Vangt | Tier |
|---|---|---|
| godmode | De server ziet de speler 30 s lang als onkwetsbaar (geen gedeelde safe zone) | B |
| witness_backed | Signalen uit de game die worden gestaafd door het eigen beeld van de server (godmode, onzichtbaarheid, geen collision) | B |
| witness_bait | De game beantwoordt een controle waar hij niets van zou mogen weten | A |
| witness_tamper | Sentinels eigen controles in de game zijn gehookt of gewijzigd | B |
Identiteit en bestanden
| Regel | Vangt | Tier |
|---|---|---|
| ban_fingerprint | Een gebande speler terug op een nieuw account (hardware tokens, identifiers, browserfingerprint) | A / flag |
| young_account | Een gloednieuw account (voegt alleen gewicht toe) | C |
| scanner_error / too_large | Resources die de scriptscanner niet kon lezen, of te grote bestanden die een blik waard zijn | info |
Wat geen enkele regel belooft
Sentinel beoordeelt wat de server kan zien en wat de game van een speler meldt. Het leest geen andere programma's op de pc van een speler, en geen enkele anti-cheat kan beloven dat elke cheat wordt gevangen. Elke bevinding komt met het bewijs erbij, zodat je staff op feiten beslist.
14. Commando's en configuratie
Elk commando staat op de commandopagina en elke configsleutel op de configuratiepagina, allebei gegenereerd uit de resource zelf. Degene die je het meest gebruikt:
| Commando | Wat het doet |
|---|---|
/sentinel owner <code> |
claim de eigenaarsplek in de game met de code uit de console |
/sentinel panel |
een eenmalige inlogcode voor het browserpaneel (alleen staff) |
/report <server id> <what happened> |
elke speler meldt een speler of een staflid |
sentinel:health |
het opstartvak opnieuw |
sentinel:diag |
wat Sentinel besloot en waarom |
sentinel:level watch\|recommended\|strict |
het beschermingsniveau wijzigen en opslaan |
sentinel:wave |
de bans in de wachtrij voor de ban wave |
sentinel:appeals |
de openstaande bezwaren |
sentinel:audit |
de riskante events van elke gestarte resource |
sentinel:guard <resource> |
de regel die een resource bewaakt |
sentinel:advisor |
de FiveM-instellingen die het waard zijn om op je server te wijzigen |
De configbestanden in config/ (config.lua, protection.lua, watch.lua) en de vertalingen in config/locales/ zijn open voor je, net als de framework-adapters in bridge/ en het guard-bestand in guard/. Houd ze geldige Lua en herstart zerodev_sentinel na een wijziging. Voor de eerste start hoef je niets in de config aan te passen.
15. Het opstartvak en de hardening-adviseur
Even nadat de opslag klaar is, print Sentinel een vak in de serverconsole. Een FAIL-regel betekent dat Sentinel niet goed kan werken; een WARN-regel betekent dat het met minder werkt (bijvoorbeeld bewijs zonder digests). Print het op elk moment opnieuw met sentinel:health.
| Regel | Wat het controleert | Als het niet OK is |
|---|---|---|
| Build | De versie en het buildlabel uit fxmanifest.lua. | - |
| OneSync | De convar onesync. Sentinel leest posities, entities en game-events via OneSync. |
zet onesync aan in server.cfg |
| Actieve kopieën | Hoeveel kopieën van de resource gestart zijn, hoe hun map ook heet. Moet 1 zijn. | houd één kopie van Sentinel; stop de andere map |
| Opslag | Welke opslag gekozen is (mysql of kvp) en of die klaar is. | zie sentinel:diag storage |
| Bewijsmap | Een test met schrijven en lezen in data/archive in de resource. | maak de map data/archive aan in de Sentinel-resource en zorg dat de server erin kan schrijven |
| SHA-256 | Of node/util.js antwoordt; het maakt een vingerafdruk van elk stuk bewijs. | bewijs wordt zonder digests opgeslagen; kijk in de console naar een Node-fout |
| Bescherming | Het beschermingsniveau, de modus en waar die vandaan komt. | - |
| Regels | Hoeveel regels live zijn en hoeveel in shadow. | - |
Na het opstartvak print de adviseur de FiveM-instellingen die het waard zijn om op je server te wijzigen (met Config.Advisor.atStartup = false print hij ze alleen bij sentinel:advisor). Per instelling toont hij de huidige waarde, de aanbevolen waarde, wat ze blokkeert, wat ze kan breken en de regel om te kopiëren. Hij leest de waarden alleen; hij wijzigt server.cfg nooit. Test een regel op je server voordat je hem houdt.
16. Talen, en wat er wordt vastgelegd
Teksten voor spelers en staff komen uit config/locales/<code>.lua, 25 talen in deze build. Config.Locale kiest de taal; met Config.GameLanguage = true leest een speler wiens game draait in een taal die GTA aanbiedt Sentinel in die taal zodra hij in game is.
Sentinel houdt per speler ongeveer de laatste twee minuten aan posities en events in het geheugen (Config.Recorder) en schrijft die naar een archief in data/archive/ wanneer er een case opent of staff sentinel:save gebruikt. Tijdens een beoordeling vraagt het de game van de verdachte om schermclips (segmenten van 20 seconden) en slaat die op in data/clips/. Het slaat de identifiers op die FiveM aan de server geeft (een IP-adres wordt vastgelegd, maar standaard nooit gebruikt om een verbinding te weigeren) en, als Discord draait, het Discord-id. Bij hun eerste join krijgt elke speler in zijn eigen taal een korte melding dat de server het spelen vastlegt en dat staff mag meekijken en meeluisteren (Config.Notice = false zet dat uit; vertel het ze dan in je regels). Vermeld het ook in je privacybeleid.
Oude archieven en clips worden in deze build niet automatisch verwijderd: leeg data/archive/ en data/clips/ zelf wanneer je ze niet meer nodig hebt.
Met oxmysql staan de gegevens van Sentinel in de tabellen zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report en zds_trail. Zonder oxmysql staan dezelfde gegevens in de key-value store van de resource (sleutels die beginnen met zds:). Bans worden altijd ook in de key-value store bewaard, zodat ze blijven gelden terwijl de database plat ligt.
17. Updaten
Nieuwe versies verschijnen op hetzelfde Keymaster-asset. Sentinel bewaart zijn bewijs in zijn eigen map, dus voordat je hem vervangt:
- Maak een back-up van de map
zerodev_sentinel: de mappenconfig/endata/(archieven, clips, rapporten, geleerde baselines) en, met oxmysql, dezds_-tabellen. - Stop de server, vervang de map
zerodev_sentineldoor de nieuwe (houd de mapnaam) en zet je mapdata/terug. Zet de instellingen die je had gewijzigd over in de nieuwe configbestanden, in plaats van oude bestanden eroverheen te kopiëren. - Start de server en lees het opstartvak (
sentinel:health).
Lees vóór het updaten de release notes van de nieuwe versie in de changelog.
18. Verwijderen
- Haal de guard-regel weg uit elke resource die je hebt bewaakt (
sentinel:guardtoont ze) en herstart die resources. Doe dit eerst: het guard-bestand is weg zodra de map weg is. - Haal
ensure zerodev_sentinelen de regelssentinel.admin/sentinel.staffuit server.cfg en stop daarna de resource. Alssentinel:lockdownde entity lockdown heeft gewijzigd, zet het stoppen van Sentinel de oorspronkelijke modus terug. - Verwijder de map
zerodev_sentinel. Daarmee verdwijntdata/met alle archieven, clips en rapporten, dus kopieer eerst alles wat je wilt houden. - Met oxmysql: verwijder de
zds_-tabellen uit sectie 16 als je de bans en cases niet meer wilt. De key-value-gegevens blijven in de store van de server onder de naam van de resource en doen niets zonder de resource.
Sentinel schrijft alleen in zijn eigen map, zijn databasetabellen en zijn key-value store. Het past geen andere resources of server.cfg aan.
Veelgestelde vragen
Bant of kickt Sentinel uit zichzelf?
Niet op Watch of Recommended. Het start op Watch, waar het alleen logt wat het gedaan zou hebben. Op Recommended krijgt staff het bewijs en beslist zelf. Alleen op Strict zet een hoge score een speler in quarantaine tot staff kijkt, en zet een bevinding op bewijsniveau een ban in de wachtrij voor de ban wave.
Heb ik een database nodig?
Nee. Met oxmysql bewaart Sentinel zijn gegevens in je database en maakt het bij de eerste start zijn eigen tabellen aan; er is geen SQL-bestand om te importeren. Zonder oxmysql staat alles in de eigen key-value store van de resource.
Werkt het op QBCore en Qbox?
Ja. Detectie, cases, clips, de console, het browserpaneel, Discord en de owner desk zijn op elk framework hetzelfde. Het geld- en itemspoor heeft een eigen adapter voor ESX, QBCore, Qbox en ox_inventory.
Hoe geef ik mijn admins toegang?
Op de owner desk, STAFF: kies een online speler, kies een rol, druk op GRANT. Of blijf ACE gebruiken: sentinel.admin geeft Admin en sentinel.staff geeft Moderator.
Kan een gebande speler bezwaar maken?
Ja. De weigeringsmelding toont een bezwaarcode. De speler stuurt die naar je staff, die hem vastlegt met sentinel:appeal, of je website stuurt hem naar de appeal-route van Sentinel. Staff accepteert of weigert het bezwaar in de console of met sentinel:decide.
Kan het cheatprogramma's op de pc van een speler zien?
Nee. Sentinel beoordeelt wat de server kan zien en wat de game van een speler meldt. Het leest geen andere programma's op de pc van een speler.
Is meeluisteren met voicechat klaar?
Het heeft pma-voice en de luisterschakelaar nodig (standaard alleen voor de eigenaar), en speelt af via je eigen game.
Wat zien spelers?
Bij hun eerste join een korte melding in hun taal dat de server het spelen vastlegt en dat staff mag meekijken en meeluisteren (Config.Notice). Voor een eerlijke speler verandert er verder niets.