ZeroDev Sentinel-dokumentasjon
ZeroDev Sentinel: installasjon og bruk
ZeroDev Sentinel er en serverside anti-cheat-resource for FiveM. Den registrerer det serveren ser, vurderer det med regler som forklarer seg selv i klare setninger, og gir staffen din bevisene før noen blir straffet. Den starter på beskyttelsesnivået Watch: den logger og straffer ingen før du velger noe annet. Denne guiden dekker versjon 0.1.2 på ESX-, QBCore-, Qbox- og standalone-servere.
1. Krav
- OneSync på (
set onesync oni server.cfg). Resourcen oppgir OneSync som avhengighet, så FXServer starter den ikke uten OneSync. - Et FXServer-artifact som kjører Node 22-skript (et hvilket som helst gjeldende anbefalt artifact; manifestet ber om
node_version '22'). Node tar seg av hashing, komprimering, fillister og nettruten for anker. - Valgfritt: oxmysql. Med det lagrer Sentinel dataene sine i databasen din og lager sine egne tabeller ved første oppstart. Det finnes ingen SQL-fil å importere. Uten det ligger alt i resourcens egen key-value store.
- Valgfritt: pma-voice, for å lytte på en spillers voice chat fra konsollen eller nettleserpanelet.
Frameworket betyr bare noe for to ting: sporet av penger og items (penger og items som ingen butikk, jobb eller skript har betalt ut, belønningsløkker, rollbacks) og hvem staffen din er (ACE-grupper, som alle frameworks bruker). Deteksjon, saker, klipp, konsollen, nettleserpanelet, Discord og eierpulten virker likt på alle frameworks.
2. Installasjon på fem minutter
Ingenting trenger SQL, du trenger ikke endre config før første oppstart, og ingen andre resources blir endret.
Trinn 5: Åpne eierpulten
Trykk F7 i spillet (eller skriv sentinel:console i F8) og åpne OWNER. Arket First run viser hva som er gjort og hva som ikke er det: Discord, klipplagring, staffen din og tillatelsene deres. Hver linje har én knapp. Spill så noen dager på Watch, les hva Sentinel fant på arket Right now, og bytt beskyttelsesnivået til Recommended på den samme pulten (seksjon 6).
3. Frameworket ditt
Sentinel finner frameworket og inventory selv når den starter. Det er ingenting å stille inn. sentinel:trail i serverkonsollen viser hvilken adapter den valgte.
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- Penger og items: leses fra ESX sine egne server events (kontopenger lagt til, fjernet eller satt; inventory-items lagt til eller fjernet; items gitt fra spiller til spiller, med begge sider koblet sammen). Rollback bruker ESX sine egne spillermetoder og leser resultatet tilbake.
- ESX med ox_inventory: penger følges på samme måte. I denne modusen returnerer ikke ESX sine item-metoder noe resultat, så Sentinel avgjør bare ut fra tilbakelesingen.
- Staff: gi adminene dine ACE-tillatelsen (seksjon 5). ESX sin egen
group.adminfungerer som ACE-gruppe når du legger til linjen for den.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- Penger: leses fra QBCore sitt event for pengeendringer (legg til, fjern og sett, med årsak). Et tap og en like stor gevinst i samme øyeblikk kobles som en overføring, fordi QBCore ikke har et eget overførings-event.
- Items: med ox_inventory følges items gjennom hookene dens. Med qb-inventory følges ikke item-endringer (payloaden til listeneren er ikke dokumentert), men en rollback kan likevel flytte items med de dokumenterte exportene til qb-inventory.
- Staff: tillatelsesgruppene i QBCore er ACE-grupper (
group.admin,group.god). Legg til ACE-linjene i seksjon 5.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- Penger: leses fra Qbox sitt event for pengeendringer; saldoer leses tilbake med
qbx_coresine egne exports. Penger endret for en karakter som er offline (via citizen id) utløser ikke noe event, så de er ikke i sporet. - Items: Qbox bruker ox_inventory, og Sentinel følger items gjennom hookene til ox_inventory. Items som står for framework-penger, overlates til framework-delen.
- Staff: ACE-grupper, som på QBCore.
Standalone (uten framework)
set onesync on
ensure zerodev_sentinel- Alt unntatt sporet av penger og items virker: bevegelse, verden, events, agn-events, godmode, state bags, våpen, saker, klipp, replay, konsoll, panel, Discord, roller og bans.
- Med ox_inventory og uten framework følges items gjennom ox_inventory.
- Lagring: key-value store, eller oxmysql hvis du starter det først.
Sjekk at det virker
sentinel:health: oppstartsboksen igjen. Hver rad er en ekte sjekk; READY betyr at ingenting mangler.sentinel:diag: hvorfor lagring, adaptere og nivå ble valgt, hver regel med tellerne sine, og de siste avgjørelsene.sentinel:trail: adapteren for penger og items som er i bruk, og de siste endringene for én spiller.
I automatisk lagringsmodus bruker Sentinel oxmysql bare når oxmysql allerede er startet (den venter opptil 15 sekunder mens oxmysql starter); starter oxmysql senere, bruker den key-value store.
4. Første oppstart: eierplassen
Første oppstart skriver ut en engangskode i serverkonsollen, gyldig i 30 minutter (sentinel:owner code skriver ut en ny). Koble til og skriv /sentinel owner <code>: plassen bindes til kontoen din, og koden slutter å gjelde.
Bare eierplassen kan endre nøkler, beskyttelsesnivå, roller og tillatelser. sentinel:owner reset i serverkonsollen frigjør plassen hvis du må flytte den til en annen konto.
5. Staff og tillatelser
På eierpulten, STAFF: velg en spiller som er online, velg en rolle, trykk GRANT. Fire roller følger med:
| Rolle | Kan, fra start |
|---|---|
| Support | se saker, behandle rapporter, vaktkartet |
| Moderator | som Support, pluss replays, kick og karantene |
| Admin | som Moderator, pluss avsløring, frikjenning, direktevisning, ban-forespørsler, anker |
| Senior admin | som Admin, pluss en ban som gjelder med en gang |
Du velger tillatelsene selv. Hver rolle er en liste med brytere du kan endre. Lag dine egne roller fra en kopi (for eksempel "Trial mod"), gi nytt navn til hvilken som helst rolle, og gi én person en ekstra bryter eller ta en fra dem uten å endre rollen deres. Brytere merket som farlige (ban med en gang, lytt på voice chat, innstillinger, staff-styring) krever et ekstra trykk. Hver endring skrives i staff-loggen, så du alltid kan se hvem som endret hva.
ACE virker fortsatt for servere som allerede bruker det, og leses ved hver sjekk:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| Tillatelse | Rolle den gir |
|---|---|
sentinel.admin |
Admin (Senior admin til eierplassen er tatt) og alle sentinel:*-kommandoer i spillet |
sentinel.staff |
Moderator; bevegelsesregler regner et staff-medlems egen bevegelse som forklart |
Noen få kommandoer (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) er registrert som begrensede: i spillet trenger de også command.<name>. Den vanlige linjen add_ace group.admin command allow dekker det. Serverkonsollen kan kjøre alle kommandoer.
6. Beskyttelsesnivået
Én bryter på eierpulten (OWNER, PROTECTION), i tillegg til sentinel:level i serverkonsollen og Config.Protection i config/config.lua. Det du setter på pulten, lagres og går foran config-linjen etter en omstart.
- Watch: hver regel følger med og skriver ned hva den ville gjort; ingen blir varslet, og ingenting skjer med noen. I mellomtiden lærer Sentinel hva som er normalt på serveren din: event-observatøren (hyppighet og form for hvert event) og join-sjekken lærer bare på Watch; grenser for entities, kamp og penger fortsetter å lære av rent spill.
- Recommended: alle regler er live. Staff får varsler med bevisene, og en sak åpnes. Sentinel straffer aldri på egen hånd; staffen din bestemmer.
- Strict: som Recommended, og en høy score setter spilleren i karantene til staff ser på det; et funn på bevisnivå (Tier A: et agn-event ble utløst, en forfalsket forespørsel) setter i tillegg en ban i kø for ban wave.
Under bryteren viser pulten hver regel med tilstand og hvor tilstanden kommer fra. Lås en enkelt regel til Live eller Shadow der hvis serveren din trenger det (for eksempel en regel som stadig markerer et av dine egne skript); en state-linje i Config.Rules låser den i config-filen og går foran pulten.
En fornuftig rekkefølge:
- Watch i noen dager med vanlig spilling.
- Les hva reglene ville gjort: arket Right now,
sentinel:diag rules(kolonnen shadow teller hvor mange ganger en regel ville gitt poeng) ogsentinel:diag decisions 100. - Lås hver regel som markerte noen du stoler på, til Shadow, og si fra til oss.
- Bytt til Recommended. Staff ser nå saker og bevis; ingen blir straffet automatisk.
- Strict når du stoler på det Recommended viser deg.
Gå tilbake når som helst: Watch på pulten, eller sentinel:level watch.
7. Staffkonsollen (F7)
Trykk F7 i spillet (eller skriv sentinel:console i F8). Hver spiller kan endre tasten i spillets innstillinger (Key Bindings, FiveM). Esc lukker den.
- Right now sier med vanlige ord hva som skjer på serveren din: hvem som ser ut som en trussel og hvorfor, hva som er bevist, hva som er forklart (en revive, en teleport fra et av dine egne scripts), og hva som trenger deg. Hver spiller som betyr noe, får én rad: hva de gjorde, hva det sannsynligvis er, hvor sikker Sentinel er (Unusual, Suspicious, Very likely, Proven), hva Sentinel allerede har gjort, og ett neste steg.
- Saksmapper: åpne saker først, hver med funnet, bevisene, skjermklipp, seglet (om sakens hash-kjede fortsatt kan verifiseres) og tastene REVEAL, QUARANTINE, CLEAR og BAN (CLEAR og BAN krever et ekstra trykk).
- Vaktkart: påloggede spillere på en 3D-modell av øya. Terrenget måles av spillet til det første staff-medlemmet og lagres i
data/map/. - Play replay lukker konsollen og spiller av hendelsen i en privat verden; trykk Backspace for å gå tilbake.
- Eier (bare eierplassen): First run, Protection, Keys, Staff, Internal affairs og Server check.
Kommandoer i spillet skrives i F8 uten skråstrek, eller i chatten med skråstrek (/sentinel:diag).
8. Nettleserpanelet
Den samme pulten i en nettleser, for når du ikke er i spillet:
- på server-PC-en:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(porten er serverporten din, 30120 som standard) - fra et annet sted:
http://<server address>:<port>/zerodev_sentinel/panel/, eller din egen HTTPS-adresse foran den
Logge inn. Bruk en engangskode: skriv /sentinel panel i spillet (koden vises bare for deg, virker én gang, i 5 minutter), eller kjør sentinel:panel <id or account> i serverkonsollen. En økt varer i 8 timer; SIGN OUT og END ALL MY SESSIONS avslutter den. Rollen og bryterne dine gjelder i nettleseren akkurat som i spillet.
Live-visning. Staff med bryteren for live-visning kan se skjermen til hvilken som helst pålogget spiller fra panelet eller konsollen. Ingenting lagres på disk med mindre du trykker Save to case.
Lytting. Å lytte til voice chatten til den spilleren krever bryteren for lytting (bare eieren som standard) og pma-voice. Lyden spilles gjennom ditt eget spill, så vær i spillet på den samme serveren.
Hver live-visning og hver lytting skrives i staff-loggen og i spillerens sak, og spillere får beskjed første gang de joiner om at staff kan se og lytte (opptaksvarselet, Config.Notice).
9. Saker, karantene, kick, ban og anker
Når noe blir funnet, navngir Right now spilleren i klartekst: hva de gjorde, hvor sikker Sentinel er, og hva den gjorde med det. Åpne saken for å se bevisene (posisjoner, skjermklipp forseglet med SHA-256, en 3D-replay), og bruk tastene:
- REVEAL: viser spillerens identifiers.
- QUARANTINE: flytter spilleren ut av den ekte verdenen til en privat routing bucket til staff ser på det.
sentinel:release <server id>henter dem tilbake. - CLEAR: ikke juks; lukker saken og stopper ban-en som står i kø.
- KICK: ut av serveren, med en begrunnelse spilleren leser.
- BAN: gjennom ban wave, med en ankekode.
Ban wave. Bans, også en BAN trykket i konsollen, settes i kø for ban wave og utføres bare på Strict, som standard på et tilfeldig tidspunkt 2 til 24 timer senere (Config.Actions). sentinel:wave lister dem opp, sentinel:wave now <account> utfører én med en gang, sentinel:wave cancel <account> avbryter den.
Anker. En bannet spiller ser en ankekode i avvisningsmeldingen (8 bokstaver og sifre). De kan ikke joine for å anke, så anken når deg utenfor spillet:
- Gjennom staffen din. Spilleren sender koden til staffen din (en Discord-ticket, en e-post). Et staff-medlem registrerer den med
sentinel:appeal <code> <text>. - Gjennom web-ruten. Sentinel svarer på serverens egen adresse:
http://<server address>:<port>/zerodev_sentinel/appeal. Den godtar bare en POST med JSON{ "code": "...", "text": "...", "contact": "optional" }(tekst på 10 til 2000 tegn), så den er ment for et skjema på nettsiden din, ikke en side du sender spillere til. Hver godtatt forespørsel får det samme svaret, 202 "received", uansett om koden passet til en ban eller ikke. For mange forespørsler fra én adresse (5 på 10 minutter) eller totalt (30 i minuttet) får 429. Bak din egen HTTPS reverse proxy setter duset sentinel_http_proxy true, slik at grensene teller adressen til den besøkende.
Avvisningsteksten sier ikke hvor man anker. Fortell det til spillerne i reglene dine, eller skriv din egen tekst med lenken din i Config.Bans.message (behold %s, den blir til koden), for eksempel 'You are banned. Appeal at discord.gg/yourserver with code %s'.
Staff bestemmer i konsollen eller med sentinel:decide <case or code> accept|reject [note]. Accept opphever alle aktive bans for den kontoen eller saken og avbryter en wave-ban i kø; reject beholder ban-en. En avgjørelse er endelig og skrives i saksloggen. sentinel:appeals lister opp de åpne.
10. Rapporter og internkontroll
Spillerrapporter. Hvilken som helst spiller skriver /report <server id> <what happened> for å rapportere en spiller eller et staff-medlem. De siste to minuttene rundt begge spillerne lagres i en sak. Staff lukker en rapport som håndtert, ingen regelbrudd, ingen bevis eller duplikat. Rapporter om staff går bare til eieren.
Internkontroll (bare eieren, på eierpulten): hva hvert staff-medlem har gjort, og hva som bør sjekkes (tildelinger til seg selv, å gjemme seg i kamp, bans uten sak, teleports til spillere). En ukentlig rettferdighetsrapport skrives til data/reports/; sentinel:staff report skriver den nå. Ingenting i staff-loggen straffer staff.
11. Beskytte en resource
Uten noe oppsett følger Sentinel med på hvert event spillere kan sende til scriptene dine, og vurderer spilleren. Den kan ikke hindre handleren til en annen resource i å kjøre. For å stoppe et dårlig kall før et script kjører, legger du guarden til i det scriptet.
sentinel:auditlister opp eventene i hver startet resource som klienter kan utløse, gradert etter hva handlerne deres gjør (for eksempel en handler som gir penger med et beløp klienten velger). Bruk den til å bestemme hvilke resources du skal beskytte først.sentinel:guard <resource>skriver ut linjen du skal legge til, og resourcens server_scripts slik de da ville sett ut. Guard-linjen må være det første server scriptet. Kommandoen bare skriver ut; den endrer ingen filer.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Start den resourcen på nytt.
sentinel:guard <resource>sier nå "guarded since ...".sentinel:guardalene lister opp alle beskyttede resources. - Legg til regler med
sentinel:patch. Til en resource har regler, slipper guarden dens gjennom alle kall, unntatt kall fra spillere i karantene, som hver guard forkaster. Eksempel: høyst 3 kjøp på 10 sekunder, et item-navn på opptil 32 tegn og et antall fra 1 til 10; et avvist kall teller som bevis ("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}
For et framework-callback skriver du callback:<name> som event: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> lister opp reglene til en resource; sentinel:patch <resource> <event> off fjerner én.
Guarden redigerer aldri filer og endrer aldri det en handler mottar. Den er enkel, lesbar Lua i guard/guard.lua.
12. Nøkler for Discord og klipplagring
Det enkleste er eierpulten, KEYS: lim inn hver verdi og trykk SAVE. Nøkler lagres bare på serveren; pulten og hvert svar sier bare "set" og viser aldri en nøkkel igjen.
| Linje på pulten | Hva det er | Eller i server.cfg (bruk set, aldri setr) |
|---|---|---|
| Discord-bot-token | en bot du har laget på discord.com/developers og invitert til serveren din | set sentinel_discord_token "..." |
| Discord-server-id | høyreklikk på serveren din, Copy Server ID (utviklermodus på) | set sentinel_discord_guild "..." |
| Id for varslingskanal | der saker blir postet, med knapper for staffen din | set sentinel_discord_channel "..." |
| Id for ankekanal | der anker blir postet | set sentinel_discord_appeals "..." |
| FiveManage-nøkkel | en medienøkkel fra fivemanage.com; klipp lastes opp dit | set sentinel_fivemanage_key "..." |
| Klipp-webhook | i stedet for FiveManage: en Discord-webhook som tar imot klippene | set sentinel_clip_webhook "..." |
| Klipplagring | fivemanage, discord, off eller automatic (den første som er satt) | set sentinel_clip_storage "..." |
En nøkkel i server.cfg vinner over pulten, og pulten sier fra om det. Discord-knappene følger de samme rollene og bryterne som konsollen. Uten noen av disse blir saker og klipp på serveren din (data/), og konsollen og panelet viser dem.
De enklere webhook-varslene virker fortsatt: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" eller sentinel:webhook set <url> i serverkonsollen. sentinel:webhook test sender en testmelding; sentinel:webhook viser status uten noen gang å skrive ut URL-en; sentinel:webhook clear fjerner den lagrede.
13. Hva hver regel fanger
Hver regel skriver en klar setning når den slår ut, om hva den så og hva den utelukket. Før en regel teller mot noen, sjekker Sentinel grunnene som kunne forklare det (en respawn, en revive, en staff-handling, et av dine egne scripts som flytter eller betaler spillere). Et forklart funn logges og gir aldri poeng.
- Tier A er bevis: noe bare juks gjør (et lokke-event som ingen ekte script kaller, en forfalsket forespørsel).
- Tier B er sterk: et staff-medlem bør se på det. Alene åpner den bare en sak når to ulike familier er enige, eller den samme gjentar seg.
- Tier C er svak: den legger til scoren og handler aldri alene.
Bevegelse
| Regel | Fanger | Forklares av | Tier |
|---|---|---|---|
| teleport | Et hopp på over 150 m (eller 3x det mulige) mellom to målinger | spawn, respawn eller revive, bytte av routing bucket, staff, teleport-eventet til scriptet ditt | B |
| foot_speed | Løping over 12 m/s i 1.5 s til fots, uten å falle, uten ragdoll | spawn, respawn, staff, scriptet ditt | B |
| air_float | Bevegelse mens spilleren er frosset (noclip); "faller" uten å komme ned (fly); rask bevegelse etter koordinater mens spillet sier at spilleren står stille (speed-menyer) | spawn, respawn, staff, scriptet ditt | B |
| foot_rise | Klatring rett opp raskere enn 4 m/s til fots i 3 s | spawn, respawn, staff, scriptet ditt | B |
| vehicle_speed | Et kjøretøy over 1.3x det raskeste klassen når på serveren din | staff, scriptet ditt | B |
Verden
| Regel | Fanger | Forklares av | Tier |
|---|---|---|---|
| entity_blocked | Spawning av en modell du har blokkert | scriptene dine som spawner den | B |
| entity_rate / entity_model_rate | Spawning av langt flere entities (eller én modell) i minuttet enn spillere og scripts gjør | spawn-scriptene dine | B |
| entity_untrusted | Entities laget av en klient uten et script som spawner dem | spawn-scriptene dine | B |
| entity_disguised | En byge av den samme ambient ped-modellen rundt én spiller (en meny som forkler spawnene sine som trafikk) | spawn, respawn, bytte av bucket | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Eksplosjoner våpenet spilleren holder ikke kan lage, for mange, usynlige eller langt unna spilleren | eksplosjonene til scriptene dine | B |
| projectile_weapon / projectile_rate | Prosjektiler våpenet ikke kan skyte, eller for mange | B | |
| ptfx_rate | Floods av partikkeleffekter (et vanlig crash- og lag-angrep) | B | |
| fire_rate | Branner startet raskere enn noe våpen tillater | B |
Kamp
| Regel | Fanger | Tier |
|---|---|---|
| damage_plausibility | Skade over våpenets mulige verdi | B |
| hit_range | Treff fra lenger unna enn våpenets rekkevidde | B |
| shot_rate / kill_rate | Skyting raskere enn våpenet; kills i minuttet langt over det normale på serveren din | B |
| silent_aim | Treff der spilleren ikke siktet, gjentatte ganger | B |
| aim_stats / aim_stats_backed | Andel headshots og snap-vinkler langt utenfor spillerne på serveren din over 30+ kamper | C (B med en annen familie) |
| esp_los_backed | Gjentatt sikting på spillere som vitnene melder er skjult bak vegger | C til B |
Events og forespørsler
| Regel | Fanger | Tier |
|---|---|---|
| bait_event | Kall på et utplassert event som ingen ekte script bruker (juksemenyer leter etter og utløser disse) | A |
| bait_statebag / statebag_write | Skriving av state bags som bare serveren skal skrive (gjøre seg selv til admin, godmode-flagg), eller altfor store | A / B |
| events_before_ready / _trap | Events sendt før spilleren i det hele tatt har spawnet (injisert før join) | B / A |
| event_rate / event_shape | Et event kalt langt raskere enn normalt, eller med argumenter som er bygd annerledes enn de vanlige kallene på serveren din | B |
| event_flood | 500+ kall på 10 s; ved FiveMs eget overflow-kick listes de hyppigste eventene opp | B |
| guard_rule / guard_hard | Brudd på en regel du har satt på et beskyttet event (beløp, frekvens, avstand) | B / A |
Økonomi
| Regel | Fanger | Tier |
|---|---|---|
| money_nowhere / item_nowhere | Penger eller items som ingen butikk, jobb eller script har delt ut (dev-events, lekkede butikksalg) | B |
| economy_repeat | Et belønnings- eller jobb-event utbetalt 10 ganger på 30 s (farming ved å kalle det i en løkke) | B |
| money_jump / money_rate | Et plutselig hopp i saldoen eller en inntjeningstakt langt over det normale på serveren din | B |
| economy_trap | Innløsning av en utplassert belønning som ingen ekte jobb betaler ut | A |
| weapon_not_owned | Å holde et våpen inventory aldri har gitt | B |
Spillerens spill (vitne)
| Regel | Fanger | Tier |
|---|---|---|
| godmode | Serveren ser spilleren som uskadelig i 30 s (ikke en felles safe zone) | B |
| witness_backed | Tegn fra spillet som støttes av serverens eget bilde (godmode, usynlighet, ingen kollisjon) | B |
| witness_bait | Spillet svarer på en sjekk det ikke burde kjenne til | A |
| witness_tamper | Sentinels egne sjekker i spillet er hooket eller endret | B |
Identitet og filer
| Regel | Fanger | Tier |
|---|---|---|
| ban_fingerprint | En bannet spiller tilbake på en ny konto (hardware tokens, identifiers, nettleser-fingerprint) | A / flag |
| young_account | En helt ny konto (legger bare til vekt) | C |
| scanner_error / too_large | Resources som script-skanneren ikke kunne lese, eller altfor store filer som er verdt en titt | info |
Hva ingen regel lover
Sentinel vurderer det serveren kan se og det en spillers spill rapporterer. Den leser ikke andre programmer på PC-en til en spiller, og ingen anti-cheat kan love at hvert eneste juks blir fanget. Hvert funn kommer med bevisene sine, så staffen din bestemmer ut fra fakta.
14. Kommandoer og konfigurasjon
Alle kommandoer står på kommandosiden og alle config-nøkler på konfigurasjonssiden, begge generert direkte fra resourcen. De du bruker mest:
| Kommando | Hva den gjør |
|---|---|
/sentinel owner <code> |
ta eierplassen i spillet med koden fra konsollen |
/sentinel panel |
en engangskode for å logge inn på nettleserpanelet (kun staff) |
/report <server id> <what happened> |
enhver spiller rapporterer en spiller eller et staff-medlem |
sentinel:health |
oppstartsboksen igjen |
sentinel:diag |
hva Sentinel bestemte og hvorfor |
sentinel:level watch\|recommended\|strict |
endre beskyttelsesnivået og lagre det |
sentinel:wave |
bansene som står i kø til ban wave |
sentinel:appeals |
de åpne ankene |
sentinel:audit |
de risikable eventene i hver startet resource |
sentinel:guard <resource> |
linjen som beskytter en resource |
sentinel:advisor |
FiveM-innstillingene det er verdt å endre på serveren din |
Config-filene i config/ (config.lua, protection.lua, watch.lua) og oversettelsene i config/locales/ er åpne for deg, det samme er framework-adapterne i bridge/ og guard-filen i guard/. Hold dem som gyldig Lua, og start zerodev_sentinel på nytt etter en endring. Første start krever ingen endringer i config.
15. Oppstartsboksen og herdingsrådgiveren
Et øyeblikk etter at lagringen er klar, skriver Sentinel en boks i serverkonsollen. En FAIL-rad betyr at Sentinel ikke kan fungere skikkelig; en WARN-rad betyr at den fungerer med mindre (for eksempel bevis uten digests). Skriv den ut igjen når som helst med sentinel:health.
| Rad | Hva den sjekker | Når den ikke er OK |
|---|---|---|
| Build | Versjonen og build-merket fra fxmanifest.lua. | - |
| OneSync | Convaren onesync. Sentinel leser posisjoner, entities og game events gjennom OneSync. |
sett onesync til on i server.cfg |
| Kopier som kjører | Hvor mange kopier av resourcen som er startet, uansett hva mappen heter. Må være 1. | behold én kopi av Sentinel; stopp den andre mappen |
| Lagring | Hvilken lagring som ble valgt (mysql eller kvp), og om den er klar. | se sentinel:diag storage |
| Bevismappe | En testskriving og -lesing i data/archive inne i resourcen. | opprett mappen data/archive inne i Sentinel-resourcen, og sørg for at serveren kan skrive til den |
| SHA-256 | Om node/util.js svarer; den lager et fingeravtrykk av hvert bevis. | bevis lagres uten digests; se etter en Node-feil i konsollen |
| Beskyttelse | Beskyttelsesnivået, modusen og hvor det kom fra. | - |
| Regler | Hvor mange regler som er Live, og hvor mange som er i Shadow. | - |
Etter oppstartsboksen skriver rådgiveren ut FiveM-innstillingene det er verdt å endre på serveren din (med Config.Advisor.atStartup = false skrives de bare ut ved sentinel:advisor). For hver innstilling viser den nåværende verdi, anbefalt verdi, hva den blokkerer, hva den kan ødelegge, og linjen du kan kopiere. Den leser bare verdiene; den endrer aldri server.cfg. Test en linje på serveren din før du beholder den.
16. Språk, og hva som registreres
Tekster til spillere og staff kommer fra config/locales/<code>.lua, 25 språk i dette buildet. Config.Locale velger språket; med Config.GameLanguage = true leser en spiller hvis spill kjører på et språk GTA tilbyr, Sentinel på det språket så snart hen er i spillet.
Sentinel holder i minnet, for hver spiller, omtrent de siste to minuttene med posisjoner og events (Config.Recorder), og skriver dem til et arkiv i data/archive/ når en sak åpnes eller staff bruker sentinel:save. Under en gjennomgang ber den spillet til den mistenkte om skjermklipp (segmenter på 20 sekunder) og lagrer dem i data/clips/. Den lagrer identifikatorene FiveM gir serveren (en IP-adresse registreres, men brukes som standard aldri til å avvise en tilkobling) og, når Discord kjører, Discord-id-en. Ved første join får hver spiller en kort melding på sitt språk om at serveren tar opp spillingen, og at staff kan se på og lytte (Config.Notice = false slår den av; si det da i reglene dine). Nevn det også i personvernerklæringen din.
Gamle arkiver og klipp slettes ikke automatisk i dette buildet: tøm data/archive/ og data/clips/ selv når du ikke trenger dem lenger.
Med oxmysql ligger Sentinels data i tabellene zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report og zds_trail. Uten oxmysql ligger de samme dataene i resourcens key-value-lager (nøkler som starter med zds:). Bans speiles alltid til key-value-lageret, så de håndheves mens databasen er nede.
17. Oppdatering
Nye versjoner publiseres på det samme Keymaster-assetet. Sentinel holder bevisene sine i sin egen mappe, så før du bytter den ut:
- Ta backup av mappen
zerodev_sentinelsine mapperconfig/ogdata/(arkiver, klipp, rapporter, lærte baselines) og, med oxmysql,zds_-tabellene. - Stopp serveren, erstatt mappen
zerodev_sentinelmed den nye (behold mappenavnet), og leggdata/-mappen din tilbake. Flytt innstillingene du har endret, over i de nye config-filene i stedet for å kopiere gamle filer over dem. - Start serveren og les oppstartsboksen (
sentinel:health).
Les release notes for den nye versjonen i changelogen før du oppdaterer.
18. Avinstallering
- Fjern guard-linjen fra hver resource du har beskyttet (
sentinel:guardlister dem), og start de resourcene på nytt. Gjør dette først: guard-filen forsvinner så snart mappen gjør det. - Fjern
ensure zerodev_sentinelog linjenesentinel.admin/sentinel.stafffra server.cfg, og stopp deretter resourcen. Hvissentinel:lockdownhar endret entity lockdown, setter stopp av Sentinel den opprinnelige modusen tilbake. - Slett mappen
zerodev_sentinel. Det fjernerdata/med alle arkiver, klipp og rapporter, så kopier ut alt du vil beholde først. - Med oxmysql dropper du
zds_-tabellene fra seksjon 16 hvis du ikke lenger vil ha bansene og sakene. Key-value-postene blir liggende i serverens lager under resourcens navn og gjør ingenting uten den.
Sentinel skriver bare i sin egen mappe, sine databasetabeller og sitt key-value-lager. Den endrer ikke andre resources eller server.cfg.
Ofte stilte spørsmål
Banner eller kicker Sentinel noen på egen hånd?
Ikke på Watch eller Recommended. Den starter på Watch, der den bare logger hva den ville ha gjort. På Recommended får staff bevisene og bestemmer. Bare på Strict setter en høy score en spiller i karantene til staff ser på det, og et funn på bevisnivå setter en ban i kø til ban wave.
Trenger jeg en database?
Nei. Med oxmysql lagrer Sentinel dataene sine i databasen din og lager egne tabeller ved første oppstart; det finnes ingen SQL-fil å importere. Uten den ligger alt i resourcens eget key-value-lager.
Virker det på QBCore og Qbox?
Ja. Deteksjon, saker, klipp, konsollen, nettleserpanelet, Discord og eierpulten er like på alle frameworks. Sporet av penger og items har sin egen adapter for ESX, QBCore, Qbox og ox_inventory.
Hvordan gir jeg adminene mine tilgang?
På eierpulten, STAFF: velg en spiller som er online, velg en rolle, trykk GRANT. Eller fortsett å bruke ACE: sentinel.admin gir Admin, og sentinel.staff gir Moderator.
Kan en bannet spiller anke?
Ja. Avvisningsmeldingen viser en ankekode. Spilleren sender den til staffen din, som registrerer den med sentinel:appeal, eller nettsiden din sender den til Sentinels anke-route. Staff godtar eller avviser den i konsollen eller med sentinel:decide.
Kan den se juksprogrammer på PC-en til en spiller?
Nei. Sentinel vurderer det serveren kan se og det spillet til en spiller rapporterer. Den leser ikke andre programmer på PC-en til en spiller.
Er lytting på voice chat klart?
Det krever pma-voice og lyttebryteren (som standard bare for eieren), og lyden spilles av gjennom ditt eget spill.
Hva ser spillerne?
Ved første join en kort melding på deres språk om at serveren tar opp spillingen, og at staff kan se på og lytte (Config.Notice). For en ren spiller endres ingenting annet.