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.
1. Krav
- OneSync på (
set onesync oni 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 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
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.adminfungerar som ACE-grupp när du lägger till raden för den.
QBCore
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
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)
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:
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:
- Watch under några dagar med vanligt spel.
- 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) ochsentinel:diag decisions 100. - Lås varje regel som flaggade någon du litar på till Shadow, och berätta det för oss.
- Byt till Recommended. Staff ser nu cases och bevis; ingen straffas automatiskt.
- 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:
- Via din staff. Spelaren skickar koden till din staff (en Discord-ticket, mejl). En staffmedlem registrerar den med
sentinel:appeal <code> <text>. - 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 duset sentinel_http_proxy trueså 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.
sentinel:auditlistar 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.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' }
- Starta om den resourcen.
sentinel:guard <resource>säger nu "guarded since ...".sentinel:guardensamt listar varje skyddad resource. - 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:
- Säkerhetskopiera mappen
zerodev_sentinel: mapparnaconfig/ochdata/(arkiv, klipp, rapporter, inlärda baslinjer) och, med oxmysql,zds_-tabellerna. - Stoppa servern, ersätt mappen
zerodev_sentinelmed den nya (behåll mappnamnet) och lägg tillbaka din mappdata/. Flytta in inställningarna du ändrat i de nya konfigfilerna i stället för att kopiera gamla filer över dem. - Starta servern och läs startrutan (
sentinel:health).
Läs den nya versionens release notes i changeloggen innan du uppdaterar.
18. Avinstallera
- Ta bort guard-raden från varje resource du skyddat (
sentinel:guardlistar dem) och starta om de resourcerna. Gör detta först: guard-filen försvinner när mappen gör det. - Ta bort
ensure zerodev_sentineloch radernasentinel.admin/sentinel.stafffrån server.cfg och stoppa sedan resourcen. Omsentinel:lockdownändrade entity lockdown sätter ett stopp av Sentinel tillbaka det ursprungliga läget. - Radera mappen
zerodev_sentinel. Det tar bortdata/med alla arkiv, klipp och rapporter, så kopiera ut det du vill behålla. - 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.