Configurando tu servidor FiveM: clave de licencia, server.cfg y recursos

Un servidor FiveM necesita tres cosas para funcionar: una clave de licencia Cfx.re gratuita, un server.cfg funcional y tus recursos (scripts, mapas y frameworks). Esta guía te ayudará a configurar las tres correctamente para que tu servidor arranque y aparezca en la lista de servidores.

1. Genera una clave de licencia Cfx.re

Cada servidor FiveM necesita una clave de licencia del keymaster de Cfx.re; es gratuita.

1. Ve a keymaster.fivem.net e inicia sesión con tu cuenta de Cfx.re (Foro).
2. Haz clic en New server key / Register.
3. Para la IP, puedes registrar una clave con la IP de tu servidor o generar una clave no listada (suficiente para la mayoría de las configuraciones). Nota: una clave está ligada a cómo la registras, por lo que si alguna vez cambias de servidor, es posible que necesites una nueva clave.
4. Copia la clave; parece una cadena larga y aleatoria.

2. Añade la clave a server.cfg

1. Abre tu servidor y haz clic en File Manager.

2. Abre server.cfg en la raíz.

3. Busca la línea sv_licenseKey (o añade una) y pega tu clave:

   sv_licenseKey your_key_here
   

4. Guarda y reinicia desde la pestaña Console.

Sin una clave válida, la consola imprimirá Invalid license key y el servidor no se conectará.

3. Entiende server.cfg

server.cfg es el corazón de tu servidor. Las líneas que más tocarás:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My ServerPrism FiveM Server"
sv_maxclients 32
sets locale "en-US"

# Load resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure my-custom-resource

sv_licenseKey your_key_here

• sv_hostname — el nombre de tu servidor en el navegador de servidores de FiveM.
• sv_maxclients — ranuras de jugadores (hasta 48 en compilaciones predeterminadas).
• ensure <name> — inicia un recurso al arrancar. Así es como habilitas los scripts.

No cambies el puerto del endpoint a menos que conozcas tu asignación. El puerto de juego de FiveM está configurado por tu asignación de ServerPrism; el 30120 predeterminado es correcto para la mayoría de los servidores. Consulta la pestaña Startup/Network si no estás seguro.

4. Añade recursos

Los recursos (scripts, mapas, frameworks como ESX o QBCore) van en la carpeta resources/.

1. Sube la carpeta del recurso a resources/ a través del File Manager o SFTP (SFTP es mejor para frameworks grandes; consulta File Manager & SFTP).
2. Añade una línea ensure <resource-name> a server.cfg para cada uno que quieras ejecutar.
3. Reinicia. Observa la consola: cada recurso imprime Started resource <name> cuando se carga.

Para un framework de roleplay completo, instala sus recursos base en el orden especificado en su documentación (normalmente una base de datos + el framework principal primero, luego los scripts dependientes).

Bases de datos (ESX/QBCore)

Los frameworks de roleplay necesitan una base de datos MySQL. Crea una en la pestaña Databases y apunta la configuración del framework (normalmente a través de mysql_connection_string en server.cfg o un archivo de configuración del framework) a las credenciales. Consulta Crear y conectar a una base de datos MySQL.

Particularidad de la base de datos en el mismo nodo: si tu base de datos y tu servidor FiveM están en el mismo nodo y el framework no puede conectarse a través de la IP pública, abre un ticket de soporte; este es un caso de red conocido que podemos solucionar rápidamente conectando los contenedores.

Problemas comunes

• Invalid license key: la clave es incorrecta, ha caducado o está registrada con una IP diferente; vuelve a generarla en keymaster.
• Servidor no aparece en el navegador: todavía está arrancando, sv_hostname no está configurado o un recurso está dando error; lee la consola para encontrar el primer error.
• Un recurso no se inicia: revisa la consola para encontrar la primera línea de error debajo de ese recurso; generalmente es una dependencia faltante o una base de datos a la que no puede acceder.
• Errores de ghmattimysql/oxmysql: la cadena de conexión de la base de datos es incorrecta; copia las credenciales de nuevo desde la pestaña Databases.

¿Sigues atascado?

Abre un ticket de soporte con la primera línea de error de tu consola y el recurso que menciona. Podemos investigar la configuración directamente en el nodo.