Este guia aborda como instalar recursos (scripts) no seu servidor FiveM, configurar um banco de dados MySQL para frameworks como ESX ou QBCore, e entender a ordem de carregamento de recursos. Se você ainda não completou a configuração inicial do servidor, comece com o Guia de Configuração do Servidor FiveM primeiro.

Instalando Recursos e Scripts

Servidores FiveM são expandidos com recursos (também chamados de scripts). Recursos adicionam funcionalidades como concessionárias de veículos, empregos, elementos de HUD, frameworks e mais.

Como Instalar um Recurso

1. Baixe o recurso de sua fonte (GitHub, fóruns Cfx.re, Tebex, etc.).
2. Extraia a pasta do recurso do ZIP/arquivo se necessário.
3. Envie a pasta do recurso para o diretório resources/ do seu servidor usando a aba Files do GPanel ou via SFTP.
4. Abra o server.cfg e adicione uma linha ensure para o recurso:

# Add your custom resources
ensure my-new-resource

5. Reinicie o servidor pelo GPanel ou TXAdmin para que o recurso seja carregado.

Manifestos de Recursos

Todo recurso válido deve conter um arquivo de manifesto. Recursos modernos usam fxmanifest.lua, enquanto os mais antigos usam __resource.lua. Se uma pasta de recurso baixada não contém nenhum desses arquivos, o recurso não será carregado. Alguns downloads colocam a pasta real do recurso dentro de uma pasta externa — certifique-se de que a pasta que você coloca em resources/ é a que contém o manifesto.

Ordem de Carregamento de Recursos

Os recursos são carregados na ordem em que aparecem no server.cfg. Se um recurso depende de outro (por exemplo, um script de emprego que depende de um framework como ESX ou QBCore), certifique-se de que a dependência esteja listada antes do recurso que precisa dela:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Organizando Recursos com Pastas de Categoria

Você pode organizar recursos em subpastas dentro do diretório resources/. Use a notação de colchetes no server.cfg para garantir o carregamento de uma pasta de categoria inteira:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Isso carrega todos os recursos dentro da subpasta nomeada. É uma maneira conveniente de agrupar scripts relacionados sem listar cada um individualmente.

Carregamento Dinâmico de Recursos via TXAdmin

Você nem sempre precisa reiniciar completamente o servidor para carregar um novo recurso. O TXAdmin pode iniciar, parar e reiniciar recursos individuais na sua página de Resources. Após enviar um novo recurso e adicionar sua linha ensure, você pode executar o seguinte comando no console ao vivo do TXAdmin:

refresh
ensure my-new-resource

O comando refresh instrui o servidor a reescanear o diretório resources/ em busca de novas entradas.

Configuração do Banco de Dados (MySQL / MariaDB)

Muitos frameworks e recursos do FiveM (como ESX, QBCore ou vRP) requerem um banco de dados MySQL ou MariaDB. A Legion Hosting fornece credenciais de banco de dados com seu servidor.

Encontrando Suas Credenciais do Banco de Dados

1. No GPanel, vá até a aba Databases.
2. Se nenhum banco de dados existir ainda, clique em New Database para criar um.
3. Anote os seguintes detalhes:
   • Database Host (endereço e porta)
   • Database Name
   • Username
   • Password (clique no ícone de olho para revelar)

Configurando a Conexão com o Banco de Dados

Os detalhes de conexão do banco de dados são definidos no server.cfg usando uma string de conexão. O formato exato depende de qual recurso MySQL você está usando, mas o formato mais comum é:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Substitua os espaços reservados pelas suas credenciais reais da aba Databases. Por exemplo:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Escolhendo um Recurso MySQL

Qualquer que seja o recurso MySQL que você use, ele deve ser garantido no server.cfg antes de quaisquer recursos que dependam dele:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Noções Básicas de Framework

Um framework fornece os sistemas principais de gameplay sobre os quais outros recursos são construídos — coisas como identidade do jogador, dinheiro, inventário, empregos e veículos. Os dois frameworks mais populares do FiveM são:

A maioria dos frameworks é instalada pelo sistema de receitas do TXAdmin durante a configuração inicial. Se você escolheu uma receita como "QBCore" ou "ESX" durante a configuração do TXAdmin, o framework e suas dependências principais já estão instalados. Se você precisar instalar um framework manualmente, siga sua documentação oficial:

• Documentação do ESX
• Documentação do QBCore

Obtendo Ajuda

Se você precisar de assistência com a instalação de recursos ou configuração do banco de dados:

1. Verifique a documentação do recurso ou sua página no GitHub para instruções de instalação e problemas conhecidos.
2. Revise o console do GPanel ou os logs do TXAdmin em busca de mensagens de erro.
3. Abra um ticket de suporte em https://legionhosting.net/submitticket.php com suas mensagens de erro e o nome do recurso que você está tentando instalar.

Artigos Relacionados

• Guia de Configuração do Servidor FiveM
• Solução de Problemas do FiveM
• Como Enviar Arquivos via SFTP
• Como Encontrar o IP e a Porta do Seu Servidor