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.

Pro ZeroDev Sentinel 0.1.223 min čteníAktualizováno

1. Požadavky

  • Zapnutý OneSync (set onesync on v 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 1: Vložte složku do resources

Zkopírujte složku zerodev_sentinel do své složky resources. Ponechte přesně tento název složky: guard soubor hlásí do zerodev_sentinel a sentinel:guard vás upozorní, když se složka jmenuje jinak.

Krok 2: Přidejte ji do server.cfg

Spouštějte ho po oxmysql a vašem frameworku, aby je úložiště a stopa peněz při startu našly. Přesné pořadí pro váš framework je v sekci 3.

Krok 3: Spusťte server

Konzole vypíše startovní box a jednorázový kód majitele. Každý řádek boxu je skutečná kontrola; poslední řádek říká READY, nebo NOT READY s počtem problémů (sekce 15).

Krok 4: Převezměte místo majitele

Připojte se na server a napište do chatu /sentinel owner <code>. Teď držíte místo majitele (sekce 4).

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

server.cfg
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.admin z ESX funguje jako ACE skupina, když pro ni přidáte řádek.

QBCore

server.cfg
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

server.cfg
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)

server.cfg
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:

server.cfg
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í:

  1. Watch na několik dní běžného hraní.
  2. 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) a sentinel:diag decisions 100.
  3. Každé pravidlo, které označilo někoho, komu věříte, připněte na Shadow a dejte nám vědět.
  4. Přepněte na Recommended. Staff teď vidí případy a důkazy; nikdo není potrestán automaticky.
  5. 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:

  1. Přes váš staff. Hráč pošle kód vašemu staffu (Discord ticket, mail). Člen staffu ho zaznamená pomocí sentinel:appeal <code> <text>.
  2. 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 nastavte set 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.

  1. sentinel:audit vypíš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í.
  2. 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' }

  1. Restartujte ten resource. sentinel:guard <resource> teď říká "guarded since ...". sentinel:guard samotný vypíše každý chráněný resource.
  2. 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:

  1. Zálohujte ve složce zerodev_sentinel složky config/ a data/ (archivy, záznamy, reporty, naučené baseliny) a s oxmysql také tabulky zds_.
  2. Zastavte server, nahraďte složku zerodev_sentinel novou (název složky ponechte) a vraťte zpět svou složku data/. Nastavení, která jste změnili, přeneste do nových konfiguračních souborů, místo abyste přes ně kopírovali staré soubory.
  3. 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

  1. Odstraňte řádek guardu z každého resource, který jste chránili (sentinel:guard je vypíše), a tyto resources restartujte. Udělejte to jako první: soubor guardu zmizí, jakmile zmizí složka.
  2. Odstraňte ensure zerodev_sentinel a řádky sentinel.admin / sentinel.staff ze server.cfg a pak resource zastavte. Pokud sentinel:lockdown změnil entity lockdown, zastavení Sentinelu vrátí původní režim.
  3. 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.
  4. 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í.

Přeloženo z angličtiny. Pokud se zde něco liší od anglické stránky, platí anglická stránka. English