Dokumentacija ZeroDev Sentinel

ZeroDev Sentinel: namestitev in uporaba

ZeroDev Sentinel je strežniški anti-cheat resource za FiveM. Beleži, kar vidi strežnik, to presoja s pravili, ki se sama razložijo v preprostih stavkih, in vašemu staffu da dokaze, preden je kdorkoli kaznovan. Začne na ravni zaščite Watch: beleži in nikogar ne kaznuje, dokler ne izberete drugače. Ta vodnik zajema različico 0.1.2 na strežnikih ESX, QBCore, Qbox in standalone.

Za ZeroDev Sentinel 0.1.223 min branjaPosodobljeno

1. Zahteve

  • Vklopljen OneSync (set onesync on v server.cfg). Resource navaja OneSync kot odvisnost, zato ga FXServer brez OneSync ne zažene.
  • FXServer artifact, ki poganja skripte Node 22 (kateri koli trenutno priporočeni artifact; manifest zahteva node_version '22'). Node skrbi za hashiranje, stiskanje, seznam datotek in spletno pot za pritožbe.
  • Neobvezno: oxmysql. Z njim Sentinel hrani svoje zapise v vaši bazi podatkov in ob prvem zagonu sam ustvari svoje tabele. Datoteke SQL za uvoz ni. Brez njega je vse v resourcovi lastni shrambi key-value.
  • Neobvezno: pma-voice, za poslušanje igralčevega glasovnega klepeta iz konzole ali spletnega panela.

Framework je pomemben le za dve stvari: sled denarja in predmetov (denar in predmeti, ki jih ni izplačala nobena trgovina, služba ali skripta, zanke nagrad, rollbacki) in kdo je vaš staff (skupine ACE, ki jih uporablja vsak framework). Zaznavanje, primeri, posnetki, konzola, spletni panel, Discord in owner desk delujejo enako na vsakem frameworku.

2. Namestitev v petih minutah

Nič ne potrebuje SQL, za prvi zagon ni treba urejati configa in noben drug resource se ne spremeni.

Korak 1: Mapo dajte v resources

Kopirajte mapo zerodev_sentinel v svojo mapo resources. Ohranite točno to ime mape: datoteka guard poroča v zerodev_sentinel, sentinel:guard pa vas opozori, če je mapa poimenovana drugače.

Korak 2: Dodajte ga v server.cfg

Zaženite ga za oxmysql in vašim frameworkom, da ju shramba in sled denarja ob zagonu najdeta. Natančen vrstni red za vaš framework je v razdelku 3.

Korak 3: Zaženite strežnik

Konzola izpiše zagonsko okno in enkratno kodo lastnika. Vsaka vrstica okna je resnično preverjanje; zadnja vrstica pove READY ali NOT READY s številom težav (razdelek 15).

Korak 4: Prevzemite mesto lastnika

Pridružite se strežniku in v klepet vpišite /sentinel owner <code>. Zdaj imate mesto lastnika vi (razdelek 4).

Korak 5: Odprite owner desk

V igri pritisnite F7 (ali v F8 vpišite sentinel:console) in odprite OWNER. Zavihek First run pokaže, kaj je narejeno in kaj ne: Discord, shramba posnetkov, vaš staff in njegova dovoljenja. Vsaka vrstica ima en gumb. Nato nekaj dni igrajte na Watch, na zavihku Right now preberite, kaj je Sentinel našel, in na istem desku preklopite raven zaščite na Recommended (razdelek 6).

3. Vaš framework

Sentinel ob zagonu sam najde framework in inventory. Ničesar ni treba nastaviti. sentinel:trail v strežniški konzoli pokaže, kateri adapter je izbral.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Denar in predmeti: prebrani iz ESX-ovih lastnih strežniških eventov (denar na računu dodan, odvzet ali nastavljen; predmeti v inventoryju dodani ali odvzeti; predmeti, dani od igralca igralcu, z obema stranema povezanima). Rollback uporablja ESX-ove lastne metode igralca in rezultat prebere nazaj.
  • ESX z ox_inventory: denar se spremlja enako. V tem načinu ESX-ove metode za predmete ne vračajo rezultatov, zato Sentinel odloča le po ponovnem branju.
  • Staff: svojim adminom dajte dovoljenje ACE (razdelek 5). ESX-ova lastna group.admin deluje kot skupina ACE, ko zanjo dodate vrstico.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Denar: prebran iz QBCore-ovega eventa za spremembo denarja (dodajanje, odvzem in nastavitev, z razlogom). Izguba in enako velik dobiček v istem trenutku se povežeta kot nakazilo, ker QBCore nima lastnega eventa za nakazila.
  • Predmeti: z ox_inventory se predmeti spremljajo prek njegovih hookov. Z qb-inventory se spremembe predmetov ne spremljajo (payload njegovega listenerja ni dokumentiran), rollback pa lahko predmete vseeno premika z dokumentiranimi exporti qb-inventory.
  • Staff: skupine dovoljenj v QBCore so skupine ACE (group.admin, group.god). Dodajte vrstice ACE iz razdelka 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Denar: prebran iz Qboxovega eventa za spremembo denarja; stanja se preberejo nazaj z lastnimi exporti qbx_core. Denar, spremenjen liku brez povezave (prek citizen id), ne sproži eventa, zato ga v sledi ni.
  • Predmeti: Qbox uporablja ox_inventory, Sentinel pa njegove predmete spremlja prek hookov ox_inventory. Predmeti, ki predstavljajo denar frameworka, so prepuščeni delu za framework.
  • Staff: skupine ACE, kot na QBCore.

Standalone (brez frameworka)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Deluje vse razen sledi denarja in predmetov: gibanje, svet, eventi, vabni eventi, godmode, state bagi, orožje, primeri, posnetki, replay, konzola, panel, Discord, vloge in bani.
  • Z ox_inventory in brez frameworka se predmeti spremljajo prek ox_inventory.
  • Shramba: shramba key-value ali oxmysql, če ga zaženete prej.

Preverjanje, ali deluje

  • sentinel:health: še enkrat zagonsko okno. Vsaka vrstica je resnično preverjanje; READY pomeni, da nič ne manjka.
  • sentinel:diag: zakaj so bili izbrani shramba, adapterji in raven, vsako pravilo z njegovimi števci in zadnje odločitve.
  • sentinel:trail: adapter za denar in predmete, ki je v uporabi, in zadnje spremembe enega igralca.

V samodejnem načinu shrambe Sentinel uporabi oxmysql le, če je oxmysql že zagnan (počaka do 15 sekund, medtem ko se oxmysql zaganja); če se oxmysql zažene pozneje, uporabi shrambo key-value.

4. Prvi zagon: mesto lastnika

Prvi zagon v strežniški konzoli izpiše enkratno kodo, veljavno 30 minut (sentinel:owner code izpiše novo). Pridružite se in vpišite /sentinel owner <code>: mesto se veže na vaš račun, koda pa preneha veljati.

Samo mesto lastnika lahko spreminja ključe, raven zaščite, vloge in dovoljenja. sentinel:owner reset v strežniški konzoli sprosti mesto, če ga morate prenesti na drug račun.

5. Staff in dovoljenja

V owner desku, STAFF: izberite igralca, ki je online, izberite vlogo, pritisnite GRANT. Priložene so štiri vloge:

Vloga Lahko, takoj po namestitvi
Podpora ogled primerov, obravnava prijav, dežurni zemljevid
Moderator kot Support, plus replayi, kick in karantena
Admin kot Moderator, plus razkritje, oprostitev, ogled v živo, zahteve za ban, pritožbe
Senior admin kot Admin, plus ban, ki velja takoj

Dovoljenja izberete vi. Vsaka vloga je seznam stikal, ki jih lahko spreminjate. Ustvarite svoje vloge iz kopije (na primer "Trial mod"), preimenujte katero koli vlogo in eni osebi dajte dodatno stikalo ali ji ga odvzemite, ne da bi spremenili njeno vlogo. Stikala, označena kot nevarna (takojšen ban, poslušanje glasovnega klepeta, nastavitve, upravljanje staffa), zahtevajo drugi pritisk. Vsaka sprememba se zapiše v evidenco staffa, zato vedno vidite, kdo je kaj spremenil.

ACE še vedno deluje za strežnike, ki ga že uporabljajo, in se prebere ob vsakem preverjanju:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Dovoljenje Vloga, ki jo da
sentinel.admin Admin (Senior admin, dokler mesto lastnika ni prevzeto) in vsak ukaz sentinel:* v igri
sentinel.staff Moderator; pravila gibanja štejejo lastno gibanje člana staffa za pojasnjeno

Nekaj ukazov (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) je registriranih kot omejeni: v igri potrebujejo tudi command.<name>. Običajna vrstica add_ace group.admin command allow to pokrije. Strežniška konzola lahko zažene vsak ukaz.

6. Raven zaščite

Eno stikalo v owner desku (OWNER, PROTECTION), poleg tega sentinel:level v strežniški konzoli in Config.Protection v config/config.lua. Kar nastavite na desku, se shrani in po ponovnem zagonu prevlada nad vrstico v configu.

  • Watch: vsako pravilo opazuje in zapiše, kaj bi naredilo; nihče ne dobi opozorila in nikomur se nič ne zgodi. Medtem se Sentinel uči, kaj je na vašem strežniku normalno: opazovalec eventov (pogostost in oblika vsakega eventa) in preverjanje ob vstopu se učita samo na Watch; omejitve za entitete, boj in denar se še naprej učijo iz poštene igre.
  • Recommended: vsako pravilo je live. Staff dobi opozorila z dokazi in odpre se primer. Sentinel nikoli ne kaznuje sam; odloča vaš staff.
  • Strict: kot Recommended, visoka ocena pa igralca da v karanteno, dokler staff ne pogleda; ugotovitev na ravni dokaza (Tier A: sprožen vabni event, ponarejena zahteva) poleg tega uvrsti ban v čakalno vrsto za ban wave.

Pod stikalom desk navede vsako pravilo z njegovim stanjem in tem, od kod to stanje izvira. Tam lahko posamezno pravilo pripnete na Live ali Shadow, če ga vaš strežnik potrebuje (na primer pravilo, ki ves čas označuje eno od vaših lastnih skript); vrstica state v Config.Rules ga pripne v datoteki config in prevlada nad deskom.

Smiseln vrstni red:

  1. Watch za nekaj dni običajne igre.
  2. Preberite, kaj bi pravila naredila: zavihek Right now, sentinel:diag rules (stolpec shadow šteje, kolikokrat bi pravilo dodelilo točke) in sentinel:diag decisions 100.
  3. Na Shadow pripnite vsako pravilo, ki je označilo nekoga, ki mu zaupate, in nam to sporočite.
  4. Preklopite na Recommended. Staff zdaj vidi primere in dokaze; nihče ni kaznovan samodejno.
  5. Strict, ko zaupate temu, kar vam pokaže Recommended.

Za vrnitev kadar koli: Watch na desku ali sentinel:level watch.

7. Konzola staffa (F7)

V igri pritisnite F7 (ali v F8 vpišite sentinel:console). Vsak igralec lahko tipko spremeni v nastavitvah igre (Key Bindings, FiveM). Esc jo zapre.

  • Right now v preprostem jeziku pove, kaj se dogaja na vašem strežniku: kdo je videti kot grožnja in zakaj, kaj je bilo dokazano, kaj je bilo pojasnjeno (revive, teleport, ki ga je naredila skripta sama) in kaj potrebuje vas. Vsak igralec, ki je pomemben, dobi eno vrstico: kaj je naredil, kaj to verjetno je, kako prepričan je Sentinel (Unusual, Suspicious, Very likely, Proven), kaj je Sentinel že naredil in en naslednji korak.
  • Case files: najprej odprti primeri, vsak s svojo ugotovitvijo, dokazi, posnetki zaslona, pečatom (ali se veriga hashev primera še ujema) in tipkami REVEAL, QUARANTINE, CLEAR in BAN (CLEAR in BAN zahtevata drugi pritisk).
  • Duty map: igralci, ki so online, na 3D-modelu otoka. Teren izmeri igra prvega člana staffa in se hrani v data/map/.
  • Play replay zapre konzolo in incident ponovno predvaja v zasebnem svetu; za vrnitev pritisnite Backspace.
  • Owner (samo mesto lastnika): First run, Protection, Keys, Staff, Internal affairs in Server check.

Ukazi, vpisani v igri, gredo v F8 brez poševnice ali v klepet s poševnico (/sentinel:diag).

8. Spletni panel

Isti desk v spletnem brskalniku, za takrat, ko niste v igri:

  • na strežniškem računalniku: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (port je port vašega strežnika, privzeto 30120)
  • od drugod: http://<server address>:<port>/zerodev_sentinel/panel/ ali vaš lasten naslov HTTPS pred njim

Prijava. Uporabite enkratno kodo: v igri vpišite /sentinel panel (koda se pokaže samo vam, deluje enkrat, 5 minut) ali v strežniški konzoli zaženite sentinel:panel <id or account>. Seja traja 8 ur; SIGN OUT in END ALL MY SESSIONS jo končata. Vaša vloga in stikala veljajo v brskalniku povsem enako kot v igri.

Ogled v živo. Staff s stikalom za ogled v živo lahko iz panela ali konzole gleda zaslon kateregakoli igralca, ki je online. Nič se ne shrani na disk, razen če pritisnete Save to case.

Poslušanje. Poslušanje glasovnega klepeta tega igralca potrebuje stikalo za poslušanje (privzeto samo lastnik) in pma-voice. Zvok se predvaja skozi vašo lastno igro, zato bodite v igri na istem strežniku.

Vsak ogled v živo in vsako poslušanje se zapišeta v evidenco staffa in v primer igralca, igralci pa so ob prvi pridružitvi obveščeni, da lahko staff gleda in posluša (obvestilo o snemanju, Config.Notice).

9. Primeri, karantena, kick, ban in pritožbe

Ko je kaj najdeno, Right now igralca imenuje v preprostem jeziku: kaj je naredil, kako prepričan je Sentinel in kaj je glede tega storil. Odprite primer, da vidite dokaze (položaje, posnetke zaslona, zapečatene s SHA-256, 3D-replay), in uporabite tipke:

  • REVEAL: pokaže identifikatorje igralca.
  • QUARANTINE: igralca premakne iz pravega sveta v zaseben routing bucket, dokler staff ne pogleda. sentinel:release <server id> ga vrne nazaj.
  • CLEAR: ni cheata; zapre primer in ustavi njegov ban v čakalni vrsti.
  • KICK: s strežnika, z razlogom, ki ga igralec prebere.
  • BAN: skozi ban wave, s kodo za pritožbo.

Ban wave. Bani, tudi BAN, pritisnjen v konzoli, se uvrstijo v čakalno vrsto za ban wave in se izvedejo samo na Strict, privzeto ob naključnem času 2 do 24 ur pozneje (Config.Actions). sentinel:wave jih izpiše, sentinel:wave now <account> enega izvede takoj, sentinel:wave cancel <account> ga prekliče.

Pritožbe. Bannani igralec v sporočilu o zavrnitvi vidi kodo za pritožbo (8 črk in številk). Za pritožbo se ne more pridružiti, zato pritožba do vas pride od zunaj igre:

  1. Prek vašega staffa. Igralec pošlje kodo vašemu staffu (Discord ticket, e-pošta). Član staffa jo zabeleži z sentinel:appeal <code> <text>.
  2. Prek spletne poti. Sentinel odgovarja na lastnem naslovu vašega strežnika: http://<server address>:<port>/zerodev_sentinel/appeal. Sprejme samo POST z JSON { "code": "...", "text": "...", "contact": "optional" } (besedilo od 10 do 2000 znakov), zato je namenjena obrazcu na vaši spletni strani, ne strani, na katero bi pošiljali igralce. Vsaka sprejeta zahteva dobi enak odgovor, 202 "received", ne glede na to, ali se je koda ujemala z banom ali ne. Preveč zahtev z enega naslova (5 v 10 minutah) ali skupaj (30 na minuto) dobi 429. Za lastnim HTTPS reverse proxyjem nastavite set sentinel_http_proxy true, da omejitve štejejo naslov obiskovalca.

Besedilo zavrnitve ne pove, kje se pritožiti. Igralcem to povejte v svojih pravilih ali napišite svoje besedilo s svojo povezavo v Config.Bans.message (obdržite %s, ta postane koda), na primer 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Staff odloči v konzoli ali z sentinel:decide <case or code> accept|reject [note]. Accept odpravi vsak aktiven ban tega računa ali primera in prekliče ban v čakalni vrsti za wave; reject ban obdrži. Odločitev je dokončna in se zapiše v dnevnik primera. sentinel:appeals izpiše odprte.

10. Prijave in internal affairs

Prijave igralcev. Vsak igralec vpiše /report <server id> <what happened>, da prijavi igralca ali člana staffa. Zadnji dve minuti okoli obeh igralcev se shranita v primer. Staff prijavo zapre kot ukrepano, brez kršitve, brez dokaza ali dvojnik. Prijave o staffu gredo samo lastniku.

Internal affairs (samo lastnik, na owner desk): kaj je naredil vsak član staffa in kaj je treba pogledati (dovoljenja, dodeljena sebi, skrivanje v boju, bani brez primera, teleporti k igralcem). Tedensko poročilo o poštenosti se zapiše v data/reports/; sentinel:staff report ga zapiše takoj. Nič v evidenci staffa staffa ne kaznuje.

11. Zaščita resourca

Brez kakršnekoli nastavitve Sentinel opazuje vsak event, ki ga igralci lahko pošljejo vašim skriptam, in presoja igralca. Handlerju drugega resourca ne more preprečiti, da se izvede. Če želite slab klic ustaviti, preden se skripta izvede, tej skripti dodajte guard.

  1. sentinel:audit izpiše evente vsakega zagnanega resourca, ki jih lahko sprožijo odjemalci, razvrščene po tem, kaj počnejo njihovi handlerji (na primer handler, ki da denar v znesku, ki ga izbere odjemalec). Z njim se odločite, katere resource zaščititi najprej.
  2. sentinel:guard <resource> izpiše vrstico, ki jo je treba dodati, in server_scripts resourca, kot bi se glasili. Vrstica guard mora biti prva strežniška skripta. Ukaz samo izpisuje; ne spremeni nobene datoteke.

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

  1. Ponovno zaženite ta resource. sentinel:guard <resource> zdaj pove "guarded since ...". Sam sentinel:guard izpiše vse zaščitene resource.
  2. Pravila dodajte s sentinel:patch. Dokler resource nima pravil, njegov guard prepusti vsak klic, razen klicev igralcev v karanteni, ki jih vsak guard zavrže. Primer: največ 3 nakupi v 10 sekundah, ime predmeta do 32 znakov in količina od 1 do 10; zavrnjen klic šteje kot dokaz ("hard": true):

text sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}

Za callback frameworka kot event napišite callback:<name>: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> izpiše pravila resourca; sentinel:patch <resource> <event> off eno odstrani.

Guard nikoli ne ureja datotek in nikoli ne spremeni tega, kar handler prejme. Je navaden, berljiv Lua v guard/guard.lua.

12. Ključi za Discord in shrambo posnetkov

Najlažja pot je owner desk, KEYS: prilepite vsako vrednost in pritisnite SAVE. Ključi se hranijo samo na strežniku; desk in vsak odgovor povesta samo "set" in ključa nikoli več ne pokažeta.

Vrstica na desku Kaj je to Ali v server.cfg (uporabite set, nikoli setr)
Žeton Discord bota bot, ki ste ga naredili na discord.com/developers in povabili na svoj strežnik set sentinel_discord_token "..."
ID Discord strežnika desni klik na vaš strežnik, Copy Server ID (z vklopljenim razvijalskim načinom) set sentinel_discord_guild "..."
ID kanala za opozorila kamor se objavljajo primeri, z gumbi za vaš staff set sentinel_discord_channel "..."
ID kanala za pritožbe kamor se objavljajo pritožbe set sentinel_discord_appeals "..."
Ključ FiveManage medijski ključ s fivemanage.com; posnetki se naložijo tja set sentinel_fivemanage_key "..."
Webhook za posnetke namesto FiveManage: Discord webhook, ki prejema posnetke set sentinel_clip_webhook "..."
Shramba posnetkov fivemanage, discord, off ali samodejno (prva, ki je nastavljena) set sentinel_clip_storage "..."

Ključ v server.cfg ima prednost pred deskom in desk to pove. Gumbi na Discordu sledijo istim vlogam in stikalom kot konzola. Brez česarkoli od tega primeri in posnetki ostanejo na vašem strežniku (data/), konzola in panel pa jih prikažeta.

Preprostejša opozorila prek webhooka še vedno delujejo: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" ali sentinel:webhook set <url> v strežniški konzoli. sentinel:webhook test pošlje testno sporočilo; sentinel:webhook pokaže stanje, ne da bi kdaj izpisal URL; sentinel:webhook clear odstrani shranjenega.

13. Kaj ujame posamezno pravilo

Vsako pravilo, ko se sproži, zapiše preprost stavek, ki pove, kaj je videlo in kaj je izključilo. Preden pravilo šteje proti komurkoli, Sentinel preveri razloge, ki bi ga pojasnili (respawn, revive, dejanje staffa, ena od vaših lastnih skript, ki premika ali plačuje igralce). Pojasnjena ugotovitev se zabeleži in se nikoli ne točkuje.

  • Tier A je dokaz: nekaj, kar naredi samo cheat (vabni event, ki ga ne kliče nobena prava skripta, ponarejena zahteva).
  • Tier B je močan: član staffa naj pogleda. Sam po sebi odpre primer samo, kadar se strinjata dve različni družini ali se ista ponovi.
  • Tier C je šibek: prišteje se k oceni in nikoli ne ukrepa sam.

Gibanje

Pravilo Ujame Pojasni ga Tier
teleport Skok za več kot 150 m (ali 3x toliko, kot je mogoče) med dvema vzorcema spawn, respawn ali revive, sprememba routing bucketa, staff, teleport event vaše skripte B
foot_speed Tek nad 12 m/s za 1.5 s peš, brez padanja, brez ragdolla spawn, respawn, staff, vaša skripta B
air_float Premikanje, ko je zamrznjen (noclip); "padanje" brez spuščanja (fly); hitro premikanje po koordinatah, medtem ko igra pravi, da igralec stoji pri miru (speed meniji) spawn, respawn, staff, vaša skripta B
foot_rise Vzpenjanje naravnost navzgor hitreje od 4 m/s peš za 3 s spawn, respawn, staff, vaša skripta B
vehicle_speed Vozilo nad 1.3x najvišje hitrosti, ki jo njegov razred doseže na vašem strežniku staff, vaša skripta B

Svet

Pravilo Ujame Pojasni ga Tier
entity_blocked Spawnanje modela, ki ste ga blokirali vaše skripte, ki ga spawnajo B
entity_rate / entity_model_rate Spawnanje veliko več entitet (ali enega modela) na minuto, kot jih spawnajo igralci in skripte vaše skripte, ki spawnajo B
entity_untrusted Entitete, ki jih je ustvaril odjemalec, brez skripte, ki bi jih spawnala vaše skripte, ki spawnajo B
entity_disguised Naval istega ambientalnega modela peda okoli enega igralca (meni, ki svoje spawne prikriva kot promet) spawn, respawn, sprememba bucketa B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Eksplozije, ki jih orožje v roki ne more narediti, preveč eksplozij, nevidne ali daleč od igralca eksplozije vaših skript B
projectile_weapon / projectile_rate Projektili, ki jih orožje ne more izstreliti, ali preveč projektilov B
ptfx_rate Poplave učinkov delcev (pogost napad za crash in lag) B
fire_rate Ognji, zaneteni hitreje, kot to dovoli katerokoli orožje B

Boj

Pravilo Ujame Tier
damage_plausibility Škoda nad največjo možno vrednostjo orožja B
hit_range Zadetki izven dosega orožja B
shot_rate / kill_rate Streljanje hitreje od orožja; uboji na minuto daleč nad vašim strežnikom B
silent_aim Zadetki tja, kamor igralec ni meril, ponovljeni B
aim_stats / aim_stats_backed Delež headshotov in koti snapov daleč izven igralcev vašega strežnika v 30+ bojih C (B z drugo družino)
esp_los_backed Ponavljajoče se merjenje v igralce, za katere priče poročajo, da so skriti za stenami C do B

Eventi in zahteve

Pravilo Ujame Tier
bait_event Klic nastavljenega eventa, ki ga ne uporablja nobena prava skripta (cheat meniji jih iščejo in sprožajo) A
bait_statebag / statebag_write Pisanje state bagov, ki bi jih smel pisati samo strežnik (da se narediš admina, zastavice godmode), ali prevelikih A / B
events_before_ready / _trap Eventi, poslani, še preden se je igralec sploh spawnal (injicirano pred pridružitvijo) B / A
event_rate / event_shape Event, klican veliko hitreje od običajnega ali z argumenti, oblikovanimi drugače od običajnih klicev na vašem strežniku B
event_flood 500+ klicev v 10 s; ob FiveM-ovem lastnem kicku zaradi overflowa so izpisani najpogostejši eventi B
guard_rule / guard_hard Kršitev pravila, ki ste ga nastavili na zaščitenem eventu (količina, pogostost, razdalja) B / A

Ekonomija

Pravilo Ujame Tier
money_nowhere / item_nowhere Denar ali predmeti, ki jih ni izdala nobena trgovina, služba ali skripta (dev eventi, razkrite prodaje v trgovinah) B
economy_repeat Event za nagrado ali službo, izplačan 10-krat v 30 s (farmanje s klicanjem v zanki) B
money_jump / money_rate Nenaden skok stanja ali hitrost zaslužka daleč nad vašim strežnikom B
economy_trap Prevzem nastavljene nagrade, ki je ne izplača nobena prava služba A
weapon_not_owned Držanje orožja, ki ga inventory nikoli ni dal B

Igralčeva igra (priča)

Pravilo Ujame Tier
godmode Strežnik 30 s bere igralca kot neranljivega (ne v skupni varni coni) B
witness_backed Znaki iz igre, podprti s strežnikovim lastnim pogledom (godmode, nevidnost, brez kolizije) B
witness_bait Igra odgovori na preverjanje, za katerega ne bi smela vedeti A
witness_tamper Sentinelova lastna preverjanja v igri so bila hookana ali spremenjena B

Identiteta in datoteke

Pravilo Ujame Tier
ban_fingerprint Bannani igralec nazaj na novem računu (strojni žetoni, identifikatorji, prstni odtis brskalnika) A / oznaka
young_account Čisto nov račun (doda samo težo) C
scanner_error / too_large Resourci, ki jih skener skript ni mogel prebrati, ali prevelike datoteke, vredne pogleda info

Česa ne obljublja nobeno pravilo

Sentinel presoja to, kar lahko vidi strežnik, in to, kar sporoča igralčeva igra. Ne bere drugih programov na igralčevem računalniku in noben anti-cheat ne more obljubiti, da bo ujet vsak cheat. Vsaka ugotovitev pride s svojimi dokazi, tako da vaš staff odloča na podlagi dejstev.

14. Ukazi in konfiguracija

Vsak ukaz je na strani z ukazi in vsak ključ configa na strani s konfiguracijo, obe sta ustvarjeni iz samega resourca. Tisti, ki jih uporabljate največ:

Ukaz Kaj naredi
/sentinel owner <code> prevzemite mesto lastnika v igri s kodo iz konzole
/sentinel panel enkratna koda za prijavo v spletni panel (samo staff)
/report <server id> <what happened> vsak igralec prijavi igralca ali člana staffa
sentinel:health še enkrat zagonsko okno
sentinel:diag kaj je Sentinel odločil in zakaj
sentinel:level watch\|recommended\|strict spremeni raven zaščite in jo shrani
sentinel:wave bani v čakalni vrsti za ban wave
sentinel:appeals odprte pritožbe
sentinel:audit tvegani eventi vsakega zagnanega resourca
sentinel:guard <resource> vrstica, ki zaščiti resource
sentinel:advisor nastavitve FiveM, ki jih je na vašem strežniku vredno spremeniti

Datoteke config v config/ (config.lua, protection.lua, watch.lua) in prevodi v config/locales/ so vam odprti, prav tako adapterji za frameworke v bridge/ in datoteka guard v guard/. Naj ostanejo veljaven Lua, po spremembi pa ponovno zaženite zerodev_sentinel. Za prvi zagon ni treba urejati configa.

15. Zagonsko okno in svetovalec za utrjevanje

Trenutek po tem, ko je shramba pripravljena, Sentinel v strežniški konzoli izpiše okno. Vrstica FAIL pomeni, da Sentinel ne more pravilno delovati; vrstica WARN pomeni, da deluje z manj (na primer dokazi brez digestov). Kadarkoli ga znova izpišite s sentinel:health.

Vrstica Kaj preverja Ko ni OK
Build Različica in oznaka builda iz fxmanifest.lua. -
OneSync Convar onesync. Sentinel položaje, entitete in dogodke igre bere prek OneSync. v server.cfg nastavite set onesync on
Zagnane kopije Koliko kopij resourca je zagnanih, ne glede na to, kako se imenuje njihova mapa. Mora biti 1. obdržite eno kopijo Sentinela; drugo mapo ustavite
Shramba Katera shramba je bila izbrana (mysql ali kvp) in ali je pripravljena. glejte sentinel:diag storage
Mapa z dokazi Testni zapis in branje v data/archive znotraj resourca. ustvarite mapo data/archive znotraj resourca Sentinel in poskrbite, da strežnik lahko piše vanjo
SHA-256 Ali node/util.js odgovarja; ta naredi prstni odtis vsakega dokaza. dokazi se shranijo brez digestov; v konzoli preverite, ali je napaka Node
Zaščita Raven zaščite, njen način in od kod izvira. -
Pravila Koliko pravil je live in koliko v shadow. -

Po zagonskem oknu svetovalec izpiše nastavitve FiveM, ki jih je na vašem strežniku vredno spremeniti (Config.Advisor.atStartup = false ga izpiše samo ob sentinel:advisor). Za vsako nastavitev pokaže trenutno vrednost, priporočeno vrednost, kaj blokira, kaj bi lahko pokvarila in vrstico za kopiranje. Vrednosti samo bere; server.cfg nikoli ne spremeni. Vrstico preizkusite na svojem strežniku, preden jo obdržite.

16. Jeziki in kaj se beleži

Besedila za igralce in staff pridejo iz config/locales/<code>.lua, v tem buildu 25 jezikov. Config.Locale izbere jezik; s Config.GameLanguage = true igralec, čigar igra teče v jeziku, ki ga ponuja GTA, Sentinel bere v tem jeziku, ko je v igri.

Sentinel za vsakega igralca v pomnilniku hrani približno zadnji dve minuti položajev in eventov (Config.Recorder) in jih zapiše v arhiv v data/archive/, ko se odpre primer ali staff uporabi sentinel:save. Med pregledom od osumljenčeve igre zahteva posnetke zaslona (20-sekundne odseke) in jih shrani v data/clips/. Shrani identifikatorje, ki jih FiveM da strežniku (naslov IP se zabeleži, a se privzeto nikoli ne uporabi za zavrnitev povezave), in, kadar teče Discord, Discord ID. Ob prvi pridružitvi vsak igralec v svojem jeziku dobi kratko obvestilo, da strežnik snema igro in da lahko staff gleda in posluša (Config.Notice = false ga izklopi; takrat jim to povejte v svojih pravilih). Omenite to tudi v svoji politiki zasebnosti.

Stari arhivi in posnetki se v tem buildu ne brišejo samodejno: data/archive/ in data/clips/ počistite sami, ko jih ne potrebujete več.

Z oxmysql so Sentinelovi zapisi v tabelah zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report in zds_trail. Brez oxmysql isti zapisi živijo v shrambi ključ/vrednost resourca (ključi, ki se začnejo z zds:). Bani se vedno zrcalijo v shrambo ključ/vrednost, zato se uveljavljajo tudi, ko baza podatkov ne deluje.

17. Posodabljanje

Nove različice se objavijo v istem assetu Keymaster. Sentinel svoje dokaze hrani v lastni mapi, zato preden jo zamenjate:

  1. V mapi zerodev_sentinel naredite varnostno kopijo map config/ in data/ (arhivi, posnetki, poročila, naučene osnove) in, z oxmysql, tabel zds_.
  2. Ustavite strežnik, mapo zerodev_sentinel zamenjajte z novo (obdržite ime mape) in vrnite svojo mapo data/. Nastavitve, ki ste jih spremenili, prenesite v nove datoteke config, namesto da čeznje kopirate stare datoteke.
  3. Zaženite strežnik in preberite zagonsko okno (sentinel:health).

Pred posodobitvijo preberite opombe k izdaji nove različice v dnevniku sprememb.

18. Odstranitev

  1. Odstranite vrstico guard iz vsakega resourca, ki ste ga zaščitili (sentinel:guard jih izpiše), in te resource ponovno zaženite. To naredite najprej: ko ni več mape, ni več niti datoteke guard.
  2. Iz server.cfg odstranite ensure zerodev_sentinel ter vrstici sentinel.admin / sentinel.staff, nato ustavite resource. Če je sentinel:lockdown spremenil entity lockdown, ustavitev Sentinela vrne prvotni način.
  3. Izbrišite mapo zerodev_sentinel. S tem se odstrani data/ z vsemi arhivi, posnetki in poročili, zato prej kopirajte ven vse, kar želite obdržati.
  4. Z oxmysql izbrišite tabele zds_, naštete v razdelku 16, če banov in primerov ne želite več. Zapisi ključ/vrednost ostanejo v shrambi strežnika pod imenom resourca in brez njega ne počnejo ničesar.

Sentinel piše samo v svojo mapo, svoje tabele v podatkovni bazi in svojo shrambo key-value. Ne ureja drugih resourceov ali server.cfg.

Pogosta vprašanja

Ali Sentinel sam koga banne ali kickne?

Na Watch ali Recommended ne. Začne na Watch, kjer samo beleži, kaj bi naredil. Na Recommended staff dobi dokaze in odloči. Samo na Strict visoka ocena igralca da v karanteno, dokler staff ne pogleda, ugotovitev na ravni dokaza pa uvrsti ban v čakalno vrsto za ban wave.

Ali potrebujem bazo podatkov?

Ne. Z oxmysql Sentinel hrani zapise v vaši podatkovni bazi in ob prvem zagonu ustvari svoje tabele; datoteke SQL za uvoz ni. Brez njega je vse v lastni shrambi key-value resourcea.

Ali deluje na QBCore in Qbox?

Da. Zaznavanje, primeri, posnetki, konzola, spletni panel, Discord in owner desk so na vsakem frameworku enaki. Sled denarja in predmetov ima lasten adapter za ESX, QBCore, Qbox in ox_inventory.

Kako dam dostop svojim adminom?

Na owner desk, STAFF: izberite igralca, ki je online, izberite vlogo, pritisnite GRANT. Ali pa še naprej uporabljajte ACE: sentinel.admin da Admin in sentinel.staff da Moderator.

Ali se lahko bannani igralec pritoži?

Da. Sporočilo o zavrnitvi pokaže kodo za pritožbo. Igralec jo pošlje vašemu staffu, ki jo zabeleži s sentinel:appeal, ali pa jo vaša spletna stran pošlje na Sentinelovo pot za pritožbe. Staff jo sprejme ali zavrne v konzoli ali s sentinel:decide.

Ali vidi programe za cheatanje na igralčevem računalniku?

Ne. Sentinel presoja to, kar lahko vidi strežnik, in to, kar sporoča igralčeva igra. Ne bere drugih programov na igralčevem računalniku.

Ali je poslušanje glasovnega klepeta pripravljeno?

Potrebuje pma-voice in stikalo za poslušanje (privzeto samo lastnik), predvaja pa se skozi vašo lastno igro.

Kaj vidijo igralci?

Ob prvi pridružitvi kratko obvestilo v njihovem jeziku, da strežnik snema igro in da lahko staff gleda in posluša (Config.Notice). Za čistega igralca se ne spremeni nič drugega.

Prevedeno iz angleščine. Če se kaj na tej strani ne ujema z angleško stranjo, velja angleška stran. English