Geração de scripts FiveM com Claude Code

Esse prompt informa framework, arquivos, comando, regra de permissão e limite de confiança. Isso reduz muito a chance de a AI inventar uma estrutura errada.

Veja o vídeo

O vídeo abaixo mostra o fluxo visual: criar o prompt, gerar o script, revisar o output e iterar com Claude Code.

O que revisar antes de instalar

Nunca coloque uma resource gerada direto em um servidor live. Revise primeiro:

• Limite server/client: dinheiro, inventário, permissões, banco de dados e entrega de items devem ficar no server.
• Nomes de eventos: use eventos com namespace, como fivemx:garage:purchaseVehicle, em vez de nomes genéricos.
• Validação de input: valide IDs de jogadores, items, modelos de veículos, quantidades, preços e chaves de config.
• Permissões: ferramentas admin precisam usar ACE, grupos do framework ou seu sistema admin atual.
• Dependências: confirme que cada export existe na sua versão de QBCore, ESX, ox_lib, ox_inventory ou oxmysql.
• Performance: evite loops a cada frame se eles não forem realmente necessários.
• Falhas: a resource deve falhar de forma clara quando um player desconecta, uma query falha ou uma dependência está ausente.

Prompt para melhorar uma resource existente

Claude Code costuma ser melhor melhorando código existente do que inventando um sistema completo do zero. Cole os arquivos relevantes e peça um patch pequeno:

Review this FiveM Lua resource for production issues.
Find security bugs, duplicated logic, missing nil checks, and server/client trust problems.
Do not rewrite the whole resource.
Return a minimal patch and explain why each change matters.

Assim o resultado continua fácil de revisar. Você aplica uma correção, reinicia a resource e testa o comportamento antes de continuar.

Informe a stack real do servidor

A maioria dos scripts FiveM ruins gerados por AI falha porque o modelo não conhece a stack real do seu servidor. "Faça um script QBCore" não basta. Um servidor maduro pode usar QBCore para players, ox_inventory para items, ox_lib para notificações, oxmysql para persistência, uma resource admin própria para permissões e webhook Discord para logs da staff.

Coloque esse contexto antes da geração:

Server stack:
- Framework: QBCore
- Inventory: ox_inventory, not qb-inventory
- Database: oxmysql
- Notifications: ox_lib notify
- Permissions: ACE group.admin
- Logging: send Discord webhook only from server.lua
- Locale files: locales/en.lua and locales/de.lua

Com isso, Claude Code evita misturar APIs incompatíveis. Sem contexto, ele pode chamar Player.Functions.AddItem mesmo que seu servidor espere exports.ox_inventory:AddItem, ou usar um evento de notificação que não existe na sua instalação.

Divida features em partes revisáveis

Não peça "um sistema completo de garagem" em um único prompt. Peça uma parte por vez:

1. estrutura da resource e config
2. comando de teste apenas para admins
3. validação server-side para uma ação
4. persistência no banco
5. marker ou menu no client
6. logs e mensagens de erro
7. limpeza e refactor

Esse fluxo parece mais com desenvolvimento real. Se a etapa do banco estiver errada, você corrige antes de misturar UI, permissões e logging no mesmo patch.

Erros comuns de AI em Lua para FiveM

Procure especialmente por estes padrões:

• confiar em source ou player ID enviado pelo client
• aceitar preços, items ou recompensas vindos de eventos client
• guardar estado do servidor via TriggerClientEvent
• criar variáveis globais em vez de estado local
• esquecer local antes de funções helper
• usar exports de framework sem checar a ordem de inicialização
• criar loops infinitos com Wait(0) quando um evento resolveria
• armazenar identifiers de jogadores em formatos inconsistentes
• não ter rollback quando uma escrita no banco funciona, mas a ação seguinte falha

Esses problemas não tornam a AI inútil. Eles só significam que código gerado precisa da mesma revisão que você daria a um pull request de um desenvolvedor júnior.

Usando AI para debugging

Claude Code não serve apenas para geração. Muitas vezes ele é mais útil quando algo quebra. Copie o erro exato, a função relevante e a ação executada:

This error appears when I run /givegaragevehicle:
[script:garage_ai] attempt to index a nil value (local 'Player')

Here is the command handler and the framework initialization.
Explain the likely root cause and give a minimal fix.
Do not rewrite unrelated files.

Esse formato faz o modelo partir do log em vez de adivinhar. Ele pode apontar player desconectado, variável source errada, QBCore inicializado tarde demais ou export diferente na sua versão.

Limites de produção

Seja mais rígido com:

• pagamentos, Tebex ou automação de doações
• entrega de items
• ferramentas admin
• comandos de ban, kick, jail, whitelist ou staff
• transferência de dinheiro e banking
• migrações de banco
• lógica anticheat
• resources que expõem endpoints HTTP

Nesses casos, exija revisão manual e plano de rollback. Registre ações da staff. Mantenha comandos admin no server. Um evento client nunca deve decidir quem recebe dinheiro, veículo, arma ou permissão.

Checklist de teste local

Antes de liberar o script para jogadores:

1. Inicie a resource com a console limpa e procure erros Lua.
2. Teste o fluxo normal com um player.
3. Teste inputs inválidos: argumentos ausentes, IDs errados, valores negativos, items desconhecidos e veículos indisponíveis.
4. Teste falha de permissão com uma conta sem admin.
5. Reinicie a resource enquanto um player está conectado.
6. Acompanhe resmon para detectar CPU anormal.
7. Verifique as linhas do banco se a resource grava dados persistentes.

Perguntas frequentes

AI consegue gerar um script FiveM completo?

Sim, mas completo não significa pronto para produção. AI consegue criar uma pasta de resource com manifest, arquivo client, arquivo server, config e comandos básicos. O risco não está em criar arquivos; está no comportamento em um servidor real. Um script de produção precisa de permissões, compatibilidade com framework, tratamento de erros, segurança no banco de dados, localização, logs e um caminho claro de atualização.

Para ferramentas simples, o resultado pode precisar só de limpeza leve. Para economia, inventário, admin ou sistemas com persistência, trate o código gerado como protótipo e revise manualmente cada ação server-side.

Claude Code é melhor que um prompt de chat comum?

Claude Code é melhor quando a resource já existe em uma pasta de projeto, porque ele pode trabalhar com arquivos, sugerir patches e manter contexto entre arquivos relacionados. Um chat comum serve para ideias, explicações ou snippets pequenos. Para trabalho real em FiveM, contexto de arquivo importa: fxmanifest.lua, configs, exports existentes, helpers de banco e convenções de nomes.

Devo deixar AI editar arquivos do servidor live?

Não. Mantenha mudanças assistidas por AI em uma cópia local ou branch git. Teste primeiro em servidor de desenvolvimento. Arquivos live geralmente têm dados de produção, estado ativo de players e ordem frágil de dependências. Um script gerado com erro pode poluir a console, duplicar items, corromper estado ou expulsar jogadores se tocar em lógica admin.

Qual é um bom primeiro projeto AI para FiveM?

Comece com uma ferramenta de baixo risco: comando debug apenas para staff, validador de config, teste de notificação ou uma pequena resource que lê dados sem alterar dinheiro, inventário ou permissões. Quando confiar no workflow, avance para scripts que escrevem estado.

Como saber se o Lua gerado é bom?

Lua bom é previsível. Usa local, valida inputs, retorna cedo em falhas, registra ações importantes, separa config de lógica e mantém eventos client pequenos. Se um script é difícil de explicar, tem muitas variáveis globais ou deixa o client decidir recompensas, ele precisa ser refeito antes da produção.

Conclusão

Geração de scripts FiveM com AI é um acelerador, não um atalho para produção sem revisão. Use Claude Code para criar base, explicar e refatorar. Mantenha cada mudança pequena. Revise cada evento e cada limite de permissão. Teste sempre em um servidor de desenvolvimento antes de tocar na produção.

Usado dessa forma, Claude Code economiza horas de trabalho Lua repetitivo sem tirar de você o controle sobre a experiência real dos jogadores.