ZeroDev Sentinel dokumentation
ZeroDev Sentinel: installation og brug
ZeroDev Sentinel er en serverside anti-cheat-resource til FiveM. Den registrerer, hvad serveren ser, vurderer det med regler, der forklarer sig selv i klare sætninger, og giver dit staff beviserne, før nogen bliver straffet. Den starter på beskyttelsesniveauet Watch: den logger og straffer ingen, før du vælger andet. Denne guide dækker version 0.1.2 på ESX-, QBCore-, Qbox- og standalone-servere.
1. Krav
- OneSync slået til (
set onesync oni server.cfg). Resourcen angiver OneSync som afhængighed, så FXServer starter den ikke uden OneSync. - Et FXServer-artifact, der kører Node 22-scripts (ethvert aktuelt anbefalet artifact; manifestet beder om
node_version '22'). Node står for hashing, komprimering, fillister og web-ruten til appeller. - Valgfrit: oxmysql. Med det gemmer Sentinel sine data i din database og opretter selv sine tabeller ved første start. Der er ingen SQL-fil at importere. Uden det ligger alt i resourcens egen key-value store.
- Valgfrit: pma-voice, til at lytte til en spillers voice chat fra konsollen eller browserpanelet.
Frameworket betyder kun noget for to ting: sporet af penge og items (penge og items, som ingen butik, job eller script har udbetalt, belønningsløkker, rollbacks) og hvem dit staff er (ACE-grupper, som alle frameworks bruger). Detektion, sager, klip, konsollen, browserpanelet, Discord og ejerpulten virker på samme måde på alle frameworks.
2. Installation på fem minutter
Intet kræver SQL, der skal ikke rettes i config før første start, og ingen andre resources bliver ændret.
Trin 5: Åbn ejerpulten
Tryk F7 i spillet (eller skriv sentinel:console i F8) og åbn OWNER. Arket First run viser, hvad der er gjort, og hvad der ikke er: Discord, klip-lagring, dit staff og deres rettigheder. Hver linje har én knap. Spil derefter et par dage på Watch, læs hvad Sentinel fandt på arket Right now, og skift beskyttelsesniveauet til Recommended på samme pult (afsnit 6).
3. Dit framework
Sentinel finder selv frameworket og inventory, når den starter. Der er intet at indstille. 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- Penge og items: læses fra ESX' egne server events (kontopenge tilføjet, fjernet eller sat; inventory-items tilføjet eller fjernet; items givet fra spiller til spiller, med begge sider koblet sammen). Rollback bruger ESX' egne spillermetoder og læser resultatet tilbage.
- ESX med ox_inventory: penge følges på samme måde. I denne tilstand returnerer ESX' item-metoder ikke noget resultat, så Sentinel afgør det kun ud fra tilbagelæsningen.
- Staff: giv dine admins ACE-rettigheden (afsnit 5). ESX' egen
group.adminvirker som ACE-gruppe, når du tilføjer linjen til den.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- Penge: læses fra QBCores event for pengeændringer (tilføj, fjern og sæt, med årsagen). Et tab og en lige så stor gevinst i samme øjeblik kobles som en overførsel, fordi QBCore ikke har sit eget overførsels-event.
- Items: med ox_inventory følges items gennem dens hooks. Med qb-inventory følges item-ændringer ikke (dens listener-payload er ikke dokumenteret), men en rollback kan stadig flytte items med qb-inventorys dokumenterede exports.
- Staff: QBCores rettighedsgrupper er ACE-grupper (
group.admin,group.god). Tilføj ACE-linjerne i afsnit 5.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- Penge: læses fra Qbox' event for pengeændringer; saldi læses tilbage med
qbx_cores egne exports. Penge ændret for en offline karakter (via citizen id) udløser intet event, så de er ikke i sporet. - Items: Qbox bruger ox_inventory, og Sentinel følger dens items gennem ox_inventorys hooks. Items, der står for framework-penge, overlades til framework-delen.
- Staff: ACE-grupper, som på QBCore.
Standalone (intet framework)
set onesync on
ensure zerodev_sentinel- Alt undtagen sporet af penge og items virker: bevægelse, verden, events, lokke-events, godmode, state bags, våben, sager, klip, replay, konsol, panel, Discord, roller og bans.
- Med ox_inventory og uden framework følges items gennem ox_inventory.
- Lagring: key-value store, eller oxmysql hvis du starter det først.
Tjek at det virker
sentinel:health: opstartsboksen igen. Hver række er et rigtigt tjek; READY betyder, at intet mangler.sentinel:diag: hvorfor lagring, adaptere og niveau blev valgt, hver regel med dens tællere og de seneste beslutninger.sentinel:trail: den adapter til penge og items, der er i brug, og de seneste ændringer for én spiller.
I automatisk lagringstilstand bruger Sentinel kun oxmysql, når oxmysql allerede er startet (den venter op til 15 sekunder, mens oxmysql starter); starter oxmysql senere, bruger den key-value store.
4. Første start: ejerpladsen
Første start viser en engangskode i serverkonsollen, gyldig i 30 minutter (sentinel:owner code viser en ny). Join og skriv /sentinel owner <code>: pladsen bindes til din konto, og koden udløber.
Kun ejerpladsen kan ændre nøgler, beskyttelsesniveau, roller og rettigheder. sentinel:owner reset i serverkonsollen frigiver pladsen, hvis du skal flytte den til en anden konto.
5. Staff og rettigheder
På ejerpulten, STAFF: vælg en spiller, der er online, vælg en rolle, tryk GRANT. Der følger fire roller med:
| Rolle | Kan, fra start |
|---|---|
| Support | se sager, håndtere rapporter, vagtkortet |
| Moderator | som Support, plus replays, kick og karantæne |
| Admin | som Moderator, plus afsløring, frikendelse, live-visning, ban-anmodninger, appeller |
| Senior admin | som Admin, plus et ban, der gælder med det samme |
Du vælger selv rettighederne. Hver rolle er en liste af kontakter, du kan ændre. Lav dine egne roller ud fra en kopi (for eksempel "Trial mod"), omdøb enhver rolle, og giv én person en ekstra kontakt eller tag én fra dem uden at ændre deres rolle. Kontakter markeret som farlige (ban med det samme, lyt til voice chat, indstillinger, staff-styring) kræver et ekstra tryk. Hver ændring skrives i staff-loggen, så du altid kan se, hvem der ændrede hvad.
ACE virker stadig for servere, der allerede bruger det, og læses ved hvert tjek:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| Rettighed | Rolle den giver |
|---|---|
sentinel.admin |
Admin (Senior admin indtil ejerpladsen er taget) og alle sentinel:*-kommandoer i spillet |
sentinel.staff |
Moderator; bevægelsesregler betragter et staff-medlems egen bevægelse som forklaret |
Nogle få kommandoer (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) er registreret som begrænsede: i spillet kræver de også command.<name>. Den almindelige linje add_ace group.admin command allow dækker det. Serverkonsollen kan køre alle kommandoer.
6. Beskyttelsesniveauet
Én kontakt på ejerpulten (OWNER, PROTECTION), desuden sentinel:level i serverkonsollen og Config.Protection i config/config.lua. Det, du sætter på pulten, gemmes og vinder over config-linjen efter en genstart.
- Watch: hver regel holder øje og skriver ned, hvad den ville have gjort; ingen får besked, og der sker ikke noget med nogen. Imens lærer Sentinel, hvad der er normalt på din server: event-observatøren (hyppighed og form for hvert event) og join-tjekket lærer kun på Watch; grænser for entities, kamp og penge bliver ved med at lære af ren spillestil.
- Recommended: alle regler er live. Staff får alarmer med beviserne, og en sag åbnes. Sentinel straffer aldrig på egen hånd; dit staff bestemmer.
- Strict: som Recommended, og en høj score sætter spilleren i karantæne, indtil staff kigger på det; et fund på bevisniveau (Tier A: et lokke-event blev udløst, en forfalsket forespørgsel) sætter også et ban i kø til ban wave.
Under kontakten viser pulten hver regel med dens tilstand, og hvor tilstanden kommer fra. Lås en enkelt regel til Live eller Shadow der, hvis din server har brug for det (for eksempel en regel, der bliver ved med at markere et af dine egne scripts); en state-linje i Config.Rules låser den i config-filen og vinder over pulten.
En fornuftig rækkefølge:
- Watch i et par dage med normalt spil.
- Læs, hvad reglerne ville have gjort: arket Right now,
sentinel:diag rules(kolonnen shadow tæller, hvor mange gange en regel ville have givet point) ogsentinel:diag decisions 100. - Lås enhver regel, der markerede en, du stoler på, til Shadow, og fortæl os om det.
- Skift til Recommended. Staff ser nu sager og beviser; ingen straffes automatisk.
- Strict, når du stoler på det, Recommended viser dig.
Gå tilbage når som helst: Watch på pulten, eller sentinel:level watch.
7. Staffkonsollen (F7)
Tryk F7 i spillet (eller skriv sentinel:console i F8). Hver spiller kan ændre tasten i spillets indstillinger (Key Bindings, FiveM). Esc lukker den.
- Right now siger med almindelige ord, hvad der sker på din server: hvem der ligner en trussel og hvorfor, hvad der er bevist, hvad der er forklaret (en revive, et teleport fra et af dine egne scripts), og hvad der kræver dig. Hver spiller, der betyder noget, får én række: hvad de gjorde, hvad det sandsynligvis er, hvor sikker Sentinel er (Unusual, Suspicious, Very likely, Proven), hvad Sentinel allerede har gjort, og ét næste skridt.
- Sagsmapper: åbne sager først, hver med fundet, beviserne, skærmklip, seglet (om sagens hash-kæde stadig kan verificeres) og knapperne REVEAL, QUARANTINE, CLEAR og BAN (CLEAR og BAN kræver et ekstra tryk).
- Vagtkort: online spillere på en 3D-model af øen. Terrænet måles af det første staff-medlems spil og gemmes i
data/map/. - Play replay lukker konsollen og afspiller hændelsen i en privat verden; tryk Backspace for at vende tilbage.
- Ejer (kun ejerpladsen): First run, Protection, Keys, Staff, Internal affairs og Server check.
Kommandoer i spillet skrives i F8 uden skråstreg eller i chatten med skråstreg (/sentinel:diag).
8. Browserpanelet
Den samme pult i en webbrowser, til når du ikke er i spillet:
- på server-pc'en:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(porten er din serverport, som standard 30120) - fra et andet sted:
http://<server address>:<port>/zerodev_sentinel/panel/, eller din egen HTTPS-adresse foran den
Log ind. Brug en engangskode: skriv /sentinel panel i spillet (koden vises kun for dig, virker én gang, i 5 minutter), eller kør sentinel:panel <id or account> i serverkonsollen. En session varer 8 timer; SIGN OUT og END ALL MY SESSIONS afslutter den. Din rolle og dine kontakter gælder i browseren præcis som i spillet.
Live-visning. Staff med kontakten til live-visning kan se enhver online spillers skærm fra panelet eller konsollen. Intet gemmes på disken, medmindre du trykker Save to case.
Lytning. At lytte til spillerens voice chat kræver kontakten til lytning (som standard kun ejeren) og pma-voice. Lyden afspilles gennem dit eget spil, så vær i spillet på den samme server.
Hver live-visning og hver lytning skrives i staff-loggen og i spillerens sag, og spillere får besked ved deres første join om, at staff kan se og lytte med (optagelsesmeddelelsen, Config.Notice).
9. Sager, karantæne, kick, ban og appeller
Når noget bliver fundet, nævner Right now spilleren i klart sprog: hvad de gjorde, hvor sikker Sentinel er, og hvad den gjorde ved det. Åbn sagen for at se beviserne (positioner, skærmklip forseglet med SHA-256, en 3D-replay), og brug knapperne:
- REVEAL: viser spillerens identifiers.
- QUARANTINE: flytter spilleren ud af den rigtige verden til en privat routing bucket, indtil staff kigger på det.
sentinel:release <server id>bringer dem tilbage. - CLEAR: ingen snyd; lukker sagen og stopper dens ban i kø.
- KICK: af serveren, med en begrundelse, som spilleren kan læse.
- BAN: gennem ban wave, med en appelkode.
Ban wave. Bans, også en BAN trykket i konsollen, sættes i kø til ban wave og udføres kun på Strict, som standard på et tilfældigt tidspunkt 2 til 24 timer senere (Config.Actions). sentinel:wave viser dem, sentinel:wave now <account> udfører én med det samme, sentinel:wave cancel <account> annullerer den.
Appeller. En banned spiller ser en appelkode i afvisningsbeskeden (8 bogstaver og tal). De kan ikke joine for at appellere, så appellen når dig uden for spillet:
- Gennem dit staff. Spilleren sender koden til dit staff (en Discord-ticket, en mail). Et staff-medlem registrerer den med
sentinel:appeal <code> <text>. - Gennem web-ruten. Sentinel svarer på din servers egen adresse:
http://<server address>:<port>/zerodev_sentinel/appeal. Den accepterer kun en POST med JSON{ "code": "...", "text": "...", "contact": "optional" }(tekst på 10 til 2000 tegn), så den er beregnet til en formular på din hjemmeside, ikke en side, du sender spillere hen til. Hver accepteret forespørgsel får det samme svar, 202 "received", uanset om koden matchede en ban eller ej. For mange forespørgsler fra én adresse (5 på 10 minutter) eller i alt (30 i minuttet) får 429. Bag din egen HTTPS reverse proxy skal du sætteset sentinel_http_proxy true, så grænserne tæller besøgendes adresse.
Afvisningsteksten siger ikke, hvor man appellerer. Fortæl det til spillerne i dine regler, eller skriv din egen tekst med dit link i Config.Bans.message (behold %s, det bliver til koden), for eksempel 'You are banned. Appeal at discord.gg/yourserver with code %s'.
Staff beslutter i konsollen eller med sentinel:decide <case or code> accept|reject [note]. Accept ophæver hver aktiv ban på den konto eller sag og annullerer en wave-ban i kø; reject beholder ban'en. En beslutning er endelig og skrives i sagsloggen. sentinel:appeals viser de åbne.
10. Rapporter og intern kontrol
Spillerrapporter. Enhver spiller skriver /report <server id> <what happened> for at rapportere en spiller eller et staff-medlem. De sidste to minutter omkring begge spillere gemmes i en sag. Staff lukker en rapport som håndteret, ingen overtrædelse, intet bevis eller dublet. Rapporter om staff går kun til ejeren.
Intern kontrol (kun ejeren, på ejerpulten): hvad hvert staff-medlem har gjort, og hvad der skal kigges på (tildelinger til sig selv, at gemme sig i kamp, bans uden sag, teleports til spillere). En ugentlig fairness-rapport skrives til data/reports/; sentinel:staff report skriver den nu. Intet i staff-loggen straffer staff.
11. Beskyt en resource
Uden nogen opsætning holder Sentinel øje med hvert event, spillere kan sende til dine scripts, og vurderer spilleren. Den kan ikke forhindre en anden resources handler i at køre. For at stoppe et dårligt kald, før et script kører, skal du tilføje guard'en til det script.
sentinel:auditviser de events i hver startet resource, som klienter kan udløse, vurderet efter hvad deres handlers gør (for eksempel en handler, der giver penge med et beløb, klienten vælger). Brug den til at beslutte, hvilke resources du skal beskytte først.sentinel:guard <resource>viser linjen, du skal tilføje, og resourcens server_scripts, som de så ville se ud. Guard-linjen skal være det første server script. Kommandoen viser kun; den ændrer ingen filer.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Genstart den resource.
sentinel:guard <resource>siger nu "guarded since ...".sentinel:guardalene viser hver beskyttet resource. - Tilføj regler med
sentinel:patch. Indtil en resource har regler, lader dens guard alle kald igennem, undtagen kald fra spillere i karantæne, som enhver guard smider væk. Eksempel: højst 3 køb på 10 sekunder, et item-navn på op til 32 tegn og et antal fra 1 til 10; et afvist kald tæller 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> viser en resources regler; sentinel:patch <resource> <event> off fjerner én.
Guard'en redigerer aldrig filer og ændrer aldrig, hvad en handler modtager. Den er almindelig, læsbar Lua i guard/guard.lua.
12. Nøgler til Discord og kliplager
Den nemmeste måde er ejerpulten, KEYS: indsæt hver værdi og tryk SAVE. Nøgler gemmes kun på serveren; pulten og hvert svar siger kun "set" og viser aldrig en nøgle igen.
| Linje på pulten | Hvad det er | Eller i server.cfg (brug set, aldrig setr) |
|---|---|---|
| Discord-bot-token | en bot, du har lavet på discord.com/developers og inviteret til din server | set sentinel_discord_token "..." |
| Discord-server-id | højreklik på din server, Copy Server ID (udviklertilstand slået til) | set sentinel_discord_guild "..." |
| Id for alarmkanal | hvor sager bliver postet, med knapper til dit staff | set sentinel_discord_channel "..." |
| Id for appelkanal | hvor appeller bliver postet | set sentinel_discord_appeals "..." |
| FiveManage-nøgle | en medienøgle fra fivemanage.com; klip uploades dertil | set sentinel_fivemanage_key "..." |
| Klip-webhook | i stedet for FiveManage: en Discord-webhook, der modtager klippene | set sentinel_clip_webhook "..." |
| Kliplager | fivemanage, discord, off eller automatic (den første, der er sat) | set sentinel_clip_storage "..." |
En nøgle i server.cfg vinder over pulten, og pulten siger det. Discord-knapper følger de samme roller og kontakter som konsollen. Uden nogen af disse bliver sager og klip på din server (data/), og konsollen og panelet viser dem.
De enklere webhook-alarmer virker stadig: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" eller sentinel:webhook set <url> i serverkonsollen. sentinel:webhook test sender en testbesked; sentinel:webhook viser status uden nogensinde at vise URL'en; sentinel:webhook clear fjerner den gemte.
13. Hvad hver regel fanger
Hver regel skriver en klar sætning, når den udløses, om hvad den så, og hvad den udelukkede. Før en regel tæller imod nogen, tjekker Sentinel de grunde, der kunne forklare det (en respawn, en revive, en staff-handling, et af dine egne scripts, der flytter eller betaler spillere). Et forklaret fund logges og giver aldrig point.
- Tier A er bevis: noget, kun snyd gør (et lokke-event, som intet rigtigt script kalder, en forfalsket forespørgsel).
- Tier B er stærk: et staff-medlem bør kigge på det. Alene åbner den kun en sag, når to forskellige familier er enige, eller den samme gentager sig.
- Tier C er svag: den lægger til scoren og handler aldrig alene.
Bevægelse
| Regel | Fanger | Forklares af | Tier |
|---|---|---|---|
| teleport | Et spring på over 150 m (eller 3x det mulige) mellem to målinger | spawn, respawn eller revive, skift af routing bucket, staff, dit scripts teleport-event | B |
| foot_speed | Løb over 12 m/s i 1.5 s til fods, uden at falde, uden ragdoll | spawn, respawn, staff, dit script | B |
| air_float | Bevægelse mens spilleren er frosset (noclip); "falder" uden at komme ned (fly); hurtig bevægelse efter koordinater, mens spillet siger, at spilleren står stille (speed-menuer) | spawn, respawn, staff, dit script | B |
| foot_rise | Klatring lodret op hurtigere end 4 m/s til fods i 3 s | spawn, respawn, staff, dit script | B |
| vehicle_speed | Et køretøj over 1.3x det hurtigste, dets klasse når på din server | staff, dit script | B |
Verden
| Regel | Fanger | Forklares af | Tier |
|---|---|---|---|
| entity_blocked | Spawn af en model, du har blokeret | dine scripts, der spawner den | B |
| entity_rate / entity_model_rate | Spawn af langt flere entities (eller én model) i minuttet, end spillere og scripts gør | dine spawn-scripts | B |
| entity_untrusted | Entities oprettet af en klient uden et script, der spawner dem | dine spawn-scripts | B |
| entity_disguised | En byge af den samme ambient ped-model omkring én spiller (en menu, der forklæder sine spawns som trafik) | spawn, respawn, skift af bucket | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Eksplosioner, som det holdte våben ikke kan lave, for mange, usynlige eller langt fra spilleren | dine scripts' eksplosioner | B |
| projectile_weapon / projectile_rate | Projektiler, som våbnet ikke kan affyre, eller for mange | B | |
| ptfx_rate | Floods af partikeleffekter (et almindeligt crash- og lag-angreb) | B | |
| fire_rate | Ild startet hurtigere, end noget våben tillader | B |
Kamp
| Regel | Fanger | Tier |
|---|---|---|
| damage_plausibility | Skade over våbnets mulige værdi | B |
| hit_range | Træffere fra længere væk end våbnets rækkevidde | B |
| shot_rate / kill_rate | Skyder hurtigere end våbnet; kills i minuttet langt over det normale på din server | B |
| silent_aim | Træffere, hvor spilleren ikke sigtede, gentagne gange | B |
| aim_stats / aim_stats_backed | Andel af headshots og snap-vinkler langt uden for din servers spillere over 30+ kampe | C (B med en anden familie) |
| esp_los_backed | Gentagen sigten på spillere, som vidnerne melder skjult bag vægge | C til B |
Events og forespørgsler
| Regel | Fanger | Tier |
|---|---|---|
| bait_event | Kald af et plantet event, som intet rigtigt script bruger (snydemenuer leder efter og udløser dem) | A |
| bait_statebag / statebag_write | Skrivning af state bags, som kun serveren bør skrive (gøre sig selv til admin, godmode-flag), eller alt for store | A / B |
| events_before_ready / _trap | Events sendt, før spilleren overhovedet er spawnet (injiceret før join) | B / A |
| event_rate / event_shape | Et event kaldt langt hurtigere end normalt eller med argumenter, der er bygget anderledes end de normale kald på din server | B |
| event_flood | 500+ kald på 10 s; ved FiveM's eget overflow-kick vises de hyppigste events | B |
| guard_rule / guard_hard | Brud på en regel, du har sat på et beskyttet event (beløb, frekvens, afstand) | B / A |
Økonomi
| Regel | Fanger | Tier |
|---|---|---|
| money_nowhere / item_nowhere | Penge eller items, som ingen butik, job eller script har givet (dev-events, lækkede butikssalg) | B |
| economy_repeat | Et belønnings- eller job-event udbetalt 10 gange på 30 s (farming ved at kalde det i en løkke) | B |
| money_jump / money_rate | Et pludseligt hop i saldoen eller en indtjeningsrate langt over det normale på din server | B |
| economy_trap | Indløsning af en plantet belønning, som intet rigtigt job udbetaler | A |
| weapon_not_owned | At holde et våben, som inventory aldrig har givet | B |
Spillerens spil (vidne)
| Regel | Fanger | Tier |
|---|---|---|
| godmode | Serveren ser spilleren som usårlig i 30 s (ikke en fælles safe zone) | B |
| witness_backed | Tegn fra spillet, som bakkes op af serverens eget billede (godmode, usynlighed, ingen kollision) | B |
| witness_bait | Spillet svarer på et tjek, det ikke burde kende til | A |
| witness_tamper | Sentinels egne tjek i spillet er blevet hooket eller ændret | B |
Identitet og filer
| Regel | Fanger | Tier |
|---|---|---|
| ban_fingerprint | En banned spiller tilbage på en ny konto (hardware tokens, identifiers, browser-fingerprint) | A / flag |
| young_account | En helt ny konto (giver kun ekstra vægt) | C |
| scanner_error / too_large | Resources, som script-scanneren ikke kunne læse, eller alt for store filer, der er værd at kigge på | info |
Hvad ingen regel lover
Sentinel vurderer det, serveren kan se, og det, en spillers spil rapporterer. Den læser ikke andre programmer på en spillers pc, og intet anti-cheat kan love, at hver eneste snyd bliver fanget. Hvert fund kommer med sine beviser, så dit staff beslutter ud fra fakta.
14. Kommandoer og konfiguration
Alle kommandoer står på kommandosiden og alle config-nøgler på konfigurationssiden, begge genereret direkte fra resourcen. Dem, du bruger mest:
| Kommando | Hvad den gør |
|---|---|
/sentinel owner <code> |
overtag ejerpladsen i spillet med koden fra konsollen |
/sentinel panel |
en engangskode til at logge ind på browserpanelet (kun staff) |
/report <server id> <what happened> |
enhver spiller rapporterer en spiller eller et staff-medlem |
sentinel:health |
opstartsboksen igen |
sentinel:diag |
hvad Sentinel besluttede og hvorfor |
sentinel:level watch\|recommended\|strict |
skift beskyttelsesniveau og gem det |
sentinel:wave |
de bans, der står i kø til ban wave |
sentinel:appeals |
de åbne appeller |
sentinel:audit |
de risikable events i hver startet resource |
sentinel:guard <resource> |
linjen, der beskytter en resource |
sentinel:advisor |
de FiveM-indstillinger, der er værd at ændre på din server |
Config-filerne i config/ (config.lua, protection.lua, watch.lua) og oversættelserne i config/locales/ er åbne for dig, ligesom framework-adapterne i bridge/ og guard-filen i guard/. Hold dem som gyldig Lua, og genstart zerodev_sentinel efter en ændring. Første start kræver ingen ændringer i config.
15. Opstartsboksen og hærdningsrådgiveren
Et øjeblik efter at lageret er klar, skriver Sentinel en boks i serverkonsollen. En FAIL-række betyder, at Sentinel ikke kan fungere ordentligt; en WARN-række betyder, at den virker med mindre (for eksempel beviser uden digests). Skriv den ud igen når som helst med sentinel:health.
| Række | Hvad den tjekker | Når den ikke er OK |
|---|---|---|
| Build | Versionen og build-mærket fra fxmanifest.lua. | - |
| OneSync | Convar'en onesync. Sentinel læser positioner, entities og game events gennem OneSync. |
sæt onesync til on i server.cfg |
| Kørende kopier | Hvor mange kopier af resourcen der er startet, uanset hvad deres mappe hedder. Skal være 1. | behold én kopi af Sentinel; stop den anden mappe |
| Lager | Hvilket lager der blev valgt (mysql eller kvp), og om det er klar. | se sentinel:diag storage |
| Bevismappe | En testskrivning og -læsning i data/archive inde i resourcen. | opret mappen data/archive inde i Sentinel-resourcen, og sørg for, at serveren kan skrive til den |
| SHA-256 | Om node/util.js svarer; den laver et fingeraftryk af hvert bevis. | beviser gemmes uden digests; kig efter en Node-fejl i konsollen |
| Beskyttelse | Beskyttelsesniveauet, dets tilstand og hvor det kom fra. | - |
| Regler | Hvor mange regler der er Live, og hvor mange der er i Shadow. | - |
Efter opstartsboksen skriver rådgiveren de FiveM-indstillinger ud, der er værd at ændre på din server (med Config.Advisor.atStartup = false skrives de kun ved sentinel:advisor). For hver indstilling viser den den nuværende værdi, den anbefalede, hvad den blokerer, hvad den kan ødelægge, og linjen, du kan kopiere. Den læser kun værdierne; den ændrer aldrig server.cfg. Test en linje på din server, før du beholder den.
16. Sprog, og hvad der registreres
Tekster til spillere og staff kommer fra config/locales/<code>.lua, 25 sprog i dette build. Config.Locale vælger sproget; med Config.GameLanguage = true læser en spiller, hvis spil kører på et sprog, GTA tilbyder, Sentinel på det sprog, så snart han er i spillet.
Sentinel gemmer i hukommelsen, for hver spiller, cirka de sidste to minutter af positioner og events (Config.Recorder) og skriver dem til et arkiv i data/archive/, når en sag åbnes, eller staff bruger sentinel:save. Under en gennemgang beder den den mistænktes spil om skærmklip (segmenter på 20 sekunder) og gemmer dem i data/clips/. Den gemmer de identifiers, FiveM giver serveren (en IP-adresse registreres, men bruges som standard aldrig til at afvise en forbindelse), og, når Discord kører, Discord-id'et. Ved første join får hver spiller en kort besked på sit sprog om, at serveren optager spillet, og at staff kan se med og lytte (Config.Notice = false slår den fra; fortæl dem det så i dine regler). Nævn det også i din privatlivspolitik.
Gamle arkiver og klip slettes ikke automatisk i dette build: ryd selv data/archive/ og data/clips/, når du ikke længere har brug for dem.
Med oxmysql ligger Sentinels data i tabellerne zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report og zds_trail. Uden oxmysql ligger de samme data i resourcens key-value-lager (nøgler, der starter med zds:). Bans spejles altid til key-value-lageret, så de håndhæves, mens databasen er nede.
17. Opdatering
Nye versioner udgives på det samme Keymaster-asset. Sentinel gemmer sine beviser i sin egen mappe, så før du udskifter den:
- Tag backup af mappen
zerodev_sentinels mapperconfig/ogdata/(arkiver, klip, rapporter, lærte baselines) og, med oxmysql,zds_-tabellerne. - Stop serveren, erstat mappen
zerodev_sentinelmed den nye (behold mappenavnet), og læg dindata/-mappe tilbage. Flyt de indstillinger, du har ændret, over i de nye config-filer i stedet for at kopiere gamle filer oven i dem. - Start serveren, og læs opstartsboksen (
sentinel:health).
Læs release notes for den nye version i changelogen, før du opdaterer.
18. Afinstallation
- Fjern guard-linjen fra hver resource, du har beskyttet (
sentinel:guardviser dem), og genstart de resources. Gør det først: guard-filen er væk, så snart mappen er væk. - Fjern
ensure zerodev_sentinelog linjernesentinel.admin/sentinel.stafffra server.cfg, og stop derefter resourcen. Hvissentinel:lockdownhar ændret entity lockdown, sætter et stop af Sentinel den oprindelige tilstand tilbage. - Slet mappen
zerodev_sentinel. Det fjernerdata/med alle arkiver, klip og rapporter, så kopiér først alt ud, du vil beholde. - Med oxmysql dropper du
zds_-tabellerne fra afsnit 16, hvis du ikke længere vil have dine bans og sager. Key-value-posterne bliver i serverens lager under resourcens navn og gør intet uden den.
Sentinel skriver kun i sin egen mappe, sine databasetabeller og sit key-value-lager. Den ændrer ikke andre resources eller server.cfg.
Ofte stillede spørgsmål
Banner eller kicker Sentinel nogen på egen hånd?
Ikke på Watch eller Recommended. Den starter på Watch, hvor den kun logger, hvad den ville have gjort. På Recommended får staff beviserne og bestemmer. Kun på Strict sætter en høj score en spiller i karantæne, indtil staff kigger, og et fund på bevisniveau sætter et ban i kø til ban wave.
Skal jeg have en database?
Nej. Med oxmysql gemmer Sentinel sine data i din database og opretter sine egne tabeller ved første start; der er ingen SQL-fil at importere. Uden den ligger alt i resourcens eget key-value-lager.
Virker det på QBCore og Qbox?
Ja. Detektion, sager, klip, konsollen, browserpanelet, Discord og ejerpulten er ens på alle frameworks. Sporet af penge og items har sin egen adapter til ESX, QBCore, Qbox og ox_inventory.
Hvordan giver jeg mine admins adgang?
På ejerpulten, STAFF: vælg en spiller, der er online, vælg en rolle, tryk GRANT. Eller bliv ved med at bruge ACE: sentinel.admin giver Admin, og sentinel.staff giver Moderator.
Kan en banned spiller appellere?
Ja. Afvisningsbeskeden viser en appelkode. Spilleren sender den til dit staff, som registrerer den med sentinel:appeal, eller din hjemmeside sender den til Sentinels appel-route. Staff godkender eller afviser den i konsollen eller med sentinel:decide.
Kan den se snydeprogrammer på en spillers pc?
Nej. Sentinel vurderer, hvad serveren kan se, og hvad en spillers spil rapporterer. Den læser ikke andre programmer på en spillers pc.
Er lytning til voice chat klar?
Det kræver pma-voice og lyttekontakten (som standard kun for ejeren), og lyden afspilles gennem dit eget spil.
Hvad ser spillerne?
Ved første join en kort besked på deres sprog om, at serveren optager spillet, og at staff kan se med og lytte (Config.Notice). For en ren spiller ændrer intet andet sig.