Aquesta guia cobreix la configuració d'administració, les comandes de consola, el sistema de paquets Lua, la gestió de jugadors i vehicles, i la configuració de bases de dades per al vostre servidor dedicat d'Onset a Legion Hosting. Per a la configuració inicial del servidor, consulteu la nostra Guia de configuració del servidor d'Onset.
Configuració d'administració
Onset gestiona els privilegis d'administració mitjançant scripts Lua dins dels vostres paquets de mode de joc. A diferència de molts jocs amb sistemes d'administració integrats, Onset es basa en els vostres paquets per definir qui té permisos elevats i què permeten aquests permisos.
La majoria de paquets de mode de joc de la comunitat inclouen un sistema d'administració. Normalment, la configuració d'administració implica:
- Obriu el File Manager a GPanel
- Navegueu al directori del vostre paquet (p. ex.,
packages/mygamemode/) - Localitzeu el fitxer de configuració d'administració (sovint
config.lua,admins.luao un fitxer de configuració JSON) - Afegiu el vostre Steam64 ID o l'ID de jugador dins del joc a la llista d'administradors
- Deseu el fitxer i reinicieu el servidor
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Comandes de consola del servidor
Onset proporciona comandes de consola del servidor integrades que funcionen independentment dels paquets instal·lats. Aquestes es poden introduir directament a la consola de GPanel.
| Comanda | Descripció |
|---|---|
help |
Llista totes les comandes de consola disponibles |
stop |
Atura el servidor de manera ordenada |
restart |
Reinicia el servidor |
players |
Llista tots els jugadors connectats amb els seus IDs |
kick <playerid> [reason] |
Expulsa un jugador del servidor |
ban <playerid> [reason] |
Bloqueja un jugador del servidor |
unban <steamid> |
Elimina el bloqueig per a l'Steam ID especificat |
package reload <name> |
Recarrega un paquet sense reiniciar el servidor |
package start <name> |
Inicia un paquet que no s'està executant |
package stop <name> |
Atura un paquet en execució |
package list |
Llista tots els paquets carregats i el seu estat |
Sistema de paquets (Lua Scripting)
La jugabilitat d'Onset es defineix completament per paquets escrits en Lua. Cada paquet és una carpeta dins del directori packages/ que conté scripts Lua que s'executen al costat del servidor i/o del client.
Estructura del paquet
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 scriptsInstal·lació de paquets
- Descarregueu el paquet dels fòrums de la comunitat d'Onset o dels repositoris de GitHub
- Connecteu-vos al vostre servidor via SFTP
- Pugeu la carpeta del paquet al directori
packages/ - Obriu
server_config.jsonal File Manager - Afegiu el nom de la carpeta del paquet a l'array
"packages" - Reinicieu el servidor a través de GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" es carreguen en l'ordre en què estan llistats. Si un paquet depèn d'un altre, assegureu-vos que la dependència estigui llistada primer.
Gestió de jugadors
A més de les comandes integrades d'expulsió i bloqueig, la majoria de paquets de mode de joc proporcionen funcions addicionals de gestió de jugadors. Les comandes habituals proporcionades per paquets inclouen:
| Comanda (dependent del paquet) | Descripció |
|---|---|
/tp <player> |
Teletransportar-se a un altre jugador |
/bring <player> |
Teletransportar un altre jugador a la vostra ubicació |
/goto <x> <y> <z> |
Teletransportar-se a coordenades específiques del món |
/setadmin <player> <level> |
Establir el nivell d'administrador d'un jugador (si el paquet admet nivells) |
/announce <message> |
Enviar un anunci a tot el servidor |
Gestió de vehicles
Onset inclou un sistema de vehicles integrat que els paquets poden ampliar. Els administradors sovint necessiten gestionar els vehicles generats per evitar la saturació del servidor.
- Generació de vehicles — La majoria de paquets de RP permeten als administradors generar vehicles amb comandes com
/car <model> - Neteja de vehicles — Alguns paquets inclouen la desaparició automàtica de vehicles abandonats o comandes d'administrador com
/destroyvehicles - Límits de vehicles — Configureu el màxim de vehicles per jugador per evitar retard causat per massa entitats generades
Base de dades (MariaDB)
Onset admet connexions a bases de dades MariaDB/MySQL per a l'emmagatzematge persistent de dades. Això és utilitzat pels paquets de roleplay i altres modes de joc per emmagatzemar dades de jugadors, inventaris, propietats i més.
La configuració de la base de dades es gestiona dins dels fitxers de configuració del vostre paquet. Una configuració típica:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Resolució de problemes
| Problema | Solució |
|---|---|
| El servidor s'inicia però no hi ha jugabilitat disponible | Necessiteu almenys un paquet de mode de joc instal·lat i llistat a server_config.json. Un servidor d'Onset nu no té jugabilitat integrada. |
| El paquet no es carrega | Comproveu la consola de GPanel per a missatges d'error de Lua. Causes habituals: package.json absent, errors de sintaxi als fitxers Lua o dependències mancants. |
| Errors de connexió a la base de dades | Verifiqueu les credencials de la vostra base de dades, assegureu-vos que la base de dades existeixi i comproveu que el servei MariaDB estigui en funcionament. Proveu la connectivitat des dels registres de la consola. |
| El servidor no és visible al navegador | Assegureu-vos que "visible": true estigui establert a server_config.json. Verifiqueu també que el port 7776 (TCP) sigui accessible per al port de consulta. |
| Alta latència o retard | Reduïu el valor de streamdistance, reduïu el tickrate si l'ús de CPU és alt i comproveu si hi ha scripts Lua ineficients als vostres paquets. |
Articles relacionats
- Guia de configuració del servidor d'Onset
- Com trobar la IP i el port del vostre servidor
- Com pujar fitxers via SFTP
- Primers passos amb el vostre nou servidor
Necessiteu ajuda?
Si teniu problemes amb el vostre servidor d'Onset o necessiteu més assistència, el nostre equip de suport està aquí per ajudar-vos. Envieu un tiquet de suport i us respondrem el més aviat possible.
