Aquesta guia us acompanya en la configuració del vostre servidor de FiveM (multijugador de GTA V) allotjat amb Legion Hosting — des de l'obtenció de la clau de llicència CFX i la configuració de TXAdmin, fins a l'edició del server.cfg i la connexió dels jugadors.

Requisits previs

• Un servidor de FiveM de Legion Hosting (actiu al vostre compte)
• Un compte al fòrum de Cfx.re (gratuït — necessari per generar la vostra clau de llicència)
• Accés a GPanel
• Client de FiveM instal·lat al vostre PC (fivem.net)

Pas 1: Obtenir la vostra clau de llicència CFX

Cada servidor de FiveM requereix una clau de llicència única de Cfx.re (els desenvolupadors de FiveM). Aquesta clau és gratuïta i està vinculada al vostre compte de Cfx.re.

1. Aneu a https://keymaster.fivem.net/ i inicieu sessió amb el vostre compte del fòrum de Cfx.re.
2. Feu clic a New Server (o Register a new server).
3. Ompliu els detalls:
   • Label: Un nom descriptiu per al vostre servidor (p. ex. "My Legion FiveM Server")
   • Server IP Address: Introduïu l'adreça IP del vostre servidor des de GPanel (consulteu Com trobar la IP i el port del vostre servidor)
   • Server Type: Seleccioneu el tipus adequat (normalment "Other / Apache / nginx")
4. Feu clic a Generate.
5. Copieu la clau de llicència generada — la necessitareu en els passos següents.

Pas 2: Primer inici del servidor i configuració de TXAdmin

Els servidors de FiveM allotjats amb Legion Hosting inclouen TXAdmin — un panell de gestió basat en web que s'executa juntament amb el vostre servidor de FiveM. En el primer inici, TXAdmin us guiarà a través de la configuració inicial.

Iniciar el servidor

1. Inicieu sessió a GPanel i seleccioneu el vostre servidor de FiveM.
2. Aneu a la pestanya Startup i localitzeu la variable FIVEM_LICENSE (o similar). Enganxeu-hi la vostra clau de llicència CFX i deseu.
3. Aneu a la pestanya Console i feu clic a Start.
4. Observeu la sortida de la consola. En el primer inici, el servidor descarregarà els artefactes necessaris de FiveM — això pot trigar uns minuts.
5. Quan TXAdmin estigui llest, veureu un missatge a la consola amb l'URL de TXAdmin i un codi PIN.

Completar la configuració de TXAdmin

1. Obriu l'URL de TXAdmin al vostre navegador.
2. Introduïu el PIN mostrat a la sortida de la consola de GPanel.
3. Creeu el vostre compte d'administrador de TXAdmin (nom d'usuari i contrasenya).
4. TXAdmin us guiarà a través d'un assistent de configuració:
   • Server Name: Trieu el nom que es mostrarà al navegador de servidors de FiveM.
   • Deployment Type: Seleccioneu una plantilla (p. ex. "Popular Recipes" per a una base preconfigurada, o "Remote URL / Template" si teniu una configuració personalitzada).
   • Server Data Folder: Deixeu-ho per defecte tret que tingueu un motiu específic per canviar-ho.
   • CFX Key: Si se us demana de nou, enganxeu la vostra clau de llicència.
5. Completeu l'assistent i deixeu que TXAdmin acabi de desplegar els fitxers del servidor. Això pot trigar uns minuts.

Pas 3: Configurar server.cfg

El fitxer server.cfg és el fitxer de configuració principal del vostre servidor de FiveM. TXAdmin en genera un de bàsic durant la configuració, però voldreu revisar-lo i personalitzar-lo.

Accedir a server.cfg

1. A GPanel, feu clic a la pestanya Files.
2. Navegueu fins a la carpeta de dades del servidor (normalment el directori arrel o una carpeta creada per la plantilla de TXAdmin).
3. Feu clic a server.cfg per obrir-lo a l'editor integrat.

Paràmetres essencials

Un exemple mínim de server.cfg:

# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"

# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"

# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"

# Player Limit
sv_maxclients 48

# Privacy
sv_endpointprivacy true

# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat

Pas 4: Connectar-se al vostre servidor de FiveM

Un cop el vostre servidor estigui configurat i en funcionament, els jugadors poden connectar-se mitjançant el navegador de servidors de FiveM o una connexió directa.

Connexió directa

1. Obriu el client de FiveM.
2. Premeu F8 per obrir la consola de FiveM, o feu clic al botó Direct Connect a la pantalla d'inici.
3. Introduïu la IP i el port de joc del vostre servidor en el format IP:PORT.
4. Feu clic a Connect.

Navegador de servidors

1. Obriu el client de FiveM i feu clic a Play.
2. Al navegador de servidors, cerqueu el nom del vostre servidor (el valor de sv_hostname del server.cfg).
3. Feu clic al vostre servidor i després feu clic a Connect.

Gestió del servidor amb TXAdmin

Després de la configuració inicial, TXAdmin proporciona un tauler web per a la gestió diària del servidor. Accediu-hi a http://YOUR_SERVER_IP:TXADMIN_PORT.

Obtenir ajuda

Si heu seguit aquesta guia i encara teniu problemes:

1. Copieu qualsevol missatge d'error de la consola de GPanel o del registre de TXAdmin.
2. Anoteu en quin pas esteu bloquejats i què heu intentat fins ara.
3. Obriu un tiquet de suport a https://legionhosting.net/submitticket.php amb aquesta informació. El nostre equip us assistirà el més ràpid possible.

Articles relacionats

• Recursos, scripts i configuració de base de dades de FiveM
• Resolució de problemes de FiveM
• Com trobar la IP i el port del vostre servidor
• Com pujar fitxers via SFTP
• Guia d'inici del servidor