Documentação do ZeroDev Sentinel
ZeroDev Sentinel: instalação e utilização
O ZeroDev Sentinel é um resource de anti-cheat do lado do servidor para FiveM. Regista o que o servidor vê, avalia-o com regras que se explicam em frases simples e dá as provas à sua staff antes de alguém ser punido. Arranca no nível de proteção Watch: regista e não pune ninguém até escolher outra coisa. Este guia abrange a versão 0.1.2 em servidores ESX, QBCore, Qbox e standalone.
1. Requisitos
- OneSync ativo (
set onesync onno server.cfg). O resource declara o OneSync como dependência, por isso o FXServer não o inicia sem OneSync. - Um artifact do FXServer que execute scripts Node 22 (qualquer artifact recomendado atual; o manifest pede
node_version '22'). O Node trata do hashing, da compressão, da listagem de ficheiros e da rota web das apelações. - Opcional: oxmysql. Com ele, o Sentinel guarda os seus registos na sua base de dados e cria as próprias tabelas no primeiro arranque. Não há ficheiro SQL para importar. Sem ele, tudo fica no armazenamento key-value do próprio resource.
- Opcional: pma-voice, para ouvir o chat de voz de um jogador a partir da consola ou do painel no navegador.
O framework só importa para duas coisas: o rasto de dinheiro e itens (dinheiro e itens que nenhuma loja, job ou script pagou, ciclos de recompensa, rollbacks) e quem é a sua staff (grupos ACE, que todos os frameworks usam). Deteção, casos, clips, a consola, o painel no navegador, o Discord e o owner desk funcionam da mesma forma em todos os frameworks.
2. Instalação em cinco minutos
Nada precisa de SQL, não é preciso editar a config para o primeiro arranque e nenhum outro resource é alterado.
Passo 5: Abra o owner desk
Carregue em F7 no jogo (ou escreva sentinel:console no F8) e abra OWNER. O separador First run mostra o que está feito e o que não está: Discord, armazenamento de clips, a sua staff e as respetivas permissões. Cada linha tem um botão. Depois jogue alguns dias em Watch, leia no separador Right now o que o Sentinel encontrou e mude o nível de proteção para Recommended no mesmo desk (secção 6).
3. O seu framework
O Sentinel encontra sozinho o framework e o inventory quando arranca. Não há nada para configurar. sentinel:trail na consola do servidor mostra que adapter escolheu.
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- Dinheiro e itens: lidos dos próprios eventos de servidor do ESX (dinheiro da conta adicionado, retirado ou definido; itens do inventory adicionados ou retirados; itens dados de jogador para jogador, com os dois lados ligados). O rollback usa os próprios métodos de jogador do ESX e volta a ler o resultado.
- ESX com ox_inventory: o dinheiro é seguido da mesma forma. Neste modo os métodos de itens do ESX não devolvem resultados, por isso o Sentinel decide apenas pela releitura.
- Staff: dê aos seus admins a permissão ACE (secção 5). O próprio
group.admindo ESX funciona como grupo ACE quando adiciona a linha correspondente.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- Dinheiro: lido do evento de alteração de dinheiro do QBCore (adicionar, retirar e definir, com o motivo). Uma perda e um ganho igual no mesmo momento são ligados como transferência, porque o QBCore não tem um evento de transferência próprio.
- Itens: com ox_inventory, os itens são seguidos através dos seus hooks. Com qb-inventory, as alterações de itens não são seguidas (o payload do seu listener não está documentado), mas um rollback pode mesmo assim mover itens com os exports documentados do qb-inventory.
- Staff: os grupos de permissões do QBCore são grupos ACE (
group.admin,group.god). Adicione as linhas ACE da secção 5.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- Dinheiro: lido do evento de alteração de dinheiro do Qbox; os saldos são relidos com os próprios exports do
qbx_core. Dinheiro alterado para uma personagem offline (pelo citizen id) não dispara nenhum evento, por isso não aparece no rasto. - Itens: o Qbox usa ox_inventory, e o Sentinel segue os itens através dos hooks do ox_inventory. Os itens que representam dinheiro do framework ficam a cargo da parte do framework.
- Staff: grupos ACE, como no QBCore.
Standalone (sem framework)
set onesync on
ensure zerodev_sentinel- Tudo funciona exceto o rasto de dinheiro e itens: movimento, mundo, eventos, eventos-isco, godmode, state bags, armas, casos, clips, replay, consola, painel, Discord, cargos e bans.
- Com ox_inventory e sem framework, os itens são seguidos através do ox_inventory.
- Armazenamento: o armazenamento key-value, ou o oxmysql se o iniciar primeiro.
Confirmar que funciona
sentinel:health: a caixa de arranque outra vez. Cada linha é uma verificação real; READY significa que não falta nada.sentinel:diag: porque foram escolhidos o armazenamento, os adapters e o nível, cada regra com os seus contadores e as decisões mais recentes.sentinel:trail: o adapter de dinheiro e itens em uso e as últimas alterações de um jogador.
No modo de armazenamento automático, o Sentinel só usa o oxmysql quando o oxmysql já está iniciado (espera até 15 segundos enquanto o oxmysql arranca); se o oxmysql arrancar mais tarde, usa o armazenamento key-value.
4. Primeiro arranque: o lugar de dono
O primeiro arranque mostra na consola do servidor um código de utilização única, válido durante 30 minutos (sentinel:owner code mostra um novo). Entre e escreva /sentinel owner <code>: o lugar fica associado à sua conta e o código deixa de valer.
Só o lugar de dono pode alterar chaves, o nível de proteção, cargos e permissões. sentinel:owner reset na consola do servidor liberta o lugar se tiver de o passar para outra conta.
5. Staff e permissões
No owner desk, STAFF: escolha um jogador online, escolha um cargo, carregue em GRANT. Vêm quatro cargos de origem:
| Cargo | Pode, de origem |
|---|---|
| Suporte | ver casos, tratar denúncias, o mapa de serviço |
| Moderator | como Support, mais replays, kick e quarentena |
| Admin | como Moderator, mais revelar, ilibar, vista em direto, pedidos de ban, apelações |
| Senior admin | como Admin, mais um ban que se aplica de imediato |
As permissões são escolhidas por si. Cada cargo é uma lista de interruptores que pode alterar. Crie os seus próprios cargos a partir de uma cópia (por exemplo "Trial mod"), mude o nome de qualquer cargo e dê a uma pessoa um interruptor extra ou retire-lhe um sem alterar o cargo dela. Os interruptores marcados como perigosos (ban imediato, ouvir o chat de voz, definições, gestão da staff) pedem um segundo clique. Cada alteração fica no registo da staff, por isso vê sempre quem alterou o quê.
O ACE continua a funcionar para servidores que já o usam, e é lido em cada verificação:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| Permissão | Cargo que dá |
|---|---|
sentinel.admin |
Admin (Senior admin até o lugar de dono ser ocupado) e todos os comandos sentinel:* no jogo |
sentinel.staff |
Moderator; as regras de movimento tratam o próprio movimento de um membro da staff como explicado |
Alguns comandos (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) estão registados como restritos: no jogo também precisam de command.<name>. A linha habitual add_ace group.admin command allow cobre isso. A consola do servidor pode executar qualquer comando.
6. O nível de proteção
Um interruptor no owner desk (OWNER, PROTECTION), e também sentinel:level na consola do servidor e Config.Protection em config/config.lua. O que definir no desk é guardado e prevalece sobre a linha da config depois de um reinício.
- Watch: cada regra observa e anota o que teria feito; ninguém é alertado e não acontece nada a ninguém. Entretanto o Sentinel aprende o que é normal no seu servidor: o observador de eventos (frequência e forma de cada evento) e a verificação de entrada só aprendem em Watch; os limites de entidades, combate e dinheiro continuam a aprender com jogo limpo.
- Recommended: todas as regras estão ativas. A staff recebe alertas com as provas, e é aberto um caso. O Sentinel nunca pune por si só; quem decide é a sua staff.
- Strict: como o Recommended, e uma pontuação alta põe o jogador em quarentena até a staff ver; uma constatação ao nível de prova (Tier A: um evento-isco disparado, um pedido forjado) também coloca um ban na fila da ban wave.
Por baixo do interruptor, o desk lista cada regra com o seu estado e a origem desse estado. Fixe aí uma regra em Live ou Shadow se o seu servidor precisar (por exemplo, uma regra que está sempre a marcar um dos seus próprios scripts); uma linha state em Config.Rules fixa-a no ficheiro de config e prevalece sobre o desk.
Uma ordem sensata:
- Watch durante alguns dias de jogo normal.
- Leia o que as regras teriam feito: o separador Right now,
sentinel:diag rules(a coluna shadow conta as vezes que uma regra teria pontuado) esentinel:diag decisions 100. - Fixe em Shadow qualquer regra que tenha marcado alguém em quem confia, e diga-nos.
- Mude para Recommended. A staff passa a ver casos e provas; ninguém é punido automaticamente.
- Strict quando confiar no que o Recommended lhe mostra.
Para voltar atrás a qualquer momento: Watch no desk, ou sentinel:level watch.
7. A consola da staff (F7)
Carregue em F7 em jogo (ou escreva sentinel:console no F8). Cada jogador pode mudar a tecla nas definições do jogo (Key Bindings, FiveM). Esc fecha-a.
- Right now diz em palavras simples o que se passa no seu servidor: quem parece uma ameaça e porquê, o que ficou provado, o que foi explicado (um revive, o teleporte de um script) e o que precisa de si. Cada jogador que importa tem uma linha: o que fez, o que provavelmente é, quão certo o Sentinel está (Unusual, Suspicious, Very likely, Proven), o que o Sentinel já fez, e um próximo passo.
- Case files: os casos abertos primeiro, cada um com a sua constatação, as provas, clips do ecrã, o selo (se a cadeia de hashes do caso ainda é válida) e as teclas REVEAL, QUARANTINE, CLEAR e BAN (CLEAR e BAN pedem um segundo clique).
- Duty map: os jogadores online num modelo 3D da ilha. O terreno é medido pelo jogo do primeiro membro da staff e guardado em
data/map/. - Play replay fecha a consola e reproduz o incidente num mundo privado; carregue em Backspace para voltar.
- Owner (só o lugar de dono): First run, Protection, Keys, Staff, Internal affairs e Server check.
Os comandos escritos em jogo vão no F8 sem barra, ou no chat com barra (/sentinel:diag).
8. O painel no navegador
O mesmo desk num navegador, para quando não está em jogo:
- no PC do servidor:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(a porta é a porta do seu servidor, 30120 por defeito) - a partir de outro lado:
http://<server address>:<port>/zerodev_sentinel/panel/, ou o seu próprio endereço HTTPS à frente dele
Iniciar sessão. Use um código de utilização única: escreva /sentinel panel em jogo (o código é mostrado só a si, funciona uma vez, durante 5 minutos), ou corra sentinel:panel <id or account> na consola do servidor. Uma sessão dura 8 horas; SIGN OUT e END ALL MY SESSIONS terminam-na. O seu cargo e os seus interruptores aplicam-se no navegador exatamente como em jogo.
Vista em direto. A staff com o interruptor de vista em direto pode ver o ecrã de qualquer jogador online a partir do painel ou da consola. Nada fica guardado em disco a não ser que carregue em Save to case.
Escuta. Ouvir o chat de voz desse jogador precisa do interruptor de escuta (só o dono, por defeito) e do pma-voice. O som toca através do seu próprio jogo, por isso esteja em jogo no mesmo servidor.
Cada vista em direto e cada escuta fica escrita no registo da staff e no caso do jogador, e os jogadores são avisados, na primeira vez que entram, de que a staff pode ver e ouvir (o aviso de gravação, Config.Notice).
9. Casos, quarentena, kick, ban e apelações
Quando algo é encontrado, o Right now nomeia o jogador em linguagem simples: o que fez, quão certo o Sentinel está, e o que o Sentinel fez em relação a isso. Abra o caso para ver as provas (posições, clips do ecrã selados com SHA-256, um replay em 3D) e use as teclas:
- REVEAL: mostra os identificadores do jogador.
- QUARANTINE: tira o jogador do mundo real para um routing bucket privado até a staff ver.
sentinel:release <server id>trá-lo de volta. - CLEAR: não há cheat; fecha o caso e trava o ban que tinha em fila.
- KICK: fora do servidor, com um motivo que o jogador lê.
- BAN: através da ban wave, com um código de apelação.
A ban wave. Os bans, incluindo um BAN carregado na consola, ficam em fila para a ban wave e só são aplicados em Strict, a uma hora aleatória 2 a 24 horas mais tarde, por defeito (Config.Actions). sentinel:wave lista-os, sentinel:wave now <account> aplica um de imediato, sentinel:wave cancel <account> cancela-o.
Apelações. Um jogador banido vê um código de apelação na mensagem de recusa (8 letras e algarismos). Não consegue entrar para apelar, por isso a apelação chega-lhe a si de fora do jogo:
- Através da sua staff. O jogador envia o código à sua staff (um ticket no Discord, e-mail). Um membro da staff regista-o com
sentinel:appeal <code> <text>. - Através da rota web. O Sentinel responde no endereço do seu próprio servidor:
http://<server address>:<port>/zerodev_sentinel/appeal. Só aceita um POST com JSON{ "code": "...", "text": "...", "contact": "optional" }(texto de 10 a 2000 caracteres), por isso serve para um formulário no seu site, não é uma página para onde mandar os jogadores. Cada pedido aceite recebe a mesma resposta, 202 "received", quer o código corresponda a um ban quer não. Demasiados pedidos do mesmo endereço (5 em 10 minutos) ou no total (30 por minuto) recebem 429. Atrás do seu próprio reverse proxy HTTPS, definaset sentinel_http_proxy truepara que os limites contem o endereço do visitante.
O texto de recusa não diz onde apelar. Diga-o aos jogadores nas suas regras, ou escreva o seu próprio texto com o seu link em Config.Bans.message (mantenha o %s, que passa a ser o código), por exemplo 'You are banned. Appeal at discord.gg/yourserver with code %s'.
A staff decide na consola ou com sentinel:decide <case or code> accept|reject [note]. Aceitar levanta todos os bans ativos dessa conta ou caso e cancela um ban em fila na wave; rejeitar mantém o ban. Uma decisão é final e fica escrita no registo do caso. sentinel:appeals lista as que estão abertas.
10. Denúncias e internal affairs
Denúncias de jogadores. Qualquer jogador escreve /report <server id> <what happened> para denunciar um jogador ou um membro da staff. Os últimos dois minutos à volta dos dois jogadores são guardados num caso. A staff fecha uma denúncia como tratada, sem infração, sem prova ou duplicada. As denúncias sobre a staff vão só para o dono.
Internal affairs (só o dono, no owner desk): o que cada membro da staff fez, e o que precisa de ser visto (permissões dadas a si próprio, esconder-se em combate, bans sem caso, teleportes para jogadores). Um relatório semanal de imparcialidade é escrito em data/reports/; sentinel:staff report escreve-o agora. Nada no registo da staff castiga a staff.
11. Proteger um resource
Sem qualquer configuração, o Sentinel observa todos os eventos que os jogadores podem enviar aos seus scripts e avalia o jogador. Não consegue impedir o handler de outro resource de correr. Para travar uma chamada má antes de um script correr, adicione o guard a esse script.
sentinel:auditlista os eventos de cada resource iniciado que os clientes podem disparar, classificados pelo que os seus handlers fazem (por exemplo, um handler que dá dinheiro com um valor escolhido pelo cliente). Use-o para decidir que resources proteger primeiro.sentinel:guard <resource>mostra a linha a adicionar e os server_scripts do resource tal como ficariam. A linha do guard tem de ser o primeiro server script. O comando só mostra; não altera nenhum ficheiro.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Reinicie esse resource.
sentinel:guard <resource>passa a dizer "guarded since ...".sentinel:guardsozinho lista todos os resources protegidos. - Adicione regras com
sentinel:patch. Enquanto um resource não tiver regras, o seu guard deixa passar todas as chamadas, exceto as de jogadores em quarentena, que todos os guards descartam. Exemplo: no máximo 3 compras em 10 segundos, um nome de item até 32 caracteres e uma quantidade de 1 a 10; uma chamada recusada conta como 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}
Para um callback do framework, escreva callback:<name> como evento: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> lista as regras de um resource; sentinel:patch <resource> <event> off remove uma.
O guard nunca edita ficheiros e nunca altera o que um handler recebe. É Lua simples e legível em guard/guard.lua.
12. Chaves do Discord e do armazenamento de clips
A forma mais fácil é o owner desk, KEYS: cole cada valor e carregue em SAVE. As chaves ficam guardadas só no servidor; o desk e todas as respostas dizem apenas "set" e nunca voltam a mostrar uma chave.
| Linha no desk | O que é | Ou no server.cfg (use set, nunca setr) |
|---|---|---|
| Discord bot token | um bot que criou em discord.com/developers, convidado para o seu servidor | set sentinel_discord_token "..." |
| Discord server id | clique com o botão direito no seu servidor, Copy Server ID (modo de programador ligado) | set sentinel_discord_guild "..." |
| Alert channel id | onde os casos são publicados, com botões para a sua staff | set sentinel_discord_channel "..." |
| Appeals channel id | onde as apelações são publicadas | set sentinel_discord_appeals "..." |
| FiveManage key | uma chave de media de fivemanage.com; os clips são enviados para lá | set sentinel_fivemanage_key "..." |
| Clip webhook | em vez do FiveManage: um webhook do Discord que recebe os clips | set sentinel_clip_webhook "..." |
| Clip storage | fivemanage, discord, off, ou automático (o primeiro que estiver definido) | set sentinel_clip_storage "..." |
Uma chave no server.cfg prevalece sobre o desk, e o desk indica-o. Os botões do Discord seguem os mesmos cargos e interruptores que a consola. Sem nada disto, os casos e os clips ficam no seu servidor (data/) e a consola e o painel mostram-nos.
Os alertas mais simples por webhook continuam a funcionar: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" ou sentinel:webhook set <url> na consola do servidor. sentinel:webhook test envia uma mensagem de teste; sentinel:webhook mostra o estado sem nunca mostrar o URL; sentinel:webhook clear remove o que está guardado.
13. O que cada regra apanha
Cada regra escreve uma frase simples quando dispara, a dizer o que viu e o que excluiu. Antes de uma regra contar contra alguém, o Sentinel verifica os motivos que a explicariam (um respawn, um revive, uma ação da staff, um dos seus próprios scripts que move ou paga jogadores). Uma constatação explicada fica registada e nunca é pontuada.
- Tier A é prova: algo que só um cheat faz (um evento-isco que nenhum script real chama, um pedido forjado).
- Tier B é forte: um membro da staff deve ver. Sozinho, só abre um caso quando duas famílias diferentes concordam, ou quando a mesma se repete.
- Tier C é fraco: soma à pontuação e nunca age sozinho.
Movimento
| Regra | Apanha | Explicado por | Tier |
|---|---|---|---|
| teleport | Um salto de mais de 150 m (ou 3x o que é possível) entre duas amostras | spawn, respawn ou revive, mudança de routing bucket, staff, o evento de teleporte do seu script | B |
| foot_speed | Correr a mais de 12 m/s durante 1.5 s a pé, sem estar a cair, sem ragdoll | spawn, respawn, staff, o seu script | B |
| air_float | Mover-se enquanto está congelado (noclip); "cair" sem descer (fly); mover-se depressa pelas coordenadas enquanto o jogo diz que o jogador está parado (speed menus) | spawn, respawn, staff, o seu script | B |
| foot_rise | Subir a direito a mais de 4 m/s a pé durante 3 s | spawn, respawn, staff, o seu script | B |
| vehicle_speed | Um veículo a mais de 1.3x a velocidade máxima que a sua classe atinge no seu servidor | staff, o seu script | B |
Mundo
| Regra | Apanha | Explicado por | Tier |
|---|---|---|---|
| entity_blocked | Fazer spawn de um modelo que bloqueou | os seus scripts que fazem spawn dele | B |
| entity_rate / entity_model_rate | Fazer spawn de muito mais entidades (ou de um só modelo) por minuto do que os jogadores e os scripts fazem | os seus scripts de spawn | B |
| entity_untrusted | Entidades criadas por um cliente sem nenhum script que faça spawn delas | os seus scripts de spawn | B |
| entity_disguised | Uma rajada do mesmo modelo de ped ambiente à volta de um jogador (um menu a disfarçar os seus spawns de trânsito) | spawn, respawn, mudança de bucket | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Explosões que a arma empunhada não consegue fazer, em excesso, invisíveis, ou longe do jogador | as explosões dos seus scripts | B |
| projectile_weapon / projectile_rate | Projéteis que a arma não consegue disparar, ou em excesso | B | |
| ptfx_rate | Floods de efeitos de partículas (um ataque comum de crash e lag) | B | |
| fire_rate | Fogos iniciados mais depressa do que qualquer arma permite | B |
Combate
| Regra | Apanha | Tier |
|---|---|---|
| damage_plausibility | Dano acima do valor possível da arma | B |
| hit_range | Acertos de além do alcance da arma | B |
| shot_rate / kill_rate | Disparar mais depressa do que a arma; kills por minuto muito acima do seu servidor | B |
| silent_aim | Acertos onde o jogador não estava a apontar, repetidos | B |
| aim_stats / aim_stats_backed | Percentagem de headshots e ângulos de snap muito fora dos jogadores do seu servidor ao longo de 30+ combates | C (B com outra família) |
| esp_los_backed | Apontar repetidamente a jogadores que as testemunhas indicam estarem escondidos atrás de paredes | C a B |
Eventos e pedidos
| Regra | Apanha | Tier |
|---|---|---|
| bait_event | Chamar um evento plantado que nenhum script real usa (os cheat menus procuram-nos e disparam-nos) | A |
| bait_statebag / statebag_write | Escrever state bags que só o servidor deve escrever (tornar-se admin, flags de godmode), ou demasiado grandes | A / B |
| events_before_ready / _trap | Eventos enviados antes de o jogador sequer ter feito spawn (injetados antes de entrar) | B / A |
| event_rate / event_shape | Um evento chamado muito mais depressa do que o normal, ou com argumentos de forma diferente das chamadas normais do seu servidor | B |
| event_flood | 500+ chamadas em 10 s; no kick por overflow do próprio FiveM, são listados os eventos mais chamados | B |
| guard_rule / guard_hard | Quebrar uma regra que definiu num evento protegido (quantidade, frequência, distância) | B / A |
Economia
| Regra | Apanha | Tier |
|---|---|---|
| money_nowhere / item_nowhere | Dinheiro ou itens que nenhuma loja, emprego ou script entregou (eventos de dev, vendas de loja expostas) | B |
| economy_repeat | Um evento de recompensa ou de emprego pago 10 vezes em 30 s (farming a chamá-lo em loop) | B |
| money_jump / money_rate | Um salto súbito de saldo ou um ritmo de pagamento muito acima do seu servidor | B |
| economy_trap | Reclamar uma recompensa plantada que nenhum emprego real paga | A |
| weapon_not_owned | Ter na mão uma arma que o inventário nunca deu | B |
O jogo do jogador (testemunha)
| Regra | Apanha | Tier |
|---|---|---|
| godmode | O servidor lê o jogador como invencível durante 30 s (não numa safe zone partilhada) | B |
| witness_backed | Sinais do jogo confirmados pela visão do próprio servidor (godmode, invisibilidade, sem colisão) | B |
| witness_bait | O jogo a responder a uma verificação que não devia conhecer | A |
| witness_tamper | As verificações do próprio Sentinel no jogo foram alvo de hook ou alteradas | B |
Identidade e ficheiros
| Regra | Apanha | Tier |
|---|---|---|
| ban_fingerprint | Um jogador banido de volta numa conta nova (tokens de hardware, identificadores, fingerprint do browser) | A / flag |
| young_account | Uma conta acabada de criar (só acrescenta peso) | C |
| scanner_error / too_large | Resources que o scanner de scripts não conseguiu ler, ou ficheiros demasiado grandes que merecem ser vistos | info |
O que nenhuma regra promete
O Sentinel avalia o que o servidor consegue ver e o que o jogo de um jogador reporta. Não lê outros programas no PC de um jogador, e nenhum anti-cheat pode prometer que todos os cheats são apanhados. Cada constatação vem com as suas provas, para que a sua staff decida com base em factos.
14. Comandos e configuração
Todos os comandos estão na página de comandos e todas as chaves de config na página de configuração, ambas geradas a partir do próprio resource. Os que mais vai usar:
| Comando | O que faz |
|---|---|
/sentinel owner <code> |
ocupar o lugar de dono em jogo com o código da consola |
/sentinel panel |
um código de início de sessão de utilização única para o painel no navegador (só staff) |
/report <server id> <what happened> |
qualquer jogador denuncia um jogador ou um membro da staff |
sentinel:health |
a caixa de arranque outra vez |
sentinel:diag |
o que o Sentinel decidiu e porquê |
sentinel:level watch\|recommended\|strict |
mudar o nível de proteção e guardá-lo |
sentinel:wave |
os bans em fila para a ban wave |
sentinel:appeals |
as apelações abertas |
sentinel:audit |
os eventos de risco de cada resource iniciado |
sentinel:guard <resource> |
a linha que protege um resource |
sentinel:advisor |
as definições do FiveM que vale a pena mudar no seu servidor |
Os ficheiros de config em config/ (config.lua, protection.lua, watch.lua) e as traduções em config/locales/ estão abertos para si, tal como os adapters de framework em bridge/ e o ficheiro guard em guard/. Mantenha-os como Lua válido e reinicie o zerodev_sentinel depois de uma alteração. Não é precisa nenhuma alteração à config para o primeiro arranque.
15. A caixa de arranque e o consultor de hardening
Um momento depois de o armazenamento estar pronto, o Sentinel mostra uma caixa na consola do servidor. Uma linha FAIL significa que o Sentinel não consegue funcionar corretamente; uma linha WARN significa que funciona com menos (por exemplo, provas sem digests). Mostre-a de novo em qualquer altura com sentinel:health.
| Linha | O que verifica | Quando não está OK |
|---|---|---|
| Build | A versão e a etiqueta de build do fxmanifest.lua. | - |
| OneSync | O convar onesync. O Sentinel lê posições, entidades e eventos do jogo através do OneSync. |
set onesync on no server.cfg |
| Cópias em execução | Quantas cópias do resource estão iniciadas, seja qual for o nome da pasta. Tem de ser 1. | mantenha uma só cópia do Sentinel; pare a outra pasta |
| Armazenamento | Que armazenamento foi escolhido (mysql ou kvp) e se está pronto. | veja sentinel:diag storage |
| Pasta de provas | Uma escrita e leitura de teste em data/archive dentro do resource. | crie a pasta data/archive dentro do resource do Sentinel e garanta que o servidor consegue escrever nela |
| SHA-256 | Se o node/util.js responde; é ele que gera a impressão digital de cada prova. | as provas são guardadas sem digests; procure um erro do Node na consola |
| Proteção | O nível de proteção, o seu modo e de onde veio. | - |
| Regras | Quantas regras estão em live e quantas em shadow. | - |
Depois da caixa de arranque, o consultor mostra as definições do FiveM que vale a pena mudar no seu servidor (Config.Advisor.atStartup = false mostra-o só com sentinel:advisor). Para cada definição mostra o valor atual, o recomendado, o que bloqueia, o que pode estragar, e a linha a copiar. Só lê os valores; nunca altera o server.cfg. Teste uma linha no seu servidor antes de a manter.
16. Idiomas, e o que fica registado
Os textos para jogadores e staff vêm de config/locales/<code>.lua, 25 idiomas nesta build. Config.Locale escolhe o idioma; com Config.GameLanguage = true, um jogador cujo jogo corre num idioma que o GTA oferece lê o Sentinel nesse idioma assim que está em jogo.
O Sentinel mantém em memória, para cada jogador, cerca dos últimos dois minutos de posições e eventos (Config.Recorder), e escreve-os num arquivo em data/archive/ quando um caso é aberto ou a staff usa sentinel:save. Durante uma análise, pede ao jogo do suspeito clips do ecrã (segmentos de 20 segundos) e guarda-os em data/clips/. Guarda os identificadores que o FiveM dá ao servidor (um endereço IP é registado mas, por defeito, nunca é usado para recusar uma ligação) e, quando o Discord está a correr, o id do Discord. Na primeira vez que entram, todos os jogadores recebem um aviso curto no seu idioma de que o servidor grava o jogo e de que a staff pode ver e ouvir (Config.Notice = false desliga-o; nesse caso, diga-lho nas suas regras). Mencione-o também na sua política de privacidade.
Os arquivos e clips antigos não são apagados automaticamente nesta build: limpe você mesmo data/archive/ e data/clips/ quando já não precisar deles.
Com oxmysql, os registos do Sentinel estão nas tabelas zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report e zds_trail. Sem oxmysql, os mesmos registos ficam no armazenamento key-value do resource (chaves que começam por zds:). Os bans são sempre espelhados no armazenamento key-value, por isso continuam a ser aplicados enquanto a base de dados está em baixo.
17. Atualizar
As novas versões são publicadas no mesmo asset do Keymaster. O Sentinel guarda as suas provas dentro da própria pasta, por isso, antes de a substituir:
- Faça uma cópia de segurança, dentro da pasta
zerodev_sentinel, das pastasconfig/edata/(arquivos, clips, relatórios, baselines aprendidas) e, com oxmysql, das tabelaszds_. - Pare o servidor, substitua a pasta
zerodev_sentinelpela nova (mantenha o nome da pasta), e volte a pôr a sua pastadata/. Passe as definições que alterou para os novos ficheiros de config em vez de copiar os ficheiros antigos por cima deles. - Inicie o servidor e leia a caixa de arranque (
sentinel:health).
Leia as notas da nova versão no registo de alterações antes de atualizar.
18. Desinstalar
- Remova a linha do guard de todos os resources que protegeu (
sentinel:guardlista-os) e reinicie esses resources. Faça isto primeiro: o ficheiro guard desaparece quando a pasta desaparecer. - Remova
ensure zerodev_sentinele as linhassentinel.admin/sentinel.staffdo server.cfg, e depois pare o resource. Se osentinel:lockdownalterou o entity lockdown, parar o Sentinel repõe o modo original. - Apague a pasta
zerodev_sentinel. Isso removedata/com todos os arquivos, clips e relatórios, por isso copie para fora o que quiser guardar. - Com oxmysql, elimine as tabelas
zds_listadas na secção 16 se já não quiser os bans e os casos. Os registos key-value ficam no armazenamento do servidor sob o nome do resource e não fazem nada sem ele.
O Sentinel só escreve dentro da sua pasta, das suas tabelas na base de dados e do seu armazenamento key-value. Não edita outras resources nem o server.cfg.
Perguntas frequentes
O Sentinel bane ou dá kick a alguém por si só?
Não em Watch nem em Recommended. Arranca em Watch, onde só regista o que teria feito. Em Recommended, a staff recebe as provas e decide. Só em Strict uma pontuação alta põe um jogador em quarentena até a staff ver, e uma constatação ao nível de prova põe um ban na fila da ban wave.
Preciso de uma base de dados?
Não. Com oxmysql, o Sentinel guarda os registos na sua base de dados e cria as suas próprias tabelas no primeiro arranque; não há ficheiro SQL para importar. Sem ele, tudo fica no armazenamento key-value próprio da resource.
Funciona em QBCore e Qbox?
Sim. Deteção, casos, clips, a consola, o painel no navegador, o Discord e o owner desk são iguais em todos os frameworks. O rasto de dinheiro e itens tem adapter próprio para ESX, QBCore, Qbox e ox_inventory.
Como dou acesso aos meus admins?
No owner desk, STAFF: escolha um jogador online, escolha um cargo, carregue em GRANT. Ou continue a usar ACE: sentinel.admin dá Admin e sentinel.staff dá Moderator.
Um jogador banido pode apelar?
Sim. A mensagem de recusa mostra um código de apelação. O jogador envia-o à sua staff, que o regista com sentinel:appeal, ou o seu site envia-o para a rota de apelações do Sentinel. A staff aceita-a ou rejeita-a na consola ou com sentinel:decide.
Consegue ver programas de cheat no PC de um jogador?
Não. O Sentinel avalia o que o servidor consegue ver e o que o jogo de um jogador reporta. Não lê outros programas no PC de um jogador.
A escuta do chat de voz está pronta?
Precisa do pma-voice, do interruptor de escuta (só o dono, por defeito), e toca através do seu próprio jogo.
O que veem os jogadores?
Na primeira vez que entram, um aviso curto no seu idioma de que o servidor grava o jogo e de que a staff pode ver e ouvir (Config.Notice). Nada mais muda para um jogador limpo.