Dokumentace ZeroDev Sentinel
ZeroDev Sentinel: instalace a použití
ZeroDev Sentinel je serverový anti-cheat resource pro FiveM. Zaznamenává, co server vidí, posuzuje to pravidly, která se sama vysvětlují srozumitelnými větami, a dává vašemu staffu důkazy dřív, než je kdokoli potrestán. Začíná na úrovni ochrany Watch: zaznamenává a nikoho netrestá, dokud se nerozhodnete jinak. Tento návod popisuje verzi 0.1.2 na serverech ESX, QBCore, Qbox a standalone.
1. Požadavky
- Zapnutý OneSync (
set onesync onv server.cfg). Resource má OneSync uvedený jako závislost, takže ho FXServer bez OneSync nespustí. - FXServer artifact, který spouští Node 22 skripty (jakýkoli aktuálně doporučený artifact; manifest požaduje
node_version '22'). Node obstarává hashování, kompresi, výpis souborů a webovou cestu pro odvolání. - Volitelně: oxmysql. S ním Sentinel ukládá své záznamy do vaší databáze a při prvním spuštění si sám vytvoří tabulky. Žádný SQL soubor k importu není. Bez něj je vše uložené ve vlastním key-value úložišti resource.
- Volitelně: pma-voice, pro poslech voice chatu hráče z konzole nebo z panelu v prohlížeči.
Framework hraje roli jen ve dvou věcech: ve stopě peněz a itemů (peníze a itemy, které nevyplatil žádný obchod, práce ani skript, smyčky odměn, rollbacky) a v tom, kdo je váš staff (ACE skupiny, které používá každý framework). Detekce, případy, záznamy, konzole, panel v prohlížeči, Discord a pult majitele fungují na každém frameworku stejně.
2. Instalace za pět minut
Nic nepotřebuje SQL, pro první spuštění není potřeba upravovat config a žádný jiný resource se nemění.
Krok 5: Otevřete pult majitele
Ve hře stiskněte F7 (nebo napište sentinel:console do F8) a otevřete OWNER. List First run ukazuje, co je hotové a co ne: Discord, úložiště záznamů, váš staff a jeho oprávnění. Každý řádek má jedno tlačítko. Potom hrajte pár dní na Watch, přečtěte si, co Sentinel našel na listu Right now, a na stejném pultu přepněte úroveň ochrany na Recommended (sekce 6).
3. Váš framework
Sentinel si framework a inventory najde sám, když se spustí. Není co nastavovat. sentinel:trail v konzoli serveru ukáže, jaký adapter zvolil.
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- Peníze a itemy: čtou se z vlastních server eventů ESX (peníze na účtu přidané, odebrané nebo nastavené; itemy v inventory přidané nebo odebrané; itemy předané z hráče na hráče, s propojením obou stran). Rollback používá vlastní metody hráče v ESX a výsledek si znovu načte.
- ESX s ox_inventory: peníze se sledují stejně. V tomto režimu metody ESX pro itemy nevracejí výsledky, takže Sentinel rozhoduje jen podle zpětného načtení.
- Staff: dejte svým adminům ACE oprávnění (sekce 5). Vlastní
group.adminz ESX funguje jako ACE skupina, když pro ni přidáte řádek.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- Peníze: čtou se z eventu QBCore pro změnu peněz (přidání, odebrání a nastavení, s důvodem). Ztráta a stejně velký zisk ve stejném okamžiku se propojí jako převod, protože QBCore vlastní event pro převod nemá.
- Itemy: s ox_inventory se itemy sledují přes jeho hooky. S qb-inventory se změny itemů nesledují (payload jeho listeneru není zdokumentovaný), ale rollback i tak může přesouvat itemy pomocí zdokumentovaných exportů qb-inventory.
- Staff: skupiny oprávnění v QBCore jsou ACE skupiny (
group.admin,group.god). Přidejte ACE řádky ze sekce 5.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- Peníze: čtou se z eventu Qbox pro změnu peněz; zůstatky se znovu načítají vlastními exporty
qbx_core. Peníze změněné offline postavě (přes citizen id) nespustí žádný event, takže ve stopě nejsou. - Itemy: Qbox používá ox_inventory a Sentinel sleduje jeho itemy přes hooky ox_inventory. Itemy, které představují peníze frameworku, jsou ponechány části pro framework.
- Staff: ACE skupiny, stejně jako na QBCore.
Standalone (bez frameworku)
set onesync on
ensure zerodev_sentinel- Funguje vše kromě stopy peněz a itemů: pohyb, svět, eventy, bait eventy, godmode, state bagy, zbraně, případy, záznamy, replay, konzole, panel, Discord, role a bany.
- S ox_inventory a bez frameworku se itemy sledují přes ox_inventory.
- Úložiště: key-value úložiště, nebo oxmysql, pokud ho spustíte dřív.
Kontrola, že to funguje
sentinel:health: znovu startovní box. Každý řádek je skutečná kontrola; READY znamená, že nic nechybí.sentinel:diag: proč bylo zvoleno úložiště, adaptery a úroveň, každé pravidlo s počítadly a poslední rozhodnutí.sentinel:trail: používaný adapter pro peníze a itemy a poslední změny jednoho hráče.
V automatickém režimu úložiště Sentinel použije oxmysql jen tehdy, když už oxmysql běží (při startu oxmysql čeká až 15 sekund); pokud se oxmysql spustí později, použije key-value úložiště.
4. První spuštění: místo majitele
První spuštění vypíše do konzole serveru jednorázový kód platný 30 minut (sentinel:owner code vypíše nový). Připojte se a napište /sentinel owner <code>: místo se naváže na váš účet a kód přestane platit.
Jen místo majitele může měnit klíče, úroveň ochrany, role a oprávnění. sentinel:owner reset v konzoli serveru místo uvolní, pokud ho potřebujete přesunout na jiný účet.
5. Staff a oprávnění
Na pultu majitele v STAFF: vyberte hráče online, vyberte roli, stiskněte GRANT. K dispozici jsou čtyři role:
| Role | Může, ve výchozím stavu |
|---|---|
| Podpora | vidět případy, řešit hlášení, mapa služby |
| Moderator | jako Support, navíc replaye, kick a karanténa |
| Admin | jako Moderator, navíc odhalení, očištění, živý náhled, žádosti o ban, odvolání |
| Senior admin | jako Admin, navíc ban, který platí okamžitě |
Oprávnění si volíte sami. Každá role je seznam přepínačů, které můžete měnit. Vytvořte si vlastní role z kopie (například "Trial mod"), přejmenujte kteroukoli roli a dejte jednomu člověku přepínač navíc nebo mu jeden odeberte, aniž byste měnili jeho roli. Přepínače označené jako nebezpečné (okamžitý ban, poslech voice chatu, nastavení, správa staffu) vyžadují druhé stisknutí. Každá změna se zapíše do záznamu staffu, takže vždy uvidíte, kdo co změnil.
ACE dál funguje pro servery, které ho už používají, a čte se při každé kontrole:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| Oprávnění | Role, kterou dává |
|---|---|
sentinel.admin |
Admin (Senior admin, dokud není místo majitele převzaté) a každý příkaz sentinel:* ve hře |
sentinel.staff |
Moderator; pravidla pohybu považují vlastní pohyb člena staffu za vysvětlený |
Několik příkazů (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) je registrováno jako omezené: ve hře potřebují ještě command.<name>. Běžný řádek add_ace group.admin command allow to pokryje. Konzole serveru může spustit každý příkaz.
6. Úroveň ochrany
Jeden přepínač na pultu majitele (OWNER, PROTECTION), dále sentinel:level v konzoli serveru a Config.Protection v config/config.lua. Co nastavíte na pultu, se uloží a po restartu má přednost před řádkem v configu.
- Watch: každé pravidlo sleduje a zapisuje, co by udělalo; nikdo nedostane upozornění a nikomu se nic nestane. Mezitím se Sentinel učí, co je na vašem serveru normální: pozorovatel eventů (četnost a tvar každého eventu) a kontrola při připojení se učí jen na Watch; limity pro entity, boj a peníze se dál učí z čisté hry.
- Recommended: každé pravidlo je aktivní. Staff dostává upozornění s důkazy a otevře se případ. Sentinel nikdy netrestá sám; rozhoduje váš staff.
- Strict: jako Recommended, a vysoké skóre dá hráče do karantény, dokud se na to staff nepodívá; nález na úrovni důkazu (Tier A: spuštěný bait event, podvržený požadavek) navíc zařadí ban do fronty pro ban wave.
Pod přepínačem pult vypisuje každé pravidlo s jeho stavem a tím, odkud stav pochází. Jednotlivé pravidlo tam můžete připnout na Live nebo Shadow, pokud to váš server potřebuje (například pravidlo, které stále označuje jeden z vašich vlastních skriptů); řádek state v Config.Rules ho připne v config souboru a má přednost před pultem.
Rozumné pořadí:
- Watch na několik dní běžného hraní.
- Přečtěte si, co by pravidla udělala: list Right now,
sentinel:diag rules(sloupec shadow počítá, kolikrát by pravidlo přidalo skóre) asentinel:diag decisions 100. - Každé pravidlo, které označilo někoho, komu věříte, připněte na Shadow a dejte nám vědět.
- Přepněte na Recommended. Staff teď vidí případy a důkazy; nikdo není potrestán automaticky.
- Strict, až budete věřit tomu, co vám Recommended ukazuje.
Návrat zpět kdykoli: Watch na pultu, nebo sentinel:level watch.
7. Staff konzole (F7)
Ve hře stiskněte F7 (nebo napište sentinel:console do F8). Každý hráč si může klávesu změnit v nastavení hry (Key Bindings, FiveM). Esc ji zavře.
- Right now srozumitelně říká, co se na vašem serveru děje: kdo vypadá jako hrozba a proč, co bylo prokázáno, co bylo vysvětleno (revive, teleport z vlastního scriptu) a co potřebuje vás. Každý důležitý hráč dostane jeden řádek: co udělal, co to nejspíš je, jak moc si je Sentinel jistý (Unusual, Suspicious, Very likely, Proven), co už Sentinel udělal a jeden další krok.
- Spisy případů: nejdřív otevřené případy, každý s nálezem, důkazy, záznamy obrazovky, pečetí (zda hash řetězec případu stále sedí) a tlačítky REVEAL, QUARANTINE, CLEAR a BAN (CLEAR a BAN vyžadují druhé stisknutí).
- Mapa služby: online hráči na 3D modelu ostrova. Terén změří hra prvního člena staffu a uloží se do
data/map/. - Play replay zavře konzoli a přehraje incident v soukromém světě; zpět se vrátíte klávesou Backspace.
- Majitel (jen místo majitele): First run, Protection, Keys, Staff, Internal affairs a Server check.
Příkazy ve hře se píší do F8 bez lomítka, nebo do chatu s lomítkem (/sentinel:diag).
8. Panel v prohlížeči
Stejný pult ve webovém prohlížeči, pro chvíle, kdy nejste ve hře:
- na počítači se serverem:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(port je port vašeho serveru, výchozí 30120) - odjinud:
http://<server address>:<port>/zerodev_sentinel/panel/, nebo vaše vlastní HTTPS adresa před ním
Přihlášení. Použijte jednorázový kód: napište ve hře /sentinel panel (kód se zobrazí jen vám, platí jednou a 5 minut), nebo spusťte sentinel:panel <id or account> v konzoli serveru. Relace trvá 8 hodin; SIGN OUT a END ALL MY SESSIONS ji ukončí. Vaše role a přepínače platí v prohlížeči přesně jako ve hře.
Živý náhled. Staff s přepínačem živého náhledu může z panelu nebo konzole sledovat obrazovku kteréhokoli online hráče. Na disk se nic neukládá, pokud nestisknete Save to case.
Poslech. Poslech voice chatu daného hráče vyžaduje přepínač poslechu (ve výchozím stavu jen majitel) a pma-voice. Zvuk hraje přes vaši vlastní hru, takže buďte ve hře na stejném serveru.
Každý živý náhled a každý poslech se zapíše do staff záznamu a do případu hráče a hráči se při prvním připojení dozví, že je staff může sledovat a poslouchat (upozornění na nahrávání, Config.Notice).
9. Případy, karanténa, kick, ban a odvolání
Když se něco najde, Right now hráče jmenuje srozumitelně: co udělal, jak moc si je Sentinel jistý a co s tím udělal. Otevřete případ, abyste viděli důkazy (pozice, záznamy obrazovky zapečetěné pomocí SHA-256, 3D replay), a použijte tlačítka:
- REVEAL: zobrazí identifikátory hráče.
- QUARANTINE: přesune hráče ze skutečného světa do soukromého routing bucketu, dokud se na to staff nepodívá.
sentinel:release <server id>ho vrátí zpět. - CLEAR: žádný cheat; zavře případ a zastaví jeho naplánovaný ban.
- KICK: ze serveru, s důvodem, který si hráč přečte.
- BAN: přes ban wave, s kódem pro odvolání.
Ban wave. Bany, včetně BAN stisknutého v konzoli, se zařadí do fronty pro ban wave a použijí se jen na Strict, ve výchozím stavu v náhodnou dobu 2 až 24 hodin později (Config.Actions). sentinel:wave je vypíše, sentinel:wave now <account> jeden použije hned, sentinel:wave cancel <account> ho zruší.
Odvolání. Zabanovaný hráč uvidí ve zprávě o odmítnutí kód pro odvolání (8 písmen a číslic). Nemůže se připojit, aby se odvolal, takže odvolání k vám přijde mimo hru:
- Přes váš staff. Hráč pošle kód vašemu staffu (Discord ticket, mail). Člen staffu ho zaznamená pomocí
sentinel:appeal <code> <text>. - Přes webovou routu. Sentinel odpovídá na vlastní adrese vašeho serveru:
http://<server address>:<port>/zerodev_sentinel/appeal. Přijímá jen POST s JSON{ "code": "...", "text": "...", "contact": "optional" }(text 10 až 2000 znaků), takže je určená pro formulář na vašem webu, ne jako stránka, na kterou posíláte hráče. Každý přijatý požadavek dostane stejnou odpověď, 202 "received", ať kód odpovídal banu, nebo ne. Příliš mnoho požadavků z jedné adresy (5 za 10 minut) nebo celkem (30 za minutu) dostane 429. Za vlastním HTTPS reverse proxy nastavteset sentinel_http_proxy true, aby limity počítaly adresu návštěvníka.
Text odmítnutí neříká, kde se odvolat. Řekněte to hráčům ve svých pravidlech, nebo napište vlastní text se svým odkazem do Config.Bans.message (ponechte %s, stane se z něj kód), například 'You are banned. Appeal at discord.gg/yourserver with code %s'.
Staff rozhoduje v konzoli nebo pomocí sentinel:decide <case or code> accept|reject [note]. Accept zruší každý aktivní ban daného účtu nebo případu a zruší naplánovaný ban z wave; reject ban ponechá. Rozhodnutí je konečné a zapíše se do logu případu. sentinel:appeals vypíše otevřená odvolání.
10. Hlášení a vnitřní kontrola
Hlášení hráčů. Kterýkoli hráč napíše /report <server id> <what happened>, aby nahlásil hráče nebo člena staffu. Poslední dvě minuty kolem obou hráčů se uloží do případu. Staff uzavře hlášení jako vyřešené, bez porušení, bez důkazu nebo duplicitní. Hlášení na staff jdou jen majiteli.
Vnitřní kontrola (jen majitel, na pultu majitele): co který člen staffu udělal a co potřebuje kontrolu (přidělení sobě, schovávání v boji, bany bez případu, teleporty k hráčům). Týdenní report férovosti se zapíše do data/reports/; sentinel:staff report ho zapíše hned. Nic ve staff záznamu staff netrestá.
11. Ochrana resource
Bez jakéhokoli nastavení Sentinel sleduje každý event, který mohou hráči poslat vašim scriptům, a posuzuje hráče. Nemůže zabránit tomu, aby se handler jiného resource spustil. Chcete-li zastavit špatné volání dřív, než se script spustí, přidejte do toho scriptu guard.
sentinel:auditvypíše eventy každého spuštěného resource, které mohou klienti spustit, seřazené podle toho, co dělají jejich handlery (například handler, který dává peníze v částce, kterou si zvolí klient). Podle toho se rozhodněte, které resource chránit jako první.sentinel:guard <resource>vypíše řádek, který máte přidat, a server_scripts daného resource tak, jak by pak vypadaly. Guard řádek musí být prvním server scriptem. Příkaz jen vypisuje; nemění žádný soubor.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Restartujte ten resource.
sentinel:guard <resource>teď říká "guarded since ...".sentinel:guardsamotný vypíše každý chráněný resource. - Pravidla přidáte pomocí
sentinel:patch. Dokud resource nemá pravidla, jeho guard propustí každé volání, kromě volání od hráčů v karanténě, která zahodí každý guard. Příklad: nejvýše 3 nákupy za 10 sekund, název itemu do 32 znaků a množství od 1 do 10; odmítnuté volání se počítá jako důkaz ("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}
Pro framework callback napište jako event callback:<name>: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> vypíše pravidla resource; sentinel:patch <resource> <event> off jedno odstraní.
Guard nikdy neupravuje soubory a nikdy nemění to, co handler dostane. Je to obyčejné, čitelné Lua v guard/guard.lua.
12. Klíče pro Discord a úložiště záznamů
Nejjednodušší je pult majitele, KEYS: vložte každou hodnotu a stiskněte SAVE. Klíče se ukládají jen na serveru; pult i každá odpověď řeknou jen "set" a klíč už nikdy nezobrazí.
| Řádek na pultu | Co to je | Nebo v server.cfg (použijte set, nikdy setr) |
|---|---|---|
| Token Discord bota | bot, kterého jste vytvořili na discord.com/developers a pozvali na svůj server | set sentinel_discord_token "..." |
| ID Discord serveru | pravým tlačítkem na váš server, Copy Server ID (se zapnutým vývojářským režimem) | set sentinel_discord_guild "..." |
| ID kanálu pro upozornění | kam se posílají případy, s tlačítky pro váš staff | set sentinel_discord_channel "..." |
| ID kanálu pro odvolání | kam se posílají odvolání | set sentinel_discord_appeals "..." |
| Klíč FiveManage | media klíč z fivemanage.com; záznamy se nahrávají tam | set sentinel_fivemanage_key "..." |
| Webhook pro záznamy | místo FiveManage: Discord webhook, který přijímá záznamy | set sentinel_clip_webhook "..." |
| Úložiště záznamů | fivemanage, discord, off nebo automatic (první, který je nastavený) | set sentinel_clip_storage "..." |
Klíč v server.cfg má přednost před pultem a pult to uvede. Tlačítka na Discordu se řídí stejnými rolemi a přepínači jako konzole. Bez čehokoli z toho zůstanou případy a záznamy na vašem serveru (data/) a konzole i panel je zobrazí.
Jednodušší webhook upozornění dál fungují: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" nebo sentinel:webhook set <url> v konzoli serveru. sentinel:webhook test pošle testovací zprávu; sentinel:webhook ukáže stav, aniž by kdy vypsal URL; sentinel:webhook clear odstraní uložený.
13. Co které pravidlo zachytí
Každé pravidlo při spuštění napíše srozumitelnou větu o tom, co vidělo a co vyloučilo. Než se pravidlo proti někomu započítá, Sentinel zkontroluje důvody, které by to vysvětlily (respawn, revive, akce staffu, některý z vašich vlastních scriptů, který hráče přesouvá nebo jim platí). Vysvětlený nález se zaloguje a nikdy se nezapočítá do skóre.
- Úroveň A je důkaz: něco, co dělá jen cheat (návnadový event, který žádný skutečný script nevolá, podvržený požadavek).
- Úroveň B je silná: měl by se na to podívat člen staffu. Sama otevře případ jen tehdy, když se shodnou dvě různé rodiny, nebo se stejná opakuje.
- Úroveň C je slabá: přidává ke skóre a nikdy nejedná sama.
Pohyb
| Pravidlo | Zachytí | Vysvětlí to | Úroveň |
|---|---|---|---|
| teleport | Skok o více než 150 m (nebo 3x víc, než je možné) mezi dvěma vzorky | spawn, respawn nebo revive, změna routing bucketu, staff, teleport event vašeho scriptu | B |
| foot_speed | Běh rychlostí přes 12 m/s po dobu 1.5 s pěšky, bez pádu, bez ragdollu | spawn, respawn, staff, váš script | B |
| air_float | Pohyb při zmražení (noclip); "padání" bez klesání (fly); rychlý pohyb podle souřadnic, zatímco hra hlásí, že hráč stojí (speed menu) | spawn, respawn, staff, váš script | B |
| foot_rise | Stoupání kolmo vzhůru rychleji než 4 m/s pěšky po dobu 3 s | spawn, respawn, staff, váš script | B |
| vehicle_speed | Vozidlo rychlejší než 1.3x nejvyšší rychlost, jakou jeho třída na vašem serveru dosahuje | staff, váš script | B |
Svět
| Pravidlo | Zachytí | Vysvětlí to | Úroveň |
|---|---|---|---|
| entity_blocked | Spawnutí modelu, který jste zablokovali | vaše scripty, které ho spawnují | B |
| entity_rate / entity_model_rate | Spawnování mnohem více entit (nebo jednoho modelu) za minutu, než to dělají hráči a scripty | vaše spawnovací scripty | B |
| entity_untrusted | Entity vytvořené klientem, aniž by je spawnoval nějaký script | vaše spawnovací scripty | B |
| entity_disguised | Nával stejného ambient ped modelu kolem jednoho hráče (menu, které své spawny maskuje jako provoz) | spawn, respawn, změna bucketu | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Exploze, které držená zbraň nedokáže vytvořit, příliš mnoho explozí, neviditelné exploze nebo exploze daleko od hráče | exploze vašich scriptů | B |
| projectile_weapon / projectile_rate | Projektily, které zbraň nemůže vystřelit, nebo jich je příliš mnoho | B | |
| ptfx_rate | Záplavy částicových efektů (častý útok na crash a lag) | B | |
| fire_rate | Požáry zakládané rychleji, než dovolí jakákoli zbraň | B |
Boj
| Pravidlo | Zachytí | Úroveň |
|---|---|---|
| damage_plausibility | Poškození nad možnou hodnotou zbraně | B |
| hit_range | Zásahy z větší vzdálenosti, než je dostřel zbraně | B |
| shot_rate / kill_rate | Střelba rychlejší, než zbraň umí; killy za minutu daleko nad běžnou úrovní vašeho serveru | B |
| silent_aim | Opakované zásahy tam, kam hráč nemířil | B |
| aim_stats / aim_stats_backed | Podíl headshotů a snap úhly daleko mimo hráče vašeho serveru během 30+ soubojů | C (B s další rodinou) |
| esp_los_backed | Opakované míření na hráče, o kterých svědci hlásí, že jsou schovaní za zdmi | C až B |
Eventy a požadavky
| Pravidlo | Zachytí | Úroveň |
|---|---|---|
| bait_event | Volání nastraženého eventu, který žádný skutečný script nepoužívá (cheat menu je hledají a spouštějí) | A |
| bait_statebag / statebag_write | Zápis state bagů, které by měl zapisovat jen server (udělat ze sebe admina, godmode příznaky), nebo příliš velkých | A / B |
| events_before_ready / _trap | Eventy poslané dřív, než se hráč vůbec spawnul (injektované před připojením) | B / A |
| event_rate / event_shape | Event volaný mnohem rychleji než obvykle, nebo s argumenty jiného tvaru, než mají běžná volání na vašem serveru | B |
| event_flood | 500+ volání za 10 s; při vlastním overflow kicku FiveM se vypíšou nejčastější eventy | B |
| guard_rule / guard_hard | Porušení pravidla, které jste nastavili na chráněný event (částka, frekvence, vzdálenost) | B / A |
Ekonomika
| Pravidlo | Zachytí | Úroveň |
|---|---|---|
| money_nowhere / item_nowhere | Peníze nebo itemy, které nevydal žádný obchod, job ani script (dev eventy, uniklé prodeje z obchodů) | B |
| economy_repeat | Event odměny nebo jobu vyplacený 10krát za 30 s (farmení voláním ve smyčce) | B |
| money_jump / money_rate | Náhlý skok zůstatku nebo tempo výdělku daleko nad běžnou úrovní vašeho serveru | B |
| economy_trap | Vyzvednutí nastražené odměny, kterou žádný skutečný job nevyplácí | A |
| weapon_not_owned | Držení zbraně, kterou inventář nikdy nevydal | B |
Hra hráče (svědek)
| Pravidlo | Zachytí | Úroveň |
|---|---|---|
| godmode | Server vidí hráče 30 s jako nezranitelného (ne ve sdílené safe zóně) | B |
| witness_backed | Signály ze hry podložené vlastním pohledem serveru (godmode, neviditelnost, žádná kolize) | B |
| witness_bait | Hra odpovídá na kontrolu, o které by neměla vědět | A |
| witness_tamper | Vlastní kontroly Sentinelu ve hře byly hooknuté nebo změněné | B |
Identita a soubory
| Pravidlo | Zachytí | Úroveň |
|---|---|---|
| ban_fingerprint | Zabanovaný hráč zpátky na novém účtu (hardware tokeny, identifikátory, otisk prohlížeče) | A / flag |
| young_account | Úplně nový účet (jen přidává váhu) | C |
| scanner_error / too_large | Resource, které skener scriptů nedokázal přečíst, nebo příliš velké soubory, na které stojí za to se podívat | info |
Co žádné pravidlo neslibuje
Sentinel posuzuje to, co server vidí a co hlásí hra hráče. Nečte jiné programy na počítači hráče a žádný anti-cheat nemůže slíbit, že zachytí každý cheat. Každý nález přichází se svými důkazy, takže váš staff rozhoduje podle faktů.
14. Příkazy a konfigurace
Každý příkaz je na stránce příkazů a každý config klíč na stránce konfigurace, obojí vygenerované přímo z resource. Ty, které použijete nejčastěji:
| Příkaz | Co dělá |
|---|---|
/sentinel owner <code> |
převzít místo majitele ve hře kódem z konzole |
/sentinel panel |
jednorázový přihlašovací kód do panelu v prohlížeči (jen pro staff) |
/report <server id> <what happened> |
kterýkoli hráč nahlásí hráče nebo člena staffu |
sentinel:health |
znovu startovní box |
sentinel:diag |
co Sentinel rozhodl a proč |
sentinel:level watch\|recommended\|strict |
změnit úroveň ochrany a uložit ji |
sentinel:wave |
bany zařazené do ban wave |
sentinel:appeals |
otevřená odvolání |
sentinel:audit |
rizikové eventy každého spuštěného resource |
sentinel:guard <resource> |
řádek, který chrání resource |
sentinel:advisor |
nastavení FiveM, která se na vašem serveru vyplatí změnit |
Konfigurační soubory v config/ (config.lua, protection.lua, watch.lua) a překlady v config/locales/ máte otevřené, stejně jako adaptéry frameworků v bridge/ a soubor guardu v guard/. Udržujte je jako platné Lua a po změně restartujte zerodev_sentinel. Pro první spuštění není potřeba nic v configu měnit.
15. Startovní box a poradce pro zabezpečení
Chvíli poté, co je úložiště připravené, vypíše Sentinel do konzole serveru box. Řádek FAIL znamená, že Sentinel nemůže správně fungovat; řádek WARN znamená, že funguje s omezením (například důkazy bez digestů). Kdykoli ho znovu vypíšete příkazem sentinel:health.
| Řádek | Co kontroluje | Když není OK |
|---|---|---|
| Build | Verze a označení buildu z fxmanifest.lua. | - |
| OneSync | Convar onesync. Sentinel čte pozice, entity a herní eventy přes OneSync. |
nastavte onesync na on v server.cfg |
| Běžící kopie | Kolik kopií resource je spuštěno, ať se jejich složka jmenuje jakkoli. Musí to být 1. | nechte jednu kopii Sentinelu; druhou složku zastavte |
| Úložiště | Které úložiště bylo zvoleno (mysql nebo kvp) a zda je připravené. | viz sentinel:diag storage |
| Složka důkazů | Testovací zápis a čtení v data/archive uvnitř resource. | vytvořte složku data/archive uvnitř resource Sentinelu a ověřte, že do ní server může zapisovat |
| SHA-256 | Zda odpovídá node/util.js; vytváří otisk každého důkazu. | důkazy se ukládají bez digestů; v konzoli hledejte chybu Node |
| Ochrana | Úroveň ochrany, její režim a odkud pochází. | - |
| Pravidla | Kolik pravidel je Live a kolik v Shadow. | - |
Po startovním boxu vypíše poradce nastavení FiveM, která se na vašem serveru vyplatí změnit (s Config.Advisor.atStartup = false je vypíše jen na sentinel:advisor). U každého nastavení ukáže aktuální hodnotu, doporučenou hodnotu, co blokuje, co by mohlo rozbít a řádek ke zkopírování. Hodnoty jen čte; server.cfg nikdy nemění. Než si řádek necháte, otestujte ho na svém serveru.
16. Jazyky a co se zaznamenává
Texty pro hráče a staff pocházejí z config/locales/<code>.lua, v tomto buildu 25 jazyků. Config.Locale volí jazyk; s Config.GameLanguage = true čte hráč, jehož hra běží v jazyce, který GTA nabízí, Sentinel po vstupu do hry v tomto jazyce.
Sentinel drží pro každého hráče v paměti zhruba poslední dvě minuty pozic a eventů (Config.Recorder) a zapíše je do archivu v data/archive/, když se otevře případ nebo staff použije sentinel:save. Během kontroly si od hry podezřelého vyžádá záznamy obrazovky (úseky po 20 sekundách) a uloží je do data/clips/. Ukládá identifikátory, které FiveM předá serveru (IP adresa se zaznamenává, ale ve výchozím stavu se nikdy nepoužívá k odmítnutí připojení), a když běží Discord, i Discord id. Při prvním připojení dostane každý hráč ve svém jazyce krátké upozornění, že server nahrává hraní a že staff může sledovat a poslouchat (Config.Notice = false ho vypne; pak to hráčům řekněte v pravidlech). Zmiňte to i v zásadách ochrany soukromí.
Staré archivy a záznamy se v tomto buildu automaticky nemažou: až je nebudete potřebovat, vyčistěte data/archive/ a data/clips/ sami.
S oxmysql jsou záznamy Sentinelu v tabulkách zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report a zds_trail. Bez oxmysql jsou stejné záznamy v key-value úložišti resource (klíče začínající na zds:). Bany se vždy zrcadlí i do key-value úložiště, takže platí i ve chvíli, kdy databáze nejede.
17. Aktualizace
Nové verze vycházejí na stejném Keymaster assetu. Sentinel si důkazy drží ve své vlastní složce, takže než ho nahradíte:
- Zálohujte ve složce
zerodev_sentinelsložkyconfig/adata/(archivy, záznamy, reporty, naučené baseliny) a s oxmysql také tabulkyzds_. - Zastavte server, nahraďte složku
zerodev_sentinelnovou (název složky ponechte) a vraťte zpět svou složkudata/. Nastavení, která jste změnili, přeneste do nových konfiguračních souborů, místo abyste přes ně kopírovali staré soubory. - Spusťte server a přečtěte si startovní box (
sentinel:health).
Před aktualizací si přečtěte poznámky k vydání nové verze v changelogu.
18. Odinstalace
- Odstraňte řádek guardu z každého resource, který jste chránili (
sentinel:guardje vypíše), a tyto resources restartujte. Udělejte to jako první: soubor guardu zmizí, jakmile zmizí složka. - Odstraňte
ensure zerodev_sentinela řádkysentinel.admin/sentinel.staffze server.cfg a pak resource zastavte. Pokudsentinel:lockdownzměnil entity lockdown, zastavení Sentinelu vrátí původní režim. - Smažte složku
zerodev_sentinel. Tím se odstranídata/se všemi archivy, záznamy a reporty, takže si předtím zkopírujte vše, co chcete zachovat. - S oxmysql smažte tabulky
zds_uvedené v sekci 16, pokud už bany a případy nechcete. Key-value záznamy zůstanou v úložišti serveru pod názvem resource a bez něj nic nedělají.
Sentinel zapisuje jen do své vlastní složky, svých databázových tabulek a svého key-value úložiště. Neupravuje jiné resources ani server.cfg.
Časté dotazy
Banuje nebo kickuje Sentinel někoho sám?
Na Watch ani Recommended ne. Začíná na Watch, kde jen zaznamenává, co by udělal. Na Recommended dostane staff důkazy a rozhodne. Jen na Strict pošle vysoké skóre hráče do karantény, dokud se na to staff nepodívá, a nález na úrovni důkazu zařadí ban do ban wave.
Potřebuji databázi?
Ne. S oxmysql ukládá Sentinel své záznamy do vaší databáze a při prvním startu si vytvoří vlastní tabulky; žádný SQL soubor k importu není. Bez něj je všechno ve vlastním key-value úložišti resource.
Funguje na QBCore a Qbox?
Ano. Detekce, případy, záznamy, konzole, panel v prohlížeči, Discord a pult majitele jsou na každém frameworku stejné. Stopa peněz a itemů má vlastní adaptér pro ESX, QBCore, Qbox a ox_inventory.
Jak dám svým adminům přístup?
Na pultu majitele v STAFF: vyberte hráče online, vyberte roli, stiskněte GRANT. Nebo dál používejte ACE: sentinel.admin dává Admin a sentinel.staff dává Moderator.
Může se zabanovaný hráč odvolat?
Ano. Zpráva o odmítnutí ukáže kód pro odvolání. Hráč ho pošle vašemu staffu, který ho zapíše příkazem sentinel:appeal, nebo ho váš web odešle na odvolací route Sentinelu. Staff ho přijme nebo zamítne v konzoli nebo příkazem sentinel:decide.
Vidí cheaty na počítači hráče?
Ne. Sentinel posuzuje, co vidí server a co hlásí hra hráče. Jiné programy na počítači hráče nečte.
Je poslech voice chatu hotový?
Potřebuje pma-voice a přepínač poslechu (ve výchozím stavu jen pro majitele) a přehrává se přes vaši vlastní hru.
Co vidí hráči?
Při prvním připojení krátké upozornění v jejich jazyce, že server nahrává hraní a že staff může sledovat a poslouchat (Config.Notice). Pro čistého hráče se nic jiného nemění.