Como criar servidor FiveM (GTA V RP) do zero — txAdmin, ESX, QBCore

Sobre o FiveM

O FiveM é a modificação multiplayer não-oficial de GTA V que domina a cena de RP mundial — só no Brasil há centenas de servidores com milhares de players. Roda cliente do jogo original conectando a um FXServer custom.

Requisitos

Servidores RP são MUITO exigentes:

Instalação FXServer (Linux)

apt update
apt install -y xz-utils curl wget git screen

useradd -m -s /bin/bash fivem
su - fivem
mkdir server && cd server

# Última build recomendada (linux) — troque URL pela mais recente:
FXBUILD_URL="https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/"
wget "$FXBUILD_URL"
tar xf fx.tar.xz && rm fx.tar.xz

Configurar server.cfg

mkdir -p ~/server-data/resources
cd ~/server-data
nano server.cfg

Template mínimo:

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

sv_maxclients 48
sv_hostname "^1[BR] ^7Meu Servidor RP ^1| ^7Vitt Host"
sv_licenseKey "SUA_KEY_AQUI"          # gere em keymaster.fivem.net

# Descrição na lista de servidores
load_server_icon myLogo.png
sets tags "roleplay, brasil, esx"
sets Discord "https://discord.gg/xxx"

# Resources essenciais
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

# Sua base de RP (ESX ou QBCore) - vem depois
# ensure es_extended
# ensure qb-core

Rodar

cd ~/server-data
screen -S fivem bash -c "cd ~/server-data && ../server/run.sh +exec server.cfg"

txAdmin — o painel obrigatório

O txAdmin já vem incluso no FXServer moderno. Ele é o "cPanel" do FiveM:

• Interface web para gerenciar tudo
• Deploy de resources, restart programado
• Logs, admin, ban
• Recovery mode se algo quebrar

Ao iniciar pela 1ª vez, o console mostra:

Please open browser and go to: http://SEU_IP:40120/xxx

Complete o setup via web. Não precisa mais mexer no server.cfg diretamente.

ESX vs QBCore — qual escolher?

Nossa recomendação: comece com QBCore (mais moderno) OU ESX Legacy se quer resources antigos que você conhece.

Instalar QBCore (rápido)

cd ~/server-data/resources
git clone https://github.com/qbcore-framework/qb-core [qb]/qb-core
git clone https://github.com/overextended/oxmysql oxmysql
# ... clone dos demais qb-* que quiser

Em server.cfg:

ensure oxmysql
ensure qb-core
ensure [qb]

Configurar banco MySQL

mysql -u root -p
CREATE DATABASE fivem;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'senha_forte';
GRANT ALL ON fivem.* TO 'fivem'@'localhost';

Import do schema QBCore:

mysql -u fivem -p fivem < ~/server-data/resources/[qb]/qb-core/dump.sql

Em server.cfg:

set mysql_connection_string "mysql://fivem:senha_forte@localhost/fivem?charset=utf8mb4"

Resources indispensáveis para RP

• oxmysql — driver MySQL moderno
• ox_lib — biblioteca UI e helpers (do overextended)
• ox_inventory — melhor inventário do mercado
• ox_target — sistema de interação (substitui qtarget)
• qb-radialmenu ou ox_radial — menu circular
• es_extended ou qb-core — base
• cd_dispatch ou ps-dispatch — dispatch policial
• screenshot-basic — foto de RP admin

Otimização de performance

sv_scriptHookAllowed 0                 # bloqueia Script Hook (segurança)
onesync on                              # obrigatório p/ mais de 32 players
onesync_workaround763185 true
onesync_forceMigration true
onesync_distanceCullVehicles true
onesync_population true
onesync_radiusFrequency 0.75            # reduz sync (menos lag)
sv_enforceGameBuild 3095                # trava build (evita quebrar mods)

Backup

# Dump do MySQL diário
0 3 * * * mysqldump -u fivem -psenha_forte fivem | gzip > /backup/fivem-$(date +\%F).sql.gz
# Backup dos resources semanal
0 4 * * 0 tar czf /backup/fivem-res-$(date +\%F).tar.gz ~/server-data/resources

Troubleshooting

"Server didn't start" → veja ~/server-data/txData/default/logs/
"Couldn't connect" → txAdmin mostra motivo. Cliente precisa CitizenFX/FiveM instalado
Lag ao entrar/veículo aparece tarde → onesync está OFF ou distanceCullVehicles OFF
Player anti-cheat/anti-inject → use Antigravidade ou KeyMaster + license lock

Links

• FiveM Docs
• Keymaster — sua key de servidor
• Cfx.re Forums — plugins e resources
• QBCore Docs

Rodar FiveM RP com 64+ players precisa de VPS robusta — nossos VPS-BR-04 e BR-05 ou dedicados dão conta.