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.

Para o ZeroDev Sentinel 0.1.223 min de leituraAtualizado a

1. Requisitos

  • OneSync ativo (set onesync on no 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 1: Coloque a pasta em resources

Copie a pasta zerodev_sentinel para a sua pasta resources. Mantenha exatamente esse nome de pasta: o ficheiro guard reporta a zerodev_sentinel, e o sentinel:guard avisa-o quando a pasta tem outro nome.

Passo 2: Adicione-o ao server.cfg

Inicie-o depois do oxmysql e do seu framework, para que o armazenamento e o rasto de dinheiro os encontrem no arranque. A ordem exata para o seu framework está na secção 3.

Passo 3: Inicie o servidor

A consola mostra uma caixa de arranque e um código de dono de utilização única. Cada linha da caixa é uma verificação real; a última linha diz READY, ou NOT READY com o número de problemas (secção 15).

Passo 4: Ocupe o lugar de dono

Entre no servidor e escreva /sentinel owner <code> no chat. Agora o lugar de dono é seu (secção 4).

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

server.cfg
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.admin do ESX funciona como grupo ACE quando adiciona a linha correspondente.

QBCore

server.cfg
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

server.cfg
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)

server.cfg
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:

server.cfg
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:

  1. Watch durante alguns dias de jogo normal.
  2. 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) e sentinel:diag decisions 100.
  3. Fixe em Shadow qualquer regra que tenha marcado alguém em quem confia, e diga-nos.
  4. Mude para Recommended. A staff passa a ver casos e provas; ninguém é punido automaticamente.
  5. 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:

  1. 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>.
  2. 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, defina set sentinel_http_proxy true para 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.

  1. sentinel:audit lista 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.
  2. 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' }

  1. Reinicie esse resource. sentinel:guard <resource> passa a dizer "guarded since ...". sentinel:guard sozinho lista todos os resources protegidos.
  2. 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:

  1. Faça uma cópia de segurança, dentro da pasta zerodev_sentinel, das pastas config/ e data/ (arquivos, clips, relatórios, baselines aprendidas) e, com oxmysql, das tabelas zds_.
  2. Pare o servidor, substitua a pasta zerodev_sentinel pela nova (mantenha o nome da pasta), e volte a pôr a sua pasta data/. Passe as definições que alterou para os novos ficheiros de config em vez de copiar os ficheiros antigos por cima deles.
  3. 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

  1. Remova a linha do guard de todos os resources que protegeu (sentinel:guard lista-os) e reinicie esses resources. Faça isto primeiro: o ficheiro guard desaparece quando a pasta desaparecer.
  2. Remova ensure zerodev_sentinel e as linhas sentinel.admin / sentinel.staff do server.cfg, e depois pare o resource. Se o sentinel:lockdown alterou o entity lockdown, parar o Sentinel repõe o modo original.
  3. Apague a pasta zerodev_sentinel. Isso remove data/ com todos os arquivos, clips e relatórios, por isso copie para fora o que quiser guardar.
  4. 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.

Traduzido do inglês. Se alguma coisa aqui não coincidir com a página em inglês, vale a página em inglês. English