Dokumentacija ZeroDev Sentinel
ZeroDev Sentinel: namestitev in uporaba
ZeroDev Sentinel je strežniški anti-cheat resource za FiveM. Beleži, kar vidi strežnik, to presoja s pravili, ki se sama razložijo v preprostih stavkih, in vašemu staffu da dokaze, preden je kdorkoli kaznovan. Začne na ravni zaščite Watch: beleži in nikogar ne kaznuje, dokler ne izberete drugače. Ta vodnik zajema različico 0.1.2 na strežnikih ESX, QBCore, Qbox in standalone.
1. Zahteve
- Vklopljen OneSync (
set onesync onv server.cfg). Resource navaja OneSync kot odvisnost, zato ga FXServer brez OneSync ne zažene. - FXServer artifact, ki poganja skripte Node 22 (kateri koli trenutno priporočeni artifact; manifest zahteva
node_version '22'). Node skrbi za hashiranje, stiskanje, seznam datotek in spletno pot za pritožbe. - Neobvezno: oxmysql. Z njim Sentinel hrani svoje zapise v vaši bazi podatkov in ob prvem zagonu sam ustvari svoje tabele. Datoteke SQL za uvoz ni. Brez njega je vse v resourcovi lastni shrambi key-value.
- Neobvezno: pma-voice, za poslušanje igralčevega glasovnega klepeta iz konzole ali spletnega panela.
Framework je pomemben le za dve stvari: sled denarja in predmetov (denar in predmeti, ki jih ni izplačala nobena trgovina, služba ali skripta, zanke nagrad, rollbacki) in kdo je vaš staff (skupine ACE, ki jih uporablja vsak framework). Zaznavanje, primeri, posnetki, konzola, spletni panel, Discord in owner desk delujejo enako na vsakem frameworku.
2. Namestitev v petih minutah
Nič ne potrebuje SQL, za prvi zagon ni treba urejati configa in noben drug resource se ne spremeni.
Korak 5: Odprite owner desk
V igri pritisnite F7 (ali v F8 vpišite sentinel:console) in odprite OWNER. Zavihek First run pokaže, kaj je narejeno in kaj ne: Discord, shramba posnetkov, vaš staff in njegova dovoljenja. Vsaka vrstica ima en gumb. Nato nekaj dni igrajte na Watch, na zavihku Right now preberite, kaj je Sentinel našel, in na istem desku preklopite raven zaščite na Recommended (razdelek 6).
3. Vaš framework
Sentinel ob zagonu sam najde framework in inventory. Ničesar ni treba nastaviti. sentinel:trail v strežniški konzoli pokaže, kateri adapter je izbral.
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- Denar in predmeti: prebrani iz ESX-ovih lastnih strežniških eventov (denar na računu dodan, odvzet ali nastavljen; predmeti v inventoryju dodani ali odvzeti; predmeti, dani od igralca igralcu, z obema stranema povezanima). Rollback uporablja ESX-ove lastne metode igralca in rezultat prebere nazaj.
- ESX z ox_inventory: denar se spremlja enako. V tem načinu ESX-ove metode za predmete ne vračajo rezultatov, zato Sentinel odloča le po ponovnem branju.
- Staff: svojim adminom dajte dovoljenje ACE (razdelek 5). ESX-ova lastna
group.admindeluje kot skupina ACE, ko zanjo dodate vrstico.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- Denar: prebran iz QBCore-ovega eventa za spremembo denarja (dodajanje, odvzem in nastavitev, z razlogom). Izguba in enako velik dobiček v istem trenutku se povežeta kot nakazilo, ker QBCore nima lastnega eventa za nakazila.
- Predmeti: z ox_inventory se predmeti spremljajo prek njegovih hookov. Z qb-inventory se spremembe predmetov ne spremljajo (payload njegovega listenerja ni dokumentiran), rollback pa lahko predmete vseeno premika z dokumentiranimi exporti qb-inventory.
- Staff: skupine dovoljenj v QBCore so skupine ACE (
group.admin,group.god). Dodajte vrstice ACE iz razdelka 5.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- Denar: prebran iz Qboxovega eventa za spremembo denarja; stanja se preberejo nazaj z lastnimi exporti
qbx_core. Denar, spremenjen liku brez povezave (prek citizen id), ne sproži eventa, zato ga v sledi ni. - Predmeti: Qbox uporablja ox_inventory, Sentinel pa njegove predmete spremlja prek hookov ox_inventory. Predmeti, ki predstavljajo denar frameworka, so prepuščeni delu za framework.
- Staff: skupine ACE, kot na QBCore.
Standalone (brez frameworka)
set onesync on
ensure zerodev_sentinel- Deluje vse razen sledi denarja in predmetov: gibanje, svet, eventi, vabni eventi, godmode, state bagi, orožje, primeri, posnetki, replay, konzola, panel, Discord, vloge in bani.
- Z ox_inventory in brez frameworka se predmeti spremljajo prek ox_inventory.
- Shramba: shramba key-value ali oxmysql, če ga zaženete prej.
Preverjanje, ali deluje
sentinel:health: še enkrat zagonsko okno. Vsaka vrstica je resnično preverjanje; READY pomeni, da nič ne manjka.sentinel:diag: zakaj so bili izbrani shramba, adapterji in raven, vsako pravilo z njegovimi števci in zadnje odločitve.sentinel:trail: adapter za denar in predmete, ki je v uporabi, in zadnje spremembe enega igralca.
V samodejnem načinu shrambe Sentinel uporabi oxmysql le, če je oxmysql že zagnan (počaka do 15 sekund, medtem ko se oxmysql zaganja); če se oxmysql zažene pozneje, uporabi shrambo key-value.
4. Prvi zagon: mesto lastnika
Prvi zagon v strežniški konzoli izpiše enkratno kodo, veljavno 30 minut (sentinel:owner code izpiše novo). Pridružite se in vpišite /sentinel owner <code>: mesto se veže na vaš račun, koda pa preneha veljati.
Samo mesto lastnika lahko spreminja ključe, raven zaščite, vloge in dovoljenja. sentinel:owner reset v strežniški konzoli sprosti mesto, če ga morate prenesti na drug račun.
5. Staff in dovoljenja
V owner desku, STAFF: izberite igralca, ki je online, izberite vlogo, pritisnite GRANT. Priložene so štiri vloge:
| Vloga | Lahko, takoj po namestitvi |
|---|---|
| Podpora | ogled primerov, obravnava prijav, dežurni zemljevid |
| Moderator | kot Support, plus replayi, kick in karantena |
| Admin | kot Moderator, plus razkritje, oprostitev, ogled v živo, zahteve za ban, pritožbe |
| Senior admin | kot Admin, plus ban, ki velja takoj |
Dovoljenja izberete vi. Vsaka vloga je seznam stikal, ki jih lahko spreminjate. Ustvarite svoje vloge iz kopije (na primer "Trial mod"), preimenujte katero koli vlogo in eni osebi dajte dodatno stikalo ali ji ga odvzemite, ne da bi spremenili njeno vlogo. Stikala, označena kot nevarna (takojšen ban, poslušanje glasovnega klepeta, nastavitve, upravljanje staffa), zahtevajo drugi pritisk. Vsaka sprememba se zapiše v evidenco staffa, zato vedno vidite, kdo je kaj spremenil.
ACE še vedno deluje za strežnike, ki ga že uporabljajo, in se prebere ob vsakem preverjanju:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| Dovoljenje | Vloga, ki jo da |
|---|---|
sentinel.admin |
Admin (Senior admin, dokler mesto lastnika ni prevzeto) in vsak ukaz sentinel:* v igri |
sentinel.staff |
Moderator; pravila gibanja štejejo lastno gibanje člana staffa za pojasnjeno |
Nekaj ukazov (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) je registriranih kot omejeni: v igri potrebujejo tudi command.<name>. Običajna vrstica add_ace group.admin command allow to pokrije. Strežniška konzola lahko zažene vsak ukaz.
6. Raven zaščite
Eno stikalo v owner desku (OWNER, PROTECTION), poleg tega sentinel:level v strežniški konzoli in Config.Protection v config/config.lua. Kar nastavite na desku, se shrani in po ponovnem zagonu prevlada nad vrstico v configu.
- Watch: vsako pravilo opazuje in zapiše, kaj bi naredilo; nihče ne dobi opozorila in nikomur se nič ne zgodi. Medtem se Sentinel uči, kaj je na vašem strežniku normalno: opazovalec eventov (pogostost in oblika vsakega eventa) in preverjanje ob vstopu se učita samo na Watch; omejitve za entitete, boj in denar se še naprej učijo iz poštene igre.
- Recommended: vsako pravilo je live. Staff dobi opozorila z dokazi in odpre se primer. Sentinel nikoli ne kaznuje sam; odloča vaš staff.
- Strict: kot Recommended, visoka ocena pa igralca da v karanteno, dokler staff ne pogleda; ugotovitev na ravni dokaza (Tier A: sprožen vabni event, ponarejena zahteva) poleg tega uvrsti ban v čakalno vrsto za ban wave.
Pod stikalom desk navede vsako pravilo z njegovim stanjem in tem, od kod to stanje izvira. Tam lahko posamezno pravilo pripnete na Live ali Shadow, če ga vaš strežnik potrebuje (na primer pravilo, ki ves čas označuje eno od vaših lastnih skript); vrstica state v Config.Rules ga pripne v datoteki config in prevlada nad deskom.
Smiseln vrstni red:
- Watch za nekaj dni običajne igre.
- Preberite, kaj bi pravila naredila: zavihek Right now,
sentinel:diag rules(stolpec shadow šteje, kolikokrat bi pravilo dodelilo točke) insentinel:diag decisions 100. - Na Shadow pripnite vsako pravilo, ki je označilo nekoga, ki mu zaupate, in nam to sporočite.
- Preklopite na Recommended. Staff zdaj vidi primere in dokaze; nihče ni kaznovan samodejno.
- Strict, ko zaupate temu, kar vam pokaže Recommended.
Za vrnitev kadar koli: Watch na desku ali sentinel:level watch.
7. Konzola staffa (F7)
V igri pritisnite F7 (ali v F8 vpišite sentinel:console). Vsak igralec lahko tipko spremeni v nastavitvah igre (Key Bindings, FiveM). Esc jo zapre.
- Right now v preprostem jeziku pove, kaj se dogaja na vašem strežniku: kdo je videti kot grožnja in zakaj, kaj je bilo dokazano, kaj je bilo pojasnjeno (revive, teleport, ki ga je naredila skripta sama) in kaj potrebuje vas. Vsak igralec, ki je pomemben, dobi eno vrstico: kaj je naredil, kaj to verjetno je, kako prepričan je Sentinel (Unusual, Suspicious, Very likely, Proven), kaj je Sentinel že naredil in en naslednji korak.
- Case files: najprej odprti primeri, vsak s svojo ugotovitvijo, dokazi, posnetki zaslona, pečatom (ali se veriga hashev primera še ujema) in tipkami REVEAL, QUARANTINE, CLEAR in BAN (CLEAR in BAN zahtevata drugi pritisk).
- Duty map: igralci, ki so online, na 3D-modelu otoka. Teren izmeri igra prvega člana staffa in se hrani v
data/map/. - Play replay zapre konzolo in incident ponovno predvaja v zasebnem svetu; za vrnitev pritisnite Backspace.
- Owner (samo mesto lastnika): First run, Protection, Keys, Staff, Internal affairs in Server check.
Ukazi, vpisani v igri, gredo v F8 brez poševnice ali v klepet s poševnico (/sentinel:diag).
8. Spletni panel
Isti desk v spletnem brskalniku, za takrat, ko niste v igri:
- na strežniškem računalniku:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(port je port vašega strežnika, privzeto 30120) - od drugod:
http://<server address>:<port>/zerodev_sentinel/panel/ali vaš lasten naslov HTTPS pred njim
Prijava. Uporabite enkratno kodo: v igri vpišite /sentinel panel (koda se pokaže samo vam, deluje enkrat, 5 minut) ali v strežniški konzoli zaženite sentinel:panel <id or account>. Seja traja 8 ur; SIGN OUT in END ALL MY SESSIONS jo končata. Vaša vloga in stikala veljajo v brskalniku povsem enako kot v igri.
Ogled v živo. Staff s stikalom za ogled v živo lahko iz panela ali konzole gleda zaslon kateregakoli igralca, ki je online. Nič se ne shrani na disk, razen če pritisnete Save to case.
Poslušanje. Poslušanje glasovnega klepeta tega igralca potrebuje stikalo za poslušanje (privzeto samo lastnik) in pma-voice. Zvok se predvaja skozi vašo lastno igro, zato bodite v igri na istem strežniku.
Vsak ogled v živo in vsako poslušanje se zapišeta v evidenco staffa in v primer igralca, igralci pa so ob prvi pridružitvi obveščeni, da lahko staff gleda in posluša (obvestilo o snemanju, Config.Notice).
9. Primeri, karantena, kick, ban in pritožbe
Ko je kaj najdeno, Right now igralca imenuje v preprostem jeziku: kaj je naredil, kako prepričan je Sentinel in kaj je glede tega storil. Odprite primer, da vidite dokaze (položaje, posnetke zaslona, zapečatene s SHA-256, 3D-replay), in uporabite tipke:
- REVEAL: pokaže identifikatorje igralca.
- QUARANTINE: igralca premakne iz pravega sveta v zaseben routing bucket, dokler staff ne pogleda.
sentinel:release <server id>ga vrne nazaj. - CLEAR: ni cheata; zapre primer in ustavi njegov ban v čakalni vrsti.
- KICK: s strežnika, z razlogom, ki ga igralec prebere.
- BAN: skozi ban wave, s kodo za pritožbo.
Ban wave. Bani, tudi BAN, pritisnjen v konzoli, se uvrstijo v čakalno vrsto za ban wave in se izvedejo samo na Strict, privzeto ob naključnem času 2 do 24 ur pozneje (Config.Actions). sentinel:wave jih izpiše, sentinel:wave now <account> enega izvede takoj, sentinel:wave cancel <account> ga prekliče.
Pritožbe. Bannani igralec v sporočilu o zavrnitvi vidi kodo za pritožbo (8 črk in številk). Za pritožbo se ne more pridružiti, zato pritožba do vas pride od zunaj igre:
- Prek vašega staffa. Igralec pošlje kodo vašemu staffu (Discord ticket, e-pošta). Član staffa jo zabeleži z
sentinel:appeal <code> <text>. - Prek spletne poti. Sentinel odgovarja na lastnem naslovu vašega strežnika:
http://<server address>:<port>/zerodev_sentinel/appeal. Sprejme samo POST z JSON{ "code": "...", "text": "...", "contact": "optional" }(besedilo od 10 do 2000 znakov), zato je namenjena obrazcu na vaši spletni strani, ne strani, na katero bi pošiljali igralce. Vsaka sprejeta zahteva dobi enak odgovor, 202 "received", ne glede na to, ali se je koda ujemala z banom ali ne. Preveč zahtev z enega naslova (5 v 10 minutah) ali skupaj (30 na minuto) dobi 429. Za lastnim HTTPS reverse proxyjem nastaviteset sentinel_http_proxy true, da omejitve štejejo naslov obiskovalca.
Besedilo zavrnitve ne pove, kje se pritožiti. Igralcem to povejte v svojih pravilih ali napišite svoje besedilo s svojo povezavo v Config.Bans.message (obdržite %s, ta postane koda), na primer 'You are banned. Appeal at discord.gg/yourserver with code %s'.
Staff odloči v konzoli ali z sentinel:decide <case or code> accept|reject [note]. Accept odpravi vsak aktiven ban tega računa ali primera in prekliče ban v čakalni vrsti za wave; reject ban obdrži. Odločitev je dokončna in se zapiše v dnevnik primera. sentinel:appeals izpiše odprte.
10. Prijave in internal affairs
Prijave igralcev. Vsak igralec vpiše /report <server id> <what happened>, da prijavi igralca ali člana staffa. Zadnji dve minuti okoli obeh igralcev se shranita v primer. Staff prijavo zapre kot ukrepano, brez kršitve, brez dokaza ali dvojnik. Prijave o staffu gredo samo lastniku.
Internal affairs (samo lastnik, na owner desk): kaj je naredil vsak član staffa in kaj je treba pogledati (dovoljenja, dodeljena sebi, skrivanje v boju, bani brez primera, teleporti k igralcem). Tedensko poročilo o poštenosti se zapiše v data/reports/; sentinel:staff report ga zapiše takoj. Nič v evidenci staffa staffa ne kaznuje.
11. Zaščita resourca
Brez kakršnekoli nastavitve Sentinel opazuje vsak event, ki ga igralci lahko pošljejo vašim skriptam, in presoja igralca. Handlerju drugega resourca ne more preprečiti, da se izvede. Če želite slab klic ustaviti, preden se skripta izvede, tej skripti dodajte guard.
sentinel:auditizpiše evente vsakega zagnanega resourca, ki jih lahko sprožijo odjemalci, razvrščene po tem, kaj počnejo njihovi handlerji (na primer handler, ki da denar v znesku, ki ga izbere odjemalec). Z njim se odločite, katere resource zaščititi najprej.sentinel:guard <resource>izpiše vrstico, ki jo je treba dodati, in server_scripts resourca, kot bi se glasili. Vrstica guard mora biti prva strežniška skripta. Ukaz samo izpisuje; ne spremeni nobene datoteke.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Ponovno zaženite ta resource.
sentinel:guard <resource>zdaj pove "guarded since ...". Samsentinel:guardizpiše vse zaščitene resource. - Pravila dodajte s
sentinel:patch. Dokler resource nima pravil, njegov guard prepusti vsak klic, razen klicev igralcev v karanteni, ki jih vsak guard zavrže. Primer: največ 3 nakupi v 10 sekundah, ime predmeta do 32 znakov in količina od 1 do 10; zavrnjen klic šteje kot 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 callback frameworka kot event napišite callback:<name>: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> izpiše pravila resourca; sentinel:patch <resource> <event> off eno odstrani.
Guard nikoli ne ureja datotek in nikoli ne spremeni tega, kar handler prejme. Je navaden, berljiv Lua v guard/guard.lua.
12. Ključi za Discord in shrambo posnetkov
Najlažja pot je owner desk, KEYS: prilepite vsako vrednost in pritisnite SAVE. Ključi se hranijo samo na strežniku; desk in vsak odgovor povesta samo "set" in ključa nikoli več ne pokažeta.
| Vrstica na desku | Kaj je to | Ali v server.cfg (uporabite set, nikoli setr) |
|---|---|---|
| Žeton Discord bota | bot, ki ste ga naredili na discord.com/developers in povabili na svoj strežnik | set sentinel_discord_token "..." |
| ID Discord strežnika | desni klik na vaš strežnik, Copy Server ID (z vklopljenim razvijalskim načinom) | set sentinel_discord_guild "..." |
| ID kanala za opozorila | kamor se objavljajo primeri, z gumbi za vaš staff | set sentinel_discord_channel "..." |
| ID kanala za pritožbe | kamor se objavljajo pritožbe | set sentinel_discord_appeals "..." |
| Ključ FiveManage | medijski ključ s fivemanage.com; posnetki se naložijo tja | set sentinel_fivemanage_key "..." |
| Webhook za posnetke | namesto FiveManage: Discord webhook, ki prejema posnetke | set sentinel_clip_webhook "..." |
| Shramba posnetkov | fivemanage, discord, off ali samodejno (prva, ki je nastavljena) | set sentinel_clip_storage "..." |
Ključ v server.cfg ima prednost pred deskom in desk to pove. Gumbi na Discordu sledijo istim vlogam in stikalom kot konzola. Brez česarkoli od tega primeri in posnetki ostanejo na vašem strežniku (data/), konzola in panel pa jih prikažeta.
Preprostejša opozorila prek webhooka še vedno delujejo: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" ali sentinel:webhook set <url> v strežniški konzoli. sentinel:webhook test pošlje testno sporočilo; sentinel:webhook pokaže stanje, ne da bi kdaj izpisal URL; sentinel:webhook clear odstrani shranjenega.
13. Kaj ujame posamezno pravilo
Vsako pravilo, ko se sproži, zapiše preprost stavek, ki pove, kaj je videlo in kaj je izključilo. Preden pravilo šteje proti komurkoli, Sentinel preveri razloge, ki bi ga pojasnili (respawn, revive, dejanje staffa, ena od vaših lastnih skript, ki premika ali plačuje igralce). Pojasnjena ugotovitev se zabeleži in se nikoli ne točkuje.
- Tier A je dokaz: nekaj, kar naredi samo cheat (vabni event, ki ga ne kliče nobena prava skripta, ponarejena zahteva).
- Tier B je močan: član staffa naj pogleda. Sam po sebi odpre primer samo, kadar se strinjata dve različni družini ali se ista ponovi.
- Tier C je šibek: prišteje se k oceni in nikoli ne ukrepa sam.
Gibanje
| Pravilo | Ujame | Pojasni ga | Tier |
|---|---|---|---|
| teleport | Skok za več kot 150 m (ali 3x toliko, kot je mogoče) med dvema vzorcema | spawn, respawn ali revive, sprememba routing bucketa, staff, teleport event vaše skripte | B |
| foot_speed | Tek nad 12 m/s za 1.5 s peš, brez padanja, brez ragdolla | spawn, respawn, staff, vaša skripta | B |
| air_float | Premikanje, ko je zamrznjen (noclip); "padanje" brez spuščanja (fly); hitro premikanje po koordinatah, medtem ko igra pravi, da igralec stoji pri miru (speed meniji) | spawn, respawn, staff, vaša skripta | B |
| foot_rise | Vzpenjanje naravnost navzgor hitreje od 4 m/s peš za 3 s | spawn, respawn, staff, vaša skripta | B |
| vehicle_speed | Vozilo nad 1.3x najvišje hitrosti, ki jo njegov razred doseže na vašem strežniku | staff, vaša skripta | B |
Svet
| Pravilo | Ujame | Pojasni ga | Tier |
|---|---|---|---|
| entity_blocked | Spawnanje modela, ki ste ga blokirali | vaše skripte, ki ga spawnajo | B |
| entity_rate / entity_model_rate | Spawnanje veliko več entitet (ali enega modela) na minuto, kot jih spawnajo igralci in skripte | vaše skripte, ki spawnajo | B |
| entity_untrusted | Entitete, ki jih je ustvaril odjemalec, brez skripte, ki bi jih spawnala | vaše skripte, ki spawnajo | B |
| entity_disguised | Naval istega ambientalnega modela peda okoli enega igralca (meni, ki svoje spawne prikriva kot promet) | spawn, respawn, sprememba bucketa | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Eksplozije, ki jih orožje v roki ne more narediti, preveč eksplozij, nevidne ali daleč od igralca | eksplozije vaših skript | B |
| projectile_weapon / projectile_rate | Projektili, ki jih orožje ne more izstreliti, ali preveč projektilov | B | |
| ptfx_rate | Poplave učinkov delcev (pogost napad za crash in lag) | B | |
| fire_rate | Ognji, zaneteni hitreje, kot to dovoli katerokoli orožje | B |
Boj
| Pravilo | Ujame | Tier |
|---|---|---|
| damage_plausibility | Škoda nad največjo možno vrednostjo orožja | B |
| hit_range | Zadetki izven dosega orožja | B |
| shot_rate / kill_rate | Streljanje hitreje od orožja; uboji na minuto daleč nad vašim strežnikom | B |
| silent_aim | Zadetki tja, kamor igralec ni meril, ponovljeni | B |
| aim_stats / aim_stats_backed | Delež headshotov in koti snapov daleč izven igralcev vašega strežnika v 30+ bojih | C (B z drugo družino) |
| esp_los_backed | Ponavljajoče se merjenje v igralce, za katere priče poročajo, da so skriti za stenami | C do B |
Eventi in zahteve
| Pravilo | Ujame | Tier |
|---|---|---|
| bait_event | Klic nastavljenega eventa, ki ga ne uporablja nobena prava skripta (cheat meniji jih iščejo in sprožajo) | A |
| bait_statebag / statebag_write | Pisanje state bagov, ki bi jih smel pisati samo strežnik (da se narediš admina, zastavice godmode), ali prevelikih | A / B |
| events_before_ready / _trap | Eventi, poslani, še preden se je igralec sploh spawnal (injicirano pred pridružitvijo) | B / A |
| event_rate / event_shape | Event, klican veliko hitreje od običajnega ali z argumenti, oblikovanimi drugače od običajnih klicev na vašem strežniku | B |
| event_flood | 500+ klicev v 10 s; ob FiveM-ovem lastnem kicku zaradi overflowa so izpisani najpogostejši eventi | B |
| guard_rule / guard_hard | Kršitev pravila, ki ste ga nastavili na zaščitenem eventu (količina, pogostost, razdalja) | B / A |
Ekonomija
| Pravilo | Ujame | Tier |
|---|---|---|
| money_nowhere / item_nowhere | Denar ali predmeti, ki jih ni izdala nobena trgovina, služba ali skripta (dev eventi, razkrite prodaje v trgovinah) | B |
| economy_repeat | Event za nagrado ali službo, izplačan 10-krat v 30 s (farmanje s klicanjem v zanki) | B |
| money_jump / money_rate | Nenaden skok stanja ali hitrost zaslužka daleč nad vašim strežnikom | B |
| economy_trap | Prevzem nastavljene nagrade, ki je ne izplača nobena prava služba | A |
| weapon_not_owned | Držanje orožja, ki ga inventory nikoli ni dal | B |
Igralčeva igra (priča)
| Pravilo | Ujame | Tier |
|---|---|---|
| godmode | Strežnik 30 s bere igralca kot neranljivega (ne v skupni varni coni) | B |
| witness_backed | Znaki iz igre, podprti s strežnikovim lastnim pogledom (godmode, nevidnost, brez kolizije) | B |
| witness_bait | Igra odgovori na preverjanje, za katerega ne bi smela vedeti | A |
| witness_tamper | Sentinelova lastna preverjanja v igri so bila hookana ali spremenjena | B |
Identiteta in datoteke
| Pravilo | Ujame | Tier |
|---|---|---|
| ban_fingerprint | Bannani igralec nazaj na novem računu (strojni žetoni, identifikatorji, prstni odtis brskalnika) | A / oznaka |
| young_account | Čisto nov račun (doda samo težo) | C |
| scanner_error / too_large | Resourci, ki jih skener skript ni mogel prebrati, ali prevelike datoteke, vredne pogleda | info |
Česa ne obljublja nobeno pravilo
Sentinel presoja to, kar lahko vidi strežnik, in to, kar sporoča igralčeva igra. Ne bere drugih programov na igralčevem računalniku in noben anti-cheat ne more obljubiti, da bo ujet vsak cheat. Vsaka ugotovitev pride s svojimi dokazi, tako da vaš staff odloča na podlagi dejstev.
14. Ukazi in konfiguracija
Vsak ukaz je na strani z ukazi in vsak ključ configa na strani s konfiguracijo, obe sta ustvarjeni iz samega resourca. Tisti, ki jih uporabljate največ:
| Ukaz | Kaj naredi |
|---|---|
/sentinel owner <code> |
prevzemite mesto lastnika v igri s kodo iz konzole |
/sentinel panel |
enkratna koda za prijavo v spletni panel (samo staff) |
/report <server id> <what happened> |
vsak igralec prijavi igralca ali člana staffa |
sentinel:health |
še enkrat zagonsko okno |
sentinel:diag |
kaj je Sentinel odločil in zakaj |
sentinel:level watch\|recommended\|strict |
spremeni raven zaščite in jo shrani |
sentinel:wave |
bani v čakalni vrsti za ban wave |
sentinel:appeals |
odprte pritožbe |
sentinel:audit |
tvegani eventi vsakega zagnanega resourca |
sentinel:guard <resource> |
vrstica, ki zaščiti resource |
sentinel:advisor |
nastavitve FiveM, ki jih je na vašem strežniku vredno spremeniti |
Datoteke config v config/ (config.lua, protection.lua, watch.lua) in prevodi v config/locales/ so vam odprti, prav tako adapterji za frameworke v bridge/ in datoteka guard v guard/. Naj ostanejo veljaven Lua, po spremembi pa ponovno zaženite zerodev_sentinel. Za prvi zagon ni treba urejati configa.
15. Zagonsko okno in svetovalec za utrjevanje
Trenutek po tem, ko je shramba pripravljena, Sentinel v strežniški konzoli izpiše okno. Vrstica FAIL pomeni, da Sentinel ne more pravilno delovati; vrstica WARN pomeni, da deluje z manj (na primer dokazi brez digestov). Kadarkoli ga znova izpišite s sentinel:health.
| Vrstica | Kaj preverja | Ko ni OK |
|---|---|---|
| Build | Različica in oznaka builda iz fxmanifest.lua. | - |
| OneSync | Convar onesync. Sentinel položaje, entitete in dogodke igre bere prek OneSync. |
v server.cfg nastavite set onesync on |
| Zagnane kopije | Koliko kopij resourca je zagnanih, ne glede na to, kako se imenuje njihova mapa. Mora biti 1. | obdržite eno kopijo Sentinela; drugo mapo ustavite |
| Shramba | Katera shramba je bila izbrana (mysql ali kvp) in ali je pripravljena. | glejte sentinel:diag storage |
| Mapa z dokazi | Testni zapis in branje v data/archive znotraj resourca. | ustvarite mapo data/archive znotraj resourca Sentinel in poskrbite, da strežnik lahko piše vanjo |
| SHA-256 | Ali node/util.js odgovarja; ta naredi prstni odtis vsakega dokaza. | dokazi se shranijo brez digestov; v konzoli preverite, ali je napaka Node |
| Zaščita | Raven zaščite, njen način in od kod izvira. | - |
| Pravila | Koliko pravil je live in koliko v shadow. | - |
Po zagonskem oknu svetovalec izpiše nastavitve FiveM, ki jih je na vašem strežniku vredno spremeniti (Config.Advisor.atStartup = false ga izpiše samo ob sentinel:advisor). Za vsako nastavitev pokaže trenutno vrednost, priporočeno vrednost, kaj blokira, kaj bi lahko pokvarila in vrstico za kopiranje. Vrednosti samo bere; server.cfg nikoli ne spremeni. Vrstico preizkusite na svojem strežniku, preden jo obdržite.
16. Jeziki in kaj se beleži
Besedila za igralce in staff pridejo iz config/locales/<code>.lua, v tem buildu 25 jezikov. Config.Locale izbere jezik; s Config.GameLanguage = true igralec, čigar igra teče v jeziku, ki ga ponuja GTA, Sentinel bere v tem jeziku, ko je v igri.
Sentinel za vsakega igralca v pomnilniku hrani približno zadnji dve minuti položajev in eventov (Config.Recorder) in jih zapiše v arhiv v data/archive/, ko se odpre primer ali staff uporabi sentinel:save. Med pregledom od osumljenčeve igre zahteva posnetke zaslona (20-sekundne odseke) in jih shrani v data/clips/. Shrani identifikatorje, ki jih FiveM da strežniku (naslov IP se zabeleži, a se privzeto nikoli ne uporabi za zavrnitev povezave), in, kadar teče Discord, Discord ID. Ob prvi pridružitvi vsak igralec v svojem jeziku dobi kratko obvestilo, da strežnik snema igro in da lahko staff gleda in posluša (Config.Notice = false ga izklopi; takrat jim to povejte v svojih pravilih). Omenite to tudi v svoji politiki zasebnosti.
Stari arhivi in posnetki se v tem buildu ne brišejo samodejno: data/archive/ in data/clips/ počistite sami, ko jih ne potrebujete več.
Z oxmysql so Sentinelovi zapisi v tabelah zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report in zds_trail. Brez oxmysql isti zapisi živijo v shrambi ključ/vrednost resourca (ključi, ki se začnejo z zds:). Bani se vedno zrcalijo v shrambo ključ/vrednost, zato se uveljavljajo tudi, ko baza podatkov ne deluje.
17. Posodabljanje
Nove različice se objavijo v istem assetu Keymaster. Sentinel svoje dokaze hrani v lastni mapi, zato preden jo zamenjate:
- V mapi
zerodev_sentinelnaredite varnostno kopijo mapconfig/indata/(arhivi, posnetki, poročila, naučene osnove) in, z oxmysql, tabelzds_. - Ustavite strežnik, mapo
zerodev_sentinelzamenjajte z novo (obdržite ime mape) in vrnite svojo mapodata/. Nastavitve, ki ste jih spremenili, prenesite v nove datoteke config, namesto da čeznje kopirate stare datoteke. - Zaženite strežnik in preberite zagonsko okno (
sentinel:health).
Pred posodobitvijo preberite opombe k izdaji nove različice v dnevniku sprememb.
18. Odstranitev
- Odstranite vrstico guard iz vsakega resourca, ki ste ga zaščitili (
sentinel:guardjih izpiše), in te resource ponovno zaženite. To naredite najprej: ko ni več mape, ni več niti datoteke guard. - Iz server.cfg odstranite
ensure zerodev_sentinelter vrsticisentinel.admin/sentinel.staff, nato ustavite resource. Če jesentinel:lockdownspremenil entity lockdown, ustavitev Sentinela vrne prvotni način. - Izbrišite mapo
zerodev_sentinel. S tem se odstranidata/z vsemi arhivi, posnetki in poročili, zato prej kopirajte ven vse, kar želite obdržati. - Z oxmysql izbrišite tabele
zds_, naštete v razdelku 16, če banov in primerov ne želite več. Zapisi ključ/vrednost ostanejo v shrambi strežnika pod imenom resourca in brez njega ne počnejo ničesar.
Sentinel piše samo v svojo mapo, svoje tabele v podatkovni bazi in svojo shrambo key-value. Ne ureja drugih resourceov ali server.cfg.
Pogosta vprašanja
Ali Sentinel sam koga banne ali kickne?
Na Watch ali Recommended ne. Začne na Watch, kjer samo beleži, kaj bi naredil. Na Recommended staff dobi dokaze in odloči. Samo na Strict visoka ocena igralca da v karanteno, dokler staff ne pogleda, ugotovitev na ravni dokaza pa uvrsti ban v čakalno vrsto za ban wave.
Ali potrebujem bazo podatkov?
Ne. Z oxmysql Sentinel hrani zapise v vaši podatkovni bazi in ob prvem zagonu ustvari svoje tabele; datoteke SQL za uvoz ni. Brez njega je vse v lastni shrambi key-value resourcea.
Ali deluje na QBCore in Qbox?
Da. Zaznavanje, primeri, posnetki, konzola, spletni panel, Discord in owner desk so na vsakem frameworku enaki. Sled denarja in predmetov ima lasten adapter za ESX, QBCore, Qbox in ox_inventory.
Kako dam dostop svojim adminom?
Na owner desk, STAFF: izberite igralca, ki je online, izberite vlogo, pritisnite GRANT. Ali pa še naprej uporabljajte ACE: sentinel.admin da Admin in sentinel.staff da Moderator.
Ali se lahko bannani igralec pritoži?
Da. Sporočilo o zavrnitvi pokaže kodo za pritožbo. Igralec jo pošlje vašemu staffu, ki jo zabeleži s sentinel:appeal, ali pa jo vaša spletna stran pošlje na Sentinelovo pot za pritožbe. Staff jo sprejme ali zavrne v konzoli ali s sentinel:decide.
Ali vidi programe za cheatanje na igralčevem računalniku?
Ne. Sentinel presoja to, kar lahko vidi strežnik, in to, kar sporoča igralčeva igra. Ne bere drugih programov na igralčevem računalniku.
Ali je poslušanje glasovnega klepeta pripravljeno?
Potrebuje pma-voice in stikalo za poslušanje (privzeto samo lastnik), predvaja pa se skozi vašo lastno igro.
Kaj vidijo igralci?
Ob prvi pridružitvi kratko obvestilo v njihovem jeziku, da strežnik snema igro in da lahko staff gleda in posluša (Config.Notice). Za čistega igralca se ne spremeni nič drugega.