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
- Siga as instruções atuais de configuração do servidor Cfx.re para o sistema operacional.
- Inicie o txAdmin e crie um perfil de teste separado em vez de alterar os dados de produção.
- 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.
- Instale um recurso com suas dependências documentadas e migração de banco de dados.
- 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
Versione o recurso e a configuração, faça backup do banco de dados de teste antes de migrações e altere uma variável por vez. Se um recurso impedir a inicialização, remova sua linha ensure, restaure os arquivos e o estado anterior do banco de dados e reproduza o problema a partir da última versão comprovadamente funcional.