07Documentação

BlackShield Network

Perfis globais dos jogadores, bans noutros servidores e privacidade.

A BlackShield Network junta o que todos os servidores com BlackShield sabem de cada jogador num perfil público em /players: confiança de 0 a 100%, estatísticas de combate, servidores onde joga e histórico de deteções e bans.

#O que ganhas

  • Bans noutros servidores: quando alguém entra, o recurso pergunta à rede se tem ban ativo noutro servidor BlackShield, ou se partilha o PC com uma conta banida. A staff recebe um aviso (ou o jogador é expulso, se quiseres).
  • Confiança mais certa: esses sinais entram na confiança do teu painel (fatores "Banido noutros servidores" e "PC partilhado com contas banidas").
  • Perfil na ficha do jogador: no painel, a ficha mostra a confiança global, os servidores, as horas na rede e o link do perfil público.

#Configuração

Em config.lua:

lua
Config.Network = {
    enabled = true,          -- false = não envia nem consulta nada
    publicServer = true,     -- mostra o nome do servidor nos perfis (false = "Servidor privado")
    onGlobalBan = 'alert',   -- 'none' | 'alert' | 'kick'
    trustFactors = true,     -- bans noutros servidores contam para a confiança aqui
    discordAvatar = true,    -- foto do Discord no perfil (precisa de um bot, ver abaixo)
}

Não há mais nada a fazer: usa a mesma licença do server_config.lua. Na consola, acnetwork mostra o estado (fila, último envio, erros) e força um envio.

Atenção

onGlobalBan = 'kick' expulsa quem tem ban ativo em qualquer outro servidor BlackShield. Cada servidor tem as suas regras: recomendamos 'alert' e decidir caso a caso.

#Fotos do Discord (precisa de um bot)

Para o perfil e a ficha do jogador mostrarem a foto do Discord, o servidor precisa de um bot do Discord. O Discord só dá a foto de alguém através de um bot.

  1. Abre o Discord Developer Portal e carrega em New Application (ou usa a aplicação do bot que já tens no teu servidor).
  2. Em Bot, carrega em Reset Token e copia o token.
  3. Mete o bot no teu Discord (OAuth2 → URL Generator, marca bot, sem permissões nenhumas) e abre o link.
  4. No server_config.lua:
lua
ServerConfig.DiscordBotToken = 'o-token-do-bot'

Reinicia o recurso. A foto é pedida quando o jogador entra (no máximo uma vez por dia por jogador) e aparece no perfil público e na ficha do painel. Quem não tiver foto no Discord fica com as iniciais.

Atenção

O token do bot é uma password: fica só no server_config.lua (nunca é enviado aos jogadores nem à BlackShield). Se aparecer na consola "DiscordBotToken inválido", gera um token novo.

#O que é enviado

EnviadoNão é enviado
Nome no jogoIP do jogador
Link da foto do Discord (se tiveres bot)O token do bot
Steam, Discord, license, ID do FiveM e tokens de hardware em hashOs identificadores em claro
Tempo de jogo, kills, mortes, tiros certeiros, headshots, dano, armasChat e comandos
Erro de mira, viragem da câmara e tempo até matarCapturas de ecrã, clipes e replays
Deteções que castigam (tipo e gravidade)Detalhes e provas das deteções e bans
Bans e unbans (deteção, validade, se foi da staff)O motivo escrito pela staff

Não são enviadas as deteções em modo de teste, as da staff com bypass, nem as configuradas para Registar.

Os hashes são SHA-256: o site consegue procurar um jogador pelo Steam ou Discord (faz o mesmo hash ao que se escreve), mas não consegue ler os identificadores, e o perfil nunca os mostra.

#Avisar os jogadores

Como dono do servidor, és responsável pelos dados dos teus jogadores. Põe nas regras ou no Discord uma frase como:

Este servidor usa o anticheat BlackShield. Estatísticas de jogo, deteções e bans são partilhados com a BlackShield Network (blackshieldac.online/players). Os teus identificadores são guardados só em hash.

Cada perfil tem um link para o jogador contestar os dados ou pedir que o perfil deixe de ser público. Ver a política de privacidade.

Precisas de ajuda?

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

Novo ticket