“FiveM mod” pode significar quatro coisas diferentes, e elas não são instaladas no mesmo lugar. Identifique o tipo de pacote a partir de sua documentação antes de copiar arquivos. Colocar arquivos aleatoriamente na pasta de dados do aplicativo FiveM pode quebrar atualizações ou violar as regras de um servidor.
Quatro tipos de mod relacionados ao FiveM
| Tipo | Instalado por | Local correto |
|---|---|---|
| Recurso do servidor | Proprietário do servidor | Diretório resources do servidor e ensure na configuração |
| Asset baixado do servidor | Proprietário do servidor; baixado automaticamente pelos jogadores | Dentro do recurso do servidor ao qual o asset pertence, geralmente stream |
| Plugin cliente aprovado | Jogador, apenas onde as regras do servidor e a documentação do plugin permitirem | O local documentado por esse plugin |
| Mod single-player GTA V | Jogador | Fluxo de trabalho de mod single-player — não um recurso de servidor FiveM |
Instale um recurso de servidor
- Verifique o criador, a licença, a soma de verificação ou a fonte da versão e as dependências do framework.
- Extraia o pacote para uma pasta de recurso de servidor dedicada.
- Confirme que a pasta contém um fxmanifest.lua válido no nível esperado.
- Importe migrações de banco de dados documentadas somente após um backup.
- Adicione
ensure resource-namena ordem de dependência correta. - Comece no ambiente de teste e verifique o console do servidor e os erros F8 do cliente.
Arquivos do lado do cliente
Não trate uma descrição ou espelho do YouTube como autoridade de instalação. Use as instruções atuais do criador e as regras do servidor. Nunca mova ferramentas de trapaça do GTA Online, injetores ou executáveis desconhecidos para um fluxo de trabalho FiveM. Verifique os downloads e mantenha uma cópia de reversão limpa.
Mods de jogador único são separados
Pacotes do OpenIV, plugins do ScriptHook e mods do modo história do GTA V são projetados para outro ambiente de execução. Eles não se tornam recursos FiveM ao serem copiados para um servidor. Mantenha uma instalação limpa do GTA V disponível e nunca use arquivos modificados no GTA Online.
Quando um recurso não carrega
- Verifique se há uma pasta aninhada, como
resource-main/resource/fxmanifest.lua. - Leia o manifesto e os erros de dependência em vez de renomear arquivos cegamente.
- Confirme as versões do framework e do banco de dados.
- Desative o último recurso alterado e restaure sua configuração anterior, se necessário. Restaure um banco de dados apenas se suas alterações exigirem, após considerar o progresso mais recente do jogador.
Se você ainda não tem o cliente, siga o guia de instalação oficial do cliente primeiro. Adicione modificações opcionais somente depois que o cliente inalterado funcionar.