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.

Voor ZeroDev Sentinel 0.1.223 min lezenBijgewerkt

1. Vereisten

  • OneSync aan (set onesync on in 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 1: Zet de map in resources

Kopieer de map zerodev_sentinel naar je map resources. Houd precies die mapnaam aan: het guard-bestand rapporteert aan zerodev_sentinel, en sentinel:guard waarschuwt je als de map anders heet.

Stap 2: Zet hem in server.cfg

Start hem na oxmysql en je framework, zodat de opslag en het geldspoor ze bij de start vinden. De precieze volgorde voor jouw framework staat in sectie 3.

Stap 3: Start de server

De console print een opstartvak en een eenmalige eigenaarscode. Elke regel van het vak is een echte controle; de laatste regel zegt READY, of NOT READY met het aantal problemen (sectie 15).

Stap 4: Claim de eigenaarsplek

Join de server en typ /sentinel owner <code> in de chat. Nu heb jij de eigenaarsplek (sectie 4).

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

server.cfg
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.admin van ESX werkt als ACE-groep wanneer je de regel daarvoor toevoegt.

QBCore

server.cfg
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

server.cfg
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)

server.cfg
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:

server.cfg
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:

  1. Watch voor een paar dagen normaal spel.
  2. 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) en sentinel:diag decisions 100.
  3. Zet elke regel die iemand markeerde die je vertrouwt vast op Shadow, en laat het ons weten.
  4. Schakel naar Recommended. Staff ziet nu cases en bewijs; niemand wordt automatisch gestraft.
  5. 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:

  1. 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>.
  2. 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 proxy set 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.

  1. sentinel:audit toont 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.
  2. 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' }

  1. Herstart die resource. sentinel:guard <resource> zegt nu "guarded since ...". sentinel:guard zonder meer toont elke beveiligde resource.
  2. 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:

  1. Maak een back-up van de map zerodev_sentinel: de mappen config/ en data/ (archieven, clips, rapporten, geleerde baselines) en, met oxmysql, de zds_-tabellen.
  2. Stop de server, vervang de map zerodev_sentinel door de nieuwe (houd de mapnaam) en zet je map data/ terug. Zet de instellingen die je had gewijzigd over in de nieuwe configbestanden, in plaats van oude bestanden eroverheen te kopiëren.
  3. 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

  1. Haal de guard-regel weg uit elke resource die je hebt bewaakt (sentinel:guard toont ze) en herstart die resources. Doe dit eerst: het guard-bestand is weg zodra de map weg is.
  2. Haal ensure zerodev_sentinel en de regels sentinel.admin / sentinel.staff uit server.cfg en stop daarna de resource. Als sentinel:lockdown de entity lockdown heeft gewijzigd, zet het stoppen van Sentinel de oorspronkelijke modus terug.
  3. Verwijder de map zerodev_sentinel. Daarmee verdwijnt data/ met alle archieven, clips en rapporten, dus kopieer eerst alles wat je wilt houden.
  4. 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.

Vertaald uit het Engels. Als iets hier afwijkt van de Engelse pagina, dan heeft de Engelse pagina gelijk. English