Cómo crear tu primer script de FiveM en Lua

Programar en FiveM empieza con algo muy simple: una carpeta, un manifiesto y un par de archivos Lua. Vamos a crear un recurso que añade un comando.

1. Crea la carpeta

Dentro de resources, crea una carpeta llamada mi_primer_script.

2. El manifiesto

Crea fxmanifest.lua con la versión del manifiesto (fx_version 'cerulean'), el juego (game 'gta5') y la lista de archivos: client_script 'client.lua' y server_script 'server.lua'.

3. Un comando en el cliente

En client.lua registra un comando con RegisterCommand. Dentro, muestra un mensaje en el chat o una notificación. Así compruebas que el cliente carga tu código.

4. Comunicación con el servidor

Los scripts del cliente y del servidor hablan mediante eventos:

• El cliente dispara un evento con TriggerServerEvent.
• El servidor lo escucha con RegisterNetEvent y AddEventHandler.
• Para responder, el servidor usa TriggerClientEvent indicando el jugador.

Recuerda: lo que viene del cliente puede ser manipulado. Valida siempre en el servidor.

5. Actívalo

Añade ensure mi_primer_script en server.cfg o arráncalo desde la consola con ensure. Escribe tu comando en el chat y comprueba el resultado.

Buenas prácticas desde el principio

• Usa nombres de eventos con prefijo propio (mi_script:accion) para evitar choques.
• Evita bucles con Wait(0) si no son imprescindibles.
• Consulta la referencia de nativas de FiveM para saber qué funciones existen.

Con esto ya entiendes la base de cualquier recurso. A partir de aquí, cada script grande es solo más de lo mismo bien organizado.