Documentação do ZeroDev Sentinel
ZeroDev Sentinel: instalação e uso
O ZeroDev Sentinel é um resource de anti-cheat server-side para FiveM. Ele registra o que o servidor vê, avalia isso com regras que se explicam em frases simples e entrega as provas para a sua staff antes que alguém seja punido. Ele começa no nível de proteção Watch: registra e não pune ninguém até você escolher outra coisa. Este guia cobre a versão 0.1.2 em servidores ESX, QBCore, Qbox e standalone.
1. Requisitos
- OneSync ligado (
set onesync onno server.cfg). O resource declara o OneSync como dependência, então o FXServer não o inicia sem OneSync. - Um artifact do FXServer que roda scripts Node 22 (qualquer artifact recomendado atual; o manifest pede
node_version '22'). O Node faz o hashing, a compressão, a listagem de arquivos e a rota web das apelações. - Opcional: oxmysql. Com ele, o Sentinel guarda seus registros no seu banco de dados e cria as próprias tabelas na primeira inicialização. Não há arquivo SQL para importar. Sem ele, tudo fica no armazenamento key-value do próprio resource.
- Opcional: pma-voice, para escutar o chat de voz de um jogador pelo console ou pelo painel no navegador.
O framework só importa para duas coisas: o rastro de dinheiro e itens (dinheiro e itens que nenhuma loja, job ou script pagou, loops de recompensa, rollbacks) e quem é a sua staff (grupos ACE, que todo framework usa). Detecção, casos, clipes, o console, o painel no navegador, o Discord e o owner desk funcionam do mesmo jeito em todo framework.
2. Instalação em cinco minutos
Nada precisa de SQL, nenhuma edição de config é necessária para a primeira inicialização e nenhum outro resource é alterado.
Passo 5: Abra o owner desk
Aperte F7 no jogo (ou digite sentinel:console no F8) e abra OWNER. A aba First run lista o que está feito e o que não está: Discord, armazenamento de clipes, sua staff e as permissões dela. Cada linha tem um botão. Depois jogue alguns dias no Watch, leia na aba Right now o que o Sentinel encontrou e mude o nível de proteção para Recommended no mesmo desk (seção 6).
3. Seu framework
O Sentinel encontra o framework e o inventory sozinho quando inicia. Não há nada para configurar. sentinel:trail no console do servidor mostra qual adapter ele 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, removido ou definido; itens do inventory adicionados ou removidos; itens dados de jogador para jogador, com os dois lados vinculados). O rollback usa os próprios métodos de jogador do ESX e lê o resultado de volta.
- ESX com ox_inventory: o dinheiro é acompanhado do mesmo jeito. Nesse modo os métodos de item do ESX não informam resultados, então o Sentinel decide só pela releitura.
- Staff: dê aos seus admins a permissão ACE (seção 5). O próprio
group.admindo ESX funciona como grupo ACE quando você adiciona a linha para ele.
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 mudança de dinheiro do QBCore (adicionar, remover e definir, com o motivo). Uma perda e um ganho igual no mesmo momento são vinculados como transferência, porque o QBCore não tem um evento de transferência próprio.
- Itens: com ox_inventory, os itens são acompanhados pelos hooks dele. Com qb-inventory, as mudanças de itens não são acompanhadas (o payload do listener dele não é documentado), mas um rollback ainda pode mover itens com os exports documentados do qb-inventory.
- Staff: os grupos de permissão do QBCore são grupos ACE (
group.admin,group.god). Adicione as linhas ACE da seçã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 mudança de dinheiro do Qbox; os saldos são relidos com os próprios exports do
qbx_core. Dinheiro alterado para um personagem offline (pelo citizen id) não dispara evento, então não aparece no rastro. - Itens: o Qbox usa ox_inventory, e o Sentinel acompanha os itens pelos hooks do ox_inventory. Itens que representam dinheiro do framework ficam por conta da parte do framework.
- Staff: grupos ACE, como no QBCore.
Standalone (sem framework)
set onesync on
ensure zerodev_sentinel- Tudo funciona, menos o rastro de dinheiro e itens: movimento, mundo, eventos, eventos-isca, godmode, state bags, armas, casos, clipes, replay, console, painel, Discord, cargos e bans.
- Com ox_inventory e sem framework, os itens são acompanhados pelo ox_inventory.
- Armazenamento: o armazenamento key-value, ou o oxmysql se você iniciá-lo antes.
Conferindo se funciona
sentinel:health: a caixa de inicialização de novo. Cada linha é uma verificação real; READY significa que não falta nada.sentinel:diag: por que o armazenamento, os adapters e o nível foram escolhidos, cada regra com seus contadores e as decisões mais recentes.sentinel:trail: o adapter de dinheiro e itens em uso e as últimas mudanças de um jogador.
No modo de armazenamento automático, o Sentinel só usa o oxmysql quando o oxmysql já está iniciado (ele espera até 15 segundos enquanto o oxmysql inicia); se o oxmysql iniciar depois, ele usa o armazenamento key-value.
4. Primeira inicialização: o posto de dono
A primeira inicialização mostra um código de uso único no console do servidor, válido por 30 minutos (sentinel:owner code gera um novo). Entre e digite /sentinel owner <code>: o posto fica vinculado à sua conta e o código deixa de valer.
Só o posto de dono pode mudar chaves, o nível de proteção, cargos e permissões. sentinel:owner reset no console do servidor libera o posto se você precisar passá-lo para outra conta.
5. Staff e permissões
No owner desk, STAFF: escolha um jogador online, escolha um cargo, aperte GRANT. Quatro cargos vêm de fábrica:
| Cargo | Pode, de fábrica |
|---|---|
| Suporte | ver casos, tratar denúncias, o mapa de plantão |
| Moderator | como Support, mais replays, kick e quarentena |
| Admin | como Moderator, mais revelar, inocentar, visão ao vivo, pedidos de ban, apelações |
| Senior admin | como Admin, mais um ban que vale na hora |
As permissões são você quem escolhe. Cada cargo é uma lista de chaves que você pode mudar. Crie seus próprios cargos a partir de uma cópia (por exemplo "Trial mod"), renomeie qualquer cargo e dê a uma pessoa uma chave extra ou tire uma sem mudar o cargo dela. As chaves marcadas como perigosas (ban na hora, escutar o chat de voz, configurações, gestão da staff) pedem um segundo clique. Cada mudança vai para o registro da staff, então você sempre vê quem mudou o quê.
O ACE continua funcionando para servidores que já o usam, e é lido em toda 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 posto de dono ser assumido) e todo comando 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) são registrados como restritos: no jogo eles também precisam de command.<name>. A linha comum add_ace group.admin command allow cobre isso. O console do servidor pode rodar qualquer comando.
6. O nível de proteção
Uma chave no owner desk (OWNER, PROTECTION), e também sentinel:level no console do servidor e Config.Protection em config/config.lua. O que você define no desk é salvo e prevalece sobre a linha da config depois de um restart.
- Watch: cada regra observa e anota o que teria feito; ninguém é alertado e nada acontece com ninguém. Enquanto isso o Sentinel aprende o que é normal no seu servidor: o observador de eventos (frequência e formato de cada evento) e a verificação de entrada só aprendem no Watch; os limites de entidades, combate e dinheiro continuam aprendendo com o jogo limpo.
- Recommended: cada regra está ativa. A staff recebe alertas com as provas, e um caso é aberto. O Sentinel nunca pune sozinho; quem decide é a sua staff.
- Strict: como o Recommended, e uma pontuação alta coloca o jogador em quarentena até a staff olhar; uma constatação em nível de prova (Tier A: um evento-isca disparado, uma requisição forjada) também coloca um ban na fila da ban wave.
Embaixo da chave, o desk lista cada regra com seu estado e de onde vem esse estado. Fixe ali uma regra em Live ou Shadow se o seu servidor precisar (por exemplo, uma regra que vive marcando um dos seus próprios scripts); uma linha state em Config.Rules fixa a regra no arquivo de config e prevalece sobre o desk.
Uma ordem sensata:
- Watch por alguns dias de jogo normal.
- Leia o que as regras teriam feito: a aba Right now,
sentinel:diag rules(a coluna shadow conta quantas vezes uma regra teria pontuado) esentinel:diag decisions 100. - Fixe em Shadow qualquer regra que marcou alguém em quem você confia, e conte para nós.
- Mude para Recommended. A staff agora vê casos e provas; ninguém é punido automaticamente.
- Strict quando você confiar no que o Recommended mostra.
Para voltar atrás a qualquer momento: Watch no desk, ou sentinel:level watch.
7. O console da staff (F7)
Aperte F7 no jogo (ou digite sentinel:console no F8). Cada jogador pode trocar a tecla nas configurações do jogo (Key Bindings, FiveM). Esc fecha.
- Right now diz em linguagem simples o que está acontecendo no seu servidor: quem parece uma ameaça e por quê, o que foi provado, o que foi explicado (um revive, o teleporte de um script) e o que precisa de você. Cada jogador que importa ganha uma linha: o que ele fez, o que provavelmente é, o quanto o Sentinel tem certeza (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 seu achado, as provas, clipes de tela, o selo (se a cadeia de hashes do caso ainda confere) e as teclas REVEAL, QUARANTINE, CLEAR e BAN (CLEAR e BAN pedem um segundo aperto).
- 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 o console e reproduz o incidente num mundo privado; aperte Backspace para voltar.
- Owner (só o lugar de dono): First run, Protection, Keys, Staff, Internal affairs e Server check.
Os comandos digitados no jogo vão no F8 sem barra, ou no chat com barra (/sentinel:diag).
8. O painel no navegador
A mesma mesa em um navegador, para quando você não está no jogo:
- no PC do servidor:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(a porta é a porta do seu servidor, 30120 por padrão) - de outro lugar:
http://<server address>:<port>/zerodev_sentinel/panel/, ou o seu próprio endereço HTTPS na frente dele
Login. Use um código de uso único: digite /sentinel panel no jogo (o código aparece só para você, funciona uma vez, por 5 minutos), ou rode sentinel:panel <id or account> no console do servidor. Uma sessão dura 8 horas; SIGN OUT e END ALL MY SESSIONS encerram a sessão. Seu cargo e suas chaves valem no navegador exatamente como no jogo.
Visão ao vivo. A staff com a chave de visão ao vivo pode assistir à tela de qualquer jogador online pelo painel ou pelo console. Nada fica em disco, a menos que você aperte Save to case.
Escuta. Escutar o chat de voz desse jogador exige a chave de escuta (só o dono, por padrão) e o pma-voice. O som toca pelo seu próprio jogo, então esteja no jogo, no mesmo servidor.
Cada visão ao vivo e cada escuta é gravada no registro da staff e no caso do jogador, e os jogadores são avisados na primeira vez que entram de que a staff pode assistir e escutar (o aviso de gravação, Config.Notice).
9. Casos, quarentena, kick, ban e apelações
Quando algo é encontrado, o Right now dá o nome do jogador em linguagem simples: o que ele fez, o quanto o Sentinel tem certeza e o que fez a respeito. Abra o caso para ver as provas (posições, clipes de tela 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 e o coloca num routing bucket privado até a staff olhar.
sentinel:release <server id>traz o jogador de volta. - CLEAR: não é cheat; fecha o caso e cancela o ban dele que estava na fila.
- KICK: fora do servidor, com um motivo que o jogador lê.
- BAN: pela ban wave, com um código de apelação.
A ban wave. Os bans, inclusive um BAN apertado no console, entram na fila da ban wave e só são aplicados no Strict, num horário aleatório de 2 a 24 horas depois, por padrão (Config.Actions). sentinel:wave lista os bans, sentinel:wave now <account> aplica um na hora, sentinel:wave cancel <account> cancela.
Apelações. Um jogador banido vê um código de apelação na mensagem de recusa (8 letras e dígitos). Ele não consegue entrar para apelar, então a apelação chega até você por fora do jogo:
- Pela sua staff. O jogador manda o código para a sua staff (um ticket no Discord, e-mail). Um membro da staff registra com
sentinel:appeal <code> <text>. - Pela rota web. O Sentinel responde no próprio endereço do seu servidor:
http://<server address>:<port>/zerodev_sentinel/appeal. Ela aceita apenas um POST com JSON{ "code": "...", "text": "...", "contact": "optional" }(texto de 10 a 2000 caracteres), então é feita para um formulário no seu site, não para ser uma página para onde mandar os jogadores. Toda requisição aceita recebe a mesma resposta, 202 "received", tenha o código batido com um ban ou não. Requisições demais de um mesmo endereço (5 em 10 minutos) ou no total (30 por minuto) recebem 429. Atrás do seu próprio proxy reverso HTTPS, definaset sentinel_http_proxy truepara que os limites contem o endereço do visitante.
O texto de recusa não diz onde apelar. Avise os jogadores nas suas regras, ou escreva o seu próprio texto com o seu link em Config.Bans.message (mantenha o %s, ele vira o código), por exemplo 'You are banned. Appeal at discord.gg/yourserver with code %s'.
A staff decide no console ou com sentinel:decide <case or code> accept|reject [note]. Accept remove todos os bans ativos daquela conta ou caso e cancela um ban na fila da ban wave; reject mantém o ban. Uma decisão é final e é gravada no log do caso. sentinel:appeals lista as apelações abertas.
10. Denúncias e internal affairs
Denúncias de jogadores. Qualquer jogador digita /report <server id> <what happened> para denunciar um jogador ou um membro da staff. Os últimos dois minutos em volta dos dois jogadores são salvos em um caso. A staff fecha uma denúncia como resolvida, 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 uma olhada (permissões dadas a si mesmo, esconder-se em combate, bans sem caso, teleportes até jogadores). Um relatório semanal de imparcialidade é gravado em data/reports/; sentinel:staff report grava o relatório agora. Nada no registro da staff pune a staff.
11. Proteger uma resource
Sem nenhuma configuração, o Sentinel observa todos os eventos que os jogadores podem enviar aos seus scripts e julga o jogador. Ele não consegue impedir que o handler de outra resource rode. Para barrar uma chamada ruim antes que um script rode, adicione o guard a esse script.
sentinel:auditlista os eventos de cada resource iniciada que os clientes podem disparar, classificados pelo que os handlers deles fazem (por exemplo, um handler que dá dinheiro com um valor que o cliente escolhe). Use para decidir quais resources proteger primeiro.sentinel:guard <resource>imprime a linha a adicionar e os server_scripts da resource como ficariam. A linha do guard precisa ser o primeiro server script. O comando só imprime; não altera nenhum arquivo.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- Reinicie essa resource.
sentinel:guard <resource>agora diz "guarded since ...".sentinel:guardsozinho lista todas as resources protegidas. - Adicione regras com
sentinel:patch. Enquanto uma resource não tem regras, o guard dela deixa passar todas as chamadas, menos as de jogadores em quarentena, que todo guard descarta. Exemplo: no máximo 3 compras em 10 segundos, um nome de item de 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 de framework, escreva callback:<name> como o evento: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> lista as regras de uma resource; sentinel:patch <resource> <event> off remove uma.
O guard nunca edita arquivos e nunca muda o que um handler recebe. É Lua simples e legível em guard/guard.lua.
12. Chaves do Discord e do armazenamento de clipes
O jeito mais fácil é o owner desk, KEYS: cole cada valor e aperte SAVE. As chaves ficam só no servidor; a mesa e todas as respostas dizem apenas "set" e nunca mostram uma chave de novo.
| Linha na mesa | O que é | Ou no server.cfg (use set, nunca setr) |
|---|---|---|
| Discord bot token | um bot que você 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 desenvolvedor ativado) | set sentinel_discord_guild "..." |
| Alert channel id | onde os casos são postados, com botões para a sua staff | set sentinel_discord_channel "..." |
| Appeals channel id | onde as apelações são postadas | set sentinel_discord_appeals "..." |
| FiveManage key | uma chave de mídia do fivemanage.com; os clipes são enviados para lá | set sentinel_fivemanage_key "..." |
| Clip webhook | em vez do FiveManage: um webhook do Discord que recebe os clipes | 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 vence a mesa, e a mesa avisa isso. Os botões do Discord seguem os mesmos cargos e chaves do console. Sem nada disso, os casos e clipes ficam no seu servidor (data/) e o console e o painel mostram tudo.
Os alertas mais simples por webhook continuam funcionando: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" ou sentinel:webhook set <url> no console do servidor. sentinel:webhook test envia uma mensagem de teste; sentinel:webhook mostra o estado sem nunca imprimir a URL; sentinel:webhook clear remove a que está guardada.
13. O que cada regra pega
Toda regra escreve uma frase simples quando dispara, dizendo o que viu e o que descartou. Antes de uma regra contar contra alguém, o Sentinel verifica os motivos que explicariam aquilo (um respawn, um revive, uma ação da staff, um dos seus próprios scripts que move ou paga jogadores). Um achado explicado é registrado e nunca pontua.
- Tier A é prova: algo que só um cheat faz (um evento-isca que nenhum script de verdade chama, uma requisição forjada).
- Tier B é forte: um membro da staff deve olhar. Sozinho, só abre um caso quando duas famílias diferentes concordam, ou quando a mesma se repete.
- Tier C é fraco: soma na pontuação e nunca age sozinho.
Movimento
| Regra | O que pega | Explicado por | Tier |
|---|---|---|---|
| teleport | Um salto de mais de 150 m (ou 3x o que é possível) entre duas amostras | spawn, respawn ou revive, troca de routing bucket, staff, o evento de teleporte do seu script | B |
| foot_speed | Correr a mais de 12 m/s por 1.5 s a pé, sem estar caindo e sem ragdoll | spawn, respawn, staff, seu script | B |
| air_float | Mover-se estando congelado (noclip); "cair" sem descer (fly); mover-se rápido pelas coordenadas enquanto o jogo diz que o jogador está parado (menus de velocidade) | spawn, respawn, staff, seu script | B |
| foot_rise | Subir em linha reta a mais de 4 m/s a pé por 3 s | spawn, respawn, staff, seu script | B |
| vehicle_speed | Um veículo a mais de 1.3x a velocidade máxima que a classe dele atinge no seu servidor | staff, seu script | B |
Mundo
| Regra | O que pega | Explicado por | Tier |
|---|---|---|---|
| entity_blocked | Fazer o spawn de um modelo que você bloqueou | os seus scripts que fazem o spawn dele | B |
| entity_rate / entity_model_rate | Fazer o spawn de muito mais entidades (ou de um mesmo modelo) por minuto do que jogadores e scripts fazem | os seus scripts de spawn | B |
| entity_untrusted | Entidades criadas por um cliente sem nenhum script que faça o spawn delas | os seus scripts de spawn | B |
| entity_disguised | Uma rajada do mesmo modelo de ped ambiente em volta de um jogador (um menu disfarçando seus spawns de trânsito) | spawn, respawn, troca de bucket | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | Explosões que a arma em mãos 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 | Incêndios iniciados mais rápido do que qualquer arma permite | B |
Combate
| Regra | O que pega | 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 | Atirar mais rápido do que a arma; kills por minuto muito acima do seu servidor | B |
| silent_aim | Acertos onde o jogador não estava mirando, repetidos | B |
| aim_stats / aim_stats_backed | Proporção de headshots e ângulos de snap muito fora dos jogadores do seu servidor ao longo de 30+ confrontos | C (B com outra família) |
| esp_los_backed | Mirar repetidamente em jogadores que as testemunhas indicam estar escondidos atrás de paredes | C a B |
Eventos e requisições
| Regra | O que pega | Tier |
|---|---|---|
| bait_event | Chamar um evento plantado que nenhum script de verdade usa (os menus de cheat procuram esses eventos e os disparam) | A |
| bait_statebag / statebag_write | Escrever state bags que só o servidor deveria escrever (virar admin por conta própria, flags de godmode), ou grandes demais | A / B |
| events_before_ready / _trap | Eventos enviados antes mesmo de o jogador ter feito o spawn (injetados antes de entrar) | B / A |
| event_rate / event_shape | Um evento chamado muito mais rápido que o normal, ou com argumentos de formato diferente das chamadas normais do seu servidor | B |
| event_flood | 500+ chamadas em 10 s; no kick por overflow do próprio FiveM, os eventos do topo são listados | B |
| guard_rule / guard_hard | Quebrar uma regra que você definiu num evento protegido (quantidade, taxa, distância) | B / A |
Economia
| Regra | O que pega | Tier |
|---|---|---|
| money_nowhere / item_nowhere | Dinheiro ou itens que nenhuma loja, emprego ou script entregou (eventos de dev, vendas de loja vazadas) | B |
| economy_repeat | Um evento de recompensa ou de emprego pago 10 vezes em 30 s (farm chamando o evento em loop) | B |
| money_jump / money_rate | Um salto repentino no saldo ou uma taxa de ganho muito acima do seu servidor | B |
| economy_trap | Resgatar uma recompensa plantada que nenhum emprego de verdade paga | A |
| weapon_not_owned | Segurar uma arma que o inventário nunca deu | B |
O jogo do jogador (testemunha)
| Regra | O que pega | Tier |
|---|---|---|
| godmode | O servidor lê o jogador como invencível por 30 s (fora de uma safe zone compartilhada) | B |
| witness_backed | Sinais vindos do jogo confirmados pela visão do próprio servidor (godmode, invisibilidade, sem colisão) | B |
| witness_bait | O jogo respondendo a uma verificação que ele não deveria conhecer | A |
| witness_tamper | As verificações do próprio Sentinel no jogo foram interceptadas (hook) ou alteradas | B |
Identidade e arquivos
| Regra | O que pega | Tier |
|---|---|---|
| ban_fingerprint | Um jogador banido de volta numa conta nova (tokens de hardware, identificadores, impressão digital do navegador) | A / flag |
| young_account | Uma conta recém-criada (só adiciona peso) | C |
| scanner_error / too_large | Resources que o scanner de scripts não conseguiu ler, ou arquivos grandes demais que valem uma olhada | info |
O que nenhuma regra promete
O Sentinel julga o que o servidor consegue ver e o que o jogo de um jogador informa. Ele não lê outros programas no PC de um jogador, e nenhum anti-cheat pode prometer que todo cheat é pego. Todo achado vem com suas provas, para que a sua staff decida com base em fatos.
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, as duas geradas a partir da própria resource. Os que você mais usa:
| Comando | O que faz |
|---|---|
/sentinel owner <code> |
assume o lugar de dono no jogo com o código do console |
/sentinel panel |
um código de login de uso único 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 inicialização de novo |
sentinel:diag |
o que o Sentinel decidiu e por quê |
sentinel:level watch\|recommended\|strict |
muda o nível de proteção e salva |
sentinel:wave |
os bans na fila da ban wave |
sentinel:appeals |
as apelações abertas |
sentinel:audit |
os eventos arriscados de cada resource iniciada |
sentinel:guard <resource> |
a linha que protege uma resource |
sentinel:advisor |
as configurações do FiveM que vale a pena mudar no seu servidor |
Os arquivos de config em config/ (config.lua, protection.lua, watch.lua) e as traduções em config/locales/ são abertos para você, assim como os adaptadores de framework em bridge/ e o arquivo do guard em guard/. Mantenha tudo como Lua válido e reinicie zerodev_sentinel depois de uma mudança. Nenhuma edição de config é necessária para a primeira inicialização.
15. A caixa de inicialização e o consultor de hardening
Um instante depois de o armazenamento ficar pronto, o Sentinel imprime uma caixa no console do servidor. Uma linha FAIL significa que o Sentinel não consegue funcionar direito; uma linha WARN significa que ele funciona com menos (por exemplo, provas sem digests). Imprima de novo a qualquer momento com sentinel:health.
| Linha | O que verifica | Quando não está OK |
|---|---|---|
| Build | A versão e o rótulo de build do fxmanifest.lua. | - |
| OneSync | O convar onesync. O Sentinel lê posições, entidades e eventos do jogo pelo OneSync. |
defina set onesync on no server.cfg |
| Copies running | Quantas cópias da resource estão iniciadas, seja qual for o nome da pasta. Precisa ser 1. | mantenha uma só cópia do Sentinel; pare a outra pasta |
| Armazenamento | Qual armazenamento foi escolhido (mysql ou kvp) e se está pronto. | veja sentinel:diag storage |
| Evidence folder | Um teste de escrita e leitura em data/archive dentro da resource. | crie a pasta data/archive dentro da resource do Sentinel e confirme que o servidor consegue escrever nela |
| SHA-256 | Se o node/util.js responde; ele gera a impressão digital de cada prova. | as provas são salvas sem digests; procure um erro do Node no console |
| Protection | O nível de proteção, o modo dele e de onde veio. | - |
| Regras | Quantas regras estão em live e quantas estão em shadow. | - |
Depois da caixa de inicialização, o consultor imprime as configurações do FiveM que vale a pena mudar no seu servidor (Config.Advisor.atStartup = false faz ele imprimir só com sentinel:advisor). Para cada configuração ele mostra o valor atual, o recomendado, o que ela bloqueia, o que pode quebrar e a linha para copiar. Ele só lê os valores; nunca altera o server.cfg. Teste uma linha no seu servidor antes de mantê-la.
16. Idiomas, e o que é gravado
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 roda num idioma que o GTA oferece lê o Sentinel nesse idioma assim que está no jogo.
O Sentinel mantém em memória, para cada jogador, cerca dos últimos dois minutos de posições e eventos (Config.Recorder), e grava isso num arquivo em data/archive/ quando um caso é aberto ou a staff usa sentinel:save. Durante uma análise, ele pede clipes de tela ao jogo do suspeito (segmentos de 20 segundos) e os guarda em data/clips/. Ele guarda os identificadores que o FiveM entrega ao servidor (um endereço IP é registrado, mas por padrão nunca é usado para recusar uma conexão) e, quando o Discord está rodando, o id do Discord. Na primeira vez que entra, cada jogador recebe um aviso curto no idioma dele dizendo que o servidor grava o jogo e que a staff pode assistir e escutar (Config.Notice = false desliga; nesse caso, avise nas suas regras). Mencione isso também na sua política de privacidade.
Arquivos e clipes antigos não são apagados automaticamente nesta build: limpe data/archive/ e data/clips/ você mesmo quando não precisar mais deles.
Com oxmysql, os registros do Sentinel ficam 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 registros ficam no armazenamento key-value da resource (chaves que começam com zds:). Os bans sempre são espelhados no armazenamento key-value, então continuam valendo enquanto o banco de dados está fora do ar.
17. Atualização
As versões novas são publicadas no mesmo asset do Keymaster. O Sentinel guarda as provas dentro da própria pasta, então, antes de substituí-la:
- Faça backup, dentro da pasta
zerodev_sentinel, das pastasconfig/edata/(arquivos, clipes, relatórios, baselines aprendidas) e, com oxmysql, das tabelaszds_. - Pare o servidor, substitua a pasta
zerodev_sentinelpela nova (mantenha o nome da pasta) e coloque a sua pastadata/de volta. Passe as configurações que você mudou para os arquivos de config novos em vez de copiar os arquivos antigos por cima deles. - Inicie o servidor e leia a caixa de inicialização (
sentinel:health).
Leia as notas de versão da nova versão no changelog antes de atualizar.
18. Desinstalar
- Remova a linha do guard de cada resource que você protegeu (
sentinel:guardlista todas) e reinicie essas resources. Faça isso primeiro: o arquivo do guard some junto com a pasta. - Remova
ensure zerodev_sentinele as linhassentinel.admin/sentinel.staffdo server.cfg e depois pare a resource. Se osentinel:lockdownmudou o entity lockdown, parar o Sentinel devolve o modo original. - Apague a pasta
zerodev_sentinel. Isso removedata/com todos os arquivos, clipes e relatórios, então copie antes o que você quiser guardar. - Com oxmysql, apague (drop) as tabelas
zds_listadas na seção 16 se você não quiser mais os bans e os casos. Os registros key-value continuam no armazenamento do servidor sob o nome da resource e não fazem nada sem ela.
O Sentinel só grava dentro da própria pasta, das próprias tabelas no banco e do próprio armazenamento key-value. Ele não edita outras resources nem o server.cfg.
Perguntas frequentes
O Sentinel bane ou dá kick em alguém por conta própria?
Não no Watch nem no Recommended. Ele começa em Watch, onde só registra o que teria feito. No Recommended, a staff recebe as provas e decide. Só no Strict uma pontuação alta coloca um jogador em quarentena até a staff olhar, e um achado em nível de prova coloca um ban na fila da ban wave.
Preciso de um banco de dados?
Não. Com oxmysql, o Sentinel guarda os registros no seu banco de dados e cria as próprias tabelas na primeira inicialização; não há arquivo SQL para importar. Sem ele, tudo fica no armazenamento key-value próprio da resource.
Funciona no QBCore e no Qbox?
Sim. Detecção, casos, clipes, o console, o painel no navegador, o Discord e o owner desk são iguais em todos os frameworks. O rastro de dinheiro e itens tem adaptador 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, aperte GRANT. Ou continue usando 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 manda o código para a sua staff, que registra com sentinel:appeal, ou o seu site envia para a rota de apelação do Sentinel. A staff aceita ou rejeita no console ou com sentinel:decide.
Ele consegue ver programas de cheat no PC de um jogador?
Não. O Sentinel julga o que o servidor consegue ver e o que o jogo de um jogador informa. Ele não lê outros programas no PC de um jogador.
A escuta do chat de voz está pronta?
Ela precisa do pma-voice, da chave de escuta (só o dono, por padrão) e toca pelo seu próprio jogo.
O que os jogadores veem?
Na primeira vez que entram, um aviso curto no idioma deles dizendo que o servidor grava o jogo e que a staff pode assistir e escutar (Config.Notice). Nada mais muda para um jogador limpo.