Esta guía cubre la configuración de administración, recursos del lado del servidor, mapas personalizados, gestión de vehículos y solución de problemas para tu servidor BeamMP en Legion Hosting. Para la configuración inicial del servidor, claves de autenticación y configuración básica, consulta Guía de Configuración del Servidor BeamMP.
Configuración de Administración
BeamMP no tiene un sistema tradicional de inicio de sesión o contraseña de administrador. En su lugar, los comandos de administración se ejecutan a través de la consola del servidor o mediante plugins Lua del lado del servidor que verifican los identificadores de los jugadores.
Comandos de Consola
La consola del servidor en GPanel proporciona acceso directo a los comandos integrados del servidor. Escribe los comandos directamente en el campo de entrada de la consola:
| Comando | Descripción |
|---|---|
kick <player_id> <reason> |
Expulsa a un jugador del servidor con un mensaje de razón opcional. |
ban <player_name> |
Banea a un jugador del servidor. Los jugadores baneados no pueden reconectarse. |
unban <player_name> |
Elimina el baneo de un jugador, permitiéndole reconectarse. |
list |
Muestra todos los jugadores conectados actualmente con sus IDs. |
say <message> |
Envía un mensaje de chat a todo el servidor desde la consola. |
status |
Muestra información del estado del servidor incluyendo cantidad de jugadores y tiempo de actividad. |
help |
Lista todos los comandos de consola disponibles. |
list para ver los jugadores conectados y sus IDs. Estos IDs son necesarios para comandos como kick.
Estructura de la Carpeta Resources
BeamMP utiliza una carpeta Resources para organizar el contenido del lado del servidor. Esta carpeta contiene dos subdirectorios con propósitos distintos:
Resources/
Client/ <-- Mods del lado del cliente (mapas, vehículos) sincronizados con los jugadores
Server/ <-- Plugins Lua del lado del servidor (no se envían a los jugadores)Recursos del Cliente
Los archivos colocados en Resources/Client/ son descargados automáticamente por los jugadores cuando se conectan. Esto se utiliza para:
- Mapas personalizados — Archivos .zip de mods de mapas que los jugadores necesitan para cargar el mapa del servidor.
- Vehículos personalizados — Archivos .zip de mods de vehículos que agregan autos nuevos o modifican los existentes.
- Otros mods del cliente — Cualquier mod de BeamNG.drive que necesite estar presente en el cliente.
Resources/Client/ es descargado por cada jugador que se une. Archivos grandes o muchos mods aumentarán significativamente los tiempos de conexión. Mantén tus recursos del cliente ligeros para la mejor experiencia de los jugadores.
Recursos del Servidor (Plugins Lua)
El directorio Resources/Server/ contiene plugins Lua del lado del servidor. Estos se ejecutan solo en el servidor y no se envían a los jugadores. Cada plugin se encuentra en su propia subcarpeta con un archivo main.lua:
Resources/
Server/
MyPlugin/
main.lua <-- Punto de entrada del plugin
AnotherPlugin/
main.luaLos plugins del lado del servidor pueden:
- Responder a eventos de jugadores (unirse, salir, mensajes de chat, aparición de vehículos).
- Implementar comandos personalizados activados por chat (por ejemplo,
/tp,/give). - Gestionar permisos y límites de vehículos.
- Agregar sistemas de economía, teletransportación u otras funciones de juego personalizadas.
- Registrar actividad de jugadores y hacer cumplir reglas.
Agregar Mapas Personalizados
Para ejecutar un mapa personalizado (no predeterminado) en tu servidor BeamMP:
- Descarga el mod del mapa como un archivo
.zipdesde una fuente de mods de BeamNG.drive (por ejemplo, el repositorio de mods de BeamNG.drive). - Detén tu servidor en GPanel.
- Sube el archivo
.zipaResources/Client/mediante la pestaña Files o SFTP. No extraigas el zip. - Actualiza la variable de inicio
MAP(oMapenServerConfig.toml) con la ruta correcta del mapa personalizado. Esta ruta típicamente tiene el formato/levels/map_name/info.json— consulta la documentación del mod para la ruta exacta. - Inicia el servidor.
Map no coincide con la ruta real dentro del archivo .zip del mod, el servidor no podrá cargar el mapa. Consulta la documentación del mod o inspecciona la estructura del .zip para encontrar la ruta correcta de /levels/.
Resources/Client/ que el jugador no tenga. Los jugadores no necesitan instalar manualmente los mods de mapas.
Gestión de Vehículos
La gestión de vehículos en servidores BeamMP se controla a través de la configuración MaxCars y opcionalmente mediante plugins Lua del lado del servidor.
Configuración de MaxCars
La configuración MaxCars en ServerConfig.toml (o la variable de inicio MAX_CARS) controla cuántos vehículos puede generar cada jugador simultáneamente:
1— Cada jugador puede tener un vehículo a la vez (recomendado para servidores más grandes).2–3— Permite a los jugadores tener un par de vehículos, útil para servidores más pequeños o encuentros de autos.- Valores más altos aumentan la carga del servidor proporcionalmente.
Mods de Vehículos Personalizados
Para agregar vehículos personalizados a tu servidor:
- Descarga el mod del vehículo como un archivo
.zip. - Colócalo en
Resources/Client/. - Reinicia el servidor. Los jugadores descargarán automáticamente el mod del vehículo al conectarse.
Restringir Vehículos mediante Plugins
Para un control más granular (por ejemplo, prohibir vehículos específicos, limitar tipos de vehículos), necesitarás un plugin Lua del lado del servidor. Estos plugins pueden interceptar eventos de aparición de vehículos y permitirlos o denegarlos según reglas personalizadas. Consulta los foros de BeamMP para plugins de gestión de vehículos.
Instalación y Gestión de Plugins
Los plugins Lua del lado del servidor extienden la funcionalidad de tu servidor. Aquí se explica cómo instalarlos y gestionarlos:
Instalar un Plugin
- Descarga los archivos del plugin (típicamente una carpeta que contiene
main.luay posiblemente otros archivos). - Detén tu servidor.
- Sube la carpeta del plugin a
Resources/Server/mediante la pestaña Files o SFTP. - Asegúrate de que la estructura de carpetas sea correcta:
Resources/Server/PluginName/main.lua. - Inicia el servidor. La consola mostrará mensajes a medida que los plugins se carguen.
Eliminar un Plugin
- Detén tu servidor.
- Elimina la carpeta del plugin de
Resources/Server/. - Inicia el servidor.
Solución de Problemas
Errores de Clave de Autenticación
- Verifica que la clave esté correctamente pegada en la variable de inicio
AUTH_KEY— sin espacios adicionales ni saltos de línea. - Asegúrate de que la clave no haya sido revocada o expirada en el BeamMP Keymaster.
- Cada clave solo puede usarse en un servidor a la vez. Si estás usando la misma clave en otro lugar, fallará.
- La consola mostrará errores de autenticación al iniciar si la clave es inválida.
Los Jugadores No Pueden Conectarse
- Confirma que el servidor esté completamente iniciado y se muestre como en línea en GPanel.
- Verifica que el jugador esté usando el launcher de BeamMP, no el launcher estándar de BeamNG.drive.
- Si el servidor está configurado como
Private = true, los jugadores deben usar conexión directa con la IP y el port correctos. Consulta Cómo Encontrar la IP y el Puerto de tu Servidor. - Asegúrate de que la versión del launcher de BeamMP del jugador sea compatible con la versión del servidor. Los launchers desactualizados pueden fallar al conectarse.
- Si el servidor está lleno (se alcanzó
MaxPlayers), los jugadores adicionales no pueden unirse hasta que alguien salga.
Problemas de Sincronización de Mods
- Si los jugadores se quedan atascados descargando o reciben errores sobre mods faltantes, verifica que los archivos .zip de mods en
Resources/Client/no estén corruptos. - Vuelve a descargar y subir el archivo del mod si el .zip está dañado.
- Archivos de mods muy grandes pueden causar tiempos de espera agotados para jugadores con conexiones lentas. Considera eliminar mods grandes innecesarios.
- Asegúrate de que los archivos .zip de mods no estén anidados (es decir, un .zip dentro de una carpeta dentro de otro .zip).
Problemas de Rendimiento con Muchos Jugadores/Vehículos
- Reduce
MaxCarsa1por jugador. - Reduce
MaxPlayerssi el servidor experimenta lag constante. - Cambia a un mapa más simple (Grid Map o Industrial) para mejor rendimiento con altas cantidades de jugadores.
- Elimina mods del cliente innecesarios de
Resources/Client/para reducir tiempos de descarga y uso de memoria. - Revisa los gráficos de uso de recursos en GPanel — si la CPU o RAM está constantemente al límite, considera mejorar tu plan de servidor. Abre un ticket de soporte para discutir opciones.
El Servidor No Aparece en el Navegador
- Asegúrate de que
Privateesté configurado comofalseen tu configuración. - Verifica que la clave de autenticación sea válida y no esté en uso por otro servidor.
- Espera 1–2 minutos después del inicio para que el servidor se registre con el backend de BeamMP.
- Revisa la consola en busca de errores relacionados con la conexión al servidor maestro.
Artículos Relacionados
- Guía de Configuración del Servidor BeamMP — Configuración inicial, clave de autenticación, configuración e instrucciones de conexión
- Cómo Encontrar la IP y el Puerto de tu Servidor
- Cómo Subir Archivos mediante SFTP
- Guía de Inicio del Servidor — Guía general para iniciar cualquier servidor de juegos en Legion Hosting
¿Necesitas Más Ayuda?
Si estás experimentando problemas no cubiertos en esta guía, nuestro equipo de soporte está disponible para asistirte. Abre un ticket en legionhosting.net/submitticket.php con los detalles de tu servidor, una descripción del problema y cualquier mensaje de error relevante de la consola de GPanel.
