Como criar servidor de FiveM RP usando a base QBCore no Ubuntu

Atualize o índice de pacotes e instale as dependências básicas:

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

O screen e tmux servem pra manter o processo do servidor rodando após você desconectar da sessão SSH — o FiveM não tem daemon nativo.

Crie um usuário dedicado pro servidor. Rodar FiveM como root é má prática e o txAdmin reclama disso explicitamente:

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

A partir daqui, todos os comandos rodam como o usuário fivem, exceto quando indicado com sudo.

Configure o firewall liberando SSH, FiveM e 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

A porta UDP 30120 é a crítica — é por onde o tráfego de jogo real passa. TCP 30120 é usada pelo handshake inicial e pela lista de servidores.

Instale o MariaDB e rode o assistente de segurança:

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

Responda Y pra todas as perguntas exceto a primeira (switch to unix_socket) — deixe N pra manter compatibilidade com autenticação por senha, que é o que o oxmysql espera.

Crie o banco e o usuário do QBCore:

sudo mariadb -u root -p

Dentro do prompt SQL:

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

Use uma senha real (gere com openssl rand -base64 24) — essa string vai pro server.cfg em texto claro.

Crie a estrutura de diretórios e baixe a versão recommended atual:

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

A URL muda a cada build. Pegue a atual em runtime.fivem.net/artifacts/fivem/build_proot_linux/master/ e copie o link da última pasta marcada como LATEST RECOMMENDED.

Clone o template inicial de server-data (recursos cfx padrão):

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

Esse repo só traz a estrutura mínima — vamos substituir os recursos pelo QBCore na próxima seção.

Crie a estrutura de pastas e clone o pacote 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

Os colchetes em [qb] não são erro — é uma convenção do FiveM pra agrupar recursos. O servidor carrega todos os recursos dentro de pastas entre colchetes recursivamente.

Instale o oxmysql, que substitui o antigo mysql-async:

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

QBCore depende de oxmysql declarado em fxmanifest.lua — sem ele, nenhum recurso inicia.

Importe o schema SQL do QBCore no banco. O arquivo de schema vem dentro do qb-core:

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

Digite a senha que você definiu no Step 05. Esse import cria as tabelas players, bans, permissions, player_vehicles, entre outras — cerca de 25 tabelas no total.

Edite o arquivo principal de configuração:

nano ~/server-data/server.cfg

Substitua o conteúdo por este template:

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

# Conexão com banco (oxmysql)
set mysql_connection_string "mysql://qbuser:troqueEstaSenhaForte123!@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

# Configurações do servidor
sv_hostname "Meu Servidor RP | QBCore"
sv_maxclients 48
sv_licenseKey "COLE_SUA_CHAVE_DO_KEYMASTER_AQUI"
sv_endpointprivacy true

# Admin inicial (substitua pelo seu identifier após primeira conexão)
add_ace group.admin command allow
add_principal identifier.license:SEU_LICENSE_IDENTIFIER group.admin

A license key sai gratuita do keymaster.fivem.net — você precisa cadastrar o IP da VPS lá pra gerar.

Inicie o servidor numa sessão screen pra que continue rodando após você desconectar:

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

Na primeira execução, o txAdmin imprime uma URL no console no formato http://SEU_IP:40120/addMaster/pin?pin=XXXX. Abra no navegador, defina senha de admin e aponte o caminho do server-data pra /home/fivem/server-data.

Pra destacar do screen sem matar o processo: Ctrl+A seguido de D.

Pelo painel web do txAdmin, clique em “Start Server”. Acompanhe a aba Console — você deve ver linhas como:

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

Se aparecer erro de conexão com banco, revisar a mysql_connection_string no server.cfg. Se der erro de license key inválida, regenerar no keymaster com o IP correto.