Como criar um servidor FiveM com QBCore no Windows

Pré-requisitos

• Windows 10 ou 11 (64 bits)
• FiveM Server (artifact mais recente)
• MySQL 8.0+ ou MariaDB 10.3+
• Git (para clonar os resources)
• Visual Studio Code (recomendado para editar configs)
• License key do FiveM (Keymaster / Cfx.re)

Requisitos de hardware (referência)

1. Banco de dados (MySQL / MariaDB)

Instalar

1. Baixe o MySQL Community Server (ou MariaDB) para Windows.
2. Siga o assistente de instalação e defina uma senha root segura.
3. Garanta que o serviço MySQL/MariaDB está em execução.

Criar database e usuário

No MySQL Workbench ou no terminal:

CREATE DATABASE qbcore;
CREATE USER 'qbcore'@'localhost' IDENTIFIED BY 'sua_senha_forte';
GRANT ALL PRIVILEGES ON qbcore.* TO 'qbcore'@'localhost';
FLUSH PRIVILEGES;

Troque sua_senha_forte e use a mesma senha na connection string do server.cfg.

2. Baixar e preparar o FiveM Server

1. Acesse a página oficial de downloads do FiveM Server (artifacts).
2. Baixe o build recomendado (Windows).
3. Extraia em uma pasta fixa, por exemplo C:\FXServer.

3. Configurar o server.cfg

Crie o arquivo server.cfg na pasta do servidor. Exemplo base (ajuste senha, key e Steam ID):

sv_hostname "Meu Servidor QBCore"
sv_maxclients 32
sv_endpointprivacy true

# Connection string MySQL
set mysql_connection_string "mysql://qbcore:sua_senha_forte@localhost/qbcore?charset=utf8mb4"

# Coloque sua license key do Keymaster
# sv_licenseKey "SUA_KEY_AQUI"

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

ensure oxmysql
ensure qb-core
ensure qb-multicharacter
ensure qb-spawn
ensure qb-hud
ensure qb-inventory
ensure qb-menu

add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.steam:SEU_STEAM_HEX group.admin

Inclua também oxmysql (ou o conector que sua base usar) antes do qb-core. Sem isso a conexão com o banco falha.

4. Instalar o framework QBCore

Clonar os resources

Abra o Prompt/PowerShell na pasta resources do servidor:

git clone https://github.com/qbcore-framework/qb-core.git [qb]
cd [qb]
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-hud.git
git clone https://github.com/qbcore-framework/qb-inventory.git
git clone https://github.com/qbcore-framework/qb-menu.git

Importar o SQL

1. Localize os arquivos .sql do qb-core e dos resources.
2. Importe no database qbcore (Workbench ou CLI).
3. Repita para SQLs extras de inventário, apartamentos, etc., se existirem.

Ajustar config do core

Edite qb-core/config.lua (spawn padrão, intervalos, max players conforme o sv_maxclients).

5. Iniciar o servidor

No Prompt, dentro da pasta do FXServer:

FXServer.exe +exec server.cfg

Acompanhe o console: resources devem iniciar sem erro crítico. No FiveM (cliente), use connect 127.0.0.1 (local) ou o IP público da máquina.

Problemas comuns no Windows

• Falha na conexão MySQL: serviço parado, senha errada ou string incorreta no server.cfg.
• Resource não carrega: nome no ensure diferente da pasta, ou falta dependência (oxmysql / qb-core).
• Jogador não conecta: firewall bloqueando a porta 30120, license key ausente ou IP errado.

FAQ rápido

Quanto tempo leva?

Em geral 30–45 minutos na primeira vez, incluindo MySQL e importação do SQL.

Windows 10 serve?

Sim — Windows 10 ou 11 64 bits.

Qual banco usar?

MySQL 8+ ou MariaDB 10.3+ são os mais indicados para QBCore.

Como atualizar o QBCore depois?

Na pasta do resource, use git pull e reinicie o servidor — sempre com backup antes.

Referência e próximos passos

Este guia resume o fluxo de instalação no Windows com base na documentação em qbcore.net/docs/installation/windows . Depois de subir a base, aprofunde em como criar uma base QBCore , como criar um servidor FiveM ou scripts Lua . No blog: instalar scripts e subir na VPS .