Cómo crear un servidor FiveM RP con QBCore en Ubuntu 24.04

Actualiza el índice de paquetes e instala las dependencias básicas:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget xz-utils git screen tmux ufw build-essential

screen y tmux sirven para mantener el proceso del servidor activo después de desconectarte de la sesión SSH — FiveM no tiene daemon nativo.

Crea un usuario dedicado para el servidor. Ejecutar FiveM como root es mala práctica y txAdmin lo advierte explícitamente:

sudo adduser --disabled-password --gecos "" fivem
sudo usermod -aG sudo fivem
sudo su - fivem

A partir de aquí, todos los comandos se ejecutan como el usuario fivem, salvo cuando se indica con sudo.

Configura el firewall abriendo SSH, FiveM y txAdmin:

sudo ufw allow 22/tcp
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow 40120/tcp
sudo ufw --force enable

El puerto UDP 30120 es el crítico — es por donde pasa el tráfico real del juego. TCP 30120 se usa para el handshake inicial y la lista de servidores.

Instala MariaDB y ejecuta el asistente de seguridad:

sudo apt install -y mariadb-server mariadb-client
sudo systemctl enable --now mariadb
sudo mariadb-secure-installation

Responde Y a todas las preguntas excepto la primera (switch to unix_socket) — deja N para mantener compatibilidad con autenticación por contraseña, que es lo que oxmysql espera.

Crea la base de datos y el usuario de QBCore:

sudo mariadb -u root -p

Dentro del prompt SQL:

CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'qbuser'@'localhost' IDENTIFIED BY 'cambiaEstaContraseñaFuerte123!';
GRANT ALL PRIVILEGES ON qbcore.* TO 'qbuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Usa una contraseña real (genera con openssl rand -base64 24) — esta cadena irá en el server.cfg en texto plano.

Crea la estructura de directorios y descarga la versión recommended actual:

mkdir -p ~/server ~/server-data
cd ~/server
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/15295-de1d8a35434f0f2b5b8bcae93e9eb8f6e4a7df14/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

La URL cambia con cada build. Obtén la actual en runtime.fivem.net/artifacts/fivem/build_proot_linux/master/ y copia el enlace de la última carpeta marcada como LATEST RECOMMENDED.

Clona el template inicial de server-data (recursos cfx por defecto):

cd ~/server-data
git clone https://github.com/citizenfx/cfx-server-data.git .

Este repositorio solo trae la estructura mínima — reemplazaremos los recursos por QBCore en la siguiente sección.

Crea la estructura de carpetas y clona el paquete principal:

cd ~/server-data/resources
mkdir -p [qb]
cd [qb]
git clone https://github.com/qbcore-framework/qb-core.git
git clone https://github.com/qbcore-framework/qb-multicharacter.git
git clone https://github.com/qbcore-framework/qb-spawn.git
git clone https://github.com/qbcore-framework/qb-inventory.git
git clone https://github.com/qbcore-framework/qb-target.git
git clone https://github.com/qbcore-framework/qb-menu.git
git clone https://github.com/qbcore-framework/qb-input.git

Los corchetes en [qb] no son un error — es una convención de FiveM para agrupar recursos. El servidor carga todos los recursos dentro de carpetas entre corchetes de forma recursiva.

Instala oxmysql, que reemplaza al antiguo mysql-async:

cd ~/server-data/resources
mkdir -p [standalone]
cd [standalone]
git clone https://github.com/overextended/oxmysql.git

QBCore depende de oxmysql declarado en fxmanifest.lua — sin él, ningún recurso arranca.

Importa el schema SQL de QBCore en la base de datos. El archivo de schema viene dentro de qb-core:

mariadb -u qbuser -p qbcore < ~/server-data/resources/[qb]/qb-core/qb-core.sql

Escribe la contraseña que definiste en el Step 05. Esta importación crea las tablas players, bans, permissions, player_vehicles, entre otras — unas 25 tablas en total.

Edita el archivo principal de configuración:

nano ~/server-data/server.cfg

Sustituye el contenido por esta plantilla:

# Endpoints
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Conexión con la base de datos (oxmysql)
set mysql_connection_string "mysql://qbuser:cambiaEstaContraseñaFuerte123!@localhost/qbcore?charset=utf8mb4"

# Recursos base
ensure oxmysql
ensure qb-core
ensure qb-multicharacter
ensure qb-spawn
ensure qb-inventory
ensure qb-target
ensure qb-menu
ensure qb-input

# Configuración del servidor
sv_hostname "Mi Servidor RP | QBCore"
sv_maxclients 48
sv_licenseKey "PEGA_TU_CLAVE_DEL_KEYMASTER_AQUÍ"
sv_endpointprivacy true

# Admin inicial (reemplaza por tu identifier tras la primera conexión)
add_ace group.admin command allow
add_principal identifier.license:TU_LICENSE_IDENTIFIER group.admin

La license key es gratuita en keymaster.fivem.net — necesitas registrar la IP de la VPS allí para generarla.

Inicia el servidor en una sesión screen para que continúe ejecutándose tras desconectarte:

screen -S fivem
cd ~/server-data
bash ~/server/run.sh +set serverProfile default

En la primera ejecución, txAdmin imprime una URL en la consola con el formato http://TU_IP:40120/addMaster/pin?pin=XXXX. Ábrela en el navegador, define la contraseña de admin y apunta la ruta de server-data a /home/fivem/server-data.

Para desconectarte del screen sin matar el proceso: Ctrl+A seguido de D.

Desde el panel web de txAdmin, haz clic en “Start Server”. Sigue la pestaña Console — deberías ver líneas como:

[script:oxmysql] Database server connection established!
[script:qb-core] QBCore Started Successfully
Resource oxmysql started
Resource qb-core started

Si aparece error de conexión con la base de datos, revisa la mysql_connection_string en server.cfg. Si el error indica license key inválida, regenera en keymaster con la IP correcta.