FiveM para um jogador: Modo História vs. um servidor de teste privado

Use o Modo História do GTA V para jogar offline normalmente e um FXServer privado quando precisar testar recursos do FiveM sozinho. Eles são ambientes de execução diferentes. Um mod do Modo História não funciona automaticamente como um recurso do FiveM, e um script de servidor normalmente precisa do FXServer mesmo quando apenas uma pessoa se conecta.

A configuração e os exemplos de código aqui são voltados ao FiveM para GTA V Legacy. O Enhanced tem regras diferentes de runtime e de compatibilidade; verifique as alterações de Legacy para Enhanced do Cfx.re antes de aplicá-las a um servidor Enhanced.

Escolha o modo certo

Meta	Melhor ajuste	Limite importante
Jogue a campanha do GTA V offline	Modo História do GTA V	Ele não executa recursos de servidor do FiveM.
Explore um ambiente FiveM sozinho	Um servidor que permite jogar sozinho	O proprietário do servidor controla seus recursos e regras.
Desenvolver ou testar um recurso de forma privada	FXServer local/privado	Você ainda precisa das dependências e da configuração do recurso.

Instale o cliente da fonte oficial

Mantenha uma instalação legítima e atualizada do GTA V e instale o FiveM através do caminho oficial do cliente. Não misture injetores desconhecidos, ferramentas de trapaça GTA Online ou repacks aleatórios na configuração de teste. Se o cliente falhar antes de conectar, reproduza primeiro com uma configuração limpa do GTA V/FiveM.

Crie um servidor de teste solo privado

1. Siga as instruções atuais de configuração do servidor Cfx.re para o sistema operacional.
2. Inicie o txAdmin e crie um perfil de teste separado em vez de alterar os dados de produção.
3. Vincule o servidor apenas tão amplamente quanto o teste exigir. Adicione autenticação ou restrições de firewall antes de expô-lo fora da máquina local.
4. Instale um recurso com suas dependências documentadas e migração de banco de dados.
5. Adicione o recurso à configuração do servidor, reinicie e conecte-se através do endpoint local/privado.

Uma receita txAdmin é um ponto de partida para implantação, não uma prova de que cada dependência empacotada ou recurso da comunidade esteja atualizado. Registre a receita e as versões dos artefatos para que o teste possa ser repetido.

Entenda a compatibilidade de recursos

Os recursos FiveM podem depender de um framework, banco de dados, inventário, sistema de interação, build do jogo ou outros recursos. Leia fxmanifest.lua e a documentação do criador antes de começar. Arquivos feitos apenas para o Story Mode, OpenIV ou ScriptHook não podem ser tratados como recursos do servidor sem uma implementação FiveM autorizada.

Execute um teste solo útil

• Use um personagem novo e um estado de banco de dados conhecido.
• Teste o início, parada e reinício do recurso, bem como um reinício completo do servidor.
• Reconecte e repita a ação principal após limpar apenas o estado de teste específico do recurso.
• Abra o console F8 e revise o console do servidor em busca de avisos e erros.
• Teste caminhos de falha, como permissões ausentes, itens ausentes e entrada inválida.

O teste solo detecta falhas de empacotamento e lógica básica. Ele não pode comprovar desempenho, sincronização, condições de corrida ou limites de permissão sob múltiplos jogadores. Mova as alterações bem-sucedidas para um servidor de teste separado antes da produção.

Mantenha o teste reversível

Versionar o recurso e a configuração, fazer backup do banco de dados de teste antes das migrações e alterar uma variável por vez. Se um recurso quebrar a inicialização, remova sua ensure linha, restaure os arquivos anteriores e o estado do banco de dados, e reproduza a partir da última versão conhecida e funcional.

Documentação de referência

Cfx.re — configurando um servidor