Como criar um servidor de FiveM: o guia completo 2026

Um servidor FiveM é um servidor multiplayer modificado de GTA V que roda com as suas regras, scripts, carros, roupas e mapas. Seguindo os passos na ordem, dá para subir um em uns 30 minutos. Este guia mostra como criar um servidor de FiveM do zero: de uma pasta vazia até um servidor em que seus amigos conseguem entrar, e depois até um servidor com a sua cara.

Resumo rápido: pegue uma license key grátis no Cfx.re Portal, baixe o build recomendado do servidor, rode, termine a configuração do txAdmin no navegador, escolha uma recipe com o seu framework, libere a porta 30120 e conecte.

O que você precisa antes de começar

Quanto de hardware? Um servidor privado pequeno para jogar com os amigos roda tranquilo num processador moderno de 4 núcleos com 8 GB de RAM. Um servidor público de RP com 64+ jogadores e centenas de resources precisa de um núcleo rápido (a thread principal do servidor FiveM se beneficia mais de clock alto do que de muitos núcleos), 16–32 GB de RAM e um SSD NVMe. Dá para começar pequeno e migrar depois; a pasta do servidor é portátil.

Hospedar em casa vs contratar uma host

Você tem duas opções:

• Hospedar no seu próprio PC. De graça e perfeito para desenvolver e testar, mas o PC precisa ficar ligado, a velocidade de upload da sua internet limita quantos jogadores conseguem entrar e você precisa abrir portas no roteador.
• Alugar uma VPS ou uma host de servidores de jogos. Custa uma mensalidade, mas você ganha conexão estável, IP fixo e mais uptime. A maioria das empresas de "hospedagem FiveM" oferece instalação do txAdmin em um clique.

O caminho mais comum é montar e testar tudo localmente e depois mover a pasta do servidor pronto para uma host quando for abrir para o público. Tudo daqui para baixo funciona igual nos dois casos.

Passo 1: Pegue sua license key

1. Acesse o Cfx.re Portal e entre com sua conta Cfx.re.
2. Abra a seção de servidores e registre uma nova server key.
3. Informe o endereço IP da máquina que vai hospedar o servidor. Para testes locais, seu IP público serve.
4. Copie a key. Você vai colar ela no txAdmin no Passo 4.

Não compartilhe essa key. Qualquer pessoa com ela consegue subir um servidor que aparece como se fosse seu.

Passo 2: Baixe o build do servidor

O software de servidor do FiveM se chama FXServer, e os builds dele são chamados de artifacts.

1. Abra a página oficial de download do servidor e siga o link para os artifacts do seu sistema operacional.
2. Baixe o build recomendado, não simplesmente o mais novo. O recomendado já foi testado; o mais recente às vezes quebra resources.
3. Extraia o arquivo numa pasta vazia, por exemplo C:\FXServer\server no Windows. Use 7-Zip ou WinRAR para arquivos .7z. No Linux, extraia o fx.tar.xz em algo como ~/fxserver.

Deixe os binários do servidor (server/) separados dos dados do servidor (resources e server.cfg, criados no Passo 4). Assim, atualizar o FXServer depois é só trocar a pasta dos binários.

GTA V Legacy vs Enhanced: a Cfx.re agora publica builds de servidor separados para a nova edição GTA V Enhanced. A maioria dos resources, frameworks e packs de assets que existem hoje foi feita para a edição Legacy, então confira se tudo o que você pretende usar é compatível com o build escolhido antes de bater o martelo.

Passo 3: Inicie o servidor e abra o txAdmin

Todo servidor FiveM moderno é gerenciado pelo txAdmin, um painel web que já vem junto com o FXServer.

1. Rode o FXServer.exe no Windows, ou ./run.sh no Linux.
2. O console mostra uma URL (por padrão na porta 40120) e um PIN de 4 dígitos. No Windows, o navegador geralmente abre sozinho.
3. Clique em Link Account, entre com sua conta Cfx.re e autorize o txAdmin.
4. Crie uma senha para o painel do txAdmin. Ela é a senha mestre do seu servidor, então trate como tal.

Passo 4: Escolha uma recipe e faça o deploy

O txAdmin monta seu servidor a partir de uma recipe: um script que baixa um framework, os resources base dele e um server.cfg pronto.

1. Digite o nome do seu servidor.
2. Escolha Popular Recipes. As principais opções são:
   • CFX Default – um sandbox vazio, sem sistemas de RP. Bom para freeroam, corrida ou para aprender.
   • Qbox Framework, QBCore Framework e ESX Legacy – frameworks de roleplay completos, com empregos, dinheiro, inventários, veículos e casas.
3. Confirme onde o txAdmin deve salvar os dados do servidor.
4. No Recipe Deployer, cole a license key do Passo 1.
5. Se a recipe precisar de banco de dados, informe o host, usuário e senha do MariaDB (veja o próximo passo).
6. Rode a recipe e depois clique em Save & Run Server.

Na dúvida sobre qual framework escolher? Leia antes Qbox vs QBCore vs ESX. Trocar de framework depois significa reescrever ou substituir a maioria dos seus scripts, então essa é a decisão que vale a pena tomar com calma.

Passo 5: Configure o banco de dados

Frameworks de roleplay precisam de um banco de dados SQL. Instale o MariaDB (o Qbox exige MariaDB 10.9 ou mais recente e não suporta MySQL; ESX e QBCore funcionam com os dois, mas o MariaDB é a escolha segura).

1. Instale o MariaDB e defina uma senha de root durante a instalação.
2. Se quiser, instale o HeidiSQL (vem junto com o instalador do MariaDB para Windows) para navegar pelos dados.
3. Passe os dados de conexão para o txAdmin quando a recipe pedir. Ele cria o banco e importa as tabelas do framework para você.

Os resources conversam com o banco de dados pelo oxmysql. A string de conexão fica no server.cfg:

set mysql_connection_string "mysql://root:yourpassword@localhost/your_database?charset=utf8mb4"

Se o console do servidor mostrar erros de conexão do oxmysql, quase sempre o culpado é essa linha: senha errada, nome do banco errado ou MariaDB fora do ar.

Passo 6: Libere as portas

Os jogadores conectam pela porta 30120, tanto em TCP quanto UDP.

• Firewall do Windows: adicione regras de entrada liberando TCP e UDP na porta 30120.
• Linux: libere a porta no seu firewall, por exemplo ufw allow 30120.
• Rede de casa: redirecione TCP e UDP 30120 no roteador para o IP local do seu PC.

Não exponha publicamente a porta do txAdmin (40120), a não ser que você precise gerenciar o servidor remotamente; e, se for o caso, use uma senha forte.

Passo 7: Conecte no seu servidor

1. Abra o FiveM.
2. Aperte F8 para abrir o console.
3. Digite connect localhost:30120 se o servidor estiver no mesmo PC, ou connect your.ip.address:30120 de outra máquina.

Seu servidor também aparece na lista de servidores dentro do jogo assim que estiver rodando com uma license key válida.

As configurações do server.cfg que importam

O server.cfg é o arquivo de configuração principal do servidor. O txAdmin gera um, mas estas são as linhas que você mais vai mexer:

sv_hostname "Meu Servidor | RP Sério | Carros Exclusivos"
sets sv_projectName "Meu Servidor"
sets sv_projectDesc "Uma descrição curta que aparece na lista de servidores"
sets tags "roleplay, custom cars, economy"
sets locale "en-US"

sv_maxclients 48
sv_licenseKey "your_license_key"

ensure oxmysql
ensure ox_lib
ensure my_first_resource

• sv_maxclients define o limite de jogadores. Sem uma assinatura do Cfx.re Element Club, os servidores ficam limitados a 48 slots.
• ensure inicia um resource. A ordem importa: inicie dependências como oxmysql e ox_lib antes dos resources que usam elas.
• sets tags e sv_projectDesc são o que os jogadores veem na lista de servidores, então escreva para pessoas, não para palavras-chave.

Como os resources funcionam

Tudo num servidor FiveM – scripts, carros, roupas, mapas, emotes – é um resource: uma pasta dentro de resources/ com um arquivo fxmanifest.lua que diz ao FXServer o que carregar.

Um fxmanifest.lua mínimo:

fx_version 'cerulean'
game 'gta5'
lua54 'yes'

client_script 'client.lua'
server_script 'server.lua'

Adicione ensure my_first_resource no server.cfg, depois digite refresh e ensure my_first_resource no console do servidor (ou use a página de resources do txAdmin) para carregar sem reiniciar tudo.

Os arquivos dentro de uma pasta stream/ são enviados (stream) para os jogadores automaticamente. É assim que você adiciona modelos, texturas e animações próprias sem mexer nos arquivos do jogo.

Deixando o servidor com a sua cara: conteúdo exclusivo

Uma instalação limpa de framework é igual a todos os outros servidores. Conteúdo exclusivo é o que faz os jogadores ficarem:

• Scripts – empregos, lojas, roubos, minigames e interfaces. A maioria precisa ser feita para o seu framework, então sempre informe qual é ao comprar, baixar ou gerar um script. O gerador de scripts da BLDR escreve Lua compatível com Qbox, QBCore e ESX.
• Veículos – arquivos .yft/.ytd em stream mais os arquivos meta. Fique de olho no tamanho das texturas; texturas de veículo pesadas demais são a causa mais comum de texture loss e loading demorado. Otimizar assets no FiveM mostra como resolver.
• Roupas – packs EUP ou roupas próprias em stream por meio de um resource de roupas. Veja o guia de packs de roupas para FiveM.
• Props e mapas – modelos .ydr para props e MLOs para interiores. Você pode gerar props 3D prontos para o jogo a partir de um prompt ou de uma imagem de referência; os guias de props personalizados e MLOs mostram como instalar os dois.
• Emotes – animações próprias vão em stream como arquivos .ycd. Veja Emotes personalizados no FiveM para transformar qualquer vídeo num emote dentro do jogo.

Mantenha o servidor leve

Problemas de desempenho geralmente aparecem um resource de cada vez. Crie estes hábitos desde o começo:

• Abra o resmon (aperte F8, digite resmon 1) e acompanhe o tempo de CPU do client por resource. Um script parado deve ficar perto de 0.00 ms; qualquer um que fique acima de uns 0.10 ms sem nada acontecendo merece uma olhada.
• Evite loops while true do Wait(0) rodando todo frame sem necessidade. Use waits maiores, checagens de distância ou eventos.
• Use o profiler do próprio servidor no txAdmin para achar scripts lentos do lado do servidor e queries pesadas no banco.
• Comprima e redimensione as texturas antes de colocar em stream. Uma textura 4K num prop pequeno custa memória e tempo de download para todos os jogadores.

Abrindo para o público

Antes de chamar a galera:

1. Faça backup do banco de dados e da pasta resources/, e agende backups automáticos.
2. Configure as permissões com os admins do txAdmin e permissões ACE para que só a staff consiga usar comandos de admin.
3. Teste com alguns amigos para achar scripts quebrados e dependências faltando antes que desconhecidos achem.
4. Crie um Discord para avisos, regras, suporte e whitelist.
5. Abra uma loja se pretende monetizar. A maioria dos servidores usa a Tebex, que é a plataforma aprovada pela Cfx.re para monetização de servidores. Leia as regras de monetização da Cfx.re antes de vender qualquer coisa.

Perguntas frequentes

Criar um servidor de FiveM é de graça?

Sim. O software do servidor, o txAdmin e a license key são gratuitos. Você só paga a hospedagem se alugar um servidor, e uma assinatura do Element Club se precisar de mais de 48 slots.

Dá para hospedar um servidor FiveM e jogar no mesmo PC?

Dá, e esse é o jeito normal de desenvolver. Espere um desempenho menor do que numa máquina dedicada, principalmente com muitos resources.

O servidor precisa ter o GTA V instalado?

Não. O servidor não precisa dos arquivos do jogo. Cada jogador que conecta precisa da sua própria cópia original do GTA V.

Por que meus amigos não conseguem conectar?

Nove em cada dez vezes é a porta 30120 (TCP e UDP) que não foi redirecionada ou liberada no firewall. Confira se o servidor aparece na lista de servidores e se sua license key foi registrada com o IP correto.

Qual framework devo usar?

Depende dos scripts que você quer e de quanto pretende personalizar. O Qbox vs QBCore vs ESX compara os três lado a lado.