Como criar servidor FiveM RP com QBCore em VPS Windows

Conecte na VPS via RDP usando o IP e credenciais fornecidos. No primeiro login, abra o Server Manager → Local Server e desative a opção IE Enhanced Security Configuration para Administrators. Sem isso, baixar arquivos pelo navegador vira um inferno de confirmações.

Instale o Visual C++ Redistributable 2019 (x64). Abra o PowerShell como Administrator e execute:

Invoke-WebRequest -Uri "https://aka.ms/vs/17/release/vc_redist.x64.exe" -OutFile "$env:TEMP\vc_redist.x64.exe"
Start-Process "$env:TEMP\vc_redist.x64.exe" -ArgumentList "/install /quiet /norestart" -Wait

Esse pacote contém as bibliotecas C++ que o FXServer.exe carrega em runtime. Se você pular este passo, o servidor abre o console e fecha imediatamente sem mensagem útil.

Libere as portas no firewall do Windows. Ainda no PowerShell:

New-NetFirewallRule -DisplayName "FiveM Server" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "FiveM Server UDP" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "txAdmin" -Direction Inbound -Protocol TCP -LocalPort 40120 -Action Allow

Baixe o instalador do MariaDB:

Invoke-WebRequest -Uri "https://archive.mariadb.org/mariadb-10.11.6/winx64-packages/mariadb-10.11.6-winx64.msi" -OutFile "$env:TEMP\mariadb.msi"
Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\mariadb.msi /quiet PASSWORD=SuaSenhaForte123 SERVICENAME=MariaDB PORT=3306" -Wait

Troque SuaSenhaForte123 por uma senha real — você vai usar ela na string de conexão do server.cfg. Anote em algum lugar seguro.

Verifique se o serviço subiu corretamente:

Get-Service -Name MariaDB

O status deve aparecer como Running. Se estiver Stopped, rode Start-Service MariaDB e confirme novamente.

Crie o banco qbcore que vai receber o esquema do framework. Abra o HeidiSQL (vem junto com o MariaDB) → conecte em 127.0.0.1:3306 com user root e a senha definida acima. No menu, clique com o botão direito na conexão → Create new → Database → nome qbcore, collation utf8mb4_general_ci.

Crie a estrutura de pastas e baixe o artifact mais recente:

New-Item -ItemType Directory -Path "C:\FXServer\server" -Force
New-Item -ItemType Directory -Path "C:\FXServer\server-data" -Force
cd C:\FXServer\server

# Pegue o link mais recente em https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/
$artifactUrl = "https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/12913-abc.../server.7z"
Invoke-WebRequest -Uri $artifactUrl -OutFile "server.7z"

O número do build muda toda semana — abra a URL no navegador da VPS, copie o link do build marcado como recommended e substitua acima.

Instale o 7-Zip para extrair o artifact e descompacte:

winget install --id 7zip.7zip --silent
& "C:\Program Files\7-Zip\7z.exe" x server.7z -oC:\FXServer\server

Depois de extrair, você deve ter C:\FXServer\server\FXServer.exe — esse é o executável principal.

Instale o Git e clone o template oficial dentro de server-data:

winget install --id Git.Git --silent
# Feche e reabra o PowerShell pra atualizar o PATH
cd C:\FXServer\server-data
git clone https://github.com/qbcore-framework/txAdminRecipe.git .

O txAdminRecipe é o blueprint oficial — ele inclui o QBCore core, oxmysql, scripts essenciais e o esquema SQL.

Gere sua chave de licença em https://keymaster.fivem.net/. Faça login com Cfx.re, clique em New → escolha Server hosted by yourself, informe o IP da VPS e copie a chave gerada (formato cfxk_...).

Vamos usar o txAdmin para finalizar a configuração — ele cuida do server.cfg, importa o SQL automaticamente e fornece interface web. Inicie o FXServer pela primeira vez:

cd C:\FXServer\server
.\FXServer.exe +set serverProfile default

Na primeira execução, o console imprime uma URL tipo http://IP-DA-VPS:40120/addMaster/PIN. Abra essa URL no seu navegador local.

Na interface do txAdmin: crie a conta admin → escolha Use recipe → cole a URL https://raw.githubusercontent.com/Qbox-project/txAdminRecipe/main/recipe.yaml (ou use o recipe do QBCore puro). O txAdmin baixa todos os scripts, cria o banco e gera o server.cfg.

Quando pedir credenciais MySQL, informe:

host: localhost
user: root
password: SuaSenhaForte123
database: qbcore

Ainda no txAdmin, abra Settings → CFX Re License e cole a chave gerada no keymaster. Em Server Name coloque o nome que vai aparecer no servidor list do FiveM. Clique Save & Start.