ZeroDev Sentinel dokumentáció

ZeroDev Sentinel: telepítés és használat

A ZeroDev Sentinel egy szerveroldali anti-cheat resource FiveM-hez. Rögzíti, amit a szerver lát, olyan szabályokkal ítéli meg, amelyek érthető mondatokban magyarázzák meg magukat, és a bizonyítékot a stábod kezébe adja, mielőtt bárkit megbüntetnének. A Watch védelmi szinten indul: naplóz, és senkit sem büntet, amíg másképp nem döntesz. Ez az útmutató a 0.1.2-es verziót írja le ESX, QBCore, Qbox és standalone szervereken.

ZeroDev Sentinel 0.1.2-hoz23 perc olvasásFrissítve:

1. Követelmények

  • OneSync bekapcsolva (set onesync on a server.cfg-ben). A resource függőségként jelöli a OneSyncet, így az FXServer OneSync nélkül nem indítja el.
  • Egy FXServer artifact, amely Node 22 scripteket futtat (bármelyik jelenleg ajánlott artifact; a manifest ezt kéri: node_version '22'). A Node végzi a hashelést, a tömörítést, a fájllistázást és a fellebbezések webes útvonalát.
  • Opcionális: oxmysql. Ezzel a Sentinel az adatbázisodban tárolja a rekordjait, és első indításkor maga hozza létre a tábláit. Nincs importálandó SQL-fájl. Nélküle minden a resource saját key-value store-jában van.
  • Opcionális: pma-voice, egy játékos voice chatjének lehallgatásához a konzolból vagy a böngészős panelből.

A framework csak két dologban számít: a pénz- és tárgynyomban (pénz és tárgyak, amelyeket egyetlen bolt, munka vagy script sem fizetett ki, jutalomhurkok, rollbackek), és abban, hogy kik a stábod tagjai (ACE csoportok, amelyeket minden framework használ). Az észlelés, az ügyek, a felvételek, a konzol, a böngészős panel, a Discord és a tulajdonosi pult minden frameworkön ugyanúgy működik.

2. Telepítés öt perc alatt

Semmihez sem kell SQL, az első indításhoz nem kell a configot szerkeszteni, és más resource nem módosul.

1. lépés: Tedd a mappát a resources-ba

Másold a zerodev_sentinel mappát a resources mappádba. Pontosan ezt a mappanevet tartsd meg: a guard fájl ide jelent: zerodev_sentinel, és a sentinel:guard figyelmeztet, ha a mappa bármi más nevet visel.

2. lépés: Add hozzá a server.cfg-hez

Az oxmysql és a frameworköd után indítsd, hogy a tárolás és a pénznyom induláskor megtalálja őket. A frameworködhöz tartozó pontos sorrend a 3. fejezetben van.

3. lépés: Indítsd el a szervert

A konzol kiír egy indítási dobozt és egy egyszer használatos tulajdonosi kódot. A doboz minden sora valódi ellenőrzés; az utolsó sor READY, vagy NOT READY a problémák számával (15. fejezet).

4. lépés: Foglald el a tulajdonosi helyet

Csatlakozz a szerverre, és írd be a chatbe: /sentinel owner <code>. Mostantól tiéd a tulajdonosi hely (4. fejezet).

5. lépés: Nyisd meg a tulajdonosi pultot

Nyomd meg az F7-et játékban (vagy írd be a sentinel:console parancsot az F8-ba), és nyisd meg az OWNER részt. A First run lap mutatja, mi van kész és mi nincs: Discord, felvételtárhely, a stábod és a jogosultságaik. Minden sorhoz egy gomb tartozik. Utána játssz néhány napot Watch szinten, olvasd el a Right now lapon, mit talált Sentinel, és ugyanezen a pulton állítsd a védelmi szintet Recommended értékre (6. fejezet).

3. A frameworköd

A Sentinel induláskor magától megtalálja a frameworköt és az inventoryt. Nincs mit beállítani. A szerverkonzolban a sentinel:trail megmutatja, melyik adaptert választotta.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Pénz és tárgyak: az ESX saját server eventjeiből olvassa (számlapénz hozzáadva, levonva vagy beállítva; inventory-tárgyak hozzáadva vagy elvéve; játékostól játékosnak adott tárgyak, mindkét oldal összekapcsolva). A rollback az ESX saját játékosmetódusait használja, és visszaolvassa az eredményt.
  • ESX ox_inventoryval: a pénzt ugyanígy követi. Ebben a módban az ESX tárgymetódusai nem adnak vissza eredményt, ezért a Sentinel csak a visszaolvasás alapján dönt.
  • Stáb: add meg az adminjaidnak az ACE jogosultságot (5. fejezet). Az ESX saját group.admin csoportja ACE csoportként működik, ha hozzáadod a hozzá tartozó sort.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Pénz: a QBCore pénzváltozási eventjéből olvassa (hozzáadás, levonás és beállítás, az okkal együtt). Az ugyanabban a pillanatban történt veszteséget és vele egyenlő nyereséget átutalásként köti össze, mert a QBCore-nak nincs saját átutalási eventje.
  • Tárgyak: ox_inventory esetén a tárgyakat a hookjain keresztül követi. qb-inventory esetén a tárgyváltozásokat nem követi (a listener payloadja nincs dokumentálva), de a rollback így is mozgathat tárgyakat a qb-inventory dokumentált exportjaival.
  • Stáb: a QBCore jogosultsági csoportjai ACE csoportok (group.admin, group.god). Add hozzá az 5. fejezet ACE sorait.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Pénz: a Qbox pénzváltozási eventjéből olvassa; az egyenlegeket a qbx_core saját exportjaival olvassa vissza. Egy offline karakternél (citizen id alapján) megváltoztatott pénz nem vált ki eventet, így nincs benne a nyomban.
  • Tárgyak: a Qbox ox_inventoryt használ, és a Sentinel az ox_inventory hookjain keresztül követi a tárgyait. A framework-pénzt jelentő tárgyakat a framework-részre hagyja.
  • Stáb: ACE csoportok, mint QBCore-on.

Standalone (framework nélkül)

server.cfg
set onesync on
ensure zerodev_sentinel
  • A pénz- és tárgynyomon kívül minden működik: mozgás, világ, eventek, csali eventek, godmode, state bagek, fegyverek, ügyek, felvételek, replay, konzol, panel, Discord, szerepek és banok.
  • ox_inventoryval és framework nélkül a tárgyakat az ox_inventoryn keresztül követi.
  • Tárolás: a key-value store, vagy az oxmysql, ha azt indítod el előbb.

Ellenőrzés, hogy működik

  • sentinel:health: újra az indítási doboz. Minden sor valódi ellenőrzés; a READY azt jelenti, hogy semmi sem hiányzik.
  • sentinel:diag: miért ezt a tárolást, adaptereket és szintet választotta, minden szabály a számlálóival, és a legutóbbi döntések.
  • sentinel:trail: a használt pénz- és tárgyadapter, és egy játékos legutóbbi változásai.

Automatikus tárolási módban a Sentinel csak akkor használja az oxmysqlt, ha az oxmysql már elindult (legfeljebb 15 másodpercet vár, amíg az oxmysql indul); ha az oxmysql később indul, a key-value store-t használja.

4. Első indítás: a tulajdonosi hely

Az első indítás egy egyszer használatos kódot ír ki a szerverkonzolba, amely 30 percig érvényes (a sentinel:owner code újat ír ki). Csatlakozz, és írd be: /sentinel owner <code>: a hely a fiókodhoz kötődik, és a kód érvényét veszti.

Csak a tulajdonosi hely módosíthatja a kulcsokat, a védelmi szintet, a szerepeket és a jogosultságokat. A szerverkonzolban a sentinel:owner reset felszabadítja a helyet, ha át kell vinned egy másik fiókra.

5. Stáb és jogosultságok

A tulajdonosi pulton, STAFF: válassz egy online játékost, válassz szerepet, nyomd meg a GRANT gombot. Négy szerep érkezik vele:

Szerep Alapból ezt teheti
Támogatás ügyek megtekintése, jelentések kezelése, a szolgálati térkép
Moderator mint Support, plusz replayek, kick és karantén
Admin mint Moderator, plusz felfedés, felmentés, élő nézet, ban-kérések, fellebbezések
Senior admin mint Admin, plusz azonnal érvényes ban

A jogosultságokat te választod meg. Minden szerep kapcsolók listája, amelyet módosíthatsz. Készíts saját szerepeket egy másolatból (például "Trial mod"), nevezz át bármelyik szerepet, és adj egy személynek egy extra kapcsolót, vagy vegyél el tőle egyet anélkül, hogy a szerepét módosítanád. A veszélyesnek jelölt kapcsolók (azonnali ban, voice chat lehallgatása, beállítások, stábkezelés) második megnyomást kérnek. Minden változás bekerül a stáb naplójába, így mindig látod, ki mit módosított.

Az ACE továbbra is működik azokon a szervereken, amelyek már használják, és minden ellenőrzésnél kiolvasásra kerül:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Jogosultság Az általa adott szerep
sentinel.admin Admin (Senior admin, amíg a tulajdonosi helyet el nem foglalják) és minden sentinel:* parancs játékban
sentinel.staff Moderator; a mozgási szabályok egy stábtag saját mozgását megmagyarázottnak tekintik

Néhány parancs (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) korlátozottként van regisztrálva: játékban ezekhez a command.<name> is kell. A szokásos add_ace group.admin command allow sor ezt lefedi. A szerverkonzol minden parancsot futtathat.

6. A védelmi szint

Egyetlen kapcsoló a tulajdonosi pulton (OWNER, PROTECTION), emellett a szerverkonzolban a sentinel:level, valamint a Config.Protection a config/config.lua fájlban. Amit a pulton beállítasz, az mentésre kerül, és újraindítás után felülírja a config sort.

  • Watch: minden szabály figyel, és leírja, mit tett volna; senki sem kap riasztást, és senkivel nem történik semmi. Közben a Sentinel megtanulja, mi a normális a szervereden: az event-megfigyelő (minden event gyakorisága és formája) és a csatlakozási ellenőrzés csak Watch szinten tanul; az entitás-, harci és pénzkorlátok a tiszta játékból tovább tanulnak.
  • Recommended: minden szabály élesben fut. A stáb riasztásokat kap a bizonyítékokkal, és megnyílik egy ügy. A Sentinel soha nem büntet magától; a stábod dönt.
  • Strict: mint a Recommended, és egy magas pontszám karanténba teszi a játékost, amíg a stáb rá nem néz; egy bizonyítékszintű megállapítás (Tier A: elsült egy csali event, hamisított kérés) ezen felül egy bant is sorba állít a ban wave-hez.

A kapcsoló alatt a pult minden szabályt felsorol az állapotával és azzal, honnan jön az állapot. Ott egy-egy szabályt Live vagy Shadow állapotra rögzíthetsz, ha a szerverednek erre van szüksége (például egy szabályt, amely folyton megjelöli az egyik saját scriptedet); egy state sor a Config.Rules részben a config fájlban rögzíti, és felülírja a pultot.

Egy ésszerű sorrend:

  1. Watch néhány napig normál játék mellett.
  2. Olvasd el, mit tettek volna a szabályok: a Right now lapot, a sentinel:diag rules kimenetét (a shadow oszlop azt számolja, hányszor adott volna pontot egy szabály) és a sentinel:diag decisions 100 kimenetét.
  3. Rögzítsd Shadow állapotra azt a szabályt, amely megjelölt valakit, akiben megbízol, és szólj nekünk.
  4. Válts Recommended szintre. A stáb most már látja az ügyeket és a bizonyítékokat; senki sem kap automatikusan büntetést.
  5. Strict, amikor már megbízol abban, amit a Recommended mutat.

Bármikor visszaléphetsz: Watch a pulton, vagy sentinel:level watch.

7. A stáb-konzol (F7)

Nyomd meg az F7-et játékban (vagy írd be a sentinel:console parancsot az F8-ba). Minden játékos átállíthatja a billentyűt a játék beállításaiban (Key Bindings, FiveM). Az Esc bezárja.

  • A Right now egyszerű szavakkal elmondja, mi történik a szervereden: ki tűnik veszélyesnek és miért, mi bizonyosodott be, minek van magyarázata (egy revive, egy saját scripted teleportja), és mihez kellesz te. Minden fontos játékos kap egy sort: mit csinált, mi lehet ez valószínűleg, mennyire biztos a Sentinel (Unusual, Suspicious, Very likely, Proven), mit tett már a Sentinel, és egy következő lépést.
  • Ügyakták: elöl a nyitott ügyek, mindegyik a megállapítással, a bizonyítékokkal, képernyőfelvételekkel, a pecséttel (hogy az ügy hash-lánca még ellenőrizhető-e) és a REVEAL, QUARANTINE, CLEAR és BAN gombokkal (a CLEAR és a BAN második megnyomást kér).
  • Szolgálati térkép: az online játékosok a sziget 3D-s modelljén. A terepet az első stábtag játéka méri fel, és a data/map/ mappában tárolódik.
  • A Play replay bezárja a konzolt, és egy privát világban visszajátssza az incidenst; a Backspace-szel térsz vissza.
  • Tulajdonos (csak a tulajdonosi hely): First run, Protection, Keys, Staff, Internal affairs és Server check.

A játékban kiadott parancsok perjel nélkül mennek az F8-ba, vagy perjellel a chatbe (/sentinel:diag).

8. A böngészős panel

Ugyanaz a pult webböngészőben, arra az esetre, ha nem vagy játékban:

  • a szervergépen: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (a port a szervered portja, alapból 30120)
  • máshonnan: http://<server address>:<port>/zerodev_sentinel/panel/, vagy a saját HTTPS-címed előtte

Bejelentkezés. Használj egyszer használatos kódot: írd be játékban a /sentinel panel parancsot (a kódot csak te látod, egyszer működik, 5 percig), vagy futtasd a sentinel:panel <id or account> parancsot a szerverkonzolban. Egy munkamenet 8 óráig tart; a SIGN OUT és az END ALL MY SESSIONS lezárja. A szereped és a kapcsolóid a böngészőben pontosan úgy érvényesek, mint játékban.

Élő nézet. Az élő nézet kapcsolóval rendelkező stáb a panelről vagy a konzolból bármelyik online játékos képernyőjét nézheti. Semmi nem kerül lemezre, hacsak meg nem nyomod a Save to case gombot.

Lehallgatás. Az adott játékos voice chatjének lehallgatásához kell a lehallgatás kapcsoló (alapból csak a tulajdonosé) és a pma-voice. A hang a saját játékodon keresztül szól, ezért légy játékban ugyanazon a szerveren.

Minden élő nézés és minden lehallgatás bekerül a stáb naplójába és a játékos ügyébe, a játékosok pedig az első csatlakozáskor értesítést kapnak arról, hogy a stáb nézheti és hallgathatja őket (a felvételi értesítés, Config.Notice).

9. Ügyek, karantén, kick, ban és fellebbezések

Ha valami előkerül, a Right now érthetően megnevezi a játékost: mit csinált, mennyire biztos a Sentinel, és mit tett ellene. Nyisd meg az ügyet a bizonyítékokért (pozíciók, SHA-256-tal lepecsételt képernyőfelvételek, 3D-s replay), és használd a gombokat:

  • REVEAL: megmutatja a játékos azonosítóit.
  • QUARANTINE: kiveszi a játékost a valódi világból egy privát routing bucketbe, amíg a stáb meg nem nézi. A sentinel:release <server id> visszahozza.
  • CLEAR: nincs csalás; lezárja az ügyet, és leállítja a sorban álló banját.
  • KICK: le a szerverről, egy indoklással, amelyet a játékos elolvas.
  • BAN: a ban wave-en keresztül, fellebbezési kóddal.

A ban wave. A banok, a konzolban megnyomott BAN is, sorba kerülnek a ban wave-hez, és csak Strict szinten hajtódnak végre, alapból véletlenszerű időpontban 2–24 órával később (Config.Actions). A sentinel:wave kilistázza őket, a sentinel:wave now <account> azonnal végrehajt egyet, a sentinel:wave cancel <account> törli.

Fellebbezések. A bannolt játékos az elutasító üzenetben lát egy fellebbezési kódot (8 betű és számjegy). Nem tud csatlakozni, hogy fellebbezzen, ezért a fellebbezés a játékon kívülről jut el hozzád:

  1. A stábodon keresztül. A játékos elküldi a kódot a stábodnak (Discord-ticket, e-mail). Egy stábtag rögzíti a sentinel:appeal <code> <text> paranccsal.
  2. A webes útvonalon keresztül. A Sentinel a szervered saját címén válaszol: http://<server address>:<port>/zerodev_sentinel/appeal. Csak JSON-os POST-ot fogad el: { "code": "...", "text": "...", "contact": "optional" } (a szöveg 10–2000 karakter), tehát a weboldaladon lévő űrlaphoz való, nem olyan oldal, ahová játékosokat küldesz. Minden elfogadott kérés ugyanazt a választ kapja, 202 "received", akár egyezett a kód egy bannal, akár nem. A túl sok kérés egy címről (5 darab 10 perc alatt) vagy összesen (30 percenként) 429-et kap. Saját HTTPS reverse proxy mögött állítsd be a set sentinel_http_proxy true sort, hogy a korlátok a látogató címét számolják.

Az elutasító szöveg nem mondja meg, hol lehet fellebbezni. Írd meg a játékosoknak a szabályzatodban, vagy írj saját szöveget a linkeddel a Config.Bans.message értékbe (tartsd meg a %s részt, abból lesz a kód), például 'You are banned. Appeal at discord.gg/yourserver with code %s'.

A stáb a konzolban dönt, vagy ezzel: sentinel:decide <case or code> accept|reject [note]. Az accept feloldja az adott fiók vagy ügy minden aktív banját, és törli a sorban álló wave-bant; a reject megtartja a bant. A döntés végleges, és bekerül az ügy naplójába. A sentinel:appeals kilistázza a nyitottakat.

10. Jelentések és belső ellenőrzés

Játékosjelentések. Bármelyik játékos beírhatja a /report <server id> <what happened> parancsot, hogy jelentsen egy játékost vagy egy stábtagot. A két játékos körüli utolsó két perc egy ügybe kerül. A stáb a jelentést intézkedve, nincs szabálysértés, nincs bizonyíték vagy duplikátum állapottal zárja le. A stábról szóló jelentések csak a tulajdonoshoz jutnak.

Belső ellenőrzés (csak a tulajdonos, a tulajdonosi pulton): mit csinált az egyes stábtagok, és mi szorul átnézésre (saját maguknak adott jogok, rejtőzködés harc közben, ügy nélküli banok, teleport játékosokhoz). Heti méltányossági jelentés készül a data/reports/ mappába; a sentinel:staff report azonnal megírja. A stáb naplójában semmi nem bünteti a stábot.

11. Egy resource védelme

Mindenféle beállítás nélkül a Sentinel figyel minden eventet, amelyet a játékosok a scriptjeidnek küldhetnek, és megítéli a játékost. Azt nem tudja megakadályozni, hogy egy másik resource handlere lefusson. Ha egy rossz hívást már azelőtt meg akarsz állítani, hogy a script lefutna, add hozzá a guardot ahhoz a scripthez.

  1. A sentinel:audit kilistázza minden elindított resource azon eventjeit, amelyeket a kliensek kiválthatnak, aszerint rangsorolva, mit csinálnak a handlereik (például egy handler, amely a kliens által választott összegű pénzt ad). Ez alapján döntsd el, melyik resource-okat véded először.
  2. A sentinel:guard <resource> kiírja a hozzáadandó sort és a resource server_scripts részét úgy, ahogy akkor kinézne. A guard sornak kell lennie az első server scriptnek. A parancs csak kiír; egyetlen fájlt sem módosít.

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

  1. Indítsd újra azt a resource-t. A sentinel:guard <resource> most ezt mondja: "guarded since ...". A sentinel:guard önmagában kilistáz minden védett resource-t.
  2. Szabályokat a sentinel:patch paranccsal adsz hozzá. Amíg egy resource-nak nincsenek szabályai, a guardja minden hívást átenged, kivéve a karanténban lévő játékosok hívásait, ezeket minden guard eldobja. Példa: legfeljebb 3 vásárlás 10 másodperc alatt, legfeljebb 32 karakteres itemnév és 1 és 10 közötti mennyiség; egy elutasított hívás bizonyítéknak számít ("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}

Framework callbackhez eventként callback:<name> formát írj: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. A sentinel:patch <resource> kilistázza egy resource szabályait; a sentinel:patch <resource> <event> off töröl egyet.

A guard soha nem szerkeszt fájlokat, és soha nem változtat azon, amit egy handler megkap. Egyszerű, olvasható Lua a guard/guard.lua fájlban.

12. Discord és felvételtároló kulcsok

A legegyszerűbb a tulajdonosi pult, KEYS: illeszd be mindegyik értéket, és nyomd meg a SAVE gombot. A kulcsok csak a szerveren tárolódnak; a pult és minden válasz csak annyit mond, hogy "set", és soha többé nem mutat meg egy kulcsot.

Sor a pulton Mi ez Vagy a server.cfg-ben (set, soha ne setr)
Discord bot token egy bot, amelyet a discord.com/developers oldalon hoztál létre, és meghívtál a szerveredre set sentinel_discord_token "..."
Discord szerver id jobb klikk a szerveredre, Copy Server ID (bekapcsolt fejlesztői móddal) set sentinel_discord_guild "..."
Riasztási csatorna id ahová az ügyek kerülnek, gombokkal a stábodnak set sentinel_discord_channel "..."
Fellebbezési csatorna id ahová a fellebbezések kerülnek set sentinel_discord_appeals "..."
FiveManage kulcs egy média kulcs a fivemanage.com oldalról; a felvételek oda töltődnek fel set sentinel_fivemanage_key "..."
Felvétel webhook FiveManage helyett: egy Discord webhook, amely fogadja a felvételeket set sentinel_clip_webhook "..."
Felvételtárolás fivemanage, discord, off vagy automatic (az első, amelyik be van állítva) set sentinel_clip_storage "..."

A server.cfg-ben lévő kulcs elsőbbséget élvez a pulttal szemben, és a pult ezt jelzi is. A Discord gombok ugyanazokat a szerepeket és kapcsolókat követik, mint a konzol. Ezek nélkül az ügyek és a felvételek a szervereden maradnak (data/), és a konzol meg a panel mutatja őket.

Az egyszerűbb webhook-riasztások továbbra is működnek: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" vagy sentinel:webhook set <url> a szerverkonzolban. A sentinel:webhook test tesztüzenetet küld; a sentinel:webhook megmutatja az állapotot anélkül, hogy valaha kiírná az URL-t; a sentinel:webhook clear törli a tároltat.

13. Mit fog meg az egyes szabály

Minden szabály, amikor jelez, ír egy egyszerű mondatot arról, mit látott és mit zárt ki. Mielőtt egy szabály bárki ellen számítana, a Sentinel ellenőrzi azokat az okokat, amelyek megmagyaráznák (respawn, revive, stábtag művelete, egy saját scripted, amely mozgatja vagy fizeti a játékosokat). A megmagyarázott megállapítás naplózódik, és soha nem kap pontot.

  • Az A szint bizonyíték: olyasmi, amit csak egy csalás csinál (egy csali event, amelyet egyetlen valódi script sem hív, egy hamisított kérés).
  • A B szint erős: egy stábtagnak meg kell néznie. Önmagában csak akkor nyit ügyet, ha két különböző család egyetért, vagy ugyanaz ismétlődik.
  • A C szint gyenge: hozzáad a pontszámhoz, és soha nem cselekszik egyedül.

Mozgás

Szabály Mit fog meg Mi magyarázza Szint
teleport Több mint 150 m-es ugrás (vagy a lehetséges 3x-osa) két mérés között spawn, respawn vagy revive, routing bucket váltás, stáb, a scripted teleport eventje B
foot_speed Gyalogos futás 12 m/s felett 1.5 s-ig, esés és ragdoll nélkül spawn, respawn, stáb, a scripted B
air_float Mozgás lefagyasztott állapotban (noclip); "esés" lejjebb kerülés nélkül (fly); gyors mozgás koordináták alapján, miközben a játék szerint a játékos áll (speed menük) spawn, respawn, stáb, a scripted B
foot_rise Függőleges emelkedés gyalog 4 m/s-nál gyorsabban 3 s-ig spawn, respawn, stáb, a scripted B
vehicle_speed Egy jármű a kategóriája által a szervereden elért legnagyobb sebesség 1.3x-osa felett stáb, a scripted B

Világ

Szabály Mit fog meg Mi magyarázza Szint
entity_blocked Egy általad tiltott modell spawnolása a scriptjeid, amelyek spawnolják B
entity_rate / entity_model_rate Percenként sokkal több entitás (vagy egy modell) spawnolása, mint amennyit a játékosok és a scriptek szoktak a spawnoló scriptjeid B
entity_untrusted Egy kliens által létrehozott entitások, amelyeket egyetlen script sem spawnol a spawnoló scriptjeid B
entity_disguised Ugyanannak az ambient ped modellnek egy hirtelen tömege egy játékos körül (egy menü, amely a spawnjait forgalomnak álcázza) spawn, respawn, bucket váltás B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Robbanások, amelyeket a kézben tartott fegyver nem tud okozni, túl sok, láthatatlan vagy a játékostól távoli robbanás a scriptjeid robbanásai B
projectile_weapon / projectile_rate Lövedékek, amelyeket a fegyver nem tud kilőni, vagy túl sok lövedék B
ptfx_rate Részecskeeffektek áradata (gyakori crash- és lag-támadás) B
fire_rate Gyorsabban gyújtott tüzek, mint amit bármelyik fegyver enged B

Harc

Szabály Mit fog meg Szint
damage_plausibility A fegyver lehetséges értékénél nagyobb sebzés B
hit_range Találatok a fegyver hatótávolságán túlról B
shot_rate / kill_rate A fegyvernél gyorsabb lövés; percenkénti killek messze a szervereden megszokott fölött B
silent_aim Ismétlődő találatok oda, ahová a játékos nem célzott B
aim_stats / aim_stats_backed Fejlövésarány és snap szögek messze a szervered játékosain kívül, 30+ harc alatt C (B egy másik családdal)
esp_los_backed Ismételt célzás olyan játékosokra, akiket a tanúk falak mögé rejtve jelentenek C-től B-ig

Eventek és kérések

Szabály Mit fog meg Szint
bait_event Egy elhelyezett event meghívása, amelyet egyetlen valódi script sem használ (a csalómenük keresik és elsütik ezeket) A
bait_statebag / statebag_write Olyan state bagek írása, amelyeket csak a szervernek kellene írnia (saját magad adminná tétele, godmode flagek), vagy túlméretes state bagek írása A / B
events_before_ready / _trap Eventek, amelyeket még azelőtt küldtek, hogy a játékos egyáltalán spawnolt volna (csatlakozás előtt injektálva) B / A
event_rate / event_shape A normálisnál jóval gyorsabban hívott event, vagy a szervered szokásos hívásaitól eltérő felépítésű argumentumokkal hívott event B
event_flood 500+ hívás 10 s alatt; a FiveM saját overflow kickjénél kilistázza a leggyakoribb eventeket B
guard_rule / guard_hard Egy védett eventre általad beállított szabály megszegése (összeg, gyakoriság, távolság) B / A

Gazdaság

Szabály Mit fog meg Szint
money_nowhere / item_nowhere Pénz vagy itemek, amelyeket egyetlen bolt, munka vagy script sem adott ki (dev eventek, kiszivárgott bolti eladások) B
economy_repeat Egy jutalom- vagy munka-event, amely 30 s alatt 10-szer fizetett (farmolás ciklusban hívva) B
money_jump / money_rate Hirtelen ugrás az egyenlegben vagy a szervereden megszokottnál jóval nagyobb kereseti ütem B
economy_trap Egy elhelyezett jutalom felvétele, amelyet egyetlen valódi munka sem fizet A
weapon_not_owned Olyan fegyver a kézben, amelyet az inventory soha nem adott B

A játékos játéka (tanú)

Szabály Mit fog meg Szint
godmode A szerver 30 s-ig sebezhetetlennek látja a játékost (nem közös safe zone) B
witness_backed A játékból érkező jelek, amelyeket a szerver saját nézete is alátámaszt (godmode, láthatatlanság, ütközés hiánya) B
witness_bait A játék válaszol egy ellenőrzésre, amelyről nem kellene tudnia A
witness_tamper A Sentinel saját, játékon belüli ellenőrzéseit hookolták vagy módosították B

Identitás és fájlok

Szabály Mit fog meg Szint
ban_fingerprint Egy bannolt játékos visszatér egy új fiókkal (hardware tokenek, azonosítók, böngészőujjlenyomat) A / flag
young_account Vadonatúj fiók (csak súlyt ad hozzá) C
scanner_error / too_large Resource-ok, amelyeket a scriptszkenner nem tudott beolvasni, vagy túlméretes fájlok, amelyeket érdemes megnézni info

Amit egyik szabály sem ígér

A Sentinel azt ítéli meg, amit a szerver lát, és amit egy játékos játéka jelent. Nem olvassa a játékos gépén futó más programokat, és egyetlen anti-cheat sem ígérheti, hogy minden csalást elkap. Minden megállapítás a bizonyítékaival érkezik, így a stábod tények alapján dönt.

14. Parancsok és konfiguráció

Minden parancs a parancsok oldalán, minden config kulcs a konfigurációs oldalon van, mindkettő magából a resource-ból generálva. A leggyakrabban használtak:

Parancs Mit csinál
/sentinel owner <code> a tulajdonosi hely átvétele játékban a konzolból kapott kóddal
/sentinel panel egyszer használható bejelentkezési kód a böngészős panelhez (csak staffnak)
/report <server id> <what happened> bármelyik játékos jelent egy játékost vagy egy staff tagot
sentinel:health újra az indítási doboz
sentinel:diag mit döntött a Sentinel és miért
sentinel:level watch\|recommended\|strict a védelmi szint módosítása és mentése
sentinel:wave a ban wave-re sorba állított banok
sentinel:appeals a nyitott fellebbezések
sentinel:audit minden elindított resource kockázatos eventjei
sentinel:guard <resource> a sor, amely védi a resource-ot
sentinel:advisor azok a FiveM beállítások, amelyeket érdemes módosítani a szervereden

A config/ mappában lévő config fájlok (config.lua, protection.lua, watch.lua) és a config/locales/ fordításai nyitottak előtted, ahogy a bridge/ framework adapterei és a guard/ guard fájlja is. Tartsd őket érvényes Lua-ként, és módosítás után indítsd újra a zerodev_sentinel resource-ot. Az első indításhoz nem kell a configot módosítani.

15. Az indítási doboz és a megerősítési tanácsadó

Egy pillanattal azután, hogy a tárolás elkészült, a Sentinel kiír egy dobozt a szerverkonzolba. Egy FAIL sor azt jelenti, hogy a Sentinel nem tud rendesen működni; egy WARN sor azt, hogy kevesebbel működik (például digest nélküli bizonyítékokkal). Bármikor újra kiírhatod a sentinel:health paranccsal.

Sor Mit ellenőriz Ha nem OK
Build A verzió és a build címke a fxmanifest.lua-ból. -
OneSync Az onesync convar. A Sentinel a OneSyncen keresztül olvassa a pozíciókat, az entitásokat és a játékeseményeket. állítsd az onesync-et on értékre a server.cfg-ben
Futó példányok Hány példány fut a resource-ból, bármi is a mappájuk neve. 1-nek kell lennie. egy Sentinel példányt tarts meg; a másik mappát állítsd le
Tárolás Melyik tárolást választotta (mysql vagy kvp), és kész-e. lásd sentinel:diag storage
Bizonyítékmappa Egy próbaírás és -olvasás a resource-on belüli data/archive mappában. hozd létre a data/archive mappát a Sentinel resource-on belül, és győződj meg róla, hogy a szerver tud bele írni
SHA-256 Válaszol-e a node/util.js; ez készít ujjlenyomatot minden bizonyítékról. a bizonyítékok digest nélkül mentődnek; nézz Node hibát a konzolban
Védelem A védelmi szint, a módja és hogy honnan jön. -
Szabályok Hány szabály Live, és hány van Shadow módban. -

Az indítási doboz után a tanácsadó kiírja azokat a FiveM beállításokat, amelyeket érdemes módosítani a szervereden (Config.Advisor.atStartup = false esetén csak a sentinel:advisor parancsra írja ki őket). Minden beállításnál megmutatja a jelenlegi értéket, az ajánlottat, hogy mit blokkol, mit ronthat el, és a másolható sort. Csak olvassa az értékeket; a server.cfg-t soha nem módosítja. Tesztelj egy sort a szervereden, mielőtt megtartod.

16. Nyelvek, és mi kerül rögzítésre

A játékosoknak és a staffnak szóló szövegek a config/locales/<code>.lua fájlokból jönnek, ebben a buildben 25 nyelven. A Config.Locale választja ki a nyelvet; Config.GameLanguage = true mellett az a játékos, akinek a játéka a GTA által kínált egyik nyelven fut, a játékba lépve ezen a nyelven olvassa a Sentinelt.

A Sentinel minden játékosnál nagyjából az utolsó két perc pozícióit és eventjeit tartja a memóriában (Config.Recorder), és kiírja őket egy archívumba a data/archive/ mappába, amikor ügy nyílik, vagy a staff használja a sentinel:save parancsot. Vizsgálat közben képernyőfelvételeket kér a gyanúsított játékától (20 másodperces szakaszokban), és a data/clips/ mappába menti őket. Elmenti az azonosítókat, amelyeket a FiveM a szervernek ad (az IP-cím rögzítésre kerül, de alapértelmezésben soha nem használja kapcsolat elutasítására), és ha a Discord fut, a Discord id-t. Az első csatlakozáskor minden játékos rövid értesítést kap a saját nyelvén arról, hogy a szerver rögzíti a játékot, és hogy a staff nézheti és hallgathatja (a Config.Notice = false kikapcsolja; ilyenkor a szabályzatodban közöld velük). Említsd meg az adatvédelmi szabályzatodban is.

A régi archívumokat és felvételeket ez a build nem törli automatikusan: ürítsd ki magad a data/archive/ és a data/clips/ mappát, ha már nincs rájuk szükséged.

oxmysql-lel a Sentinel adatai a zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report és zds_trail táblákban vannak. oxmysql nélkül ugyanezek az adatok a resource key-value tárolójában vannak (a kulcsok zds: előtaggal kezdődnek). A banok mindig a key-value tárolóba is bekerülnek, így akkor is érvényben maradnak, amikor az adatbázis leállt.

17. Frissítés

Az új verziók ugyanarra a Keymaster assetre kerülnek fel. A Sentinel a bizonyítékait a saját mappájában tartja, ezért mielőtt lecseréled:

  1. Készíts mentést a zerodev_sentinel mappa config/ és data/ mappájáról (archívumok, felvételek, jelentések, tanult alapértékek), és oxmysql esetén a zds_ táblákról.
  2. Állítsd le a szervert, cseréld le a zerodev_sentinel mappát az újra (a mappanév maradjon), és tedd vissza a data/ mappádat. A módosított beállításaidat vidd át az új config fájlokba, ahelyett hogy a régi fájlokat rájuk másolnád.
  3. Indítsd el a szervert, és olvasd el az indítási dobozt (sentinel:health).

Frissítés előtt olvasd el az új verzió kiadási megjegyzéseit a changelogban.

18. Eltávolítás

  1. Vedd ki a guard sort minden resource-ból, amelyet védtél (a sentinel:guard kilistázza őket), és indítsd újra ezeket a resource-okat. Ezt tedd elsőként: a guard fájl eltűnik, amint a mappa eltűnik.
  2. Töröld az ensure zerodev_sentinel sort és a sentinel.admin / sentinel.staff sorokat a server.cfg-ből, majd állítsd le a resource-ot. Ha a sentinel:lockdown módosította az entity lockdownt, a Sentinel leállítása visszaállítja az eredeti módot.
  3. Töröld a zerodev_sentinel mappát. Ezzel törlődik a data/ is az összes archívummal, felvétellel és jelentéssel, ezért előbb másold ki, amit meg akarsz tartani.
  4. oxmysql-lel dobd el a 16. szakaszban felsorolt zds_ táblákat, ha már nem kellenek a banok és az ügyek. A key-value bejegyzések a resource nevén a szerver tárolójában maradnak, és nélküle nem csinálnak semmit.

A Sentinel csak a saját mappájába, a saját adatbázistábláiba és a saját key-value tárolójába ír. Nem módosít más resource-okat és a server.cfg-t sem.

Gyakran ismételt kérdések

Bannol vagy kickel Sentinel bárkit magától?

Watch és Recommended szinten nem. Watch szinten indul, ahol csak naplózza, mit tett volna. Recommended szinten a staff megkapja a bizonyítékokat, és ő dönt. Csak Strict szinten tesz egy magas pontszám karanténba egy játékost, amíg a staff rá nem néz, és csak itt állít egy bizonyíték szintű találat bant sorba a ban wave-re.

Kell hozzá adatbázis?

Nem. oxmysql-lel a Sentinel az adatbázisodban tárolja az adatait, és az első indításkor létrehozza a saját tábláit; nincs importálandó SQL fájl. Nélküle minden a resource saját key-value tárolójában van.

Működik QBCore-on és Qboxon?

Igen. Az észlelés, az ügyek, a felvételek, a konzol, a böngészős panel, a Discord és a tulajdonosi pult minden frameworkön ugyanaz. A pénz- és itemnyomkövetésnek saját adaptere van ESX-hez, QBCore-hoz, Qboxhoz és ox_inventoryhoz.

Hogyan adok hozzáférést az adminjaimnak?

A tulajdonosi pulton, STAFF: válassz egy online játékost, válassz szerepet, nyomd meg a GRANT gombot. Vagy használd továbbra is az ACE-t: a sentinel.admin Admin, a sentinel.staff pedig Moderator szerepet ad.

Fellebbezhet egy bannolt játékos?

Igen. Az elutasító üzenet egy fellebbezési kódot mutat. A játékos elküldi a staffodnak, aki rögzíti a sentinel:appeal paranccsal, vagy a weboldalad elküldi a Sentinel fellebbezési route-jára. A staff a konzolban vagy a sentinel:decide paranccsal elfogadja vagy elutasítja.

Látja a csalóprogramokat a játékos gépén?

Nem. A Sentinel azt ítéli meg, amit a szerver lát, és amit a játékos játéka jelent. Más programokat nem olvas a játékos gépén.

Kész már a voice chat lehallgatása?

Kell hozzá a pma-voice és a lehallgatás kapcsoló (alapból csak a tulajdonosnak), és a saját játékodon keresztül szól.

Mit látnak a játékosok?

Az első csatlakozáskor egy rövid értesítést a saját nyelvükön arról, hogy a szerver rögzíti a játékot, és hogy a staff nézheti és hallgathatja (Config.Notice). Egy tiszta játékos számára semmi más nem változik.

Angolból fordítva. Ha bármi itt eltér az angol oldaltól, az angol oldal a mérvadó. English