Como instalar um resource e conferir se ele iniciou no FiveM

Um resource é um conjunto de arquivos que o FiveM carrega para acrescentar scripts ou conteúdo. Vamos separar a instalação em três conferências: o arquivo foi colocado na pasta certa, o servidor reconheceu o resource e a função dele realmente funciona no jogo.

Leia as exigências do autor

Confira a versão, o framework e as dependências. Um resource feito para ESX pode depender de componentes que não existem numa instalação básica. Se houver instruções para importar um arquivo SQL, faça um backup do banco antes e siga o procedimento específico do autor.

💡 O nome da pasta será usado no comando

Neste exemplo, a pasta se chama willber_tutorial. Ela contém um teste simples que escreve uma mensagem no Console. Não é um pacote de cidade e não depende de banco.

Envie para os dados que o txAdmin usa

Abra Files no Pterodactyl. Entre na pasta de dados escolhida no assistente txAdmin e depois em resources. A instalação pode ter outra pasta resources na raiz; confirme o caminho ativo antes de enviar.

Diretório ativo de resources da instalação FiveM de demonstração.Ampliar

Envie o ZIP do resource, extraia e confira sua pasta. O arquivo fxmanifest.lua deve ficar dentro da pasta do resource, sem uma segunda pasta com o mesmo nome entre eles.

Atualize a lista e inicie

No Live Console do txAdmin, execute os comandos abaixo, um por vez. Substitua o nome se você estiver instalando outro resource.

refresh
ensure willber_tutorial

refresh procura resources nos arquivos. ensure inicia o resource quando ele está parado e o reinicia quando já está rodando. Evite repetir o comando numa cidade com jogadores sem saber o efeito desse reinício.

Resource de demonstração na lista do txAdmin, com estado de execução.Ampliar

✅ Confira o resultado esperado pelo resource

No exemplo, procure a mensagem de carregamento no Console. Em um resource de garagem, inventário ou mapa, confira também a função correspondente no jogo. “Started” não confirma todas as funções de um pacote.

Mantenha no próximo início

Depois do teste, acrescente ensure willber_tutorial ao server.cfg ativo, respeitando a ordem das dependências. Salve e confira uma nova inicialização. No servidor deste exemplo, o resource continuou em execução depois de reiniciar o container; os controles Restart e Stop da captura mostram esse estado. Se aparecer “Could not find resource”, confira a pasta, o manifest e o caminho dos dados ativos antes de baixar outro pacote.

Fontes: estrutura dos resources e comandos de início.