Documentația ZeroDev Sentinel

ZeroDev Sentinel: instalare și utilizare

ZeroDev Sentinel este o resursă anti-cheat server-side pentru FiveM. Înregistrează ce vede serverul, judecă totul cu reguli care se explică singure în propoziții simple și îi dă staffului tău dovezile înainte ca cineva să fie pedepsit. Pornește pe nivelul de protecție Watch: înregistrează și nu pedepsește pe nimeni până nu alegi altceva. Acest ghid acoperă versiunea 0.1.2 pe servere ESX, QBCore, Qbox și standalone.

Pentru ZeroDev Sentinel 0.1.223 min de cititActualizat

1. Cerințe

  • OneSync pornit (set onesync on în server.cfg). Resursa declară OneSync ca dependență, așa că FXServer nu o pornește fără OneSync.
  • Un artifact FXServer care rulează scripturi Node 22 (orice artifact recomandat actual; manifestul cere node_version '22'). Node se ocupă de hashing, compresie, listarea fișierelor și ruta web pentru contestații.
  • Opțional: oxmysql. Cu el, Sentinel își ține datele în baza ta de date și își creează singur tabelele la prima pornire. Nu există niciun fișier SQL de importat. Fără el, totul stă în stocarea key-value proprie a resursei.
  • Opțional: pma-voice, pentru ascultarea chatului vocal al unui jucător din consolă sau din panoul din browser.

Framework-ul contează doar pentru două lucruri: urma banilor și a itemelor (bani și iteme pe care nu le-a plătit niciun shop, job sau script, bucle de recompense, rollback-uri) și cine face parte din staff (grupuri ACE, pe care le folosește orice framework). Detecția, cazurile, clipurile, consola, panoul din browser, Discord și owner desk funcționează la fel pe orice framework.

2. Instalare în cinci minute

Nimic nu are nevoie de SQL, pentru prima pornire nu trebuie să modifici configul și nicio altă resursă nu este schimbată.

Pasul 1: Pune folderul în resources

Copiază folderul zerodev_sentinel în folderul tău resources. Păstrează exact acest nume de folder: fișierul guard raportează către zerodev_sentinel, iar sentinel:guard te avertizează când folderul se numește altfel.

Pasul 2: Adaugă-l în server.cfg

Pornește-l după oxmysql și framework-ul tău, ca stocarea și urma banilor să le găsească la pornire. Ordinea exactă pentru framework-ul tău este în secțiunea 3.

Pasul 3: Pornește serverul

Consola afișează o casetă de pornire și un cod de proprietar de unică folosință. Fiecare rând din casetă este o verificare reală; ultima linie spune READY sau NOT READY, cu numărul de probleme (secțiunea 15).

Pasul 4: Revendică locul de proprietar

Intră pe server și scrie /sentinel owner <code> în chat. Acum locul de proprietar este al tău (secțiunea 4).

Pasul 5: Deschide owner desk

Apasă F7 în joc (sau scrie sentinel:console în F8) și deschide OWNER. Fila First run arată ce e gata și ce nu: Discord, stocarea clipurilor, staff-ul tău și permisiunile lui. Fiecare linie are un buton. Apoi joacă câteva zile pe Watch, citește în fila Right now ce a găsit Sentinel și schimbă nivelul de protecție pe Recommended în același desk (secțiunea 6).

3. Framework-ul tău

Sentinel găsește singur framework-ul și inventory-ul la pornire. Nu e nimic de setat. sentinel:trail în consola serverului arată ce adaptor a ales.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Bani și iteme: citite din evenimentele de server proprii ale ESX (bani în cont adăugați, scoși sau setați; iteme din inventory adăugate sau scoase; iteme date de la un jucător la altul, cu ambele părți legate). Rollback-ul folosește metodele de jucător proprii ale ESX și citește înapoi rezultatul.
  • ESX cu ox_inventory: banii sunt urmăriți la fel. În acest mod metodele de iteme ale ESX nu raportează rezultate, așa că Sentinel decide doar pe baza recitirii.
  • Staff: dă-le adminilor tăi permisiunea ACE (secțiunea 5). group.admin propriu al ESX funcționează ca grup ACE când adaugi linia pentru el.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Bani: citiți din evenimentul de schimbare a banilor din QBCore (adăugare, scoatere și setare, cu motivul). O pierdere și un câștig egal în același moment sunt legate ca transfer, pentru că QBCore nu are un eveniment de transfer propriu.
  • Iteme: cu ox_inventory, itemele sunt urmărite prin hook-urile lui. Cu qb-inventory, schimbările de iteme nu sunt urmărite (payload-ul listenerului său nu este documentat), dar un rollback poate totuși muta iteme cu exporturile documentate ale qb-inventory.
  • Staff: grupurile de permisiuni din QBCore sunt grupuri ACE (group.admin, group.god). Adaugă liniile ACE din secțiunea 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Bani: citiți din evenimentul de schimbare a banilor din Qbox; soldurile sunt recitite cu exporturile proprii ale qbx_core. Banii schimbați pentru un personaj offline (după citizen id) nu declanșează niciun eveniment, deci nu apar în urmă.
  • Iteme: Qbox folosește ox_inventory, iar Sentinel îi urmărește itemele prin hook-urile ox_inventory. Itemele care țin locul banilor din framework sunt lăsate în seama părții de framework.
  • Staff: grupuri ACE, ca pe QBCore.

Standalone (fără framework)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Totul în afară de urma banilor și a itemelor funcționează: mișcare, lume, evenimente, evenimente-capcană, godmode, state bags, arme, cazuri, clipuri, replay, consolă, panou, Discord, roluri și banuri.
  • Cu ox_inventory și fără framework, itemele sunt urmărite prin ox_inventory.
  • Stocare: stocarea key-value sau oxmysql, dacă îl pornești primul.

Verifică dacă funcționează

  • sentinel:health: din nou caseta de pornire. Fiecare rând este o verificare reală; READY înseamnă că nu lipsește nimic.
  • sentinel:diag: de ce au fost alese stocarea, adaptoarele și nivelul, fiecare regulă cu contoarele ei și cele mai recente decizii.
  • sentinel:trail: adaptorul de bani și iteme folosit și ultimele schimbări ale unui jucător.

În modul automat de stocare, Sentinel folosește oxmysql doar când oxmysql este deja pornit (așteaptă până la 15 secunde cât oxmysql pornește); dacă oxmysql pornește mai târziu, folosește stocarea key-value.

4. Prima pornire: locul de proprietar

Prima pornire afișează în consola serverului un cod de unică folosință, valabil 30 de minute (sentinel:owner code afișează unul nou). Intră și scrie /sentinel owner <code>: locul este legat de contul tău, iar codul expiră.

Doar locul de proprietar poate schimba cheile, nivelul de protecție, rolurile și permisiunile. sentinel:owner reset în consola serverului eliberează locul dacă trebuie să-l muți pe alt cont.

5. Staff și permisiuni

În owner desk, STAFF: alege un jucător online, alege un rol, apasă GRANT. Vin patru roluri incluse:

Rol Poate, din start
Suport vede cazuri, rezolvă raportări, harta de serviciu
Moderator ca Support, plus replay-uri, kick și carantină
Admin ca Moderator, plus dezvăluire, exonerare, vizualizare live, cereri de ban, contestații
Senior admin ca Admin, plus un ban care se aplică imediat

Permisiunile le alegi tu. Fiecare rol este o listă de comutatoare pe care le poți schimba. Creează-ți propriile roluri dintr-o copie (de exemplu "Trial mod"), redenumește orice rol și dă-i unei persoane un comutator în plus sau ia-i unul, fără să-i schimbi rolul. Comutatoarele marcate ca periculoase (ban imediat, ascultarea chatului vocal, setări, gestionarea staffului) cer o a doua apăsare. Fiecare schimbare este scrisă în registrul staffului, așa că vezi mereu cine ce a schimbat.

ACE funcționează în continuare pentru serverele care îl folosesc deja și este citit la fiecare verificare:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Permisiune Rolul pe care îl dă
sentinel.admin Admin (Senior admin până când locul de proprietar este revendicat) și orice comandă sentinel:* în joc
sentinel.staff Moderator; regulile de mișcare tratează mișcarea proprie a unui membru al staffului ca explicată

Câteva comenzi (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) sunt înregistrate ca restricționate: în joc au nevoie și de command.<name>. Linia obișnuită add_ace group.admin command allow acoperă asta. Consola serverului poate rula orice comandă.

6. Nivelul de protecție

Un singur comutator în owner desk (OWNER, PROTECTION), plus sentinel:level în consola serverului și Config.Protection în config/config.lua. Ce setezi în desk se salvează și are prioritate față de linia din config după un restart.

  • Watch: fiecare regulă urmărește și notează ce ar fi făcut; nimeni nu primește alertă și nu se întâmplă nimic nimănui. Între timp, Sentinel învață ce e normal pe serverul tău: observatorul de evenimente (frecvența și forma fiecărui eveniment) și verificarea la conectare învață doar pe Watch; limitele pentru entități, luptă și bani continuă să învețe din jocul curat.
  • Recommended: fiecare regulă este live. Staff-ul primește alerte cu dovezile și se deschide un caz. Sentinel nu pedepsește niciodată de unul singur; decide staff-ul tău.
  • Strict: ca Recommended, iar un scor mare îl pune pe jucător în carantină până se uită staff-ul; o constatare la nivel de dovadă (Tier A: un eveniment-capcană declanșat, o cerere falsificată) pune în plus un ban în coada pentru ban wave.

Sub comutator, desk-ul listează fiecare regulă cu starea ei și de unde vine acea stare. Acolo poți fixa o singură regulă pe Live sau Shadow, dacă serverul tău are nevoie (de exemplu o regulă care tot marchează unul dintre scripturile tale); o linie state în Config.Rules o fixează în fișierul de config și are prioritate față de desk.

O ordine rezonabilă:

  1. Watch câteva zile de joc normal.
  2. Citește ce ar fi făcut regulile: fila Right now, sentinel:diag rules (coloana shadow numără de câte ori o regulă ar fi dat scor) și sentinel:diag decisions 100.
  3. Fixează pe Shadow orice regulă care a marcat pe cineva în care ai încredere și spune-ne.
  4. Treci pe Recommended. Staff-ul vede acum cazuri și dovezi; nimeni nu este pedepsit automat.
  5. Strict când ai încredere în ce îți arată Recommended.

Ca să revii oricând: Watch în desk sau sentinel:level watch.

7. Consola staffului (F7)

Apasă F7 în joc (sau scrie sentinel:console în F8). Fiecare jucător poate schimba tasta din setările jocului (Key Bindings, FiveM). Esc o închide.

  • Right now spune pe înțelesul tuturor ce se întâmplă pe serverul tău: cine pare o amenințare și de ce, ce a fost dovedit, ce a fost explicat (un revive, teleportul propriu al unui script) și ce are nevoie de tine. Fiecare jucător care contează primește un rând: ce a făcut, ce este probabil, cât de sigur e Sentinel (Unusual, Suspicious, Very likely, Proven), ce a făcut deja Sentinel și un singur pas următor.
  • Case files: cazurile deschise mai întâi, fiecare cu constatarea, dovezile, clipurile de ecran, sigiliul (dacă lanțul de hash-uri al cazului se mai verifică) și tastele REVEAL, QUARANTINE, CLEAR și BAN (CLEAR și BAN cer o a doua apăsare).
  • Duty map: jucătorii online pe un model 3D al insulei. Terenul e măsurat de jocul primului membru din staff și păstrat în data/map/.
  • Play replay închide consola și redă incidentul într-o lume privată; apasă Backspace ca să te întorci.
  • Owner (doar locul de proprietar): First run, Protection, Keys, Staff, Internal affairs și Server check.

Comenzile scrise în joc se dau în F8 fără slash sau în chat cu slash (/sentinel:diag).

8. Panoul din browser

Același desk într-un browser web, pentru când nu ești în joc:

  • pe PC-ul serverului: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (portul e portul serverului tău, 30120 implicit)
  • din altă parte: http://<server address>:<port>/zerodev_sentinel/panel/ sau propria ta adresă HTTPS pusă în fața lui

Autentificare. Folosește un cod de unică folosință: scrie /sentinel panel în joc (codul ți se arată doar ție, merge o singură dată, timp de 5 minute) sau rulează sentinel:panel <id or account> în consola serverului. O sesiune durează 8 ore; SIGN OUT și END ALL MY SESSIONS o încheie. Rolul și comutatoarele tale se aplică în browser exact ca în joc.

Live view. Staff-ul care are comutatorul de live view poate urmări ecranul oricărui jucător online din panou sau din consolă. Nimic nu se păstrează pe disc dacă nu apeși Save to case.

Ascultare. Ca să asculți chatul vocal al acelui jucător ai nevoie de comutatorul de ascultare (implicit doar proprietarul) și de pma-voice. Sunetul se aude prin propriul tău joc, așa că trebuie să fii în joc pe același server.

Fiecare live view și fiecare ascultare se scrie în registrul de staff și în cazul jucătorului, iar jucătorilor li se spune la prima intrare că staff-ul poate urmări și asculta (notificarea de înregistrare, Config.Notice).

9. Cazuri, carantină, kick, ban și contestații

Când se găsește ceva, Right now numește jucătorul pe înțelesul tuturor: ce a făcut, cât de sigur e Sentinel și ce a făcut în privința asta. Deschide cazul ca să vezi dovezile (poziții, clipuri de ecran sigilate cu SHA-256, un replay 3D) și folosește tastele:

  • REVEAL: arată identificatorii jucătorului.
  • QUARANTINE: mută jucătorul din lumea reală într-un routing bucket privat până se uită staff-ul. sentinel:release <server id> îl aduce înapoi.
  • CLEAR: nu e cheat; închide cazul și oprește banul lui pus la coadă.
  • KICK: afară de pe server, cu un motiv pe care jucătorul îl citește.
  • BAN: prin ban wave, cu un cod de contestație.

Ban wave. Banurile, inclusiv un BAN apăsat în consolă, sunt puse la coadă pentru ban wave și se aplică doar pe Strict, la un moment aleatoriu, implicit între 2 și 24 de ore mai târziu (Config.Actions). sentinel:wave le listează, sentinel:wave now <account> aplică unul pe loc, sentinel:wave cancel <account> îl anulează.

Contestații. Un jucător banat vede un cod de contestație în mesajul de refuz (8 litere și cifre). Nu poate intra pe server ca să conteste, așa că contestația ajunge la tine din afara jocului:

  1. Prin staff-ul tău. Jucătorul trimite codul staff-ului tău (un tichet pe Discord, e-mail). Un membru din staff îl înregistrează cu sentinel:appeal <code> <text>.
  2. Prin ruta web. Sentinel răspunde pe adresa proprie a serverului tău: http://<server address>:<port>/zerodev_sentinel/appeal. Acceptă doar un POST cu JSON { "code": "...", "text": "...", "contact": "optional" } (text de 10 până la 2000 de caractere), deci e gândită pentru un formular de pe site-ul tău, nu ca pagină la care să trimiți jucătorii. Fiecare cerere acceptată primește același răspuns, 202 "received", indiferent dacă codul corespunde unui ban sau nu. Prea multe cereri de la o singură adresă (5 în 10 minute) sau în total (30 pe minut) primesc 429. În spatele propriului tău reverse proxy HTTPS, setează set sentinel_http_proxy true pentru ca limitele să numere adresa vizitatorului.

Textul de refuz nu spune unde se face contestația. Spune-le jucătorilor în regulament sau scrie propriul text, cu linkul tău, în Config.Bans.message (păstrează %s, devine codul), de exemplu 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Staff-ul decide în consolă sau cu sentinel:decide <case or code> accept|reject [note]. Accept ridică fiecare ban activ al acelui cont sau caz și anulează un ban pus la coadă pentru wave; reject păstrează banul. O decizie e definitivă și se scrie în logul cazului. sentinel:appeals le listează pe cele deschise.

10. Raportări și internal affairs

Player reports. Orice jucător scrie /report <server id> <what happened> ca să raporteze un jucător sau un membru din staff. Ultimele două minute din jurul ambilor jucători se salvează într-un caz. Staff-ul închide o raportare ca rezolvată cu măsuri, fără încălcare, fără dovezi sau duplicat. Raportările despre staff ajung doar la proprietar.

Internal affairs (doar proprietarul, pe owner desk): ce a făcut fiecare membru din staff și ce trebuie verificat (permisiuni date sieși, ascunderea în luptă, banuri fără caz, teleporturi la jucători). Un raport săptămânal de corectitudine se scrie în data/reports/; sentinel:staff report îl scrie pe loc. Nimic din registrul de staff nu pedepsește staff-ul.

11. Protejarea unei resurse

Fără nicio configurare, Sentinel observă fiecare eveniment pe care jucătorii îl pot trimite scripturilor tale și judecă jucătorul. Nu poate opri handlerul altei resurse să ruleze. Ca să oprești un apel rău înainte să ruleze un script, adaugă guard-ul în acel script.

  1. sentinel:audit listează evenimentele fiecărei resurse pornite pe care clienții le pot declanșa, clasificate după ce fac handlerele lor (de exemplu un handler care dă bani cu o sumă aleasă de client). Folosește-l ca să decizi ce resurse protejezi mai întâi.
  2. sentinel:guard <resource> afișează linia de adăugat și server_scripts ale resursei așa cum ar arăta. Linia de guard trebuie să fie primul script de server. Comanda doar afișează; nu modifică niciun fișier.

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

  1. Repornește acea resursă. sentinel:guard <resource> spune acum "guarded since ...". sentinel:guard singur listează fiecare resursă protejată.
  2. Adaugă reguli cu sentinel:patch. Până când o resursă are reguli, guard-ul ei lasă să treacă orice apel, în afară de apelurile de la jucătorii în carantină, pe care orice guard le respinge. Exemplu: cel mult 3 cumpărări în 10 secunde, un nume de item de până la 32 de caractere și o cantitate de la 1 la 10; un apel refuzat contează ca dovadă ("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}

Pentru un callback de framework, scrie callback:<name> ca eveniment: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> listează regulile unei resurse; sentinel:patch <resource> <event> off elimină una.

Guard-ul nu editează niciodată fișiere și nu schimbă niciodată ce primește un handler. E Lua simplu, lizibil, în guard/guard.lua.

12. Chei pentru Discord și stocarea clipurilor

Cel mai simplu e pe owner desk, KEYS: lipește fiecare valoare și apasă SAVE. Cheile se păstrează doar pe server; desk-ul și fiecare răspuns spun doar "set" și nu mai arată niciodată o cheie.

Linia de pe desk Ce este Sau în server.cfg (folosește set, niciodată setr)
Token de bot Discord un bot făcut de tine pe discord.com/developers, invitat pe serverul tău set sentinel_discord_token "..."
ID-ul serverului de Discord click dreapta pe serverul tău, Copy Server ID (cu modul developer activat) set sentinel_discord_guild "..."
ID-ul canalului de alerte unde se postează cazurile, cu butoane pentru staff-ul tău set sentinel_discord_channel "..."
ID-ul canalului de contestații unde se postează contestațiile set sentinel_discord_appeals "..."
Cheie FiveManage o cheie media de pe fivemanage.com; clipurile se încarcă acolo set sentinel_fivemanage_key "..."
Webhook pentru clipuri în loc de FiveManage: un webhook de Discord care primește clipurile set sentinel_clip_webhook "..."
Stocarea clipurilor fivemanage, discord, off sau automatic (primul care e setat) set sentinel_clip_storage "..."

O cheie din server.cfg are prioritate față de desk, iar desk-ul îți spune asta. Butoanele din Discord urmează aceleași roluri și comutatoare ca în consolă. Fără niciuna dintre ele, cazurile și clipurile rămân pe serverul tău (data/), iar consola și panoul le arată.

Alertele mai simple prin webhook încă funcționează: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" sau sentinel:webhook set <url> în consola serverului. sentinel:webhook test trimite un mesaj de test; sentinel:webhook arată starea fără să afișeze vreodată URL-ul; sentinel:webhook clear îl șterge pe cel salvat.

13. Ce prinde fiecare regulă

Fiecare regulă scrie o propoziție simplă când se declanșează, în care spune ce a văzut și ce a exclus. Înainte ca o regulă să conteze împotriva cuiva, Sentinel verifică motivele care ar explica-o (un respawn, un revive, o acțiune a staff-ului, unul dintre scripturile tale care mută sau plătește jucători). O constatare explicată se înregistrează în log și nu primește niciodată scor.

  • Tier A înseamnă dovadă: ceva ce face doar un cheat (un eveniment-capcană pe care niciun script real nu îl apelează, o cerere falsificată).
  • Tier B înseamnă puternic: un membru din staff ar trebui să se uite. De unul singur deschide un caz doar când două familii diferite sunt de acord sau când aceeași se repetă.
  • Tier C înseamnă slab: adaugă la scor și nu acționează niciodată singur.

Mișcare

Regulă Prinde Explicat de Tier
teleport Un salt de peste 150 m (sau de 3x cât e posibil) între două eșantioane spawn, respawn sau revive, schimbare de routing bucket, staff, evenimentul de teleport al scriptului tău B
foot_speed Alergare cu peste 12 m/s timp de 1.5 s pe jos, fără cădere, fără ragdoll spawn, respawn, staff, scriptul tău B
air_float Mișcare în timp ce e înghețat (noclip); "cădere" fără să coboare (fly); mișcare rapidă după coordonate în timp ce jocul spune că jucătorul stă pe loc (meniuri de viteză) spawn, respawn, staff, scriptul tău B
foot_rise Urcare drept în sus cu peste 4 m/s pe jos timp de 3 s spawn, respawn, staff, scriptul tău B
vehicle_speed Un vehicul la peste 1.3x din cea mai mare viteză atinsă de clasa lui pe serverul tău staff, scriptul tău B

Lume

Regulă Prinde Explicat de Tier
entity_blocked Spawnarea unui model pe care l-ai blocat scripturile tale care îl spawnează B
entity_rate / entity_model_rate Spawnarea a mult mai multe entități (sau a unui singur model) pe minut decât o fac jucătorii și scripturile scripturile tale care spawnează B
entity_untrusted Entități create de un client fără niciun script care să le spawneze scripturile tale care spawnează B
entity_disguised O rafală cu același model de ped ambiental în jurul unui singur jucător (un meniu care își deghizează spawnurile în trafic) spawn, respawn, schimbare de bucket B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Explozii pe care arma ținută nu le poate produce, prea multe, invizibile sau departe de jucător exploziile scripturilor tale B
projectile_weapon / projectile_rate Proiectile pe care arma nu le poate trage sau prea multe B
ptfx_rate Flood-uri de efecte de particule (un atac frecvent de crash și lag) B
fire_rate Focuri pornite mai repede decât permite orice armă B

Luptă

Regulă Prinde Tier
damage_plausibility Damage peste valoarea posibilă a armei B
hit_range Lovituri de dincolo de raza armei B
shot_rate / kill_rate Tragere mai rapidă decât arma; kill-uri pe minut cu mult peste serverul tău B
silent_aim Lovituri în locuri spre care jucătorul nu țintea, repetate B
aim_stats / aim_stats_backed Procentul de headshot-uri și unghiurile de snap cu mult în afara jucătorilor de pe serverul tău, pe 30+ lupte C (B cu altă familie)
esp_los_backed Țintire repetată spre jucători pe care martorii îi raportează ascunși după pereți de la C la B

Evenimente și cereri

Regulă Prinde Tier
bait_event Apelarea unui eveniment plantat pe care niciun script real nu îl folosește (meniurile de cheat le caută și le declanșează) A
bait_statebag / statebag_write Scrierea de state bags pe care doar serverul ar trebui să le scrie (să te faci admin, flaguri de godmode) sau a unora supradimensionate A / B
events_before_ready / _trap Evenimente trimise înainte ca jucătorul să fi apucat măcar să se spawneze (injectate înainte de intrare) B / A
event_rate / event_shape Un eveniment apelat mult mai repede decât e normal sau cu argumente care nu seamănă cu apelurile normale de pe serverul tău B
event_flood 500+ apeluri în 10 s; la kick-ul de overflow al FiveM, evenimentele din top sunt listate B
guard_rule / guard_hard Încălcarea unei reguli pe care ai setat-o pe un eveniment protejat (sumă, frecvență, distanță) B / A

Economie

Regulă Prinde Tier
money_nowhere / item_nowhere Bani sau iteme pe care nu le-a dat niciun shop, job sau script (evenimente de dev, vânzări de shop expuse) B
economy_repeat O recompensă sau un eveniment de job plătit de 10 ori în 30 s (farm prin apelarea lui în buclă) B
money_jump / money_rate Un salt brusc al soldului sau un ritm de plată cu mult peste serverul tău B
economy_trap Revendicarea unei recompense plantate pe care niciun job real nu o plătește A
weapon_not_owned Ținerea unei arme pe care inventarul nu a dat-o niciodată B

Jocul jucătorului (martor)

Regulă Prinde Tier
godmode Serverul îl citește pe jucător ca invincibil timp de 30 s (nu într-o safe zone comună) B
witness_backed Semne din joc susținute de ce vede serverul însuși (godmode, invizibilitate, fără coliziune) B
witness_bait Jocul răspunde la o verificare despre care n-ar trebui să știe A
witness_tamper Verificările proprii ale lui Sentinel din joc au fost hook-uite sau modificate B

Identitate și fișiere

Regulă Prinde Tier
ban_fingerprint Un jucător banat revenit pe un cont nou (tokenuri hardware, identificatori, amprentă de browser) A / flag
young_account Un cont nou-nouț (doar adaugă greutate) C
scanner_error / too_large Resurse pe care scannerul de scripturi nu le-a putut citi sau fișiere supradimensionate care merită verificate info

Ce nu promite nicio regulă

Sentinel judecă ce poate vedea serverul și ce raportează jocul unui jucător. Nu citește alte programe de pe PC-ul unui jucător și niciun anti-cheat nu poate promite că orice cheat e prins. Fiecare constatare vine cu dovezile ei, așa că staff-ul tău decide pe baza faptelor.

14. Comenzi și configurare

Fiecare comandă e pe pagina de comenzi și fiecare cheie de config pe pagina de configurare, ambele generate din resursa în sine. Cele pe care le folosești cel mai des:

Comandă Ce face
/sentinel owner <code> revendici locul de proprietar în joc, cu codul din consolă
/sentinel panel un cod de autentificare de unică folosință pentru panoul din browser (doar staff)
/report <server id> <what happened> orice jucător raportează un jucător sau un membru din staff
sentinel:health din nou caseta de pornire
sentinel:diag ce a decis Sentinel și de ce
sentinel:level watch\|recommended\|strict schimbă nivelul de protecție și îl salvează
sentinel:wave banurile puse la coadă pentru ban wave
sentinel:appeals contestațiile deschise
sentinel:audit evenimentele riscante ale fiecărei resurse pornite
sentinel:guard <resource> linia care protejează o resursă
sentinel:advisor setările FiveM care merită schimbate pe serverul tău

Fișierele de config din config/ (config.lua, protection.lua, watch.lua) și traducerile din config/locales/ îți sunt deschise, la fel ca adaptoarele de framework din bridge/ și fișierul guard din guard/. Păstrează-le Lua valid și repornește zerodev_sentinel după o modificare. Pentru prima pornire nu e nevoie de nicio modificare în config.

15. Caseta de pornire și consilierul de hardening

La un moment după ce stocarea e gata, Sentinel afișează o casetă în consola serverului. Un rând FAIL înseamnă că Sentinel nu poate funcționa cum trebuie; un rând WARN înseamnă că funcționează cu mai puțin (de exemplu dovezi fără digesturi). O poți afișa din nou oricând cu sentinel:health.

Rând Ce verifică Când nu e OK
Build Versiunea și eticheta de build din fxmanifest.lua. -
OneSync Convarul onesync. Sentinel citește pozițiile, entitățile și evenimentele de joc prin OneSync. set onesync on în server.cfg
Copies running Câte copii ale resursei sunt pornite, indiferent cum se numește folderul lor. Trebuie să fie 1. păstrează o singură copie de Sentinel; oprește celălalt folder
Stocare Ce stocare a fost aleasă (mysql sau kvp) și dacă e gata. vezi sentinel:diag storage
Evidence folder O scriere și o citire de test în data/archive, în interiorul resursei. creează folderul data/archive în interiorul resursei Sentinel și asigură-te că serverul poate scrie în el
SHA-256 Dacă node/util.js răspunde; el amprentează fiecare dovadă. dovezile se salvează fără digesturi; verifică în consolă dacă există o eroare Node
Protection Nivelul de protecție, modul lui și de unde provine. -
Reguli Câte reguli sunt live și câte sunt în shadow. -

După caseta de pornire, consilierul afișează setările FiveM care merită schimbate pe serverul tău (Config.Advisor.atStartup = false îl afișează doar la sentinel:advisor). Pentru fiecare setare arată valoarea curentă, pe cea recomandată, ce blochează, ce ar putea strica și linia de copiat. Doar citește valorile; nu modifică niciodată server.cfg. Testează o linie pe serverul tău înainte să o păstrezi.

16. Limbi, și ce se înregistrează

Textele pentru jucători și staff vin din config/locales/<code>.lua, 25 de limbi în acest build. Config.Locale alege limba; cu Config.GameLanguage = true, un jucător al cărui joc rulează într-o limbă oferită de GTA citește Sentinel în acea limbă odată ajuns în joc.

Sentinel păstrează în memorie, pentru fiecare jucător, cam ultimele două minute de poziții și evenimente (Config.Recorder) și le scrie într-o arhivă din data/archive/ când se deschide un caz sau când staff-ul folosește sentinel:save. În timpul unei analize, cere jocului suspectului clipuri de ecran (segmente de 20 de secunde) și le stochează în data/clips/. Stochează identificatorii pe care FiveM îi dă serverului (o adresă IP e înregistrată, dar implicit nu e folosită niciodată pentru a refuza o conexiune) și, când rulează Discord, ID-ul de Discord. La prima intrare, fiecare jucător primește o scurtă notificare în limba lui că serverul înregistrează jocul și că staff-ul poate urmări și asculta (Config.Notice = false o dezactivează; atunci spune-le în regulament). Menționeaz-o și în politica ta de confidențialitate.

Arhivele și clipurile vechi nu se șterg automat în acest build: golește singur data/archive/ și data/clips/ când nu mai ai nevoie de ele.

Cu oxmysql, înregistrările lui Sentinel sunt în tabelele zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report și zds_trail. Fără oxmysql, aceleași înregistrări stau în stocarea key-value a resursei (chei care încep cu zds:). Banurile sunt mereu copiate și în stocarea key-value, așa că rămân aplicate cât timp baza de date e căzută.

17. Actualizare

Versiunile noi se publică în același asset din Keymaster. Sentinel își ține dovezile în propriul folder, așa că înainte să-l înlocuiești:

  1. Din folderul zerodev_sentinel, fă backup la folderele config/ și data/ (arhive, clipuri, rapoarte, baseline-uri învățate) și, cu oxmysql, la tabelele zds_.
  2. Oprește serverul, înlocuiește folderul zerodev_sentinel cu cel nou (păstrează numele folderului) și pune-ți folderul data/ la loc. Mută setările pe care le-ai schimbat în noile fișiere de config, în loc să copiezi fișierele vechi peste ele.
  3. Pornește serverul și citește caseta de pornire (sentinel:health).

Citește notele de lansare ale noii versiuni în changelog înainte să actualizezi.

18. Dezinstalare

  1. Scoate linia de guard din fiecare resursă pe care ai protejat-o (sentinel:guard le listează) și repornește acele resurse. Fă asta mai întâi: fișierul guard dispare odată cu folderul.
  2. Scoate ensure zerodev_sentinel și liniile sentinel.admin / sentinel.staff din server.cfg, apoi oprește resursa. Dacă sentinel:lockdown a schimbat entity lockdown, oprirea lui Sentinel pune la loc modul original.
  3. Șterge folderul zerodev_sentinel. Asta elimină data/ cu toate arhivele, clipurile și rapoartele, așa că scoate de acolo tot ce vrei să păstrezi.
  4. Cu oxmysql, șterge tabelele zds_ listate în secțiunea 16 dacă nu mai vrei banurile și cazurile. Înregistrările key-value rămân în stocarea serverului sub numele resursei și nu fac nimic fără ea.

Sentinel scrie doar în propriul folder, în propriile tabele din baza de date și în propria stocare key-value. Nu modifică alte resurse și nici server.cfg.

Întrebări frecvente

Dă Sentinel ban sau kick cuiva de unul singur?

Nu pe Watch sau Recommended. Pornește pe Watch, unde doar înregistrează ce ar fi făcut. Pe Recommended, staff-ul primește dovezile și decide. Doar pe Strict un scor mare pune un jucător în carantină până se uită staff-ul, iar o constatare la nivel de dovadă pune un ban la coadă pentru ban wave.

Am nevoie de o bază de date?

Nu. Cu oxmysql, Sentinel își ține înregistrările în baza ta de date și își creează propriile tabele la prima pornire; nu există niciun fișier SQL de importat. Fără el, totul stă în stocarea key-value proprie a resursei.

Funcționează pe QBCore și Qbox?

Da. Detecția, cazurile, clipurile, consola, panoul din browser, Discord și owner desk sunt la fel pe orice framework. Urma banilor și a itemelor are propriul adaptor pentru ESX, QBCore, Qbox și ox_inventory.

Cum le dau acces adminilor mei?

Pe owner desk, STAFF: alege un jucător online, alege un rol, apasă GRANT. Sau folosește în continuare ACE: sentinel.admin dă Admin, iar sentinel.staff dă Moderator.

Poate un jucător banat să facă o contestație?

Da. Mesajul de refuz arată un cod de contestație. Jucătorul îl trimite staff-ului tău, care îl înregistrează cu sentinel:appeal, sau site-ul tău îl trimite pe ruta de contestații a lui Sentinel. Staff-ul îl acceptă sau îl respinge în consolă sau cu sentinel:decide.

Poate vedea programe de cheat pe PC-ul unui jucător?

Nu. Sentinel judecă ce poate vedea serverul și ce raportează jocul unui jucător. Nu citește alte programe de pe PC-ul unui jucător.

Este gata ascultarea chatului vocal?

Are nevoie de pma-voice, de comutatorul de ascultare (implicit doar proprietarul) și se aude prin propriul tău joc.

Ce văd jucătorii?

La prima intrare, o scurtă notificare în limba lor că serverul înregistrează jocul și că staff-ul poate urmări și asculta (Config.Notice). Pentru un jucător curat nu se schimbă nimic altceva.

Tradus din engleză. Dacă ceva de aici nu se potrivește cu pagina în engleză, pagina în engleză are dreptate. English