Lua para FiveM: o básico, erros comuns e a skill de IA

Lua para FiveM é uma linguagem pequena com algumas arestas afiadas, e a maioria dos recursos quebrados tropeça nessas arestas, não na API do FiveM. Arrays começam em 1, nil e false são coisas diferentes, não existe continue nem operador ternário. Se você escreve ou revisa recursos em Lua, ou deixa um assistente de IA escrevê-los, precisa dessas regras na sua frente. A skill de Lua básico empacota tudo em arquivos de regras que o assistente lê antes de escrever código.

O que a skill de Lua básico te dá

O SKILL.md é um índice. Cada tema tem o seu próprio arquivo de regras com explicações e exemplos.

• rules/functions.md. Tamanho de funções, nomes, parâmetros, exports e guard clauses. Funções curtas que retornam cedo em vez de aninhar.
• rules/tables.md. Índices de array começam em 1, desreferenciação, evitar table.insert em caminhos quentes, iteração com ipairs e pairs, e tamanho de array com #.
• rules/variables.md. Nomes para constantes, locais em vez de globais, e quando um enum se lê melhor que um booleano.
• rules/conditionals.md. Valores padrão com or, expressões booleanas e legibilidade.
• rules/errors.md. Asserções, pré-condições, erros como valores e falhar em voz alta em vez de engolir problemas.
• rules/reference-links.md. Documentação oficial de Lua e FiveM, incluindo docs.fivem.net.

Erros comuns com Lua para FiveM

• Globais acidentais. Um local faltando transforma a variável em uma global compartilhada por todos os arquivos do recurso. Sintoma: valores vazando entre scripts, um contador de um arquivo mudando em outro, e acesso mais lento que com locais. Correção: declare tudo com local e trate uma atribuição sem local como bug.
• Indexar a partir de 0. players[0] é nil e um loop for i = 0, #players começa em um slot vazio. Sintoma: a primeira entrada é pulada ou o código falha na iteração zero. Correção: comece em 1 e itere com ipairs.
• Usar # na tabela errada. #t só está definido para uma sequência sem buracos. Ele ignora chaves de texto e, com buracos, o resultado é imprevisível. Correção: mantenha um contador separado ou itere com pairs quando as chaves não forem 1..n.
• Confundir false com nil. if x then falha tanto com nil quanto com false. Se false é um valor válido, um padrão como x = x or true sobrescreve em silêncio. Correção: escreva if x ~= nil then quando false importa, e cuidado com a and b or c quando b pode ser false.
• Tratar Lua como JavaScript. Não existe != (use ~=), não existe continue (use goto continue ou reestruture), não existe ternário. Montar strings grandes com .. dentro de loops cria uma string nova a cada passo. Correção: use table.concat para saídas grandes e escreva condicionais do jeito Lua.

Por que assistentes de IA erram em Lua para FiveM

Um assistente genérico escreve Lua com a memória muscular de JavaScript e Python. Ele esquece local, começa loops em 0, usa !=, inventa um continue e recorre a a and b or c como ternário sem perceber o caso de false. Também chama table.insert dentro de loops quentes do servidor porque é o que todo tutorial faz. O código costuma rodar e falhar depois, em silêncio, sob carga.

A skill de Lua básico entrega ao assistente os cinco arquivos de regras e manda ler o que combina com a tarefa. Funções ganham guard clauses e corpos curtos, tabelas usam loops a partir de 1 com ipairs, variáveis são locais por padrão e erros aparecem por meio de asserções e pré-condições em vez de serem ignorados. O resultado se lê como Lua escrito por alguém que trabalha com FiveM todo dia, e isso torna a revisão muito mais fácil.

Instale a skill de Lua básico em 30 segundos

1. Clique em "Download SKILL.md" no topo desta página.
2. Descompacte na pasta de skills ou rules 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 "escreva uma função que retorne os jogadores a menos de 10 metros de uma coordenada", e confira que toda variável é local, que o loop usa ipairs e que a função retorna cedo com entrada inválida.