08Documentação

BlackShield Client obrigatório

Plano Master — só entra quem tiver o programa para Windows aberto e limpo.

O BlackShield Client é um programa para Windows que verifica o PC do jogador (cheats, mod menus, injetores, debuggers e drivers vulneráveis). Com o plano Master, o teu servidor só deixa entrar quem tiver o Client aberto, com sessão iniciada e sem nada detetado.

#O que precisas

  • Uma licença do plano Master (no painel, a licença diz Master). Com a licença normal esta parte fica inativa.
  • Jogadores com Windows 10/11 (64 bits) e o Discord aberto ao entrarem no FiveM: é pelo Discord que o servidor liga o jogador à conta BlackShield.

#Ligar

Em config.lua (também se muda no painel /ac → Configuração, sem reiniciar):

config.lua
Config.ClientGuard = {
    enabled = true,          -- exige o Client a todos os jogadores
    requireMaster = true,    -- só funciona com a licença Master
    graceSeconds = 15,       -- tempo à entrada para o jogador abrir o Client
    recheckSeconds = 30,     -- confirma durante o jogo que continua aberto e limpo
    matchIp = true,          -- o IP do jogo tem de ser o mesmo do Client
    requireDiscord = true,
    allowIpFallback = false, -- sem Discord, tenta pelo IP (menos seguro)
    onSiteDown = 'allow',    -- o site não responde: 'allow' deixa entrar | 'kick' recusa
    banMinutes = 0,          -- 0 = permanente, quando a ação é 'ban'
    exemptAces = true,       -- a staff com bypass não precisa do Client
}

Reinicia o recurso e confirma na consola:

text
[BlackShield] BlackShield Client obrigatório: ATIVO · staff dispensada · site em baixo: deixa entrar

#O que acontece a cada caso

Em Config.ClientGuard.actions, cada caso pode ser 'kick', 'ban', 'warn' (só avisa a staff) ou 'allow':

CasoQuandoDefeito
no_clientClient fechado ou sem sessão iniciadakick
no_accountO Discord do jogador não está ligado a nenhuma conta BlackShieldkick
outdatedVersão do Client demasiado antigakick
dirtyÀ entrada: o Client detetou um cheat ou foi adulteradokick
detectionDurante o jogo: o Client detetou um cheat ou foi adulteradokick
ip_mismatchClient aberto e limpo, mas o jogo chega por outro IP (VPN de jogo como ExitLag, WTFast ou NoPing; duas ligações à internet)warn

Dica

Começa com kick em tudo. Passa dirty e detection para ban depois de umas semanas sem queixas.

#Modo Dev com o Client

Com o Modo Dev ligado, as deteções do Client (dirty e detection) não expulsam nem banem: a staff recebe [DEV] … castigo real: X (no máximo um aviso por jogador e motivo a cada 5 minutos).

Quem não tem o Client, tem uma versão antiga ou não tem conta continua a não entrar, também em Modo Dev.

#O que dizer aos jogadores

Põe isto nas regras ou no Discord do servidor:

Para jogar neste servidor precisas do BlackShield Client:

  1. Cria conta em blackshieldac.online e liga o teu Discord no painel.
  2. Transfere o Client em blackshieldac.online/client e inicia sessão.
  3. Deixa o Client aberto e entra no servidor com o Discord aberto.

O Client fica na bandeja do sistema e atualiza-se sozinho.

#Consola

acclient mostra o estado: ativo ou inativo, plano, licença e a última resposta do site.

MensagemO que fazer
INATIVO: precisa do plano MasterA licença não é Master. Compra o plano Master ou põe requireMaster = false só para testes.
INATIVO: falta a licençaMete a chave em server_config.lua.
o site recusou o servidor (other_server)A licença está presa a outro IP: usa Mudar de servidor no painel.
o site recusou o servidor (not_master)A licença não é do plano Master.

#Problemas comuns

  • Jogador com o Client aberto é recusado como "sem Client": confirma que o Discord está aberto antes do FiveM e ligado no painel do site, na mesma conta com que entrou no Client.
  • VPN de jogo (ExitLag, WTFast, NoPing): o jogo e o Client saem por IPs diferentes. Por defeito (ip_mismatch = 'warn') o jogador entra e a staff é avisada; com 'kick' é recusado com uma mensagem a explicar.
  • Servidor e jogadores na mesma rede de casa: se forem recusados, põe matchIp = false.
  • Steam: não é obrigatória (quem tem o GTA V pela Epic ou pela Rockstar entra na mesma). Quando a Steam está aberta, a conta BlackShield fica ligada a ela; numa troca de Steam a entrada é recusada e a ligação repõe-se no painel.
  • O site da BlackShield em baixo: com onSiteDown = 'allow' o servidor continua a deixar entrar, para nunca ficar trancado.
Precisas de ajuda?

Algo não está claro? Abre um ticket.

Novo ticket