Conserte e construa seu servidor FiveM conversando com um agente

A maioria dos problemas de um servidor FiveM começa do mesmo jeito. Algo quebra depois de um restart, você abre o console e fica olhando para uma linha vermelha que não entende. O FiveAI coloca um agente nesse lugar. Você descreve o problema em um chat ("o script de garagem quebrou depois do último restart") e o agente lê os arquivos e o console do seu servidor, encontra a causa, edita o recurso, reinicia e conta o que mudou. Este post mostra a instalação e o que esperar quando tudo estiver rodando.

O que você precisa

• Um servidor FiveM que você controle, em um PC com Windows ou em uma máquina Linux.
• Uma conta do ChatGPT. O FiveAI roda o Codex com o seu próprio plano do ChatGPT, então você não precisa de outra conta de IA.

O FiveAI aceita um servidor FiveM por conta.

Como as peças se encaixam

O app web e o seu servidor não conversam diretamente. Um programa pequeno chamado listener roda na máquina onde o seu servidor FiveM roda. Ele acompanha o console, mantém a conexão com o app e executa o agente quando você envia uma mensagem. No app você conversa e vê o que acontece.

O agente é o Codex, o agente de programação da OpenAI, incluído no listener em uma versão fixa. Ele entra com a sua conta do ChatGPT, não com uma chave que guardamos.

Passo 1: instale o listener

Abra a página de instalação do app. Ela mostra um comando por sistema operacional. Inicie primeiro o seu servidor FiveM e cole o comando na máquina em que ele roda.

Windows. Abra o PowerShell e cole o comando do install.ps1. O Windows pede permissão para executar como administrador. Aceite. O instalador cria um usuário dedicado FiveAI e uma pasta protegida, e inicia o listener com esse usuário quando o PC liga. Se você recusar, a instalação continua, mas só para o seu usuário. Ele inicia quando você faz login e o agente consegue ler as credenciais do FiveAI. Aceite, a menos que tenha um motivo para não fazer isso.

Linux. Cole o comando do install.sh em um terminal. Ele usa sudo, então pede a sua senha. Detecta o txAdmin e o FXServer, cria um usuário de sistema fiveai e configura um serviço do systemd. O sandbox do agente precisa de user namespaces sem privilégio. No Ubuntu 24.04 essa opção vem desativada e, se estiver bloqueada, o instalador mostra o comando exato que você deve rodar.

Rodar o mesmo comando depois atualiza o listener. Ao terminar, o instalador mostra um código de pareamento.

Passo 2: pareie o servidor

De volta ao app, você chega à etapa "Connect your server". Dê um nome ao servidor e depois:

Enter the 8-character code shown on your server.

Ou seja, digite o código de 8 caracteres que o seu servidor mostra e clique em Connect server. O app cria uma conta dedicada para esse único servidor e a entrega ao listener uma só vez. A partir daí o listener entra com essa conta e não tem as chaves do resto do sistema.

No Windows, o instalador também pode abrir o app com o código já preenchido, então talvez você só precise confirmar o nome.

Passo 3: conecte o ChatGPT

A próxima etapa é Connect ChatGPT. O app pede ao seu listener que inicie um login no ChatGPT e mostra duas coisas:

1. Um botão que abre a página de login do ChatGPT.
2. Um código curto para digitar lá.

Termine o login e o app percebe sozinho. A OpenAI pode avisar que o código foi compartilhado por um site. Ele é seguro: o seu próprio servidor o solicitou quando você clicou no botão. O FiveAI nunca vê a sua senha do ChatGPT.

Passo 4: descreva o problema

Agora você tem uma caixa de chat e alguns exemplos de mensagem (em inglês no app):

• "What resources does my server have?"
• "Are there any errors in the console?"
• "Create a /heal command that heals the player"

Você pode escrever em português. Não precisa citar arquivos. Uma mensagem como "os jogadores não conseguem abrir a loja desde que atualizei" já basta para começar.

O que o agente faz

O agente trabalha dentro da sua pasta server-data, a que tem server.cfg e resources/. Além de ler e escrever arquivos, ele tem três ferramentas:

• fx console mostra a saída mais recente do console.
• fx restart <recurso> reinicia um recurso e informa se iniciou ou falhou.
• fx sql lê e altera o seu banco de dados. O agente olha primeiro as tabelas reais em vez de supor como o seu framework as organiza.

Ele segue algumas regras que importam para um dono de servidor:

• Investiga antes de editar. Lê primeiro o console e os arquivos relevantes.
• Funcionalidades novas vão em um recurso novo. Cria uma pasta em resources/[fiveai]/ e adiciona uma linha ensure ao server.cfg, então os seus scripts atuais ficam intactos.
• Pergunta antes de mudar o que já existe. Se você pede três ranks de mecânico e o job tem cinco, ele diz quais dois removeria e espera o seu sim.
• Pergunta antes de mexer no banco de forma destrutiva. Apagar, truncar, remover tabelas e fazer atualizações em massa exigem a sua confirmação, e ele mostra as linhas que uma escrita alteraria.
• Confere o que caiu com um restart. Reiniciar um recurso para os que dependem dele, então o agente confere o console depois e inicia de novo o que parou.

Ele responde em palavras simples e no idioma em que você escreveu: o que encontrou ou consertou, quais arquivos tocou e o que você deve conferir em seguida.

O sandbox e o console ao vivo

O agente não tem liberdade total. O Codex roda em um sandbox, com permissão de escrita só na sua pasta server-data (ele pode baixar scripts da internet, mas não altera nada fora dela). Ele não circula pelo resto da sua máquina.

Na parte de baixo do workspace você vê o console ao vivo do servidor, a mesma saída que veria no txAdmin. Quando o agente reinicia um recurso, as linhas aparecem em tempo real. Se o agente diz que consertou algo e o console diz outra coisa, você percebe na hora.

Onde ajuda e onde você manda

Um agente que pode editar o seu servidor é útil e também um risco real, então trate-o como um ajudante rápido que é novo no seu projeto.

• Revise o que mudou. O agente diz quais arquivos tocou. Abra-os. Nosso post sobre por que o ChatGPT escreve scripts FiveM quebrados lista o que conferir.
• Faça backups. Coloque resources/ no git e exporte o banco antes de mudanças grandes. O agente pergunta antes de passos destrutivos no banco, mas um backup cobre os erros que ninguém previu.
• Teste primeiro em um servidor de desenvolvimento. Tudo que mexe com dinheiro, jobs ou itens merece um teste longe dos seus jogadores.
• Seja específico quando importar. Diga qual framework você usa (ESX, QBCore ou Qbox) e qual recurso quer dizer. O agente carrega skills de FiveM para isso, mas não consegue adivinhar um script pago que nunca viu.
• Algumas coisas continuam com você. Se o problema está fora da pasta server-data, por exemplo uma porta fechada no roteador, o agente pode dizer o que mudar, mas não consegue fazer isso por você.

Se o seu servidor não inicia de jeito nenhum, comece pelo nosso guia de erros de inicialização do txAdmin. Quando o console voltar a mostrar saída, o agente continua a partir daí.

Se você está comparando opções, nosso comparativo de ferramentas de IA para FiveM mostra onde cada uma acerta e onde falha.

Perguntas frequentes

Preciso saber programar?

Não. O agente foi pensado para donos de servidor que não programam e explica os termos na primeira vez que os usa. Mesmo assim, você precisa ler os resumos dele e testar o resultado no jogo.

Funciona com ESX, QBCore e Qbox?

O agente carrega skills de FiveM, Lua, ESX, QBCore, ox_lib, oxmysql, banco de dados, NUI, segurança e Fivemanage quando uma tarefa precisa delas. Diga qual framework você usa para ele partir da API certa.

A minha senha do ChatGPT passa pelo FiveAI?

Não. O login acontece na página do ChatGPT, com um código que o seu listener solicitou. O FiveAI nunca vê a sua senha.

Posso usar em mais de um servidor?

Cada conta conecta um servidor FiveM.