Scripting no FiveM: recursos, fxmanifest, eventos e a skill de IA

O scripting no FiveM começa pelos recursos: pastas que contêm um fxmanifest.lua e os scripts de cliente, servidor e compartilhados que formam uma funcionalidade. Cada framework, script de emprego ou interface de um servidor é um recurso, então essas bases valem para qualquer pessoa que programe para FiveM. Esta página explica o que a skill de fundamentos do FiveM da FiveAI documenta, os erros que impedem um recurso de iniciar e como instalar a skill no seu assistente de IA.

O que a skill de fundamentos do FiveM te dá

A skill é um arquivo SKILL.md com um arquivo de regras por tema:

• structure: como organizar um recurso, separação entre cliente e servidor, agrupamento lógico e nomes.
• fxmanifest: as chaves do manifesto que importam: fx_version, game, client_scripts, server_scripts, shared_scripts, files e dependencies.
• client-server: o que roda em cada lado, código compartilhado e os padrões de comunicação entre os dois.
• events: RegisterNetEvent, TriggerServerEvent, TriggerClientEvent, convenções de nomes e segurança.
• exports: como definir um export e chamar a partir de outro recurso.
• debugging: o console do servidor versus o console F8 do cliente, e quando pedir os logs do F8 se o servidor não mostra nada.
• optimization: locais, tempo dos loops, cache de PlayerPedId(), distância com vetores, state bags e estrutura de pastas.
• reference-links: a documentação oficial em https://docs.fivem.net/docs/ e a referência de natives em https://docs.fivem.net/natives/.

Use a skill sempre que criar ou editar um recurso, não importa qual framework roda em cima.

Erros comuns com recursos do FiveM

• fx_version ou game ausentes ou errados no fxmanifest.lua. Sintoma: o recurso não inicia e o console do servidor imprime um erro de manifesto. Correção: declare fx_version 'cerulean' e game 'gta5' no início do manifesto e depois liste seus scripts.
• Lógica de servidor em um arquivo de cliente. Sintoma: uma consulta ao banco de dados ou um native exclusivo de servidor roda no cliente, falha ou expõe dados para todos os jogadores. Correção: mantenha tudo que toca banco de dados, dinheiro ou permissões em server_scripts e envie resultados ao cliente por eventos.
• RegisterNetEvent sem handler, ou nomes de handler que não batem com o trigger. Sintoma: o evento dispara e nada acontece, sem erro em nenhum console. Correção: registre o evento e adicione o handler com a mesma string, e use um prefixo de recurso como meurecurso:server:fazerAlgo para os nomes nunca colidirem.
• Ordem de ensure errada no server.cfg. Sintoma: um recurso inicia antes do framework ou da biblioteca de que precisa, então os exports dela são nil na carga. Correção: adicione dependency 'ox_lib' (ou dependencies { ... }) no fxmanifest.lua e faça o ensure da dependência antes no server.cfg.
• Loops pesados while true do Wait(0) end e globais por toda parte. Sintoma: tempo alto de recurso no resmon e colisões de nomes entre scripts. Correção: use um Wait mais longo quando não há nada por perto, cacheie PlayerPedId() fora do loop, compare distâncias com vetores e declare variáveis com local.

Por que os assistentes de IA erram com FiveM

Um assistente genérico não sabe a qual lado da rede um native pertence, então chama natives de cliente no servidor, inventa exports que um recurso nunca teve e escreve manifestos de memória com um fx_version desatualizado ou sem a linha game. Também recorre à sintaxe de eventos mais antiga dos dados de treinamento e raramente adiciona um prefixo de recurso aos nomes de eventos.

A skill dá a ele uma referência curta para cada uma dessas áreas: as chaves do manifesto, a separação entre cliente e servidor, as funções de eventos com suas regras de nomes e segurança, o padrão de exports e a orientação de otimização. Também manda o assistente consultar a referência de natives em docs.fivem.net em vez de adivinhar a assinatura de um native, e pedir os logs do F8 quando um bug de cliente deixa o console do servidor limpo. É isso que transforma um script plausível em um que inicia e funciona.

Instale a skill de fundamentos do FiveM em 30 segundos

1. Clique em "Download SKILL.md" no topo desta página.
2. Descompacte na pasta de skills ou regras da sua ferramenta de IA. A seção de instalação abaixo mostra o caminho exato para Claude Code, Cursor e VS Code.
3. Peça ao assistente algo concreto, como um recurso com um evento de servidor e um comando de cliente, e confira se o manifesto tem fx_version e game e se os nomes dos eventos batem nos dois lados.