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.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:
[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':
| Caso | Quando | Defeito |
|---|---|---|
no_client | Client fechado ou sem sessão iniciada | kick |
no_account | O Discord do jogador não está ligado a nenhuma conta BlackShield | kick |
outdated | Versão do Client demasiado antiga | kick |
dirty | À entrada: o Client detetou um cheat ou foi adulterado | kick |
detection | Durante o jogo: o Client detetou um cheat ou foi adulterado | kick |
ip_mismatch | Client 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:
- Cria conta em blackshieldac.online e liga o teu Discord no painel.
- Transfere o Client em blackshieldac.online/client e inicia sessão.
- 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.
| Mensagem | O que fazer |
|---|---|
INATIVO: precisa do plano Master | A licença não é Master. Compra o plano Master ou põe requireMaster = false só para testes. |
INATIVO: falta a licença | Mete 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.
Algo não está claro? Abre um ticket.