Instalação
Monte um servidor AI Core com o txAdmin em poucos minutos, ou à mão.
Requisitos
| Dependência | Versão | Para quê |
|---|---|---|
| FXServer (artifact) com txAdmin | 38039 ou mais recente | O ai-core precisa dele: o próprio servidor vê a morte dos jogadores. |
| MariaDB (ou MySQL) | mais recente | O banco de dados. O AI Core cria suas próprias tabelas. |
| Bun | mais recente | Só para alterar ou compilar scripts. Cada script já vem com seu build, então rodar um servidor não precisa de ferramentas de build. |
Instalar com o txAdmin (recomendado)
Inicie o txAdmin
Baixe o artifact mais recente do FXServer e inicie: o txAdmin abre no seu navegador. Siga o guia oficial até a etapa de implantação.
Use a receita do AI Core
Escolha Popular Recipes > Remote URL Template e cole:
https://raw.githubusercontent.com/aicore8/aicore-server/main/recipe/ai-core.yamlPreencha os dados
Digite o nome do seu servidor, sua chave de licença do portal.cfx.re e o banco de dados. A receita escreve server.cfg e env.cfg, conecta o banco de dados e baixa cada script ai-*. Não há arquivo SQL para importar: o AI Core e os scripts criam e atualizam suas próprias tabelas na primeira inicialização.
Torne-se administrador
Entre no servidor. Um cartão de boas-vindas mostra a linha que torna você administrador: adicione-a ao permission.cfg e reinicie. Depois aperte F10 para abrir o painel de administração; o guia de configuração dele leva você pelas primeiras configurações.
O nome, a descrição, as tags, o idioma, os banners e o link do Discord da lista de servidores são configurados em portal.cfx.re/servers, não no server.cfg.
Instalar à mão
Pegue a pasta do servidor
Baixe a pasta do servidor (os arquivos cfg, recipe/, tools/, template/). Para cada script ai-*, baixe <name>.zip da release mais recente dele no GitHub e descompacte em resources/[ai]/. Para só os arquivos que o servidor roda, sem o código-fonte, use <name>-runtime.zip no lugar.
Configure os segredos
Copie env.example.cfg para env.cfg, preencha sua chave de licença e a conexão com o banco de dados, depois crie o banco de dados.
Inicie o servidor
Inicie o FXServer (txAdmin) com esta pasta como pasta de dados do servidor.
Estrutura
| Caminho | O quê |
|---|---|
server.cfg | A lista de recursos e os includes de config. |
env.cfg | Licença, slots, endpoints, banco de dados, RCON. Específico da máquina, nunca no git. |
security.cfg | Configurações de segurança do FiveM rígidas. Nunca as afrouxe: cada script é escrito para elas. |
permission.cfg | Administradores e permissões ACE. |
misc.cfg | Idioma e outras convars compartilhadas. |
resources/[ai]/ | Os scripts do AI Core, uma pasta por script ai-*. |
resources/[standalone]/ | Recursos de terceiros que você adiciona. |
packages/ | Os pacotes @aicore8/* (desenvolvedores). |
template/ | Modelo para novos scripts: bun run new <name> "<description>". |