Deploy de servidor FiveM: artifacts, server.cfg e a skill de IA

Ver no skills.sh

Atualizado em

Baixar SKILL.mdComunidade

Não quer gerenciar as skills por conta própria? Obtenha o app completo.

Para fazer o deploy de um servidor FiveM, use o artifact do FXServer recomendado pela API oficial de changelogs, mantenha-o dentro da janela de suporte e escreva um server.cfg que faça ensure das dependências primeiro. Este guia cobre essas regras, os erros comuns e a skill de IA.

Fazer o deploy de um servidor FiveM se resume a três decisões: qual artifact do FXServer rodar, como mantê-lo dentro da janela de suporte e como escrever um server.cfg que inicie. A skill de deploy ensina um assistente de IA a decidir com dados reais, não de memória.

O que a skill de deploy do FiveM oferece

A skill se apoia na API oficial de changelogs:

  • Lê recommended e latest da sua plataforma (linux ou win32) antes de responder. Escolha recommended para produção e latest só para testar conteúdo novo do jogo.
  • Compara a sua build com a entrada support_policy_eol dela mesma. O fim de suporte é rolante e vale por build.
  • Avisa sobre o limite de compatibilidade que a skill documenta: builds abaixo de 35245 precisam de atualização antes de 15 de outubro de 2026.
  • Define sv_enforceGameBuild conforme a regra de Legacy ou Enhanced, ou o omite para usar o padrão.
  • Audita o server.cfg antes do deploy, mantendo a ordem dos ensure.

Os arquivos de regras cobrem artifacts, a janela de compatibilidade, o essencial do server.cfg e como o txAdmin trata as atualizações de artifacts. A referência original é o manual de servidor do FiveM.

Erros comuns ao fazer deploy do FiveM

  • Citar um número de build de memória. Os números mudam. Leia recommended e latest da API toda vez.
  • Usar os campos critical e optional. Eles estão fixados na build 7290 e não são mantidos. Ignore.
  • Achar que uma build que funciona continua com suporte. O EOL é rolante, então uma build que funciona hoje pode expirar na semana que vem.
  • Definir sv_enforceGameBuild em execução. Ele só vale na inicialização. No Enhanced, só 1 é aceito.
  • Usar sv_replaceExeToSwitchBuilds. Está obsoleto desde a build 35245. Não o adicione a configs novas.
  • Ativar sv_scriptHookAllowed. Nunca recomende sv_scriptHookAllowed true, porque deixa o servidor vulnerável.
  • Iniciar um recurso antes das dependências. A ordem do server.cfg é literal, então faça ensure das dependências primeiro.

Por que assistentes de IA erram no deploy do FiveM

Um assistente treinado em fóruns antigos cita um número de build que valia anos atrás, sugere convars que não existem mais e mistura configurações de Legacy e Enhanced. A resposta soa segura e o servidor não inicia ou derruba jogadores.

A skill de deploy impõe a ordem: buscar os dados de ciclo de vida, comparar a build e responder com o número da build, a data de EOL e a URL de origem. Ela também proíbe inventar número de build, convar ou caminho de menu do txAdmin.

Instale a skill de deploy do FiveM em 30 segundos

  1. Clique em "Download SKILL.md" no topo desta página.
  2. Descompacte na pasta de skills ou regras da sua ferramenta de IA. A seção de instalação abaixo mostra o caminho exato para Claude Code, Cursor e VS Code.
  3. Peça ao assistente algo concreto, como "qual build do FXServer meu servidor de produção deve usar", e confira se ele lê recommended da API de changelogs e informa o número da build, o EOL e a URL de origem.

Como instalar esta skill

Baixe o zip, descompacte e coloque a pasta onde a sua ferramenta carrega skills ou regras. O caminho exato depende da ferramenta:

Claude Code

Descompacte em .claude/skills/fivem-deployment/ dentro do projeto (a pasta precisa conter SKILL.md). Para todos os projetos, use ~/.claude/skills/fivem-deployment/.

Documentação de skills do Claude Code

Cursor

O Cursor carrega as regras do projeto de .cursor/rules/. Adicione ali um arquivo de regra apontando para a skill descompactada, ou cole o conteúdo do SKILL.md e dos arquivos de regras em uma regra. O formato é .mdc com frontmatter e muda entre versões, então confira a documentação da sua versão.

Documentação de regras do Cursor

VS Code / Copilot

O Copilot lê arquivos de instruções em .github/instructions/*.instructions.md. Copie o SKILL.md para lá com um glob applyTo para os seus arquivos Lua e mantenha os arquivos de regras ao lado.

Documentação de instruções do VS Code

O arquivo SKILL.md

Este é o arquivo que o seu assistente de IA lê. Ele aponta para os arquivos de regras incluídos no download.

Conteúdo da skill (inclui SKILL.md e quaisquer outros arquivos)

O conteúdo da skill está em inglês: é documentação técnica feita para agentes de IA.

FiveM Deployment

Choosing an FXServer artifact, keeping it inside its support window, and writing a server.cfg that starts.

Activation Contract

Load this skill when the user asks which artifact to run, how to update FXServer or txAdmin, why clients cannot connect after an update, what sv_enforceGameBuild should be, or how to write or audit server.cfg.

Hard Rules

  • Never state a build number from memory. Read recommended and latest from the changelogs API before answering.
  • Ignore the critical and optional fields. They are stale-pinned to build 7290 and are not maintained.
  • EOL is rolling and per build. A build that works today can expire next week; check support_policy_eol for the exact build in use.
  • sv_replaceExeToSwitchBuilds is deprecated as of build 35245. Never emit it.
  • On Enhanced, sv_enforceGameBuild accepts only 1 (base game, no DLC); numeric build values are Legacy-only.
  • sv_enforceGameBuild can only be set at startup, never at runtime.
  • Never recommend sv_scriptHookAllowed true. It makes the server vulnerable.
  • Resource load order in server.cfg is literal: dependencies must be ensured before dependents.

Decision Gates

Situation Build to pick
Production server recommended from the API
Testing a new game DLC latest
Currently below 35245 Upgrade to 35245 or later before October 15 2026
Build's support_policy_eol date has passed Upgrade now; it is out of support
Symptom Read
Clients cannot join after an update rules/compatibility-window.md
Choosing or verifying a build rules/artifacts.md
Server will not start / bad convar rules/server-cfg.md
Updating artifacts in place rules/txadmin.md

Execution Steps

  1. Fetch the lifecycle JSON for the platform (linux or win32) and read recommended, latest, support_policy, support_policy_eol.
  2. Compare the user's current build against recommended and against its own support_policy_eol entry.
  3. If the current build is older than 35245, flag the October 15 2026 compatibility cutoff.
  4. Set sv_enforceGameBuild per the Legacy/Enhanced rule above, or omit it to take the default.
  5. Audit server.cfg against rules/server-cfg.md before deploying.
  6. Restate the build number, its EOL value, and the source URL in the answer.

Output Contract

Return the chosen build number, its EOL timestamp, and the API URL you read it from. Emit server.cfg lines as runnable cfg blocks with ensure order intact. Never invent a build number, convar, or txAdmin menu path.

References

  • rules/artifacts.md — changelogs API, recommended vs latest, rolling EOL, picking a build.
  • rules/compatibility-window.md — October 15 2026 cutoff, upgrade path, deprecations.
  • rules/server-cfg.md — server.cfg essentials, gamebuild, security convars.
  • rules/txadmin.md — txAdmin's role in artifact updates and version pairing.

Upstream docs: https://docs.fivem.net/docs/server-manual/setting-up-a-server/

Perguntas frequentes

Qual build do FXServer devo usar em produção?
A build recommended da API de changelogs. Use latest só para testar conteúdo novo do jogo e confira a data support_policy_eol da build exata que você roda, porque o fim de suporte é rolante.
Qual deve ser o valor de sv_enforceGameBuild?
No Enhanced ele aceita apenas 1, que significa jogo base sem DLC. Valores numéricos de build são só do Legacy, e o convar só pode ser definido na inicialização, nunca em execução.
Posso usar esta skill com o ChatGPT?
Sim, com um passo manual. O SKILL.md é markdown puro, então você pode colá-lo na conversa como contexto. O suporte nativo a skills é para Claude Code, Cursor e VS Code.

Guias relacionados

Leituras mais longas do blog da FiveAI sobre o mesmo tema.

Mais skills