Aquesta guia explica com instal·lar recursos (scripts) al vostre servidor de FiveM, configurar una base de dades MySQL per a frameworks com ESX o QBCore, i entendre l'ordre de càrrega dels recursos. Si encara no heu completat la configuració inicial del servidor, comenceu amb la Guia de configuració del servidor de FiveM.

Instal·lació de recursos i scripts

Els servidors de FiveM s'amplien amb recursos (també anomenats scripts). Els recursos afegeixen funcionalitats com concessionaris de cotxes, feines, elements HUD, frameworks i molt més.

Com instal·lar un recurs

1. Descarregueu el recurs des de la seva font (GitHub, fòrums de Cfx.re, Tebex, etc.).
2. Extraieu la carpeta del recurs del ZIP/arxiu si cal.
3. Pugeu la carpeta del recurs al directori resources/ del vostre servidor utilitzant la pestanya Files de GPanel o via SFTP.
4. Obriu server.cfg i afegiu una línia ensure per al recurs:

# Add your custom resources
ensure my-new-resource

5. Reinicieu el servidor des de GPanel o TXAdmin perquè el recurs es carregui.

Manifests dels recursos

Cada recurs vàlid ha de contenir un fitxer manifest. Els recursos moderns utilitzen fxmanifest.lua, mentre que els més antics utilitzen __resource.lua. Si una carpeta de recurs descarregada no conté cap d'aquests fitxers, el recurs no es carregarà. Algunes descàrregues nien la carpeta real del recurs dins d'una carpeta exterior — assegureu-vos que la carpeta que col·loqueu a resources/ sigui la que conté el manifest.

Ordre de càrrega dels recursos

Els recursos es carreguen en l'ordre en què apareixen a server.cfg. Si un recurs depèn d'un altre (per exemple, un script de feina que depèn d'un framework com ESX o QBCore), assegureu-vos que la dependència estigui llistada abans del recurs que la necessita:

# 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

Organització de recursos amb carpetes de categories

Podeu organitzar els recursos en subcarpetes dins del directori resources/. Utilitzeu la notació amb claudàtors a server.cfg per assegurar tota una carpeta de categoria:

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

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

Això carrega tots els recursos dins de la subcarpeta indicada. És una manera pràctica d'agrupar scripts relacionats sense haver de llistar cadascun individualment.

Càrrega en calent de recursos via TXAdmin

No sempre cal un reinici complet del servidor per carregar un nou recurs. TXAdmin pot iniciar, aturar i reiniciar recursos individuals des de la seva pàgina de Resources. Després de pujar un nou recurs i afegir la seva línia ensure, podeu executar la comanda següent a la consola en viu de TXAdmin:

refresh
ensure my-new-resource

La comanda refresh indica al servidor que torni a escanejar el directori resources/ per trobar noves entrades.

Configuració de la base de dades (MySQL / MariaDB)

Molts frameworks i recursos de FiveM (com ESX, QBCore o vRP) requereixen una base de dades MySQL o MariaDB. Legion Hosting proporciona les credencials de la base de dades amb el vostre servidor.

Trobar les credencials de la base de dades

1. A GPanel, aneu a la pestanya Databases.
2. Si encara no existeix cap base de dades, feu clic a New Database per crear-ne una.
3. Anoteu els detalls següents:
   • Database Host (adreça i port)
   • Database Name
   • Username
   • Password (feu clic a la icona de l'ull per revelar-la)

Configuració de la connexió a la base de dades

Els detalls de connexió a la base de dades es configuren a server.cfg mitjançant una cadena de connexió. El format exacte depèn del recurs MySQL que utilitzeu, però el format més habitual és:

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

Substituïu els marcadors de posició amb les vostres credencials reals de la pestanya Databases. Per exemple:

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

Triar un recurs MySQL

Sigui quin sigui el recurs MySQL que utilitzeu, ha d'estar assegurat a server.cfg abans de qualsevol recurs que en depengui:

# 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

Conceptes bàsics dels frameworks

Un framework proporciona els sistemes de joc bàsics sobre els quals es construeixen altres recursos — coses com la identitat del jugador, diners, inventari, feines i vehicles. Els dos frameworks de FiveM més populars són:

La majoria de frameworks s'instal·len mitjançant el sistema de receptes de TXAdmin durant la configuració inicial. Si heu triat una recepta com "QBCore" o "ESX" durant la configuració de TXAdmin, el framework i les seves dependències bàsiques ja estan instal·lats. Si necessiteu instal·lar un framework manualment, seguiu la seva documentació oficial:

• Documentació d'ESX
• Documentació de QBCore

Obtenir ajuda

Si necessiteu assistència amb la instal·lació de recursos o la configuració de la base de dades:

1. Consulteu la documentació del recurs o la seva pàgina de GitHub per a instruccions d'instal·lació i problemes coneguts.
2. Reviseu la consola de GPanel o els registres de TXAdmin per a missatges d'error.
3. Obriu un tiquet de suport a https://legionhosting.net/submitticket.php amb els vostres missatges d'error i el nom del recurs que esteu intentant instal·lar.

Articles relacionats

• Guia de configuració del servidor de FiveM
• Resolució de problemes de FiveM
• Com pujar fitxers via SFTP
• Com trobar la IP i el port del vostre servidor