Esta guía cubre la configuración de administrador, comandos de consola, el sistema de paquetes Lua, gestión de jugadores y vehículos, y configuración de base de datos para tu servidor dedicado de Onset en Legion Hosting. Para la configuración inicial del servidor, consulta nuestra Onset Server Setup Guide.
Configuración de Admin
Onset gestiona los privilegios de administrador a través de scripts Lua dentro de los paquetes de tu modo de juego. A diferencia de muchos juegos con sistemas de admin integrados, Onset depende de tus paquetes para definir quién tiene permisos elevados y qué permiten esos permisos.
La mayoría de los paquetes de modos de juego de la comunidad incluyen un sistema de admin. Típicamente, la configuración de admin implica:
- Abre el File Manager en GPanel
- Navega al directorio de tu paquete (ej.,
packages/mygamemode/) - Localiza el archivo de configuración de admin (generalmente
config.lua,admins.lua, o un archivo de configuración JSON) - Agrega tu Steam64 ID o ID de jugador del juego a la lista de administradores
- Guarda el archivo y reinicia el servidor
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Comandos de Consola del Servidor
Onset proporciona comandos de consola integrados que funcionan independientemente de los paquetes instalados. Estos se pueden ingresar directamente en la consola de GPanel.
| Comando | Descripción |
|---|---|
help |
Lista todos los comandos de consola disponibles |
stop |
Detiene el servidor de forma segura |
restart |
Reinicia el servidor |
players |
Lista todos los jugadores conectados con sus IDs |
kick <playerid> [reason] |
Expulsa a un jugador del servidor |
ban <playerid> [reason] |
Banea a un jugador del servidor |
unban <steamid> |
Elimina un baneo para el Steam ID especificado |
package reload <name> |
Recarga un paquete sin reiniciar el servidor |
package start <name> |
Inicia un paquete que no está ejecutándose actualmente |
package stop <name> |
Detiene un paquete en ejecución |
package list |
Lista todos los paquetes cargados y su estado |
Sistema de Paquetes (Scripting Lua)
La jugabilidad de Onset está definida completamente por paquetes escritos en Lua. Cada paquete es una carpeta dentro del directorio packages/ que contiene scripts Lua que se ejecutan en el lado del servidor y/o del cliente.
Estructura de Paquetes
packages/
mygamemode/
package.json <-- Package metadata and file declarations
server/
main.lua <-- Server-side entry point
commands.lua <-- Custom command handlers
client/
main.lua <-- Client-side entry point
ui.lua <-- User interface scriptsInstalación de Paquetes
- Descarga el paquete desde los foros de la comunidad de Onset o repositorios de GitHub
- Conéctate a tu servidor vía SFTP
- Sube la carpeta del paquete al directorio
packages/ - Abre
server_config.jsonen el File Manager - Agrega el nombre de la carpeta del paquete al arreglo
"packages" - Reinicia el servidor a través de GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" se cargan en el orden en que están listados. Si un paquete depende de otro, asegúrate de que la dependencia esté listada primero.
Gestión de Jugadores
Más allá de los comandos integrados de expulsión y baneo, la mayoría de los paquetes de modos de juego proporcionan funciones adicionales de gestión de jugadores. Los comandos comunes proporcionados por paquetes incluyen:
| Comando (Dependiente del Paquete) | Descripción |
|---|---|
/tp <player> |
Teletransportarse a otro jugador |
/bring <player> |
Teletransportar a otro jugador a tu ubicación |
/goto <x> <y> <z> |
Teletransportarse a coordenadas específicas del mundo |
/setadmin <player> <level> |
Establecer el nivel de admin de un jugador (si el paquete soporta niveles) |
/announce <message> |
Enviar un anuncio a todo el servidor |
Gestión de Vehículos
Onset cuenta con un sistema de vehículos integrado que los paquetes pueden extender. Los administradores comúnmente necesitan gestionar los vehículos generados para evitar la acumulación en el servidor.
- Generación de vehículos — La mayoría de los paquetes RP permiten a los admins generar vehículos mediante comandos como
/car <model> - Limpieza de vehículos — Algunos paquetes incluyen auto-despawn para vehículos abandonados o comandos de admin como
/destroyvehicles - Límites de vehículos — Configura el máximo de vehículos por jugador para prevenir lag por demasiadas entidades generadas
Base de Datos (MariaDB)
Onset soporta conexiones de base de datos MariaDB/MySQL para almacenamiento persistente de datos. Esto es utilizado por paquetes de roleplay y otros modos de juego para almacenar datos de jugadores, inventarios, propiedades y más.
La configuración de la base de datos se maneja dentro de los archivos de configuración de tu paquete. Una configuración típica:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Solución de Problemas
| Problema | Solución |
|---|---|
| El servidor inicia pero no hay jugabilidad disponible | Necesitas al menos un paquete de modo de juego instalado y listado en server_config.json. Un servidor Onset sin paquetes no tiene jugabilidad integrada. |
| El paquete no se carga | Revisa la consola de GPanel para mensajes de error de Lua. Causas comunes: falta package.json, errores de sintaxis en archivos Lua, o dependencias faltantes. |
| Errores de conexión a la base de datos | Verifica tus credenciales de base de datos, asegúrate de que la base de datos exista y comprueba que el servicio MariaDB esté ejecutándose. Prueba la conectividad desde los registros de la consola. |
| El servidor no es visible en el navegador | Asegúrate de que "visible": true esté establecido en server_config.json. También verifica que el puerto 7776 (TCP) sea accesible para el puerto de consulta. |
| Alta latencia o lag | Reduce el valor de streamdistance, disminuye el tickrate si el uso de CPU es alto, y revisa los scripts Lua ineficientes en tus paquetes. |
Artículos Relacionados
- Onset Server Setup Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
¿Necesitas Ayuda?
Si estás experimentando problemas con tu servidor de Onset o necesitas asistencia adicional, nuestro equipo de soporte está aquí para ayudarte. Envía un ticket de soporte y te responderemos lo antes posible.
