Este guia aborda como instalar recursos (scripts) no seu servidor FiveM, configurar uma base de dados MySQL para frameworks como ESX ou QBCore, e compreender a ordem de carregamento de recursos. Se ainda não completou a configuração inicial do servidor, comece pelo Guia de Configuração do Servidor FiveM.

Instalação de Recursos e Scripts

Os servidores FiveM são expandidos com recursos (também chamados scripts). Os recursos adicionam funcionalidades como stands de automóveis, empregos, elementos de HUD, frameworks e muito mais.

Como Instalar um Recurso

1. Descarregue o recurso a partir da sua fonte (GitHub, fóruns Cfx.re, Tebex, etc.).
2. Extraia a pasta do recurso do ficheiro ZIP/arquivo, se necessário.
3. Envie a pasta do recurso para o diretório resources/ do seu servidor utilizando o separador 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 a partir do GPanel ou do TXAdmin para que o recurso seja carregado.

Manifestos de Recursos

Cada recurso válido deve conter um ficheiro de manifesto. Os recursos modernos utilizam fxmanifest.lua, enquanto os mais antigos utilizam __resource.lua. Se a pasta de um recurso descarregado não contiver nenhum destes ficheiros, o recurso não será carregado. Alguns downloads colocam a pasta real do recurso dentro de uma pasta exterior — certifique-se de que a pasta que coloca em resources/ é aquela que contém o manifesto.

Ordem de Carregamento de Recursos

Os recursos são carregados pela 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 está 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

Organizar Recursos com Pastas de Categorias

Pode organizar recursos em subpastas dentro do diretório resources/. Utilize a notação com parênteses retos 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]

Isto carrega todos os recursos dentro da subpasta indicada. É uma forma conveniente de agrupar scripts relacionados sem listar cada um individualmente.

Carregamento Dinâmico de Recursos via TXAdmin

Nem sempre precisa de reiniciar completamente o servidor para carregar um novo recurso. O TXAdmin pode iniciar, parar e reiniciar recursos individuais a partir da sua página de Resources. Depois de enviar um novo recurso e adicionar a sua linha ensure, pode executar o seguinte comando na consola ao vivo do TXAdmin:

refresh
ensure my-new-resource

O comando refresh indica ao servidor para voltar a analisar o diretório resources/ à procura de novas entradas.

Configuração da Base de Dados (MySQL / MariaDB)

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

Encontrar as Credenciais da Base de Dados

1. No GPanel, vá ao separador Databases.
2. Se ainda não existir nenhuma base de dados, clique em New Database para criar uma.
3. Anote os seguintes dados:
   • Database Host (endereço e porta)
   • Database Name
   • Username
   • Password (clique no ícone do olho para revelar)

Configurar a Ligação à Base de Dados

Os dados de ligação à base de dados são definidos no server.cfg através de uma string de conexão. O formato exato depende do recurso MySQL que está a utilizar, 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 do separador Databases. Por exemplo:

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

Escolher um Recurso MySQL

Qualquer que seja o recurso MySQL que utilize, 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 Frameworks

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

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

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

Obter Ajuda

Se precisar de assistência com a instalação de recursos ou configuração da base de dados:

1. Consulte a documentação do recurso ou a sua página no GitHub para instruções de instalação e problemas conhecidos.
2. Reveja a consola do GPanel ou os registos do TXAdmin para mensagens de erro.
3. Abra um ticket de suporte em https://legionhosting.net/submitticket.php com as suas mensagens de erro e o nome do recurso que está a tentar instalar.

Artigos Relacionados

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