Documentazione di ZeroDev Sentinel
ZeroDev Sentinel: installazione e uso
ZeroDev Sentinel è una resource anti-cheat lato server per FiveM. Registra ciò che vede il server, lo giudica con regole che si spiegano da sole in frasi chiare e dà al tuo staff le prove prima che qualcuno venga punito. Parte al livello di protezione Watch: registra e non punisce nessuno finché non decidi diversamente. Questa guida copre la versione 0.1.2 su server ESX, QBCore, Qbox e standalone.
1. Requisiti
- OneSync attivo (
set onesync onin server.cfg). La resource dichiara OneSync come dipendenza, quindi FXServer non la avvia senza OneSync. - Un artifact FXServer che esegue script Node 22 (qualsiasi artifact consigliato attuale; il manifest chiede
node_version '22'). Node si occupa di hashing, compressione, elenco dei file e della route web per i ricorsi. - Facoltativo: oxmysql. Con oxmysql, Sentinel salva i suoi dati nel tuo database e crea da solo le sue tabelle al primo avvio. Non c'è nessun file SQL da importare. Senza, tutto resta nel key-value store della resource stessa.
- Facoltativo: pma-voice, per ascoltare la chat vocale di un giocatore dalla console o dal pannello browser.
Il framework conta solo per due cose: la traccia di soldi e item (soldi e item che nessun negozio, lavoro o script ha pagato, loop di ricompense, rollback) e chi è il tuo staff (gruppi ACE, che usa ogni framework). Rilevamento, casi, clip, console, pannello browser, Discord e la scrivania del proprietario funzionano allo stesso modo su ogni framework.
2. Installazione in cinque minuti
Niente richiede SQL, non serve modificare il config per il primo avvio e nessun'altra resource viene cambiata.
Passo 5: Apri la scrivania del proprietario
Premi F7 in gioco (o scrivi sentinel:console in F8) e apri OWNER. Il foglio First run elenca cosa è fatto e cosa no: Discord, storage delle clip, il tuo staff e i suoi permessi. Ogni riga ha un pulsante. Poi gioca qualche giorno su Watch, leggi cosa ha trovato Sentinel nel foglio Right now e passa il livello di protezione a Recommended dalla stessa scrivania (sezione 6).
3. Il tuo framework
Sentinel trova da solo il framework e l'inventario all'avvio. Non c'è niente da impostare. sentinel:trail nella console del server mostra quale adapter ha scelto.
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- Soldi e item: letti dagli eventi server di ESX stesso (soldi del conto aggiunti, tolti o impostati; item dell'inventario aggiunti o tolti; item dati da giocatore a giocatore, con entrambe le parti collegate). Il rollback usa i metodi del giocatore di ESX stesso e rilegge il risultato.
- ESX con ox_inventory: i soldi vengono seguiti allo stesso modo. In questa modalità i metodi degli item di ESX non restituiscono risultati, quindi Sentinel decide solo in base alla rilettura.
- Staff: dai ai tuoi admin il permesso ACE (sezione 5). Il
group.admindi ESX funziona come gruppo ACE quando aggiungi la riga apposita.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- Soldi: letti dall'evento di cambio soldi di QBCore (aggiunta, rimozione e impostazione, con il motivo). Una perdita e un guadagno uguale nello stesso momento vengono collegati come trasferimento, perché QBCore non ha un proprio evento di trasferimento.
- Item: con ox_inventory, gli item vengono seguiti tramite i suoi hook. Con qb-inventory, i cambi degli item non vengono seguiti (il payload del suo listener non è documentato), ma un rollback può comunque spostare item con gli export documentati di qb-inventory.
- Staff: i gruppi di permessi di QBCore sono gruppi ACE (
group.admin,group.god). Aggiungi le righe ACE della sezione 5.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- Soldi: letti dall'evento di cambio soldi di Qbox; i saldi vengono riletti con gli export di
qbx_corestesso. I soldi cambiati a un personaggio offline (tramite citizen id) non generano alcun evento, quindi non sono nella traccia. - Item: Qbox usa ox_inventory, e Sentinel segue i suoi item tramite gli hook di ox_inventory. Gli item che rappresentano soldi del framework sono lasciati alla parte framework.
- Staff: gruppi ACE, come su QBCore.
Standalone (nessun framework)
set onesync on
ensure zerodev_sentinel- Funziona tutto tranne la traccia di soldi e item: movimento, mondo, eventi, eventi esca, godmode, state bag, armi, casi, clip, replay, console, pannello, Discord, ruoli e ban.
- Con ox_inventory e senza framework, gli item vengono seguiti tramite ox_inventory.
- Storage: il key-value store, oppure oxmysql se lo avvii prima.
Verificare che funzioni
sentinel:health: di nuovo il riquadro di avvio. Ogni riga è un controllo reale; READY significa che non manca niente.sentinel:diag: perché sono stati scelti storage, adapter e livello, ogni regola con i suoi contatori e le ultime decisioni.sentinel:trail: l'adapter di soldi e item in uso e gli ultimi cambi di un giocatore.
In modalità di storage automatica, Sentinel usa oxmysql solo se oxmysql è già avviato (aspetta fino a 15 secondi mentre oxmysql si avvia); se oxmysql parte più tardi, usa il key-value store.
4. Primo avvio: il posto di proprietario
Il primo avvio stampa nella console del server un codice monouso, valido 30 minuti (sentinel:owner code ne stampa uno nuovo). Entra e scrivi /sentinel owner <code>: il posto viene legato al tuo account e il codice non vale più.
Solo il posto di proprietario può cambiare chiavi, livello di protezione, ruoli e permessi. sentinel:owner reset nella console del server libera il posto se devi spostarlo su un altro account.
5. Staff e permessi
Sulla scrivania del proprietario, STAFF: scegli un giocatore online, scegli un ruolo, premi GRANT. Sono inclusi quattro ruoli:
| Ruolo | Può, di base |
|---|---|
| Supporto | vedere i casi, gestire le segnalazioni, la mappa di servizio |
| Moderator | come Support, più replay, kick e quarantena |
| Admin | come Moderator, più rivelare, scagionare, vista dal vivo, richieste di ban, ricorsi |
| Senior admin | come Admin, più un ban che vale subito |
I permessi li scegli tu. Ogni ruolo è un elenco di interruttori che puoi cambiare. Crea i tuoi ruoli partendo da una copia (per esempio "Trial mod"), rinomina qualsiasi ruolo e dai a una persona un interruttore in più o togline uno senza cambiare il suo ruolo. Gli interruttori segnati come pericolosi (ban immediato, ascolto della chat vocale, impostazioni, gestione dello staff) chiedono una seconda pressione. Ogni modifica viene scritta nel registro dello staff, così puoi sempre vedere chi ha cambiato cosa.
ACE funziona ancora per i server che lo usano già, e viene letto a ogni controllo:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| Permesso | Ruolo che dà |
|---|---|
sentinel.admin |
Admin (Senior admin finché il posto di proprietario non viene preso) e ogni comando sentinel:* in gioco |
sentinel.staff |
Moderator; le regole di movimento considerano spiegato il movimento di un membro dello staff |
Alcuni comandi (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) sono registrati come riservati: in gioco richiedono anche command.<name>. La riga comune add_ace group.admin command allow lo copre. La console del server può eseguire ogni comando.
6. Il livello di protezione
Un solo interruttore sulla scrivania del proprietario (OWNER, PROTECTION), e inoltre sentinel:level nella console del server e Config.Protection in config/config.lua. Ciò che imposti sulla scrivania viene salvato e, dopo un riavvio, prevale sulla riga del config.
- Watch: ogni regola osserva e annota cosa avrebbe fatto; nessuno viene avvisato e a nessuno succede nulla. Nel frattempo Sentinel impara cosa è normale sul tuo server: l'osservatore degli eventi (frequenza e forma di ogni evento) e il controllo all'ingresso imparano solo su Watch; i limiti di entità, combattimento e soldi continuano a imparare dal gioco pulito.
- Recommended: ogni regola è attiva. Lo staff riceve avvisi con le prove e si apre un caso. Sentinel non punisce mai da solo; decide il tuo staff.
- Strict: come Recommended, e un punteggio alto mette il giocatore in quarantena finché lo staff non controlla; un rilievo a livello di prova (Tier A: un evento esca attivato, una richiesta falsificata) mette anche in coda un ban per la ban wave.
Sotto l'interruttore la scrivania elenca ogni regola con il suo stato e da dove viene quello stato. Lì puoi fissare una singola regola su Live o Shadow se il tuo server lo richiede (per esempio una regola che continua a segnalare uno dei tuoi script); una riga state in Config.Rules la fissa nel file di config e prevale sulla scrivania.
Un ordine sensato:
- Watch per qualche giorno di gioco normale.
- Leggi cosa avrebbero fatto le regole: il foglio Right now,
sentinel:diag rules(la colonna shadow conta le volte in cui una regola avrebbe assegnato un punteggio) esentinel:diag decisions 100. - Fissa su Shadow ogni regola che ha segnalato qualcuno di cui ti fidi, e faccelo sapere.
- Passa a Recommended. Ora lo staff vede casi e prove; nessuno viene punito automaticamente.
- Strict quando ti fidi di ciò che ti mostra Recommended.
Per tornare indietro in qualsiasi momento: Watch sulla scrivania, oppure sentinel:level watch.
7. La console staff (F7)
Premi F7 in gioco (oppure scrivi sentinel:console in F8). Ogni giocatore può cambiare il tasto nelle impostazioni del gioco (Key Bindings, FiveM). Esc la chiude.
- Right now dice in parole semplici cosa sta succedendo sul tuo server: chi sembra una minaccia e perché, cosa è stato provato, cosa è stato spiegato (un revive, un teletrasporto di un tuo script) e cosa ha bisogno di te. Ogni giocatore che conta ha una riga: cosa ha fatto, cosa è probabilmente, quanto è sicuro Sentinel (Unusual, Suspicious, Very likely, Proven), cosa ha già fatto Sentinel e un passo successivo.
- Fascicoli: prima i casi aperti, ognuno con il rilievo, le prove, le clip dello schermo, il sigillo (se la catena di hash del caso è ancora verificata) e i tasti REVEAL, QUARANTINE, CLEAR e BAN (CLEAR e BAN chiedono una seconda pressione).
- Mappa di servizio: i giocatori online su un modello 3D dell'isola. Il terreno viene misurato dal gioco del primo membro dello staff e salvato in
data/map/. - Play replay chiude la console e riproduce l'incidente in un mondo privato; premi Backspace per tornare.
- Proprietario (solo il posto di proprietario): First run, Protection, Keys, Staff, Internal affairs e Server check.
I comandi in gioco vanno in F8 senza barra, oppure in chat con la barra (/sentinel:diag).
8. Il pannello browser
La stessa scrivania in un browser web, per quando non sei in gioco:
- sul PC del server:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(la porta è quella del tuo server, 30120 di default) - da altrove:
http://<server address>:<port>/zerodev_sentinel/panel/, oppure il tuo indirizzo HTTPS messo davanti
Accesso. Usa un codice monouso: scrivi /sentinel panel in gioco (il codice lo vedi solo tu, funziona una volta, per 5 minuti), oppure esegui sentinel:panel <id or account> nella console del server. Una sessione dura 8 ore; SIGN OUT e END ALL MY SESSIONS la chiudono. Il tuo ruolo e i tuoi interruttori valgono nel browser esattamente come in gioco.
Vista dal vivo. Lo staff con l'interruttore della vista dal vivo può guardare lo schermo di qualsiasi giocatore online dal pannello o dalla console. Non viene salvato nulla su disco, a meno che tu non prema Save to case.
Ascolto. Per ascoltare la chat vocale di quel giocatore servono l'interruttore di ascolto (di default solo il proprietario) e pma-voice. L'audio passa dal tuo gioco, quindi devi essere in gioco sullo stesso server.
Ogni vista dal vivo e ogni ascolto vengono scritti nel registro dello staff e nel caso del giocatore, e i giocatori vengono avvisati al primo ingresso che lo staff può guardare e ascoltare (l'avviso di registrazione, Config.Notice).
9. Casi, quarantena, kick, ban e ricorsi
Quando viene trovato qualcosa, Right now nomina il giocatore in modo chiaro: cosa ha fatto, quanto è sicuro Sentinel e cosa ha fatto in merito. Apri il caso per vedere le prove (posizioni, clip dello schermo sigillate con SHA-256, un replay 3D) e usa i tasti:
- REVEAL: mostra gli identificatori del giocatore.
- QUARANTINE: sposta il giocatore fuori dal mondo reale in un routing bucket privato finché lo staff non guarda.
sentinel:release <server id>lo riporta indietro. - CLEAR: nessun cheat; chiude il caso e ferma il suo ban in coda.
- KICK: fuori dal server, con un motivo che il giocatore legge.
- BAN: tramite la ban wave, con un codice di ricorso.
La ban wave. I ban, compreso un BAN premuto nella console, vengono messi in coda per la ban wave e applicati solo su Strict, di default in un momento casuale tra 2 e 24 ore dopo (Config.Actions). sentinel:wave li elenca, sentinel:wave now <account> ne applica uno subito, sentinel:wave cancel <account> lo annulla.
Ricorsi. Un giocatore bannato vede un codice di ricorso nel messaggio di rifiuto (8 lettere e cifre). Non può entrare per fare ricorso, quindi il ricorso ti arriva da fuori dal gioco:
- Tramite il tuo staff. Il giocatore manda il codice al tuo staff (un ticket Discord, una mail). Un membro dello staff lo registra con
sentinel:appeal <code> <text>. - Tramite la route web. Sentinel risponde sull'indirizzo stesso del tuo server:
http://<server address>:<port>/zerodev_sentinel/appeal. Accetta solo una POST con JSON{ "code": "...", "text": "...", "contact": "optional" }(testo da 10 a 2000 caratteri), quindi è pensata per un modulo sul tuo sito, non come pagina a cui mandare i giocatori. Ogni richiesta accettata riceve la stessa risposta, 202 "received", che il codice corrisponda o meno a un ban. Troppe richieste da un indirizzo (5 in 10 minuti) o in totale (30 al minuto) ricevono 429. Dietro il tuo reverse proxy HTTPS, impostaset sentinel_http_proxy truecosì i limiti contano l'indirizzo del visitatore.
Il testo di rifiuto non dice dove fare ricorso. Dillo ai giocatori nel tuo regolamento, oppure scrivi il tuo testo con il tuo link in Config.Bans.message (mantieni il %s, diventa il codice), per esempio 'You are banned. Appeal at discord.gg/yourserver with code %s'.
Lo staff decide nella console o con sentinel:decide <case or code> accept|reject [note]. Accept toglie ogni ban attivo di quell'account o di quel caso e annulla un ban della wave in coda; reject mantiene il ban. Una decisione è definitiva e viene scritta nel log del caso. sentinel:appeals elenca quelli aperti.
10. Segnalazioni e affari interni
Segnalazioni dei giocatori. Qualsiasi giocatore scrive /report <server id> <what happened> per segnalare un giocatore o un membro dello staff. Gli ultimi due minuti attorno a entrambi i giocatori vengono salvati in un caso. Lo staff chiude una segnalazione come gestita, nessuna violazione, nessuna prova o duplicato. Le segnalazioni sullo staff vanno solo al proprietario.
Affari interni (solo il proprietario, sulla scrivania del proprietario): cosa ha fatto ogni membro dello staff e cosa merita un'occhiata (concessioni a se stessi, nascondersi in combattimento, ban senza caso, teletrasporti verso i giocatori). Un report settimanale di equità viene scritto in data/reports/; sentinel:staff report lo scrive subito. Niente nel registro dello staff punisce lo staff.
11. Proteggere una resource
Senza alcuna configurazione, Sentinel osserva ogni evento che i giocatori possono inviare ai tuoi script e giudica il giocatore. Non può impedire che l'handler di un'altra resource venga eseguito. Per fermare una chiamata malevola prima che uno script venga eseguito, aggiungi il guard a quello script.
sentinel:auditelenca gli eventi di ogni resource avviata che i client possono attivare, classificati in base a cosa fanno i loro handler (per esempio un handler che dà soldi con un importo scelto dal client). Usalo per decidere quali resource proteggere per prime.sentinel:guard <resource>stampa la riga da aggiungere e i server_scripts della resource come risulterebbero. La riga del guard deve essere il primo server script. Il comando stampa soltanto; non modifica alcun file.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Riavvia quella resource.
sentinel:guard <resource>ora dice "guarded since ...".sentinel:guardda solo elenca tutte le resource protette. - Aggiungi regole con
sentinel:patch. Finché una resource non ha regole, il suo guard lascia passare ogni chiamata, tranne quelle dei giocatori in quarantena, che ogni guard scarta. Esempio: al massimo 3 acquisti in 10 secondi, un nome item fino a 32 caratteri e una quantità da 1 a 10; una chiamata rifiutata conta come prova ("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}
Per un callback del framework, scrivi callback:<name> come evento: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> elenca le regole di una resource; sentinel:patch <resource> <event> off ne rimuove una.
Il guard non modifica mai i file e non cambia mai ciò che riceve un handler. È Lua semplice e leggibile in guard/guard.lua.
12. Chiavi per Discord e per l'archivio delle clip
Il modo più semplice è la scrivania del proprietario, KEYS: incolla ogni valore e premi SAVE. Le chiavi restano solo sul server; la scrivania e ogni risposta dicono solo "set" e non mostrano mai più una chiave.
| Riga sulla scrivania | Cos'è | Oppure in server.cfg (usa set, mai setr) |
|---|---|---|
| Token del bot Discord | un bot che hai creato su discord.com/developers e invitato nel tuo server | set sentinel_discord_token "..." |
| Id del server Discord | clic destro sul tuo server, Copy Server ID (con la modalità sviluppatore attiva) | set sentinel_discord_guild "..." |
| Id del canale avvisi | dove vengono pubblicati i casi, con pulsanti per il tuo staff | set sentinel_discord_channel "..." |
| Id del canale ricorsi | dove vengono pubblicati i ricorsi | set sentinel_discord_appeals "..." |
| Chiave FiveManage | una chiave media di fivemanage.com; le clip vengono caricate lì | set sentinel_fivemanage_key "..." |
| Webhook delle clip | al posto di FiveManage: un webhook Discord che riceve le clip | set sentinel_clip_webhook "..." |
| Archivio delle clip | fivemanage, discord, off o automatic (il primo che è impostato) | set sentinel_clip_storage "..." |
Una chiave in server.cfg ha la precedenza sulla scrivania, e la scrivania lo indica. I pulsanti di Discord seguono gli stessi ruoli e interruttori della console. Senza nessuno di questi, casi e clip restano sul tuo server (data/) e la console e il pannello li mostrano.
Gli avvisi webhook più semplici funzionano ancora: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" oppure sentinel:webhook set <url> nella console del server. sentinel:webhook test invia un messaggio di prova; sentinel:webhook mostra lo stato senza mai stampare l'URL; sentinel:webhook clear rimuove quello salvato.
13. Cosa rileva ogni regola
Ogni regola, quando scatta, scrive una frase chiara su cosa ha visto e cosa ha escluso. Prima che una regola conti contro qualcuno, Sentinel controlla i motivi che la spiegherebbero (un respawn, un revive, un'azione dello staff, uno dei tuoi script che sposta o paga i giocatori). Un rilievo spiegato viene registrato e non dà mai punteggio.
- Livello A è prova: qualcosa che fa solo un cheat (un evento esca che nessuno script reale chiama, una richiesta falsificata).
- Livello B è forte: un membro dello staff dovrebbe dare un'occhiata. Da solo apre un caso solo quando due famiglie diverse concordano, o la stessa si ripete.
- Livello C è debole: si aggiunge al punteggio e non agisce mai da solo.
Movimento
| Regola | Rileva | Spiegato da | Livello |
|---|---|---|---|
| teleport | Un salto di oltre 150 m (o 3x il possibile) tra due campioni | spawn, respawn o revive, cambio di routing bucket, staff, l'evento di teletrasporto del tuo script | B |
| foot_speed | Correre a oltre 12 m/s per 1.5 s a piedi, senza cadere, senza ragdoll | spawn, respawn, staff, il tuo script | B |
| air_float | Muoversi mentre si è congelati (noclip); "cadere" senza scendere (fly); muoversi veloce per coordinate mentre il gioco dice che il giocatore è fermo (speed menu) | spawn, respawn, staff, il tuo script | B |
| foot_rise | Salire in verticale a più di 4 m/s a piedi per 3 s | spawn, respawn, staff, il tuo script | B |
| vehicle_speed | Un veicolo oltre 1.3x la velocità massima che la sua classe raggiunge sul tuo server | staff, il tuo script | B |
Mondo
| Regola | Rileva | Spiegato da | Livello |
|---|---|---|---|
| entity_blocked | Spawnare un modello che hai bloccato | i tuoi script che lo spawnano | B |
| entity_rate / entity_model_rate | Spawnare molte più entità (o un solo modello) al minuto di quanto facciano giocatori e script | i tuoi script di spawn | B |
| entity_untrusted | Entità create da un client senza alcuno script che le spawni | i tuoi script di spawn | B |
| entity_disguised | Una raffica dello stesso modello di ped ambientale attorno a un giocatore (un menu che maschera i suoi spawn da traffico) | spawn, respawn, cambio di bucket | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Esplosioni che l'arma in mano non può causare, troppe, invisibili o lontane dal giocatore | le esplosioni dei tuoi script | B |
| projectile_weapon / projectile_rate | Proiettili che l'arma non può sparare, o troppi | B | |
| ptfx_rate | Flood di effetti particellari (un comune attacco per crash e lag) | B | |
| fire_rate | Incendi appiccati più velocemente di quanto consenta qualsiasi arma | B |
Combattimento
| Regola | Rileva | Livello |
|---|---|---|
| damage_plausibility | Danni oltre il valore possibile dell'arma | B |
| hit_range | Colpi da oltre la gittata dell'arma | B |
| shot_rate / kill_rate | Sparare più veloce dell'arma; kill al minuto ben oltre la norma del tuo server | B |
| silent_aim | Colpi dove il giocatore non stava mirando, ripetuti | B |
| aim_stats / aim_stats_backed | Percentuale di headshot e angoli di snap molto fuori da quelli dei giocatori del tuo server su 30+ scontri | C (B con un'altra famiglia) |
| esp_los_backed | Mirare ripetutamente a giocatori che i testimoni segnalano nascosti dietro i muri | Da C a B |
Eventi e richieste
| Regola | Rileva | Livello |
|---|---|---|
| bait_event | Chiamare un evento piazzato che nessuno script reale usa (i menu di cheat li cercano e li attivano) | A |
| bait_statebag / statebag_write | Scrivere state bag che dovrebbe scrivere solo il server (farsi admin, flag di godmode), o state bag troppo grandi | A / B |
| events_before_ready / _trap | Eventi inviati prima ancora che il giocatore sia spawnato (iniettati prima di entrare) | B / A |
| event_rate / event_shape | Un evento chiamato molto più velocemente del normale, o con argomenti di forma diversa dalle chiamate normali del tuo server | B |
| event_flood | 500+ chiamate in 10 s; con il kick per overflow di FiveM stesso, vengono elencati gli eventi più chiamati | B |
| guard_rule / guard_hard | Violare una regola che hai impostato su un evento protetto (importo, frequenza, distanza) | B / A |
Economia
| Regola | Rileva | Livello |
|---|---|---|
| money_nowhere / item_nowhere | Soldi o item che nessun negozio, lavoro o script ha dato (eventi di sviluppo, vendite di negozio trapelate) | B |
| economy_repeat | Un evento di ricompensa o di lavoro pagato 10 volte in 30 s (farming chiamandolo in loop) | B |
| money_jump / money_rate | Un salto improvviso del saldo o un ritmo di guadagno ben oltre la norma del tuo server | B |
| economy_trap | Riscuotere una ricompensa piazzata che nessun lavoro reale paga | A |
| weapon_not_owned | Impugnare un'arma che l'inventario non ha mai dato | B |
Il gioco del giocatore (testimone)
| Regola | Rileva | Livello |
|---|---|---|
| godmode | Il server vede il giocatore invincibile per 30 s (non in una safe zone condivisa) | B |
| witness_backed | Segnali dal gioco confermati dalla vista del server stesso (godmode, invisibilità, nessuna collisione) | B |
| witness_bait | Il gioco risponde a un controllo che non dovrebbe conoscere | A |
| witness_tamper | I controlli di Sentinel nel gioco sono stati hookati o modificati | B |
Identità e file
| Regola | Rileva | Livello |
|---|---|---|
| ban_fingerprint | Un giocatore bannato tornato con un nuovo account (hardware token, identificatori, impronta del browser) | A / flag |
| young_account | Un account nuovissimo (aggiunge solo peso) | C |
| scanner_error / too_large | Resource che lo scanner degli script non è riuscito a leggere, o file troppo grandi che meritano un'occhiata | info |
Cosa nessuna regola promette
Sentinel giudica ciò che il server può vedere e ciò che il gioco di un giocatore segnala. Non legge altri programmi sul PC di un giocatore, e nessun anti-cheat può promettere di beccare ogni cheat. Ogni rilievo arriva con le sue prove, così il tuo staff decide sui fatti.
14. Comandi e configurazione
Ogni comando è nella pagina dei comandi e ogni chiave di config nella pagina di configurazione, entrambe generate dalla resource stessa. Quelli che userai di più:
| Comando | Cosa fa |
|---|---|
/sentinel owner <code> |
prendere il posto di proprietario in gioco con il codice dalla console |
/sentinel panel |
un codice di accesso monouso per il pannello browser (solo staff) |
/report <server id> <what happened> |
qualsiasi giocatore segnala un giocatore o un membro dello staff |
sentinel:health |
di nuovo il riquadro di avvio |
sentinel:diag |
cosa ha deciso Sentinel e perché |
sentinel:level watch\|recommended\|strict |
cambia il livello di protezione e salvalo |
sentinel:wave |
i ban in coda per la ban wave |
sentinel:appeals |
i ricorsi aperti |
sentinel:audit |
gli event a rischio di ogni resource avviata |
sentinel:guard <resource> |
la riga che protegge una resource |
sentinel:advisor |
le impostazioni di FiveM che vale la pena cambiare sul tuo server |
I file di config in config/ (config.lua, protection.lua, watch.lua) e le traduzioni in config/locales/ sono aperti, così come gli adapter dei framework in bridge/ e il file del guard in guard/. Mantienili in Lua valido e riavvia zerodev_sentinel dopo una modifica. Per il primo avvio non serve modificare la config.
15. Il riquadro di avvio e il consulente di hardening
Un attimo dopo che lo storage è pronto, Sentinel stampa un riquadro nella console del server. Una riga FAIL significa che Sentinel non può funzionare correttamente; una riga WARN significa che funziona con meno (per esempio prove senza digest). Ristampalo quando vuoi con sentinel:health.
| Riga | Cosa controlla | Quando non è OK |
|---|---|---|
| Build | La versione e l'etichetta della build da fxmanifest.lua. | - |
| OneSync | La convar onesync. Sentinel legge posizioni, entità ed eventi di gioco tramite OneSync. |
imposta onesync su on in server.cfg |
| Copie in esecuzione | Quante copie della resource sono avviate, comunque si chiami la loro cartella. Deve essere 1. | tieni una sola copia di Sentinel; ferma l'altra cartella |
| Archiviazione | Quale storage è stato scelto (mysql o kvp) e se è pronto. | vedi sentinel:diag storage |
| Cartella delle prove | Una scrittura e lettura di prova in data/archive dentro la resource. | crea la cartella data/archive dentro la resource di Sentinel e assicurati che il server possa scriverci |
| SHA-256 | Se node/util.js risponde; crea l'impronta di ogni prova. | le prove vengono salvate senza digest; cerca un errore di Node nella console |
| Protezione | Il livello di protezione, la sua modalità e da dove arriva. | - |
| Regole | Quante regole sono Live e quante in Shadow. | - |
Dopo il riquadro di avvio, il consulente stampa le impostazioni di FiveM che vale la pena cambiare sul tuo server (con Config.Advisor.atStartup = false le stampa solo con sentinel:advisor). Per ogni impostazione mostra il valore attuale, quello consigliato, cosa blocca, cosa potrebbe rompere e la riga da copiare. Legge solo i valori; non modifica mai server.cfg. Prova una riga sul tuo server prima di tenerla.
16. Lingue, e cosa viene registrato
I testi per giocatori e staff vengono da config/locales/<code>.lua, 25 lingue in questa build. Config.Locale sceglie la lingua; con Config.GameLanguage = true un giocatore il cui gioco è in una lingua offerta da GTA legge Sentinel in quella lingua una volta in gioco.
Sentinel tiene in memoria, per ogni giocatore, circa gli ultimi due minuti di posizioni ed event (Config.Recorder), e li scrive in un archivio in data/archive/ quando si apre un caso o lo staff usa sentinel:save. Durante una revisione chiede al gioco del sospettato clip dello schermo (segmenti da 20 secondi) e le salva in data/clips/. Salva gli identificativi che FiveM dà al server (l'indirizzo IP viene registrato ma di default non viene mai usato per rifiutare una connessione) e, quando Discord è attivo, l'id Discord. Al primo accesso ogni giocatore riceve un breve avviso nella sua lingua che il server registra le partite e che lo staff può guardare e ascoltare (Config.Notice = false lo disattiva; in quel caso diglielo nel regolamento). Indicalo anche nella tua informativa sulla privacy.
In questa build vecchi archivi e clip non vengono eliminati automaticamente: svuota tu data/archive/ e data/clips/ quando non ti servono più.
Con oxmysql, i dati di Sentinel sono nelle tabelle zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report e zds_trail. Senza oxmysql gli stessi dati stanno nell'archivio key-value della resource (chiavi che iniziano con zds:). I ban vengono sempre copiati anche nell'archivio key-value, quindi restano applicati mentre il database è giù.
17. Aggiornare
Le nuove versioni vengono pubblicate sullo stesso asset Keymaster. Sentinel tiene le sue prove dentro la sua cartella, quindi prima di sostituirlo:
- Fai un backup, nella cartella
zerodev_sentinel, delle cartelleconfig/edata/(archivi, clip, segnalazioni, baseline apprese) e, con oxmysql, delle tabellezds_. - Ferma il server, sostituisci la cartella
zerodev_sentinelcon quella nuova (mantieni il nome della cartella) e rimetti la tua cartelladata/. Riporta le impostazioni che hai cambiato nei nuovi file di config invece di copiarci sopra i vecchi file. - Avvia il server e leggi il riquadro di avvio (
sentinel:health).
Prima di aggiornare, leggi le note di rilascio della nuova versione nel changelog.
18. Disinstallare
- Togli la riga del guard da ogni resource che hai protetto (
sentinel:guardle elenca) e riavvia quelle resource. Fallo per primo: il file del guard sparisce non appena sparisce la cartella. - Togli
ensure zerodev_sentinele le righesentinel.admin/sentinel.staffda server.cfg, poi ferma la resource. Sesentinel:lockdownha cambiato l'entity lockdown, fermare Sentinel rimette la modalità originale. - Elimina la cartella
zerodev_sentinel. Così spariscedata/con tutti gli archivi, le clip e le segnalazioni, quindi copia prima tutto quello che vuoi tenere. - Con oxmysql, elimina le tabelle
zds_elencate nella sezione 16 se non vuoi più i ban e i casi. I record key-value restano nell'archivio del server sotto il nome della resource e senza di essa non fanno nulla.
Sentinel scrive solo nella sua cartella, nelle sue tabelle del database e nel suo archivio key-value. Non modifica altre resource né server.cfg.
Domande frequenti
Sentinel banna o kicka qualcuno da solo?
Non su Watch né su Recommended. Parte su Watch, dove registra solo quello che avrebbe fatto. Su Recommended lo staff riceve le prove e decide. Solo su Strict un punteggio alto mette un giocatore in quarantena finché lo staff non controlla, e un riscontro a livello di prova mette un ban in coda per la ban wave.
Mi serve un database?
No. Con oxmysql, Sentinel tiene i suoi dati nel tuo database e crea le sue tabelle al primo avvio; non c'è nessun file SQL da importare. Senza, tutto sta nell'archivio key-value interno della resource.
Funziona su QBCore e Qbox?
Sì. Rilevamento, casi, clip, la console, il pannello browser, Discord e la scrivania del proprietario sono uguali su ogni framework. La traccia di soldi e item ha un suo adapter per ESX, QBCore, Qbox e ox_inventory.
Come do l'accesso ai miei admin?
Sulla scrivania del proprietario, STAFF: scegli un giocatore online, scegli un ruolo, premi GRANT. Oppure continua a usare ACE: sentinel.admin dà Admin e sentinel.staff dà Moderator.
Un giocatore bannato può fare ricorso?
Sì. Il messaggio di rifiuto mostra un codice di ricorso. Il giocatore lo invia al tuo staff, che lo registra con sentinel:appeal, oppure il tuo sito lo invia alla route dei ricorsi di Sentinel. Lo staff lo accetta o lo respinge dalla console o con sentinel:decide.
Può vedere i programmi di cheat sul PC di un giocatore?
No. Sentinel giudica ciò che il server può vedere e ciò che riporta il gioco di un giocatore. Non legge altri programmi sul PC di un giocatore.
L'ascolto della chat vocale è pronto?
Richiede pma-voice e l'interruttore di ascolto (di default solo per il proprietario), e l'audio passa dal tuo gioco.
Cosa vedono i giocatori?
Al primo accesso, un breve avviso nella loro lingua che il server registra le partite e che lo staff può guardare e ascoltare (Config.Notice). Per un giocatore pulito non cambia nient'altro.