Dokumentation för ZeroDev Sentinel

ZeroDev Sentinel: installation och användning

ZeroDev Sentinel är en serverbaserad anticheat-resource för FiveM. Den registrerar vad servern ser, bedömer det med regler som förklarar sig själva med vanliga meningar, och ger din staff bevisen innan någon straffas. Den startar på skyddsnivån Watch: den loggar och straffar ingen förrän du väljer något annat. Den här guiden gäller version 0.1.2 på ESX-, QBCore-, Qbox- och standalone-servrar.

För ZeroDev Sentinel 0.1.223 min läsningUppdaterad

1. Krav

  • OneSync på (set onesync on i server.cfg). Resourcen anger OneSync som beroende, så FXServer startar den inte utan OneSync.
  • En FXServer-artifact som kör Node 22-skript (vilken aktuell rekommenderad artifact som helst; manifestet kräver node_version '22'). Node sköter hashning, komprimering, fillistning och webbrouten för överklaganden.
  • Valfritt: oxmysql. Med det sparar Sentinel sina data i din databas och skapar sina egna tabeller vid första starten. Det finns ingen SQL-fil att importera. Utan det ligger allt i resourcens egen key-value-lagring.
  • Valfritt: pma-voice, för att lyssna på en spelares röstchatt från konsolen eller webbpanelen.

Frameworket spelar bara roll för två saker: spåret för pengar och items (pengar och items som ingen butik, inget jobb eller skript har betalat ut, belöningsloopar, rollbacks) och vilka som är din staff (ACE-grupper, som alla frameworks använder). Detektion, cases, klipp, konsolen, webbpanelen, Discord och owner desk fungerar likadant på alla frameworks.

2. Installation på fem minuter

Inget behöver SQL, ingen ändring i configen behövs för första starten, och ingen annan resource ändras.

Steg 1: Lägg mappen i resources

Kopiera mappen zerodev_sentinel till din mapp resources. Behåll exakt det mappnamnet: guard-filen rapporterar till zerodev_sentinel, och sentinel:guard varnar dig om mappen heter något annat.

Steg 2: Lägg till den i server.cfg

Starta den efter oxmysql och ditt framework, så att lagringen och pengaspåret hittar dem vid start. Den exakta ordningen för ditt framework finns i avsnitt 3.

Steg 3: Starta servern

Konsolen skriver ut en startruta och en ägarkod för engångsbruk. Varje rad i rutan är en riktig kontroll; sista raden säger READY, eller NOT READY med antalet problem (avsnitt 15).

Steg 4: Ta ägarplatsen

Gå in på servern och skriv /sentinel owner <code> i chatten. Nu har du ägarplatsen (avsnitt 4).

Steg 5: Öppna owner desk

Tryck F7 i spelet (eller skriv sentinel:console i F8) och öppna OWNER. Fliken First run visar vad som är klart och vad som inte är det: Discord, klipplagring, din staff och deras behörigheter. Varje rad har en knapp. Spela sedan några dagar på Watch, läs vad Sentinel hittat på fliken Right now, och byt skyddsnivå till Recommended på samma desk (avsnitt 6).

3. Ditt framework

Sentinel hittar framework och inventory själv när den startar. Det finns inget att ställa in. sentinel:trail i serverkonsolen visar vilken adapter den valde.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Pengar och items: läses från ESX:s egna server-events (kontopengar tillagda, borttagna eller satta; inventory-items tillagda eller borttagna; items som getts från spelare till spelare, med båda sidor kopplade). Rollback använder ESX:s egna spelarmetoder och läser tillbaka resultatet.
  • ESX med ox_inventory: pengar följs på samma sätt. I det här läget rapporterar ESX:s item-metoder inga resultat, så Sentinel beslutar bara utifrån återläsningen.
  • Staff: ge dina admins ACE-behörigheten (avsnitt 5). ESX:s egen group.admin fungerar som ACE-grupp när du lägger till raden för den.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Pengar: läses från QBCore:s money-change-event (lägga till, ta bort och sätta, med orsaken). En förlust och en lika stor vinst i samma ögonblick kopplas ihop som en överföring, eftersom QBCore inte har något eget överföringsevent.
  • Items: med ox_inventory följs items via dess hooks. Med qb-inventory följs inte itemändringar (dess listener-payload är inte dokumenterad), men en rollback kan ändå flytta items med qb-inventorys dokumenterade exports.
  • Staff: QBCore:s behörighetsgrupper är ACE-grupper (group.admin, group.god). Lägg till ACE-raderna i avsnitt 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Pengar: läses från Qbox money-change-event; saldon läses tillbaka med qbx_core:s egna exports. Pengar som ändras för en offline-karaktär (via citizen id) utlöser inget event, så de finns inte i spåret.
  • Items: Qbox använder ox_inventory, och Sentinel följer dess items via ox_inventorys hooks. Items som står för framework-pengar lämnas åt framework-delen.
  • Staff: ACE-grupper, som på QBCore.

Standalone (inget framework)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Allt utom spåret för pengar och items fungerar: rörelse, värld, events, bete-events, godmode, state bags, vapen, cases, klipp, replay, konsol, panel, Discord, roller och bans.
  • Med ox_inventory och inget framework följs items via ox_inventory.
  • Lagring: key-value-lagringen, eller oxmysql om du startar det först.

Kontrollera att det fungerar

  • sentinel:health: startrutan igen. Varje rad är en riktig kontroll; READY betyder att inget saknas.
  • sentinel:diag: varför lagring, adaptrar och nivå valdes, varje regel med sina räknare, och de senaste besluten.
  • sentinel:trail: adaptern för pengar och items som används, och de senaste ändringarna för en spelare.

I automatiskt lagringsläge använder Sentinel oxmysql bara om oxmysql redan är startat (den väntar upp till 15 sekunder medan oxmysql startar); om oxmysql startar senare använder den key-value-lagringen.

4. Första start: ägarplatsen

Första starten skriver ut en engångskod i serverkonsolen, giltig i 30 minuter (sentinel:owner code skriver ut en ny). Gå in och skriv /sentinel owner <code>: platsen knyts till ditt konto och koden slutar gälla.

Bara ägarplatsen kan ändra nycklar, skyddsnivån, roller och behörigheter. sentinel:owner reset i serverkonsolen frigör platsen om du måste flytta den till ett annat konto.

5. Staff och behörigheter

På owner desk, STAFF: välj en spelare som är online, välj en roll, tryck GRANT. Fyra roller följer med:

Roll Kan, från start
Support se cases, hantera rapporter, tjänstekartan
Moderator som Support, plus replays, kick och karantän
Admin som Moderator, plus avslöja, frikänna, live-vy, ban-förfrågningar, överklaganden
Senior admin som Admin, plus en ban som gäller direkt

Behörigheterna väljer du själv. Varje roll är en lista med reglage som du kan ändra. Skapa egna roller från en kopia (till exempel "Trial mod"), byt namn på vilken roll som helst, och ge en person ett extra reglage eller ta bort ett utan att ändra deras roll. Reglagen som är markerade som farliga (ban direkt, lyssna på röstchatt, inställningar, hantering av staff) kräver ett andra tryck. Varje ändring skrivs till staffloggen, så du ser alltid vem som ändrade vad.

ACE fungerar fortfarande för servrar som redan använder det, och läses vid varje kontroll:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Behörighet Roll den ger
sentinel.admin Admin (Senior admin tills ägarplatsen är tagen) och varje sentinel:*-kommando i spelet
sentinel.staff Moderator; rörelseregler räknar en staffmedlems egen rörelse som förklarad

Några kommandon (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) är registrerade som restricted: i spelet behöver de också command.<name>. Den vanliga raden add_ace group.admin command allow täcker det. Serverkonsolen kan köra alla kommandon.

6. Skyddsnivån

Ett reglage på owner desk (OWNER, PROTECTION), dessutom sentinel:level i serverkonsolen och Config.Protection i config/config.lua. Det du ställer in på desken sparas och går före config-raden efter en omstart.

  • Watch: varje regel tittar och skriver ner vad den skulle ha gjort; ingen larmas och inget händer någon. Under tiden lär sig Sentinel vad som är normalt på din server: event-observatören (frekvens och form för varje event) och join-kontrollen lär sig bara på Watch; gränserna för entities, strid och pengar fortsätter att lära sig av rent spel.
  • Recommended: varje regel är live. Staff får larm med bevisen, och ett case öppnas. Sentinel straffar aldrig på egen hand; din staff bestämmer.
  • Strict: som Recommended, och en hög poäng sätter spelaren i karantän tills staff tittar; ett fynd på bevisnivå (Tier A: ett bete-event utlöstes, en förfalskad request) köar dessutom en ban till nästa ban wave.

Under reglaget listar desken varje regel med dess läge och var läget kommer ifrån. Lås en enskild regel till Live eller Shadow där om din server behöver det (till exempel en regel som hela tiden flaggar ett av dina egna skript); en state-rad i Config.Rules låser den i config-filen och går före desken.

En vettig ordning:

  1. Watch under några dagar med vanligt spel.
  2. Läs vad reglerna skulle ha gjort: fliken Right now, sentinel:diag rules (kolumnen shadow räknar hur många gånger en regel skulle ha gett poäng) och sentinel:diag decisions 100.
  3. Lås varje regel som flaggade någon du litar på till Shadow, och berätta det för oss.
  4. Byt till Recommended. Staff ser nu cases och bevis; ingen straffas automatiskt.
  5. Strict när du litar på det Recommended visar dig.

För att backa när som helst: Watch på desken, eller sentinel:level watch.

7. Staffkonsolen (F7)

Tryck F7 i spelet (eller skriv sentinel:console i F8). Varje spelare kan byta tangent i spelets inställningar (Key Bindings, FiveM). Esc stänger den.

  • Right now berättar med vanliga ord vad som händer på din server: vem som ser ut som ett hot och varför, vad som bevisades, vad som förklarades (en revive, ett skripts egen teleport) och vad som behöver dig. Varje spelare som spelar roll får en rad: vad de gjorde, vad det troligen är, hur säker Sentinel är (Unusual, Suspicious, Very likely, Proven), vad Sentinel redan har gjort och ett nästa steg.
  • Case files: öppna cases först, vart och ett med sitt fynd, bevisen, skärmklipp, sigillet (om casets hashkedja fortfarande stämmer) och knapparna REVEAL, QUARANTINE, CLEAR och BAN (CLEAR och BAN kräver ett andra tryck).
  • Duty map: spelare online på en 3D-modell av ön. Terrängen mäts av den första staffmedlemmens spel och sparas i data/map/.
  • Play replay stänger konsolen och spelar upp incidenten i en privat värld; tryck Backspace för att gå tillbaka.
  • Owner (bara ägarplatsen): First run, Protection, Keys, Staff, Internal affairs och Server check.

Kommandon som skrivs i spelet skrivs i F8 utan snedstreck, eller i chatten med snedstreck (/sentinel:diag).

8. Webbpanelen

Samma desk i en webbläsare, för när du inte är i spelet:

  • på serverdatorn: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (porten är din serverport, 30120 som standard)
  • från andra ställen: http://<server address>:<port>/zerodev_sentinel/panel/, eller din egen HTTPS-adress framför den

Logga in. Använd en engångskod: skriv /sentinel panel i spelet (koden visas bara för dig, fungerar en gång, i 5 minuter), eller kör sentinel:panel <id or account> i serverkonsolen. En session varar i 8 timmar; SIGN OUT och END ALL MY SESSIONS avslutar den. Din roll och dina brytare gäller i webbläsaren precis som i spelet.

Live view. Staff med brytaren för live view kan se vilken onlinespelares skärm som helst från panelen eller konsolen. Inget sparas på disk om du inte trycker Save to case.

Avlyssning. Att lyssna på den spelarens röstchatt kräver lyssnarbrytaren (som standard bara för ägaren) och pma-voice. Ljudet spelas upp genom ditt eget spel, så var i spelet på samma server.

Varje live view och varje avlyssning skrivs till staffloggen och till spelarens case, och spelarna får veta första gången de ansluter att staff kan titta och lyssna (inspelningsmeddelandet, Config.Notice).

9. Cases, karantän, kick, ban och överklaganden

När något hittas namnger Right now spelaren på vanlig svenska: vad de gjorde, hur säker Sentinel är och vad den gjorde åt det. Öppna caset för att se bevisen (positioner, skärmklipp förseglade med SHA-256, en 3D-replay) och använd knapparna:

  • REVEAL: visa spelarens identifierare.
  • QUARANTINE: flytta spelaren ut ur den riktiga världen till en privat routing bucket tills staff tittar. sentinel:release <server id> tar tillbaka dem.
  • CLEAR: inget fusk; stänger caset och stoppar dess köade ban.
  • KICK: ut från servern, med en anledning som spelaren läser.
  • BAN: via ban wave, med en överklagandekod.

Ban wave. Bans, även en BAN som trycks i konsolen, köas till ban wave och verkställs bara på Strict, vid en slumpmässig tidpunkt 2 till 24 timmar senare som standard (Config.Actions). sentinel:wave listar dem, sentinel:wave now <account> verkställer en direkt, sentinel:wave cancel <account> avbryter den.

Överklaganden. En bannad spelare ser en överklagandekod i avvisningsmeddelandet (8 bokstäver och siffror). De kan inte ansluta för att överklaga, så överklagandet når dig utanför spelet:

  1. Via din staff. Spelaren skickar koden till din staff (en Discord-ticket, mejl). En staffmedlem registrerar den med sentinel:appeal <code> <text>.
  2. Via webbrouten. Sentinel svarar på din servers egen adress: http://<server address>:<port>/zerodev_sentinel/appeal. Den tar bara emot en POST med JSON { "code": "...", "text": "...", "contact": "optional" } (text 10 till 2000 tecken), så den är tänkt för ett formulär på din webbplats, inte en sida att skicka spelare till. Varje godtagen request får samma svar, 202 "received", oavsett om koden matchade en ban eller inte. För många requests från en adress (5 på 10 minuter) eller totalt (30 per minut) får 429. Bakom din egen HTTPS reverse proxy sätter du set sentinel_http_proxy true så att gränserna räknar besökarens adress.

Avvisningstexten säger inte var man överklagar. Berätta det för spelarna i dina regler, eller skriv din egen text med din länk i Config.Bans.message (behåll %s, det blir koden), till exempel 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Staff beslutar i konsolen eller med sentinel:decide <case or code> accept|reject [note]. Accept häver varje aktiv ban för det kontot eller caset och avbryter en köad wave-ban; reject behåller bannen. Ett beslut är slutgiltigt och skrivs till case-loggen. sentinel:appeals listar de öppna.

10. Rapporter och internal affairs

Player reports. Vilken spelare som helst skriver /report <server id> <what happened> för att rapportera en spelare eller en staffmedlem. De senaste två minuterna runt båda spelarna sparas i ett case. Staff stänger en rapport som åtgärdad, inget regelbrott, inga bevis eller dubblett. Rapporter om staff går bara till ägaren.

Internal affairs (bara ägaren, på owner desk): vad varje staffmedlem gjorde, och vad som behöver kollas (behörigheter till sig själv, att gömma sig i strid, bans utan case, teleporter till spelare). En veckorapport om rättvisa skrivs till data/reports/; sentinel:staff report skriver den nu. Inget i staffloggen straffar staff.

11. Skydda en resource

Utan någon inställning observerar Sentinel varje event som spelare kan skicka till dina skript och bedömer spelaren. Den kan inte hindra en annan resources handler från att köras. För att stoppa ett dåligt anrop innan ett skript körs lägger du till guarden i det skriptet.

  1. sentinel:audit listar de events i varje startad resource som klienter kan trigga, graderade efter vad deras handlers gör (till exempel en handler som ger pengar med ett belopp som klienten väljer). Använd den för att bestämma vilka resources du ska skydda först.
  2. sentinel:guard <resource> skriver ut raden att lägga till och resourcens server_scripts som de skulle se ut. Guard-raden måste vara det första serverskriptet. Kommandot skriver bara ut; det ändrar ingen fil.

lua server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }

  1. Starta om den resourcen. sentinel:guard <resource> säger nu "guarded since ...". sentinel:guard ensamt listar varje skyddad resource.
  2. Lägg till regler med sentinel:patch. Tills en resource har regler släpper dess guard igenom varje anrop, utom anrop från spelare i karantän, som varje guard kastar. Exempel: högst 3 köp på 10 sekunder, ett item-namn på upp till 32 tecken och ett antal från 1 till 10; ett nekat anrop räknas 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}

För en framework-callback skriver du callback:<name> som event: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> listar en resources regler; sentinel:patch <resource> <event> off tar bort en.

Guarden redigerar aldrig filer och ändrar aldrig vad en handler tar emot. Den är vanlig, läsbar Lua i guard/guard.lua.

12. Nycklar för Discord och klipplagring

Enklast är owner desk, KEYS: klistra in varje värde och tryck SAVE. Nycklar sparas bara på servern; desken och varje svar säger bara "set" och visar aldrig en nyckel igen.

Rad på desken Vad det är Eller i server.cfg (använd set, aldrig setr)
Discord bot token en bot du har skapat på discord.com/developers, inbjuden till din server set sentinel_discord_token "..."
Discord server id högerklicka på din server, Copy Server ID (utvecklarläge på) set sentinel_discord_guild "..."
Alert channel id där cases postas, med knappar för din staff set sentinel_discord_channel "..."
Appeals channel id där överklaganden postas set sentinel_discord_appeals "..."
FiveManage key en medianyckel från fivemanage.com; klippen laddas upp dit set sentinel_fivemanage_key "..."
Clip webhook i stället för FiveManage: en Discord-webhook som tar emot klippen set sentinel_clip_webhook "..."
Clip storage fivemanage, discord, off eller automatiskt (den första som är inställd) set sentinel_clip_storage "..."

En nyckel i server.cfg går före desken, och desken säger det. Discord-knapparna följer samma roller och brytare som konsolen. Utan något av detta stannar cases och klipp på din server (data/) och konsolen och panelen visar dem.

De enklare webhook-larmen fungerar fortfarande: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" eller sentinel:webhook set <url> i serverkonsolen. sentinel:webhook test skickar ett testmeddelande; sentinel:webhook visar läget utan att någonsin skriva ut URL:en; sentinel:webhook clear tar bort den sparade.

13. Vad varje regel fångar

Varje regel skriver en vanlig mening när den slår till, som säger vad den såg och vad den uteslöt. Innan en regel räknas mot någon kontrollerar Sentinel de orsaker som skulle förklara det (en respawn, en revive, en staffåtgärd, ett av dina egna skript som flyttar eller betalar spelare). Ett förklarat fynd loggas och ger aldrig poäng.

  • Tier A är bevis: något som bara ett fusk gör (ett bete-event som inget riktigt skript anropar, en förfalskad request).
  • Tier B är starkt: en staffmedlem bör titta. På egen hand öppnar det ett case bara när två olika familjer är överens, eller när samma upprepas.
  • Tier C är svagt: det lägger till poäng och agerar aldrig ensamt.

Rörelse

Regel Fångar Förklaras av Nivå
teleport Ett hopp på över 150 m (eller 3x vad som är möjligt) mellan två mätpunkter spawn, respawn eller revive, byte av routing bucket, staff, ditt skripts teleport-event B
foot_speed Springer över 12 m/s i 1.5 s till fots, utan att falla, utan ragdoll spawn, respawn, staff, ditt skript B
air_float Rör sig trots att spelaren är fryst (noclip); "faller" utan att komma ner (fly); rör sig snabbt enligt koordinaterna medan spelet säger att spelaren står still (speed-menyer) spawn, respawn, staff, ditt skript B
foot_rise Klättrar rakt upp snabbare än 4 m/s till fots i 3 s spawn, respawn, staff, ditt skript B
vehicle_speed Ett fordon över 1.3x det snabbaste dess klass når på din server staff, ditt skript B

Värld

Regel Fångar Förklaras av Nivå
entity_blocked Spawnar en modell du har blockerat dina skript som spawnar den B
entity_rate / entity_model_rate Spawnar långt fler entities (eller en modell) per minut än spelare och skript gör dina skript som spawnar B
entity_untrusted Entities skapade av en klient utan något skript som spawnar dem dina skript som spawnar B
entity_disguised En skur av samma ambient ped-modell runt en spelare (en meny som maskerar sina spawns som trafik) spawn, respawn, byte av bucket B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Explosioner som vapnet i handen inte kan göra, för många, osynliga, eller långt från spelaren dina skripts explosioner B
projectile_weapon / projectile_rate Projektiler som vapnet inte kan avfyra, eller för många B
ptfx_rate Floods av partikeleffekter (en vanlig krasch- och laggattack) B
fire_rate Bränder som startas snabbare än något vapen tillåter B

Strid

Regel Fångar Nivå
damage_plausibility Skada över vapnets möjliga värde B
hit_range Träffar från bortom vapnets räckvidd B
shot_rate / kill_rate Skjuter snabbare än vapnet; kills per minut långt över din server B
silent_aim Träffar där spelaren inte siktade, upprepat B
aim_stats / aim_stats_backed Andel headshots och snap-vinklar långt utanför din servers spelare över 30+ strider C (B med en annan familj)
esp_los_backed Upprepat siktande på spelare som vittnena rapporterar som dolda bakom väggar C till B

Events och requests

Regel Fångar Nivå
bait_event Anropar ett utplacerat event som inget riktigt skript använder (fuskmenyer letar efter och triggar sådana) A
bait_statebag / statebag_write Skriver state bags som bara servern ska skriva (göra sig själv till admin, godmode-flaggor), eller för stora sådana A / B
events_before_ready / _trap Events som skickas innan spelaren ens har spawnat (injicerat före anslutningen) B / A
event_rate / event_shape Ett event som anropas långt snabbare än normalt, eller med argument som inte liknar din servers normala anrop B
event_flood 500+ anrop på 10 s; vid FiveM:s egen overflow-kick listas de vanligaste eventen B
guard_rule / guard_hard Bryter mot en regel du har satt på ett skyddat event (belopp, frekvens, avstånd) B / A

Ekonomi

Regel Fångar Nivå
money_nowhere / item_nowhere Pengar eller items som ingen butik, inget jobb eller skript har delat ut (dev-events, läckta butiksförsäljningar) B
economy_repeat Ett belönings- eller jobb-event som betalats ut 10 gånger på 30 s (farmning genom att anropa det i en loop) B
money_jump / money_rate Ett plötsligt hopp i saldot eller en inkomsttakt långt över din server B
economy_trap Hämtar ut en utplacerad belöning som inget riktigt jobb betalar A
weapon_not_owned Håller ett vapen som inventoryt aldrig gav B

Spelarens spel (vittne)

Regel Fångar Nivå
godmode Servern läser spelaren som odödlig i 30 s (inte en delad safe zone) B
witness_backed Tecken från spelet som stöds av serverns egen bild (godmode, osynlighet, ingen kollision) B
witness_bait Spelet svarar på en kontroll som det inte borde känna till A
witness_tamper Sentinels egna kontroller i spelet har hookats eller ändrats B

Identitet och filer

Regel Fångar Nivå
ban_fingerprint En bannad spelare tillbaka på ett nytt konto (hårdvarutokens, identifierare, webbläsarens fingeravtryck) A / flag
young_account Ett helt nytt konto (lägger bara till vikt) C
scanner_error / too_large Resources som skriptskannern inte kunde läsa, eller för stora filer som är värda en titt info

Vad ingen regel lovar

Sentinel bedömer vad servern kan se och vad en spelares spel rapporterar. Den läser inte andra program på en spelares dator, och ingen anticheat kan lova att varje fusk fångas. Varje fynd kommer med sina bevis, så din staff beslutar utifrån fakta.

14. Kommandon och konfiguration

Varje kommando finns på kommandosidan och varje config-nyckel på konfigurationssidan, båda genererade från själva resourcen. De du använder mest:

Kommando Vad den gör
/sentinel owner <code> ta ägarplatsen i spelet med koden från konsolen
/sentinel panel en engångskod för att logga in i webbpanelen (endast staff)
/report <server id> <what happened> vilken spelare som helst rapporterar en spelare eller en i staff
sentinel:health startrutan igen
sentinel:diag vad Sentinel bestämde och varför
sentinel:level watch\|recommended\|strict ändra skyddsnivån och spara den
sentinel:wave de bans som väntar på nästa ban wave
sentinel:appeals de öppna överklagandena
sentinel:audit de riskabla eventen i varje startad resource
sentinel:guard <resource> raden som skyddar en resource
sentinel:advisor de FiveM-inställningar som är värda att ändra på din server

Konfigfilerna i config/ (config.lua, protection.lua, watch.lua) och översättningarna i config/locales/ är öppna för dig, liksom framework-adaptrarna i bridge/ och guard-filen i guard/. Håll dem som giltig Lua och starta om zerodev_sentinel efter en ändring. Inga ändringar i konfigen behövs för första starten.

15. Startrutan och härdningsrådgivaren

Strax efter att lagringen är klar skriver Sentinel ut en ruta i serverkonsolen. En FAIL-rad betyder att Sentinel inte kan fungera ordentligt; en WARN-rad betyder att det fungerar med mindre (till exempel bevis utan digests). Skriv ut den igen när som helst med sentinel:health.

Rad Vad den kontrollerar När den inte är OK
Build Versionen och buildetiketten från fxmanifest.lua. -
OneSync Convaren onesync. Sentinel läser positioner, entiteter och game events via OneSync. slå på onesync i server.cfg
Körande kopior Hur många kopior av resourcen som är startade, oavsett vad mappen heter. Måste vara 1. behåll en kopia av Sentinel; stoppa den andra mappen
Lagring Vilken lagring som valdes (mysql eller kvp) och om den är redo. se sentinel:diag storage
Bevismapp En testskrivning och testläsning i data/archive inuti resourcen. skapa mappen data/archive inuti Sentinel-resourcen och se till att servern kan skriva till den
SHA-256 Om node/util.js svarar; den tar ett fingeravtryck av varje bevis. bevis sparas utan digests; leta efter ett Node-fel i konsolen
Skydd Skyddsnivån, dess läge och var den kom ifrån. -
Regler Hur många regler som är live och hur många som är i shadow. -

Efter startrutan skriver rådgivaren ut de FiveM-inställningar som är värda att ändra på din server (med Config.Advisor.atStartup = false skrivs de bara ut vid sentinel:advisor). För varje inställning visar den nuvarande värde, rekommenderat värde, vad den blockerar, vad den kan förstöra och raden att kopiera. Den läser bara värdena; den ändrar aldrig server.cfg. Testa en rad på din server innan du behåller den.

16. Språk, och vad som spelas in

Texter för spelare och staff kommer från config/locales/<code>.lua, 25 språk i den här builden. Config.Locale väljer språket; med Config.GameLanguage = true läser en spelare vars spel körs på ett språk som GTA erbjuder Sentinel på det språket när hen väl är i spelet.

Sentinel håller för varje spelare ungefär de senaste två minuterna av positioner och events i minnet (Config.Recorder) och skriver dem till ett arkiv i data/archive/ när ett case öppnas eller staff använder sentinel:save. Under en granskning ber den den misstänktes spel om skärmklipp (segment på 20 sekunder) och sparar dem i data/clips/. Den sparar de identifierare som FiveM ger servern (en IP-adress registreras men används som standard aldrig för att neka en anslutning) och, när Discord körs, Discord-id:t. Första gången de ansluter får varje spelare ett kort meddelande på sitt språk om att servern spelar in spelandet och att staff kan titta och lyssna (Config.Notice = false stänger av det; berätta det då i dina regler). Nämn det också i din integritetspolicy.

Gamla arkiv och klipp raderas inte automatiskt i den här builden: töm data/archive/ och data/clips/ själv när du inte längre behöver dem.

Med oxmysql ligger Sentinels data i tabellerna zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report och zds_trail. Utan oxmysql ligger samma data i resourcens key-value store (nycklar som börjar med zds:). Bans speglas alltid till key-value store, så de gäller fortfarande när databasen ligger nere.

17. Uppdatera

Nya versioner publiceras till samma Keymaster-asset. Sentinel sparar sina bevis i sin egen mapp, så innan du byter ut den:

  1. Säkerhetskopiera mappen zerodev_sentinel: mapparna config/ och data/ (arkiv, klipp, rapporter, inlärda baslinjer) och, med oxmysql, zds_-tabellerna.
  2. Stoppa servern, ersätt mappen zerodev_sentinel med den nya (behåll mappnamnet) och lägg tillbaka din mapp data/. Flytta in inställningarna du ändrat i de nya konfigfilerna i stället för att kopiera gamla filer över dem.
  3. Starta servern och läs startrutan (sentinel:health).

Läs den nya versionens release notes i changeloggen innan du uppdaterar.

18. Avinstallera

  1. Ta bort guard-raden från varje resource du skyddat (sentinel:guard listar dem) och starta om de resourcerna. Gör detta först: guard-filen försvinner när mappen gör det.
  2. Ta bort ensure zerodev_sentinel och raderna sentinel.admin / sentinel.staff från server.cfg och stoppa sedan resourcen. Om sentinel:lockdown ändrade entity lockdown sätter ett stopp av Sentinel tillbaka det ursprungliga läget.
  3. Radera mappen zerodev_sentinel. Det tar bort data/ med alla arkiv, klipp och rapporter, så kopiera ut det du vill behålla.
  4. Med oxmysql: ta bort zds_-tabellerna som listas i avsnitt 16 om du inte längre vill ha dina bans och cases. Key-value-posterna ligger kvar i serverns lagring under resourcens namn och gör ingenting utan den.

Sentinel skriver bara i sin egen mapp, sina databastabeller och sin key-value-lagring. Den ändrar inga andra resources och inte server.cfg.

Vanliga frågor

Bannar eller kickar Sentinel någon på egen hand?

Inte på Watch eller Recommended. Den startar på Watch, där den bara loggar vad den skulle ha gjort. På Recommended får staff bevisen och bestämmer. Bara på Strict sätter en hög poäng en spelare i karantän tills staff tittar, och ett fynd på bevisnivå köar en ban till nästa ban wave.

Behöver jag en databas?

Nej. Med oxmysql sparar Sentinel sina data i din databas och skapar sina egna tabeller vid första starten; det finns ingen SQL-fil att importera. Utan det ligger allt i resourcens egen key-value-lagring.

Fungerar det på QBCore och Qbox?

Ja. Detektion, cases, klipp, konsolen, webbpanelen, Discord och owner desk är likadana på alla frameworks. Spåret för pengar och items har en egen adapter för ESX, QBCore, Qbox och ox_inventory.

Hur ger jag mina admins åtkomst?

På owner desk, STAFF: välj en spelare som är online, välj en roll, tryck GRANT. Eller fortsätt använda ACE: sentinel.admin ger Admin och sentinel.staff ger Moderator.

Kan en bannad spelare överklaga?

Ja. Avvisningsmeddelandet visar en överklagandekod. Spelaren skickar den till din staff, som registrerar den med sentinel:appeal, eller så skickar din webbplats den till Sentinels appeal-route. Staff godkänner eller avslår den i konsolen eller med sentinel:decide.

Kan den se fuskprogram på en spelares dator?

Nej. Sentinel bedömer det servern kan se och det en spelares spel rapporterar. Den läser inte andra program på en spelares dator.

Är avlyssning av röstchatt klar?

Den kräver pma-voice och lyssnarbrytaren (som standard bara för ägaren), och spelas upp genom ditt eget spel.

Vad ser spelarna?

Första gången de ansluter, ett kort meddelande på deras språk om att servern spelar in spelandet och att staff kan titta och lyssna (Config.Notice). För en ärlig spelare ändras inget annat.

Översatt från engelska. Om något här skiljer sig från den engelska sidan är det den engelska sidan som gäller. English