ZeroDev Sentinel dokumentacija

ZeroDev Sentinel: instalacija i upotreba

ZeroDev Sentinel je anti-cheat resource za FiveM koji radi na strani servera. Bilježi ono što server vidi, procjenjuje to pravilima koja se sama objašnjavaju jasnim rečenicama i daje tvom staffu dokaze prije nego što iko bude kažnjen. Počinje na nivou zaštite Watch: bilježi i ne kažnjava nikoga dok ti ne odlučiš drugačije. Ovaj vodič pokriva verziju 0.1.2 na ESX, QBCore, Qbox i standalone serverima.

Za ZeroDev Sentinel 0.1.223 min čitanjaAžurirano

1. Zahtjevi

  • OneSync uključen (set onesync on u server.cfg). Resource navodi OneSync kao zavisnost, pa ga FXServer bez OneSynca ne pokreće.
  • FXServer artifact koji pokreće Node 22 skripte (bilo koji trenutno preporučeni artifact; manifest traži node_version '22'). Node radi hashiranje, kompresiju, listanje fajlova i web rutu za žalbe.
  • Opcionalno: oxmysql. S njim Sentinel čuva svoje zapise u tvojoj bazi podataka i pri prvom pokretanju sam pravi svoje tabele. Nema SQL fajla za uvoz. Bez njega sve se čuva u resourceovom vlastitom key-value storeu.
  • Opcionalno: pma-voice, za slušanje voice chata igrača iz konzole ili panela u pregledniku.

Framework je bitan samo za dvije stvari: trag novca i itema (novac i itemi koje nije isplatila nijedna prodavnica, posao ili skripta, petlje nagrada, rollbackovi) i ko je tvoj staff (ACE grupe, koje koristi svaki framework). Detekcija, slučajevi, snimci, konzola, panel u pregledniku, Discord i pult vlasnika rade isto na svakom frameworku.

2. Instalacija za pet minuta

Ništa ne traži SQL, za prvo pokretanje ne treba mijenjati config, i nijedan drugi resource se ne mijenja.

Korak 1: Stavi folder u resources

Kopiraj folder zerodev_sentinel u svoj resources folder. Zadrži tačno to ime foldera: guard fajl se javlja na zerodev_sentinel, a sentinel:guard te upozori ako se folder zove bilo kako drugačije.

Korak 2: Dodaj ga u server.cfg

Pokreni ga nakon oxmysql-a i svog frameworka, da ih pohrana i trag novca pronađu pri pokretanju. Tačan redoslijed za tvoj framework je u odjeljku 3.

Korak 3: Pokreni server

Konzola ispiše okvir pri pokretanju i jednokratni kod vlasnika. Svaki red okvira je stvarna provjera; zadnji red kaže READY, ili NOT READY s brojem problema (odjeljak 15).

Korak 4: Preuzmi mjesto vlasnika

Uđi na server i ukucaj /sentinel owner <code> u chat. Sada imaš mjesto vlasnika (odjeljak 4).

Korak 5: Otvori pult vlasnika

Pritisni F7 u igri (ili ukucaj sentinel:console u F8) i otvori OWNER. List First run pokazuje šta je urađeno, a šta nije: Discord, pohrana snimaka, tvoj staff i njihove dozvole. Svaki red ima jedno dugme. Zatim igraj nekoliko dana na Watch, pročitaj šta je Sentinel pronašao na listu Right now i prebaci nivo zaštite na Recommended na istom pultu (odjeljak 6).

3. Tvoj framework

Sentinel sam pronađe framework i inventory kad se pokrene. Nema ništa za podešavanje. sentinel:trail u konzoli servera pokazuje koji je adapter izabrao.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Novac i itemi: čitaju se iz ESX-ovih vlastitih server evenata (novac na računu dodan, uklonjen ili postavljen; itemi u inventoryju dodani ili uklonjeni; itemi dati od igrača igraču, s povezane obje strane). Rollback koristi ESX-ove vlastite metode igrača i ponovo očita rezultat.
  • ESX s ox_inventory: novac se prati na isti način. U ovom načinu ESX-ove metode za iteme ne vraćaju rezultate, pa Sentinel odlučuje samo na osnovu ponovnog očitavanja.
  • Staff: daj svojim adminima ACE dozvolu (odjeljak 5). ESX-ov vlastiti group.admin radi kao ACE grupa kad dodaš red za njega.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Novac: čita se iz QBCore-ovog eventa za promjenu novca (dodavanje, uklanjanje i postavljanje, s razlogom). Gubitak i jednak dobitak u istom trenutku povezuju se kao transfer, jer QBCore nema vlastiti event za transfer.
  • Itemi: s ox_inventory itemi se prate kroz njegove hookove. S qb-inventory promjene itema se ne prate (payload njegovog listenera nije dokumentovan), ali rollback i dalje može premjestiti iteme pomoću dokumentovanih exporta qb-inventoryja.
  • Staff: QBCore-ove grupe dozvola su ACE grupe (group.admin, group.god). Dodaj ACE redove iz odjeljka 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Novac: čita se iz Qbox-ovog eventa za promjenu novca; stanja se ponovo očitavaju vlastitim exportima qbx_core. Novac promijenjen za offline lika (preko citizen id) ne okida nikakav event, pa nije u tragu.
  • Itemi: Qbox koristi ox_inventory, a Sentinel prati njegove iteme kroz hookove ox_inventoryja. Itemi koji predstavljaju novac frameworka prepušteni su dijelu za framework.
  • Staff: ACE grupe, kao na QBCore.

Standalone (bez frameworka)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Sve osim traga novca i itema radi: kretanje, svijet, eventi, bait eventi, godmode, state bagovi, oružja, slučajevi, snimci, replay, konzola, panel, Discord, uloge i banovi.
  • S ox_inventory i bez frameworka, itemi se prate kroz ox_inventory.
  • Pohrana: key-value store, ili oxmysql ako ga pokreneš prvi.

Provjera da radi

  • sentinel:health: ponovo okvir pri pokretanju. Svaki red je stvarna provjera; READY znači da ništa ne nedostaje.
  • sentinel:diag: zašto su izabrani pohrana, adapteri i nivo, svako pravilo s brojačima i posljednje odluke.
  • sentinel:trail: adapter za novac i iteme koji se koristi i posljednje promjene jednog igrača.

U automatskom načinu pohrane Sentinel koristi oxmysql samo kad je oxmysql već pokrenut (čeka do 15 sekundi dok se oxmysql pokreće); ako se oxmysql pokrene kasnije, koristi key-value store.

4. Prvo pokretanje: mjesto vlasnika

Prvo pokretanje ispiše jednokratni kod u konzoli servera, važeći 30 minuta (sentinel:owner code ispiše novi). Uđi i ukucaj /sentinel owner <code>: mjesto se veže za tvoj račun, a kod prestaje važiti.

Samo mjesto vlasnika može mijenjati ključeve, nivo zaštite, uloge i dozvole. sentinel:owner reset u konzoli servera oslobađa mjesto ako ga moraš prebaciti na drugi račun.

5. Staff i dozvole

Na pultu vlasnika, STAFF: izaberi igrača koji je online, izaberi ulogu, pritisni GRANT. Dolaze četiri uloge:

Uloga Može, odmah po instalaciji
Podrška vidi slučajeve, rješava prijave, mapa dežurstva
Moderator kao Support, plus replayevi, kick i karantin
Admin kao Moderator, plus otkrivanje, oslobađanje, prikaz uživo, zahtjevi za ban, žalbe
Senior admin kao Admin, plus ban koji važi odmah

Dozvole biraš ti. Svaka uloga je lista prekidača koje možeš mijenjati. Napravi svoje uloge od kopije (na primjer "Trial mod"), preimenuj bilo koju ulogu i daj jednoj osobi dodatni prekidač ili joj ga oduzmi bez mijenjanja njene uloge. Prekidači označeni kao opasni (ban odmah, slušanje voice chata, postavke, upravljanje staffom) traže drugi pritisak. Svaka promjena se upisuje u zapis staffa, pa uvijek možeš vidjeti ko je šta promijenio.

ACE i dalje radi za servere koji ga već koriste i čita se pri svakoj provjeri:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Dozvola Uloga koju daje
sentinel.admin Admin (Senior admin dok se ne preuzme mjesto vlasnika) i svaka sentinel:* komanda u igri
sentinel.staff Moderator; pravila kretanja tretiraju vlastito kretanje člana staffa kao objašnjeno

Nekoliko komandi (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) registrovano je kao ograničeno: u igri im treba i command.<name>. Uobičajeni red add_ace group.admin command allow to pokriva. Konzola servera može pokrenuti svaku komandu.

6. Nivo zaštite

Jedan prekidač na pultu vlasnika (OWNER, PROTECTION), a tu su i sentinel:level u konzoli servera i Config.Protection u config/config.lua. Ono što postaviš na pultu se sačuva i nakon restarta ima prednost nad redom u configu.

  • Watch: svako pravilo prati i zapisuje šta bi uradilo; niko ne dobija upozorenje i nikome se ništa ne dešava. U međuvremenu Sentinel uči šta je normalno na tvom serveru: posmatrač evenata (učestalost i oblik svakog eventa) i provjera pri ulasku uče samo na Watch; limiti za entitete, borbu i novac nastavljaju učiti iz čiste igre.
  • Recommended: svako pravilo je aktivno. Staff dobija upozorenja s dokazima i otvara se slučaj. Sentinel nikad ne kažnjava sam; odlučuje tvoj staff.
  • Strict: kao Recommended, a visok rezultat stavlja igrača u karantin dok staff ne pogleda; nalaz na nivou dokaza (Tier A: okinut bait event, krivotvoren zahtjev) uz to stavlja ban u red za ban wave.

Ispod prekidača pult prikazuje svako pravilo s njegovim stanjem i odakle to stanje dolazi. Tu možeš zakačiti jedno pravilo na Live ili Shadow ako tvoj server to treba (na primjer pravilo koje stalno označava neku tvoju skriptu); red state u Config.Rules ga zakači u config fajlu i ima prednost nad pultom.

Razuman redoslijed:

  1. Watch nekoliko dana normalne igre.
  2. Pročitaj šta bi pravila uradila: list Right now, sentinel:diag rules (kolona shadow broji koliko puta bi pravilo dodijelilo bodove) i sentinel:diag decisions 100.
  3. Zakači na Shadow svako pravilo koje je označilo nekoga kome vjeruješ, i javi nam.
  4. Prebaci na Recommended. Staff sada vidi slučajeve i dokaze; niko nije automatski kažnjen.
  5. Strict kad vjeruješ onome što ti Recommended pokazuje.

Za povratak u bilo kojem trenutku: Watch na pultu ili sentinel:level watch.

7. Staff konzola (F7)

Pritisni F7 u igri (ili ukucaj sentinel:console u F8). Svaki igrač može promijeniti tipku u postavkama igre (Key Bindings, FiveM). Esc je zatvara.

  • Right now jednostavnim riječima kaže šta se dešava na tvom serveru: ko izgleda kao prijetnja i zašto, šta je dokazano, šta je objašnjeno (revive, teleport neke tvoje skripte) i šta traži tebe. Svaki bitan igrač dobije jedan red: šta je uradio, šta je to vjerovatno, koliko je Sentinel siguran (Unusual, Suspicious, Very likely, Proven), šta je Sentinel već uradio i jedan sljedeći korak.
  • Dosijei slučajeva: prvo otvoreni slučajevi, svaki s nalazom, dokazima, snimcima ekrana, pečatom (da li se hash lanac slučaja i dalje verifikuje) i tipkama REVEAL, QUARANTINE, CLEAR i BAN (CLEAR i BAN traže drugi pritisak).
  • Mapa dežurstva: online igrači na 3D modelu ostrva. Teren mjeri igra prvog člana staffa i čuva se u data/map/.
  • Play replay zatvara konzolu i ponovo pušta incident u privatnom svijetu; pritisni Backspace za povratak.
  • Vlasnik (samo mjesto vlasnika): First run, Protection, Keys, Staff, Internal affairs i Server check.

Komande u igri kucaš u F8 bez kose crte ili u chatu s kosom crtom (/sentinel:diag).

8. Panel u pregledniku

Isti pult u web pregledniku, za kada nisi u igri:

  • na računaru servera: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (port je port tvog servera, po defaultu 30120)
  • s drugog mjesta: http://<server address>:<port>/zerodev_sentinel/panel/, ili tvoja vlastita HTTPS adresa ispred njega

Prijava. Koristi jednokratni kod: ukucaj /sentinel panel u igri (kod se prikazuje samo tebi, radi jednom, 5 minuta) ili pokreni sentinel:panel <id or account> u konzoli servera. Sesija traje 8 sati; SIGN OUT i END ALL MY SESSIONS je završavaju. Tvoja uloga i prekidači važe u pregledniku tačno kao u igri.

Prikaz uživo. Staff s prekidačem za prikaz uživo može iz panela ili konzole gledati ekran bilo kojeg online igrača. Ništa se ne čuva na disku osim ako pritisneš Save to case.

Slušanje. Za slušanje voice chata tog igrača treba prekidač za slušanje (po defaultu samo vlasnik) i pma-voice. Zvuk ide kroz tvoju vlastitu igru, zato budi u igri na istom serveru.

Svaki prikaz uživo i svako slušanje upisuje se u staff evidenciju i u slučaj igrača, a igrači pri prvom ulasku saznaju da ih staff može gledati i slušati (obavijest o snimanju, Config.Notice).

9. Slučajevi, karantin, kick, ban i žalbe

Kada se nešto pronađe, Right now imenuje igrača jasnim riječima: šta je uradio, koliko je Sentinel siguran i šta je poduzeo. Otvori slučaj da vidiš dokaze (pozicije, snimke ekrana zapečaćene sa SHA-256, 3D replay) i koristi tipke:

  • REVEAL: prikazuje identifikatore igrača.
  • QUARANTINE: premješta igrača iz stvarnog svijeta u privatni routing bucket dok ga staff ne pregleda. sentinel:release <server id> ga vraća.
  • CLEAR: nema cheata; zatvara slučaj i zaustavlja njegov ban na čekanju.
  • KICK: izbacivanje sa servera, s razlogom koji igrač pročita.
  • BAN: kroz ban wave, s kodom za žalbu.

Ban wave. Banovi, uključujući BAN pritisnut u konzoli, stavljaju se na čekanje za ban wave i primjenjuju se samo na Strict, po defaultu u nasumično vrijeme 2 do 24 sata kasnije (Config.Actions). sentinel:wave ih izlistava, sentinel:wave now <account> odmah primjenjuje jedan, sentinel:wave cancel <account> ga otkazuje.

Žalbe. Banovani igrač vidi kod za žalbu u poruci o odbijanju (8 slova i cifara). Ne može ući na server da se žali, pa žalba do tebe stiže izvan igre:

  1. Preko tvog staffa. Igrač pošalje kod tvom staffu (Discord tiket, mail). Član staffa ga zabilježi sa sentinel:appeal <code> <text>.
  2. Preko web rute. Sentinel odgovara na vlastitoj adresi tvog servera: http://<server address>:<port>/zerodev_sentinel/appeal. Prihvata samo POST s JSON-om { "code": "...", "text": "...", "contact": "optional" } (tekst od 10 do 2000 znakova), pa je namijenjen formi na tvojoj web stranici, a ne stranici na koju šalješ igrače. Svaki prihvaćeni zahtjev dobije isti odgovor, 202 "received", bez obzira na to da li kod odgovara banu ili ne. Previše zahtjeva s jedne adrese (5 u 10 minuta) ili ukupno (30 u minuti) dobije 429. Iza tvog vlastitog HTTPS reverse proxyja postavi set sentinel_http_proxy true da bi ograničenja brojala adresu posjetioca.

Tekst odbijanja ne kaže gdje se žaliti. Reci igračima u svojim pravilima ili napiši vlastiti tekst sa svojim linkom u Config.Bans.message (zadrži %s, on postaje kod), na primjer 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Staff odlučuje u konzoli ili sa sentinel:decide <case or code> accept|reject [note]. Accept skida svaki aktivni ban tog računa ili slučaja i otkazuje ban iz wavea na čekanju; reject zadržava ban. Odluka je konačna i upisuje se u log slučaja. sentinel:appeals izlistava otvorene.

10. Prijave i unutrašnja kontrola

Prijave igrača. Bilo koji igrač ukuca /report <server id> <what happened> da prijavi igrača ili člana staffa. Posljednje dvije minute oko oba igrača spremaju se u slučaj. Staff zatvara prijavu kao riješenu, bez prekršaja, bez dokaza ili duplikat. Prijave protiv staffa idu samo vlasniku.

Unutrašnja kontrola (samo vlasnik, na pultu vlasnika): šta je koji član staffa uradio i šta treba pregledati (dodjele samima sebi, skrivanje u borbi, banovi bez slučaja, teleporti do igrača). Sedmični izvještaj o pravednosti upisuje se u data/reports/; sentinel:staff report ga piše odmah. Ništa u staff evidenciji ne kažnjava staff.

11. Zaštita resourcea

Bez ikakvog podešavanja Sentinel posmatra svaki event koji igrači mogu poslati tvojim skriptama i procjenjuje igrača. Ne može spriječiti da se handler drugog resourcea izvrši. Da zaustaviš loš poziv prije nego što se skripta izvrši, dodaj guard u tu skriptu.

  1. sentinel:audit izlistava evente svakog pokrenutog resourcea koje klijenti mogu okinuti, ocijenjene prema tome šta njihovi handleri rade (na primjer handler koji daje novac u iznosu koji bira klijent). Koristi ga da odlučiš koje resourceove prve zaštititi.
  2. sentinel:guard <resource> ispisuje liniju koju treba dodati i server_scripts tog resourcea kako bi tada izgledali. Guard linija mora biti prva server skripta. Komanda samo ispisuje; ne mijenja nijedan fajl.

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

  1. Restartuj taj resource. sentinel:guard <resource> sada kaže "guarded since ...". sentinel:guard sam izlistava svaki zaštićeni resource.
  2. Dodaj pravila sa sentinel:patch. Dok resource nema pravila, njegov guard propušta svaki poziv, osim poziva igrača u karantinu, koje svaki guard odbacuje. Primjer: najviše 3 kupovine u 10 sekundi, ime itema do 32 znaka i količina od 1 do 10; odbijeni poziv računa se kao dokaz ("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}

Za framework callback napiši callback:<name> kao event: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> izlistava pravila resourcea; sentinel:patch <resource> <event> off uklanja jedno.

Guard nikada ne uređuje fajlove i nikada ne mijenja ono što handler primi. To je običan, čitljiv Lua u guard/guard.lua.

12. Ključevi za Discord i pohranu snimaka

Najlakše je preko pulta vlasnika, KEYS: zalijepi svaku vrijednost i pritisni SAVE. Ključevi se čuvaju samo na serveru; pult i svaki odgovor kažu samo "set" i nikada više ne prikazuju ključ.

Red na pultu Šta je to Ili u server.cfg (koristi set, nikada setr)
Token Discord bota bot koji si napravio na discord.com/developers i pozvao na svoj server set sentinel_discord_token "..."
ID Discord servera desni klik na tvoj server, Copy Server ID (uključen developer mode) set sentinel_discord_guild "..."
ID kanala za upozorenja gdje se objavljuju slučajevi, s dugmadima za tvoj staff set sentinel_discord_channel "..."
ID kanala za žalbe gdje se objavljuju žalbe set sentinel_discord_appeals "..."
FiveManage ključ media ključ sa fivemanage.com; snimci se tamo uploaduju set sentinel_fivemanage_key "..."
Webhook za snimke umjesto FiveManagea: Discord webhook koji prima snimke set sentinel_clip_webhook "..."
Pohrana snimaka fivemanage, discord, off ili automatic (prvi koji je postavljen) set sentinel_clip_storage "..."

Ključ u server.cfg ima prednost nad pultom, i pult to i kaže. Discord dugmad prate iste uloge i prekidače kao konzola. Bez ičega od ovoga, slučajevi i snimci ostaju na tvom serveru (data/), a konzola i panel ih prikazuju.

Jednostavnija webhook upozorenja i dalje rade: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" ili sentinel:webhook set <url> u konzoli servera. sentinel:webhook test šalje probnu poruku; sentinel:webhook prikazuje stanje bez ispisivanja URL-a; sentinel:webhook clear uklanja spremljeni.

13. Šta koje pravilo hvata

Svako pravilo napiše jednostavnu rečenicu kada se okine, s onim što je vidjelo i šta je isključilo. Prije nego što se pravilo uračuna protiv nekoga, Sentinel provjeri razloge koji bi to objasnili (respawn, revive, akcija staffa, neka tvoja skripta koja pomjera ili plaća igrače). Objašnjen nalaz se bilježi i nikada se ne boduje.

  • Nivo A je dokaz: nešto što radi samo cheat (mamac event koji nijedna stvarna skripta ne poziva, krivotvoren zahtjev).
  • Nivo B je jak: član staffa treba pogledati. Sam otvara slučaj samo kada se dvije različite porodice slože ili kada se ista ponavlja.
  • Nivo C je slab: dodaje se na skor i nikada ne djeluje sam.

Kretanje

Pravilo Hvata Objašnjava ga Nivo
teleport Skok od preko 150 m (ili 3x više od mogućeg) između dva uzorka spawn, respawn ili revive, promjena routing bucketa, staff, teleport event tvoje skripte B
foot_speed Trčanje preko 12 m/s tokom 1.5 s pješice, bez padanja, bez ragdolla spawn, respawn, staff, tvoja skripta B
air_float Kretanje dok je zamrznut (noclip); "padanje" bez spuštanja (fly); brzo kretanje po koordinatama dok igra kaže da igrač stoji (speed meniji) spawn, respawn, staff, tvoja skripta B
foot_rise Penjanje ravno gore brže od 4 m/s pješice tokom 3 s spawn, respawn, staff, tvoja skripta B
vehicle_speed Vozilo preko 1.3x najveće brzine koju njegova klasa dostiže na tvom serveru staff, tvoja skripta B

Svijet

Pravilo Hvata Objašnjava ga Nivo
entity_blocked Spawnanje modela koji si blokirao tvoje skripte koje ga spawnaju B
entity_rate / entity_model_rate Spawnanje daleko više entiteta (ili jednog modela) u minuti nego što to rade igrači i skripte tvoje skripte za spawnanje B
entity_untrusted Entiteti koje je napravio klijent bez skripte koja ih spawna tvoje skripte za spawnanje B
entity_disguised Nalet istog ambient ped modela oko jednog igrača (meni koji svoje spawnove maskira kao saobraćaj) spawn, respawn, promjena bucketa B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Eksplozije koje oružje u ruci ne može napraviti, previše njih, nevidljive ili daleko od igrača eksplozije tvojih skripti B
projectile_weapon / projectile_rate Projektili koje oružje ne može ispaliti, ili previše njih B
ptfx_rate Poplave particle efekata (čest napad za crash i lag) B
fire_rate Vatre zapaljene brže nego što ijedno oružje dozvoljava B

Borba

Pravilo Hvata Nivo
damage_plausibility Šteta iznad moguće vrijednosti oružja B
hit_range Pogoci izvan dometa oružja B
shot_rate / kill_rate Pucanje brže od oružja; killovi u minuti daleko iznad uobičajenog na tvom serveru B
silent_aim Pogoci tamo gdje igrač nije nišanio, ponovljeno B
aim_stats / aim_stats_backed Udio headshotova i snap uglovi daleko izvan igrača tvog servera kroz 30+ borbi C (B s drugom porodicom)
esp_los_backed Ponovljeno nišanjenje u igrače za koje svjedoci javljaju da su skriveni iza zidova C do B

Eventi i zahtjevi

Pravilo Hvata Nivo
bait_event Pozivanje podmetnutog eventa koji nijedna stvarna skripta ne koristi (cheat meniji ih traže i okidaju) A
bait_statebag / statebag_write Pisanje state bagova koje bi trebao pisati samo server (pravljenje sebe adminom, godmode zastavice), ili prevelikih A / B
events_before_ready / _trap Eventi poslani prije nego što se igrač uopšte spawnao (ubačeni prije ulaska) B / A
event_rate / event_shape Event pozvan daleko brže nego inače ili s argumentima drugačijeg oblika od uobičajenih poziva na tvom serveru B
event_flood 500+ poziva u 10 s; kod FiveM-ovog vlastitog overflow kicka izlistaju se najčešći eventi B
guard_rule / guard_hard Kršenje pravila koje si postavio na zaštićeni event (iznos, učestalost, udaljenost) B / A

Ekonomija

Pravilo Hvata Nivo
money_nowhere / item_nowhere Novac ili itemi koje nije dala nijedna prodavnica, posao ni skripta (dev eventi, procurjele prodaje iz prodavnica) B
economy_repeat Event za nagradu ili posao isplaćen 10 puta u 30 s (farmanje pozivanjem u petlji) B
money_jump / money_rate Nagli skok stanja ili stopa zarade daleko iznad uobičajenog na tvom serveru B
economy_trap Preuzimanje podmetnute nagrade koju nijedan stvarni posao ne isplaćuje A
weapon_not_owned Držanje oružja koje inventory nikada nije dao B

Igra igrača (svjedok)

Pravilo Hvata Nivo
godmode Server vidi igrača kao neranjivog 30 s (nije zajednička safe zona) B
witness_backed Znakovi iz igre potkrijepljeni vlastitim pogledom servera (godmode, nevidljivost, bez kolizije) B
witness_bait Igra odgovara na provjeru za koju ne bi trebala znati A
witness_tamper Sentinelove vlastite provjere u igri su hookane ili izmijenjene B

Identitet i fajlovi

Pravilo Hvata Nivo
ban_fingerprint Banovani igrač se vratio na novom računu (hardware tokeni, identifikatori, otisak preglednika) A / flag
young_account Potpuno nov račun (samo dodaje težinu) C
scanner_error / too_large Resourcei koje skener skripti nije mogao pročitati, ili preveliki fajlovi vrijedni pogleda info

Šta nijedno pravilo ne obećava

Sentinel procjenjuje ono što server može vidjeti i ono što igra igrača prijavi. Ne čita druge programe na računaru igrača, i nijedan anti-cheat ne može obećati da će svaki cheat biti uhvaćen. Svaki nalaz dolazi sa svojim dokazima, tako da tvoj staff odlučuje na osnovu činjenica.

14. Komande i konfiguracija

Svaka komanda je na stranici s komandama, a svaki config ključ na stranici s konfiguracijom, obje generisane iz samog resourcea. One koje najčešće koristiš:

Komanda Šta radi
/sentinel owner <code> preuzmi mjesto vlasnika u igri s kodom iz konzole
/sentinel panel jednokratni kod za prijavu u panel u pregledniku (samo za staff)
/report <server id> <what happened> bilo koji igrač prijavljuje igrača ili člana staffa
sentinel:health ponovo okvir pri pokretanju
sentinel:diag šta je Sentinel odlučio i zašto
sentinel:level watch\|recommended\|strict promijeni nivo zaštite i sačuvaj ga
sentinel:wave banovi koji čekaju na ban wave
sentinel:appeals otvorene žalbe
sentinel:audit rizični eventi svakog pokrenutog resourcea
sentinel:guard <resource> red koji štiti resource
sentinel:advisor FiveM postavke koje vrijedi promijeniti na tvom serveru

Config fajlovi u config/ (config.lua, protection.lua, watch.lua) i prijevodi u config/locales/ su ti otvoreni, kao i framework adapteri u bridge/ i guard fajl u guard/. Drži ih kao ispravan Lua i restartuj zerodev_sentinel nakon promjene. Za prvo pokretanje ne treba mijenjati config.

15. Okvir pri pokretanju i savjetnik za ojačavanje

Trenutak nakon što je pohrana spremna, Sentinel ispisuje okvir u konzoli servera. Red FAIL znači da Sentinel ne može raditi kako treba; red WARN znači da radi s manje mogućnosti (na primjer dokazi bez digesta). Ispiši ga ponovo bilo kada sa sentinel:health.

Red Šta provjerava Kad nije OK
Build Verzija i oznaka builda iz fxmanifest.lua. -
OneSync Convar onesync. Sentinel čita pozicije, entitete i game evente preko OneSynca. postavi onesync na on u server.cfg
Pokrenute kopije Koliko je kopija resourcea pokrenuto, bez obzira kako se zove njihov folder. Mora biti 1. zadrži jednu kopiju Sentinela; zaustavi drugi folder
Pohrana Koja je pohrana izabrana (mysql ili kvp) i da li je spremna. pogledaj sentinel:diag storage
Folder za dokaze Probno pisanje i čitanje u data/archive unutar resourcea. napravi folder data/archive unutar Sentinel resourcea i provjeri da server može pisati u njega
SHA-256 Da li node/util.js odgovara; on pravi otisak za svaki dokaz. dokazi se čuvaju bez digesta; potraži Node grešku u konzoli
Zaštita Nivo zaštite, njegov način rada i odakle dolazi. -
Pravila Koliko je pravila Live, a koliko u Shadow. -

Nakon okvira pri pokretanju, savjetnik ispisuje FiveM postavke koje vrijedi promijeniti na tvom serveru (uz Config.Advisor.atStartup = false ispisuje ih samo na sentinel:advisor). Za svaku postavku pokazuje trenutnu vrijednost, preporučenu, šta blokira, šta bi mogla pokvariti i red za kopiranje. Samo čita vrijednosti; nikada ne mijenja server.cfg. Testiraj red na svom serveru prije nego što ga zadržiš.

16. Jezici i šta se bilježi

Tekstovi za igrače i staff dolaze iz config/locales/<code>.lua, 25 jezika u ovom buildu. Config.Locale bira jezik; uz Config.GameLanguage = true igrač čija igra radi na jeziku koji GTA nudi čita Sentinel na tom jeziku čim uđe u igru.

Sentinel za svakog igrača drži u memoriji otprilike posljednje dvije minute pozicija i evenata (Config.Recorder) i upisuje ih u arhivu u data/archive/ kada se otvori slučaj ili staff koristi sentinel:save. Tokom pregleda traži od igre osumnjičenog snimke ekrana (segmenti od 20 sekundi) i čuva ih u data/clips/. Čuva identifikatore koje FiveM daje serveru (IP adresa se bilježi, ali se po defaultu nikada ne koristi za odbijanje konekcije) i, kada Discord radi, Discord id. Pri prvom ulasku svaki igrač dobije kratko obavještenje na svom jeziku da server snima igru i da staff može gledati i slušati (Config.Notice = false ga isključuje; tada im to reci u pravilima). Spomeni to i u politici privatnosti.

Stare arhive i snimke se u ovom buildu ne brišu automatski: očisti data/archive/ i data/clips/ sam kada ti više ne trebaju.

Uz oxmysql, Sentinelovi zapisi su u tabelama zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report i zds_trail. Bez oxmysql isti zapisi su u key-value storeu resourcea (ključevi koji počinju sa zds:). Banovi se uvijek kopiraju i u key-value store, tako da ostaju na snazi dok je baza pala.

17. Ažuriranje

Nove verzije se objavljuju na istom Keymaster assetu. Sentinel čuva svoje dokaze unutar svog foldera, pa prije nego što ga zamijeniš:

  1. Napravi backup foldera zerodev_sentinel, tačnije njegovih foldera config/ i data/ (arhive, snimke, prijave, naučene osnovne vrijednosti) i, uz oxmysql, tabela zds_.
  2. Zaustavi server, zamijeni folder zerodev_sentinel novim (zadrži ime foldera) i vrati svoj folder data/. Prenesi postavke koje si mijenjao u nove config fajlove umjesto da kopiraš stare fajlove preko njih.
  3. Pokreni server i pročitaj okvir pri pokretanju (sentinel:health).

Prije ažuriranja pročitaj bilješke o izdanju nove verzije u changelogu.

18. Deinstalacija

  1. Ukloni guard red iz svakog resourcea koji si zaštitio (sentinel:guard ih izlistava) i restartuj te resourcee. Uradi to prvo: guard fajl nestaje čim nestane folder.
  2. Ukloni ensure zerodev_sentinel i redove sentinel.admin / sentinel.staff iz server.cfg, pa zaustavi resource. Ako je sentinel:lockdown promijenio entity lockdown, zaustavljanje Sentinela vraća prvobitni način rada.
  3. Obriši folder zerodev_sentinel. Time se uklanja data/ sa svim arhivama, snimkama i prijavama, pa prvo kopiraj sve što želiš zadržati.
  4. Uz oxmysql, obriši tabele zds_ navedene u odjeljku 16 ako ti banovi i slučajevi više ne trebaju. Key-value zapisi ostaju u storeu servera pod imenom resourcea i bez njega ne rade ništa.

Sentinel piše samo unutar svog foldera, svojih tabela u bazi i svog key-value storea. Ne mijenja druge resourcee niti server.cfg.

Česta pitanja

Da li Sentinel sam banuje ili kickuje nekoga?

Ne na Watch ili Recommended. Počinje na Watch, gdje samo bilježi šta bi uradio. Na Recommended staff dobija dokaze i odlučuje. Samo na Strict visok skor stavlja igrača u karantin dok staff ne pogleda, a nalaz na nivou dokaza stavlja ban u red za ban wave.

Da li mi treba baza podataka?

Ne. S oxmysql Sentinel čuva svoje zapise u vašoj bazi podataka i pravi svoje tabele pri prvom pokretanju; nema SQL fajla za import. Bez njega sve se čuva u vlastitom key-value storeu resourcea.

Da li radi na QBCore i Qbox?

Da. Detekcija, slučajevi, snimke, konzola, panel u pregledniku, Discord i pult vlasnika isti su na svakom frameworku. Trag novca i itema ima vlastiti adapter za ESX, QBCore, Qbox i ox_inventory.

Kako da svojim adminima dam pristup?

Na pultu vlasnika, STAFF: izaberi igrača koji je online, izaberi ulogu, pritisni GRANT. Ili nastavi koristiti ACE: sentinel.admin daje Admin, a sentinel.staff daje Moderator.

Može li se banovani igrač žaliti?

Da. Poruka o odbijanju prikazuje kod za žalbu. Igrač ga šalje tvom staffu, koji ga upisuje sa sentinel:appeal, ili ga tvoj sajt šalje na Sentinelovu rutu za žalbe. Staff je prihvata ili odbija u konzoli ili sa sentinel:decide.

Može li vidjeti cheat programe na računaru igrača?

Ne. Sentinel sudi o onome što server može vidjeti i što igra igrača prijavljuje. Ne čita druge programe na računaru igrača.

Da li je slušanje voice chata spremno?

Treba mu pma-voice i prekidač za slušanje (po defaultu samo za vlasnika), a zvuk ide kroz tvoju vlastitu igru.

Šta igrači vide?

Pri prvom ulasku, kratko obavještenje na njihovom jeziku da server snima igru i da staff može gledati i slušati (Config.Notice). Za čistog igrača ništa se drugo ne mijenja.

Prevedeno s engleskog. Ako se nešto ovdje razlikuje od engleske stranice, engleska stranica je mjerodavna. English