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.
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 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
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.adminpropriu al ESX funcționează ca grup ACE când adaugi linia pentru el.
QBCore
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
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)
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:
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ă:
- Watch câteva zile de joc normal.
- 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) șisentinel:diag decisions 100. - Fixează pe Shadow orice regulă care a marcat pe cineva în care ai încredere și spune-ne.
- Treci pe Recommended. Staff-ul vede acum cazuri și dovezi; nimeni nu este pedepsit automat.
- 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:
- 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>. - 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 truepentru 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.
sentinel:auditlistează 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.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' }
- Repornește acea resursă.
sentinel:guard <resource>spune acum "guarded since ...".sentinel:guardsingur listează fiecare resursă protejată. - 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:
- Din folderul
zerodev_sentinel, fă backup la foldereleconfig/șidata/(arhive, clipuri, rapoarte, baseline-uri învățate) și, cu oxmysql, la tabelelezds_. - Oprește serverul, înlocuiește folderul
zerodev_sentinelcu cel nou (păstrează numele folderului) și pune-ți folderuldata/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. - 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
- Scoate linia de guard din fiecare resursă pe care ai protejat-o (
sentinel:guardle listează) și repornește acele resurse. Fă asta mai întâi: fișierul guard dispare odată cu folderul. - Scoate
ensure zerodev_sentinelși liniilesentinel.admin/sentinel.staffdin server.cfg, apoi oprește resursa. Dacăsentinel:lockdowna schimbat entity lockdown, oprirea lui Sentinel pune la loc modul original. - Ș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. - 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.