Instalação

Do download ao servidor protegido em 5 minutos.

#Antes de começar

Servidor FiveM com OneSync ligado (set onesync on).
oxmysql a correr (as tabelas do BlackShield criam-se sozinhas).
QBCore, Qbox, ESX ou standalone — o BlackShield deteta o framework sozinho.
A tua chave de licença (está no painel, no formato BS-XXXX-XXXX-XXXX-XXXX).

#1. Descarregar

O recurso é entregue pela Cfx.re: entra em portal.cfx.re com a mesma conta Cfx.re que usaste no pagamento e descarrega o blackshield em Granted Assets.

#2. Colocar no servidor

Põe a pasta blackshield dentro de resources (pode ser numa subpasta como [seguranca]).

#3. Chave de licença

Abre blackshield/server_config.lua e mete a tua chave:

server_config.lua

ServerConfig.LicenseKey = 'BS-XXXX-XXXX-XXXX-XXXX'

Nota

A licença fica presa ao primeiro servidor que a usar (IP). Para a passar para outro servidor, usa Mudar de servidor no painel (uma vez por dia).

#4. server.cfg

Arranca o BlackShield logo a seguir ao oxmysql, antes dos teus scripts:

server.cfg

ensure oxmysql
ensure blackshield

# acesso da staff (os grupos de admin do framework já entram)
add_ace group.admin blackshield allow

#5. Primeiro arranque

Reinicia o servidor. Na consola deves ver:

text

BlackShield v1.x
Licença validada

Dica

Primeira semana: liga o Modo de teste (Config.TestMode = true ou no painel → Configuração → Definições). As deteções só ficam nos registos, ninguém é castigado, e afinas os limites ao teu servidor. Depois desliga.

#6. Abrir o painel

No jogo: comando /ac.
No browser: https://<o-teu-servidor>.users.cfx.re/blackshield/ — na primeira vez cria a conta root com o código que aparece na consola.

#Opcional

screenshot-basic — capturas de ecrã antes de cada ban, clipes de prova e no painel.
Safe Events — proteção extra dos eventos de todos os teus recursos. Ver Safe Events.

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