Aquesta guia cobreix la configuració d'administrador, els recursos del servidor, els mapes personalitzats, la gestió de vehicles i la resolució de problemes per al vostre servidor BeamMP a Legion Hosting. Per a la configuració inicial del servidor, les claus d'autenticació i la configuració bàsica, consulteu la Guia de configuració del servidor BeamMP.

---

Configuració d'administrador

BeamMP no té un sistema tradicional d'inici de sessió o contrasenya d'administrador. En canvi, les comandes d'administrador s'executen a través de la consola del servidor o mitjançant plugins Lua del costat del servidor que comproven els identificadors dels jugadors.

Comandes de consola

La consola del servidor a GPanel proporciona accés directe a les comandes integrades del servidor. Escriviu les comandes directament al camp d'entrada de la consola:

---

Estructura de la carpeta de recursos

BeamMP utilitza una carpeta Resources per organitzar el contingut del costat del servidor. Aquesta carpeta conté dos subdirectoris amb finalitats diferents:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

Recursos del client

Els fitxers col·locats a Resources/Client/ es descarreguen automàticament pels jugadors quan es connecten. S'utilitza per a:

• Mapes personalitzats — Fitxers .zip de mods de mapes que els jugadors necessiten per carregar el mapa del servidor.
• Vehicles personalitzats — Fitxers .zip de mods de vehicles que afegeixen cotxes nous o modifiquen els existents.
• Altres mods de client — Qualsevol mod de BeamNG.drive que necessiti estar present al client.

Recursos del servidor (plugins Lua)

El directori Resources/Server/ conté plugins Lua del costat del servidor. Aquests s'executen només al servidor i no s'envien als jugadors. Cada plugin viu a la seva pròpia subcarpeta amb un fitxer main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

Els plugins del costat del servidor poden:

• Respondre a esdeveniments dels jugadors (unir-se, sortir, missatges de xat, aparicions de vehicles).
• Implementar comandes personalitzades activades via xat (p. ex., /tp, /give).
• Gestionar permisos i límits de vehicles.
• Afegir sistemes d'economia, teletransport o altres funcions de jugabilitat personalitzades.
• Registrar l'activitat dels jugadors i aplicar regles.

---

Afegir mapes personalitzats

Per executar un mapa personalitzat (no predeterminat) al vostre servidor BeamMP:

1. Descarregueu el mod del mapa com a fitxer .zip d'una font de mods de BeamNG.drive (p. ex., el repositori de mods de BeamNG.drive).
2. Atureu el vostre servidor a GPanel.
3. Pugeu el fitxer .zip a Resources/Client/ mitjançant la pestanya Files o SFTP. No descomprimiu el zip.
4. Actualitzeu la variable d'inici MAP (o Map a ServerConfig.toml) amb la ruta correcta del mapa personalitzat. Aquesta ruta normalment té el format /levels/map_name/info.json — consulteu la documentació del mod per a la ruta exacta.
5. Inicieu el servidor.

---

Gestió de vehicles

La gestió de vehicles als servidors BeamMP es controla mitjançant la configuració MaxCars i opcionalment mitjançant plugins Lua del costat del servidor.

Configuració de MaxCars

La configuració MaxCars a ServerConfig.toml (o la variable d'inici MAX_CARS) controla quants vehicles pot generar cada jugador simultàniament:

• 1 — Cada jugador pot tenir un vehicle alhora (recomanat per a servidors grans).
• 2–3 — Permet als jugadors tenir un parell de vehicles, útil per a servidors petits o trobades de cotxes.
• Valors més alts augmenten la càrrega del servidor proporcionalment.

Mods de vehicles personalitzats

Per afegir vehicles personalitzats al vostre servidor:

1. Descarregueu el mod del vehicle com a fitxer .zip.
2. Col·loqueu-lo a Resources/Client/.
3. Reinicieu el servidor. Els jugadors descarregaran automàticament el mod del vehicle en connectar-se.

Restringir vehicles mitjançant plugins

Per a un control més granular (p. ex., prohibir vehicles específics, limitar tipus de vehicles), necessitareu un plugin Lua del costat del servidor. Aquests plugins poden interceptar esdeveniments de generació de vehicles i permetre'ls o denegar-los segons regles personalitzades. Consulteu els fòrums de BeamMP per a plugins de gestió de vehicles.

---

Instal·lar i gestionar plugins

Els plugins Lua del costat del servidor amplien la funcionalitat del vostre servidor. Aquí teniu com instal·lar-los i gestionar-los:

Instal·lar un plugin

1. Descarregueu els fitxers del plugin (normalment una carpeta que conté main.lua i possiblement altres fitxers).
2. Atureu el vostre servidor.
3. Pugeu la carpeta del plugin a Resources/Server/ mitjançant la pestanya Files o SFTP.
4. Assegureu-vos que l'estructura de carpetes és correcta: Resources/Server/PluginName/main.lua.
5. Inicieu el servidor. La consola mostrarà missatges a mesura que es carreguin els plugins.

Eliminar un plugin

1. Atureu el vostre servidor.
2. Elimineu la carpeta del plugin de Resources/Server/.
3. Inicieu el servidor.

---

Resolució de problemes

Errors de clau d'autenticació

• Verifiqueu que la clau s'ha enganxat correctament a la variable d'inici AUTH_KEY — sense espais addicionals ni salts de línia.
• Assegureu-vos que la clau no ha estat revocada o no ha caducat al BeamMP Keymaster.
• Cada clau només es pot utilitzar en un servidor alhora. Si esteu utilitzant la mateixa clau en un altre lloc, fallarà.
• La consola mostrarà errors d'autenticació a l'inici si la clau no és vàlida.

Els jugadors no es poden connectar

• Confirmeu que el servidor s'ha iniciat completament i es mostra com a en línia a GPanel.
• Comproveu que el jugador està utilitzant el llançador de BeamMP, no el llançador estàndard de BeamNG.drive.
• Si el servidor està configurat com a Private = true, els jugadors han d'utilitzar la connexió directa amb la IP i el port correctes. Consulteu Com trobar la IP i el port del vostre servidor.
• Assegureu-vos que la versió del llançador de BeamMP del jugador és compatible amb la versió del servidor. Els llançadors obsolets poden no connectar-se.
• Si el servidor és ple (s'ha assolit MaxPlayers), els jugadors addicionals no poden unir-s'hi fins que algú surti.

Problemes de sincronització de mods

• Si els jugadors es queden bloquejats descarregant o reben errors sobre mods que falten, verifiqueu que els fitxers .zip dels mods a Resources/Client/ no estan danyats.
• Torneu a descarregar i pugeu el fitxer del mod si el .zip està malmès.
• Fitxers de mods molt grans poden causar temps d'espera per als jugadors amb connexions lentes. Considereu eliminar mods grans innecessaris.
• Assegureu-vos que els fitxers .zip dels mods no estan imbricats (és a dir, un .zip dins d'una carpeta dins d'un altre .zip).

Problemes de rendiment amb molts jugadors/vehicles

• Reduïu MaxCars a 1 per jugador.
• Reduïu MaxPlayers si el servidor experimenta lag constant.
• Canvieu a un mapa més simple (Grid Map o Industrial) per a un millor rendiment amb molts jugadors.
• Elimineu mods de client innecessaris de Resources/Client/ per reduir els temps de descàrrega i l'ús de memòria.
• Consulteu els gràfics d'ús de recursos de GPanel — si la CPU o la RAM estan constantment al límit, considereu actualitzar el vostre pla de servidor. Obriu un tiquet de suport per discutir opcions.

El servidor no apareix al navegador

• Assegureu-vos que Private està configurat com a false a la vostra configuració.
• Verifiqueu que la clau d'autenticació és vàlida i no està en ús per un altre servidor.
• Espereu 1–2 minuts després de l'inici perquè el servidor es registri amb el backend de BeamMP.
• Comproveu la consola per si hi ha errors relacionats amb la connexió al servidor mestre.

---

Articles relacionats

• Guia de configuració del servidor BeamMP — Configuració inicial, clau d'autenticació, configuració i instruccions de connexió
• Com trobar la IP i el port del vostre servidor
• Com pujar fitxers via SFTP
• Guia d'inici del servidor — Guia general per iniciar qualsevol servidor de jocs a Legion Hosting

---

Necessiteu més ajuda?

Si teniu problemes no coberts en aquesta guia, el nostre equip de suport està disponible per ajudar-vos. Obriu un tiquet a legionhosting.net/submitticket.php amb els detalls del vostre servidor, una descripció del problema i qualsevol missatge d'error rellevant de la consola de GPanel.