Instalar MariaDB y conectar la base de datos de FiveM (oxmysql)

QBCore, ESX y Qbox guardan jugadores, inventarios y vehículos en una base de datos MySQL/MariaDB. La instalas una vez, en el mismo VPS, y FiveM se conecta por localhost.

Windows

1. Descarga el instalador MSI de MariaDB (una versión LTS) desde mariadb.org/download.
2. Instálalo y pon una contraseña de root larga. Deja marcado Install as service para que arranque con Windows.
3. El instalador incluye HeidiSQL, un programa para ver y editar la base de datos con ventanas.

Linux (Ubuntu / Debian)

apt install -y mariadb-server
mariadb-secure-installation

Responde a las preguntas: quita los usuarios anónimos y la base de datos de pruebas.

Crea la base de datos y su usuario

No uses root para FiveM. Entra en MariaDB (en Windows, desde HeidiSQL o con mysql -u root -p; en Linux, con mariadb) y ejecuta:

CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'UNA_CONTRASEÑA_LARGA';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;

Esos son los datos que te pedirá txAdmin al desplegar la receta: base de datos fivem, usuario fivem y su contraseña.

La cadena de conexión (oxmysql)

txAdmin la deja escrita en tu server.cfg. Si la pones a mano, tiene esta forma:

set mysql_connection_string "mysql://fivem:UNA_CONTRASEÑA_LARGA@localhost/fivem?charset=utf8mb4"

Y ensure oxmysql tiene que ir antes que el framework en el orden de carga. Si tu contraseña lleva símbolos como @ o #, cámbiala por una sin ellos: rompen la cadena.

No abras el puerto 3306

La base de datos solo la usa el servidor de FiveM, que está en la misma máquina. Abrir el 3306 a Internet es invitar a que la ataquen. Para gestionarla desde tu PC, usa HeidiSQL con su opción de túnel SSH (en Linux) o conéctate por escritorio remoto (en Windows).

Los dos errores más típicos

Y haz copias: el volcado diario de la base de datos es lo que te salva si un script te borra los inventarios.