Cómo conectar mi servidor de FiveM a la base de datos Imprimir

Con esta guía conectás tu servidor de FiveM a una base de datos creada en el panel de juegos. Se hace cargando los datos de la base en la configuración del servidor.

Te conviene usar una base del panel y no una que tengas en tu PC: así tu servidor no depende de que tu computadora esté prendida y conectada.

Antes de empezar

• Necesitás una base creada en la pestaña Databases de tu servidor. Si todavía no la tenés, seguí la guía Cómo crear una base de datos para mi servidor de juegos.
• Si tu framework o tus scripts traen un archivo .sql, o tenés datos de un servidor anterior, importalos primero en la base. Los pasos están en Importar base de datos.

Dónde ver los datos de tu base

En https://gpanel.neatech.ar, entrá a tu servidor y abrí Databases. Para cada base vas a ver:

• Nombre: el panel le pone adelante un prefijo del tipo s123_. Usalo completo, con ese prefijo.
• Endpoint: el host y el puerto, separados por dos puntos. Lo que está antes de los dos puntos es el host y el número de después es el puerto.
• Username: el usuario.
• Password: la contraseña. La ves tocando el ojo de la base.

Conectar tu servidor

1. Apagá el servidor desde la Terminal. Hacé estos cambios siempre con el servidor apagado.
2. En Startup, fijate cómo está la variable USAR TXADMIN?. Si está en 0, abrí Files y, en la carpeta principal, el archivo server.cfg. Si está en 1 (txAdmin activado), tu servidor arranca con el .cfg que elegiste al configurar txAdmin, que puede no ser ese server.cfg: abrí ese archivo desde Files. Si no sabés cuál es, abrí un ticket y te lo indicamos.
3. Buscá la línea set mysql_connection_string. Si no está, agregala arriba de todo. Tiene que estar antes de las líneas ensure o start, porque el script de base de datos lee ese dato al arrancar. El formato lo define ese script. Si usás oxmysql, su documentación está en https://overextended.dev/docs/oxmysql. Los dos más comunes son:
   • set mysql_connection_string "user=USUARIO;password=CONTRASEÑA;host=HOST;port=PUERTO;database=BASE;charset=utf8mb4"
   • set mysql_connection_string "mysql://USUARIO:CONTRASEÑA@HOST:PUERTO/BASE?charset=utf8mb4"
4. Reemplazá USUARIO, CONTRASEÑA, HOST, PUERTO y BASE por los datos de tu base. Copiá el host y el puerto de Endpoint tal cual. No dejes localhost ni 127.0.0.1: dentro de tu servidor apuntan a tu propio servidor, no a la base.
5. Tocá Save Content.
6. Prendé el servidor con el botón verde de encendido y mirá la Terminal. El script de base de datos avisa ahí si se conectó o te muestra el error.

El panel no toca la línea set mysql_connection_string, así que lo que cargues queda guardado. Otras líneas de server.cfg, como sv_hostname o sv_maxclients, el panel las vuelve a escribir en cada arranque con los valores de Startup.

Tu server.cfg tiene la contraseña de la base. Si lo compartís con alguien, borrala antes.

Si no conecta

1. Revisá que el host y el puerto sean exactamente los de Endpoint.
2. Usá el nombre completo de la base, con el prefijo.
3. Si rotaste la contraseña con Rotate Password, cargá la nueva en el archivo.
4. Revisá que estés editando el archivo con el que arranca tu servidor. Con txAdmin, es el .cfg que elegiste ahí.
5. Revisá los símbolos de la contraseña. La que genera el panel siempre trae algunos (!, @, =, ., + o ^), y algunos scripts no los aceptan dentro de la cadena de conexión. Por ejemplo, con oxmysql un = corta la contraseña en el formato con punto y coma (user=...;password=...). Si te pasa, probá con el otro formato. Si sigue fallando, rotá la contraseña con Rotate Password hasta que no tenga el símbolo que molesta y cargá la nueva.
6. Si desde tu PC conecta pero desde el servidor da timeout (por ejemplo ETIMEDOUT o error 10060), o el script no resuelve nombres de host, abrí un ticket con el error exacto y el nombre de la base. Te indicamos qué dirección cargar.

Si se prueba muchas veces seguidas con datos equivocados, el servidor de bases puede bloquear la dirección desde la que llegan los intentos. Corregí los datos antes de volver a probar.

Si seguís igual, abrí un ticket desde tu cuenta (no como invitado) en https://neatech.ar/submitticket.php, en el departamento Soporte Game Servers, y elegí el servicio afectado. Contanos qué script de base de datos usás, qué error ves en la Terminal y desde cuándo, con una captura. No pongas la contraseña de la base en el ticket y tapala si aparece en la captura.

También te puede pasar si...

• Mi servidor de FiveM no conecta con la base de datos.
• No sé dónde poner los datos de la base en el server.cfg.
• Mi mysql_connection_string dice localhost y no anda.
• oxmysql me tira un error de conexión en la consola.
• Mi servidor da ETIMEDOUT o error 10060 al conectar con la base.
• Activé txAdmin y no sé qué archivo .cfg editar.
• Quiero dejar de usar la base de datos de mi PC.
• Cambié la contraseña de la base y el servidor dejó de conectar.