Lua para FiveM: lo básico, errores comunes y la skill de IA

Lua para FiveM es un lenguaje pequeño con unas pocas aristas afiladas, y la mayoría de los recursos rotos tropiezan con esas aristas y no con la API de FiveM. Los arrays empiezan en 1, nil y false son cosas distintas, no hay continue ni operador ternario. Si escribes o revisas recursos en Lua, o dejas que un asistente de IA los escriba por ti, necesitas estas reglas delante. La skill de Lua básico las empaqueta en archivos de reglas que el asistente lee antes de escribir código.

Qué te da la skill de Lua básico

El SKILL.md es un índice. Cada tema tiene su propio archivo de reglas con explicaciones y ejemplos.

• rules/functions.md. Tamaño de funciones, nombres, parámetros, exports y guard clauses. Funciones cortas que retornan pronto en vez de anidar.
• rules/tables.md. Los índices de array empiezan en 1, desreferenciar, evitar table.insert en rutas calientes, iterar con ipairs y pairs, y el tamaño de array con #.
• rules/variables.md. Nombres para constantes, locales antes que globales, y cuándo un enum se lee mejor que un booleano.
• rules/conditionals.md. Valores por defecto con or, expresiones booleanas y legibilidad.
• rules/errors.md. Aserciones, precondiciones, errores como valores y fallar ruidosamente en vez de tragarse los problemas.
• rules/reference-links.md. Documentación oficial de Lua y FiveM, incluida docs.fivem.net.

Errores comunes con Lua para FiveM

• Globales accidentales. Un local que falta convierte la variable en una global compartida por todos los archivos del recurso. Síntoma: valores que se filtran entre scripts, un contador de un archivo que cambia en otro, y accesos más lentos que con locales. Solución: declara todo con local y trata una asignación sin local como un bug.
• Indexar desde 0. players[0] es nil y un bucle for i = 0, #players arranca en un hueco vacío. Síntoma: se salta la primera entrada o el código falla en la iteración cero. Solución: empieza en 1 e itera con ipairs.
• Usar # en la tabla equivocada. #t solo está definido para una secuencia sin huecos. Ignora las claves de texto y con huecos el resultado es impredecible. Solución: lleva un contador aparte o itera con pairs cuando las claves no son 1..n.
• Confundir false con nil. if x then falla tanto con nil como con false. Si false es un valor válido, un valor por defecto como x = x or true lo pisa en silencio. Solución: escribe if x ~= nil then cuando false importa, y cuidado con a and b or c cuando b puede ser false.
• Tratar Lua como JavaScript. No hay != (usa ~=), no hay continue (usa goto continue o reestructura), no hay ternario. Construir cadenas grandes con .. dentro de bucles crea una cadena nueva en cada paso. Solución: usa table.concat para salidas grandes y escribe los condicionales a la manera de Lua.

Por qué los asistentes de IA fallan con Lua para FiveM

Un asistente genérico escribe Lua con la memoria muscular de JavaScript y Python. Omite local, arranca bucles en 0, usa !=, se inventa un continue y recurre a a and b or c como ternario sin ver el caso de false. También llama a table.insert dentro de bucles calientes del servidor porque eso hace cada tutorial. El código suele correr y fallar más tarde, en silencio, bajo carga.

La skill de Lua básico le da al asistente los cinco archivos de reglas y le indica que lea el que encaja con la tarea. Las funciones llevan guard clauses y cuerpos cortos, las tablas usan bucles desde 1 con ipairs, las variables son locales por defecto y los errores salen a la luz con aserciones y precondiciones en vez de ignorarse. El resultado se lee como Lua escrito por alguien que trabaja en FiveM a diario, y eso hace que revisarlo sea mucho más fácil.

Instala la skill de Lua básico en 30 segundos

1. Haz clic en "Download SKILL.md" en la parte superior de esta página.
2. Descomprímelo en la carpeta de skills o rules de tu herramienta de IA. La sección de instalación de abajo muestra la ruta exacta para Claude Code, Cursor y VS Code.
3. Pídele al asistente algo concreto, como "escribe una función que devuelva los jugadores a menos de 10 metros de una coordenada", y comprueba que cada variable es local, que el bucle usa ipairs y que la función retorna pronto con entradas inválidas.