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.

Til ZeroDev Sentinel 0.1.223 min. læsningOpdateret

1. Krav

  • OneSync slået til (set onesync on i 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 1: Læg mappen i resources

Kopiér mappen zerodev_sentinel ind i din resources-mappe. Behold præcis det mappenavn: guard-filen rapporterer til zerodev_sentinel, og sentinel:guard advarer dig, hvis mappen hedder noget andet.

Trin 2: Tilføj den i server.cfg

Start den efter oxmysql og dit framework, så lagringen og pengesporet finder dem ved start. Den præcise rækkefølge for dit framework står i afsnit 3.

Trin 3: Start serveren

Konsollen viser en opstartsboks og en engangs-ejerkode. Hver række i boksen er et rigtigt tjek; sidste linje siger READY eller NOT READY med antallet af problemer (afsnit 15).

Trin 4: Gør krav på ejerpladsen

Join serveren og skriv /sentinel owner <code> i chatten. Nu har du ejerpladsen (afsnit 4).

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

server.cfg
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.admin virker som ACE-gruppe, når du tilføjer linjen til den.

QBCore

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

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

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

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

  1. Watch i et par dage med normalt spil.
  2. 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) og sentinel:diag decisions 100.
  3. Lås enhver regel, der markerede en, du stoler på, til Shadow, og fortæl os om det.
  4. Skift til Recommended. Staff ser nu sager og beviser; ingen straffes automatisk.
  5. 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:

  1. Gennem dit staff. Spilleren sender koden til dit staff (en Discord-ticket, en mail). Et staff-medlem registrerer den med sentinel:appeal <code> <text>.
  2. 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ætte set 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.

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

  1. Genstart den resource. sentinel:guard <resource> siger nu "guarded since ...". sentinel:guard alene viser hver beskyttet resource.
  2. 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:

  1. Tag backup af mappen zerodev_sentinels mapper config/ og data/ (arkiver, klip, rapporter, lærte baselines) og, med oxmysql, zds_-tabellerne.
  2. Stop serveren, erstat mappen zerodev_sentinel med den nye (behold mappenavnet), og læg din data/-mappe tilbage. Flyt de indstillinger, du har ændret, over i de nye config-filer i stedet for at kopiere gamle filer oven i dem.
  3. Start serveren, og læs opstartsboksen (sentinel:health).

Læs release notes for den nye version i changelogen, før du opdaterer.

18. Afinstallation

  1. Fjern guard-linjen fra hver resource, du har beskyttet (sentinel:guard viser dem), og genstart de resources. Gør det først: guard-filen er væk, så snart mappen er væk.
  2. Fjern ensure zerodev_sentinel og linjerne sentinel.admin / sentinel.staff fra server.cfg, og stop derefter resourcen. Hvis sentinel:lockdown har ændret entity lockdown, sætter et stop af Sentinel den oprindelige tilstand tilbage.
  3. Slet mappen zerodev_sentinel. Det fjerner data/ med alle arkiver, klip og rapporter, så kopiér først alt ud, du vil beholde.
  4. 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.

Oversat fra engelsk. Hvis noget her ikke stemmer overens med den engelske side, er det den engelske side, der gælder. English