Você pode usar Resources para adicionar recursos ao seu servidor de FiveM. Isso é especialmente interessante se você planeja projetos maiores, como um servidor de roleplay ou algo parecido. Projetos assim dificilmente funcionam sem Resources adicionais.
O FiveM e a comunidade oferecem uma grande variedade de Resources. Confira uma lista das Resources mais populares no fórum da Cfx.re: https://forum.cfx.re/c/development/releases/7
A maneira mais rápida de instalar uma Resource é usar o FiveM Resource Installer, diretamente no painel. Envie o arquivo ZIP, e o instalador colocará a Resource na pasta correta, adicionará uma entrada à server.cfg e, se você quiser, importará os arquivos SQL incluídos para o seu banco de dados. Mais abaixo, você encontra o método tradicional por SFTP.
O Resource Installer está disponível para servidores FiveM. Para FiveM Enhanced e RedM, use o método por SFTP.
Abra o painel do seu servidor FiveM, acesse a aba Ferramentas e selecione FiveM Resource Installer. Não é necessário parar o servidor.
Para usar o instalador, é necessário que um modelo de servidor (Recipe) já esteja configurado no txAdmin. Só então haverá uma server.cfg e uma pasta resources nas quais o instalador poderá gravar.
Envie a Resource como um arquivo ZIP. Você pode usar diretamente um download do GitHub por Code → Download ZIP ou um ZIP de lançamento.
- São aceitos arquivos ZIP de até 100 MB (no máximo 400 MB e 5.000 arquivos após a extração).
- Se você tiver um arquivo RAR ou 7z, extraia-o e compacte os arquivos novamente em ZIP.
- O instalador remove pastas intermediárias desnecessárias (por exemplo,
minha-resource-main) e elimina do nome sufixos de versão e-main. - Se o arquivo contiver várias Resources, o instalador as listará separadamente e as organizará de acordo com as dependências.
- Arquivos executáveis, como
.exe,.batou.sh, nunca serão gravados no servidor.
Antes de instalar qualquer coisa, o instalador mostra o conteúdo do arquivo:
- Nome e pasta de destino: O nome pode conter letras, números e os caracteres
_,.e-(no máximo 64 caracteres). Em Pasta em resources/, selecione a pasta de categoria, por exemplo,[standalone]. Se o arquivo não incluir uma,[local]será selecionada por padrão. Com Diretamente em resources/ (sem pasta), a Resource ficará sem uma pasta de categoria. - Dependências: Para cada dependência (por exemplo, ESX, QBCore, Qbox, ox_lib, oxmysql), você verá se ela está incluída no arquivo, se está disponível no servidor ou se está faltando. Dependências mencionadas apenas no código, mas não listadas em
fxmanifest.lua, serão marcadas como suspeitas. - Verificação de segurança: O instalador verifica todos os arquivos
.luae.jsem busca de padrões conhecidos de código malicioso. Se encontrar algo, você receberá um aviso. Ainda será possível instalar, mas a verificação de segurança desativará a Resource na próxima inicialização do servidor. Se você acredita que se trata de um falso positivo, entre em contato com o nosso suporte. - Arquivos SQL: Os arquivos
.sqlincluídos serão listados, com informações sobre as tabelas que criam, alteram ou preenchem.
Se a Resource já existir no servidor, o instalador cancelará a instalação por padrão. Para substituí-la (por exemplo, ao atualizá-la), marque Sobrescrever Resource existente. A pasta inteira será substituída, incluindo configurações como config.lua. Antes disso, a pasta antiga será salva como arquivo em backups/resource-installer/.
Mantenha marcada a opção Adicionar ao server.cfg para iniciar automaticamente. O instalador adicionará ensure <Name> à server.cfg da pasta ativa do servidor, depois das dependências da Resource, e salvará uma cópia da server.cfg antiga como server.cfg.bak-….
Clique em Instalar no servidor. Você verá o progresso (backup, extração, gravação, atualização da server.cfg e verificação do resultado). A instalação continuará mesmo se você fechar a página.
O resultado mostrará como a Resource será iniciada:
- Linha ensure adicionada ao server.cfg: tudo pronto.
- já constava no server.cfg: a linha já existia.
- iniciada pela pasta da categoria: sua
server.cfgjá contémensure [Categoria], que também inicia a Resource. - Linha ensure ainda não adicionada: adicione
ensure <Name>manualmente àserver.cfg(consulte Ativação).
Para que o FiveM carregue a nova Resource, reinicie o servidor usando Reiniciar servidor. Outra opção é digitar refresh e, em seguida, ensure <Name> no console ao vivo.
Se a Resource precisar de um banco de dados, você poderá importar o arquivo SQL diretamente pelo instalador. Isso não acontece automaticamente: você precisa clicar em Importar para o banco de dados no arquivo correspondente.
- Selecione o banco de dados do seu servidor. O banco de dados principal já vem selecionado. Se o servidor ainda não tiver um banco de dados, crie um em Criar banco de dados, na aba Bases de dados.
- Se já houver tabelas do arquivo, a janela informará. Nesse caso, mantenha selecionada a opção Ignorar tabelas existentes (recomendado). Assim, as tabelas existentes e os dados delas não serão alterados.
- Se o ZapX Pass estiver ativo, será feito um backup do banco de dados automaticamente antes da importação. Sem o Pass, confirme Vou importar sem backup.
- Clique em Importar agora.
Cada arquivo pode ter até 2 MB e conter até 5.000 instruções SQL. Para importar arquivos maiores, siga as instruções em FiveM: importar arquivo SQL e use o phpMyAdmin.
A importação sempre é feita no banco de dados selecionado. Por isso, linhas como CREATE DATABASE … ou USE … não são permitidas. Se o arquivo contiver uma dessas linhas, ela não será importada. Remova essas linhas, gere o ZIP novamente e envie-o mais uma vez.
| Mensagem ou problema | Solução |
|---|---|
| Arquivos RAR e 7z não são suportados | Extraia o arquivo e compacte a pasta novamente como ZIP. |
| Não é possível instalar este arquivo compactado | Verifique o nome e a pasta de destino. Se já houver uma Resource com o mesmo nome em outra pasta, renomeie a nova ou remova a antiga. Se o arquivo não contiver fxmanifest.lua (ou __resource.lua), não se trata de uma Resource, mas, por exemplo, apenas de um mapa ou arquivo de veículo. |
| Falta uma dependência no servidor | Instale primeiro a Resource que está faltando (por exemplo, ox_lib), também usando o instalador. Sem ela, normalmente a Resource não inicia. |
| Aviso de Recipe ou modelo de servidor ausente | Primeiro configure um modelo de servidor no txAdmin e, depois, abra o instalador novamente. |
| Já há uma instalação em andamento neste servidor | Aguarde a conclusão da instalação em andamento. O progresso continuará sendo exibido na página. |
| A instalação foi interrompida ou falhou | Verifique o servidor e tente instalar novamente. Se uma Resource existente tiver sido substituída, o instalador restaurará a pasta antiga em caso de erro. |
| SQL: USE não é permitido ou Não é permitido criar, alterar ou excluir bancos de dados | Remova as linhas USE e CREATE DATABASE do arquivo SQL e envie o ZIP novamente. |
| SQL: Falha na linha … | As instruções até essa linha já foram executadas. Corrija o arquivo e inicie a importação novamente, selecionando Ignorar tabelas existentes. |
| A Resource não inicia após a reinicialização | Verifique a mensagem de erro no console ao vivo, confirme se todas as dependências estão em execução e se a linha ensure está depois delas. Para obter ajuda com problemas comuns, consulte FiveM: problemas comuns. |
Quer verificar um arquivo sem instalá-lo? Nossa ferramenta gratuita FiveM Resource Installer faz a análise diretamente no navegador, sem enviar nada.
Fonte preferida no Google
