Den här guiden behandlar adminkonfiguration, konsolkommandon, Lua-paketsystemet, spelar- och fordonshantering samt databaskonfiguration för din Onset-dedikerade server på Legion Hosting. För grundläggande serverkonfiguration, se vår Onset Server Setup Guide.
Adminkonfiguration
Onset hanterar adminbehörigheter genom Lua-skript inom dina spellägespaket. Till skillnad från många spel med inbyggda adminsystem förlitar sig Onset på dina paket för att definiera vem som har förhöjda behörigheter och vad dessa behörigheter tillåter.
De flesta community-spellägespaket inkluderar ett adminsystem. Vanligtvis innebär adminkonfiguration:
- Öppna File Manager i GPanel
- Navigera till din paketkatalog (t.ex.
packages/mygamemode/) - Lokalisera adminkonfigurationsfilen (ofta
config.lua,admins.luaeller en JSON-konfigurationsfil) - Lägg till ditt Steam64 ID eller in-game-spelar-ID till adminlistan
- Spara filen och starta om servern
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}
Serverkonsolkommandon
Onset tillhandahåller inbyggda serverkonsolkommandon som fungerar oavsett installerade paket. Dessa kan anges direkt i GPanel-konsolen.
| Kommando | Beskrivning |
|---|---|
help |
Listar alla tillgängliga konsolkommandon |
stop |
Stoppar servern på ett kontrollerat sätt |
restart |
Startar om servern |
players |
Listar alla anslutna spelare med deras ID:n |
kick <playerid> [reason] |
Sparkar en spelare från servern |
ban <playerid> [reason] |
Bannar en spelare från servern |
unban <steamid> |
Tar bort en ban för det angivna Steam ID:t |
package reload <name> |
Laddar om ett paket utan att starta om servern |
package start <name> |
Startar ett paket som inte körs för närvarande |
package stop <name> |
Stoppar ett körande paket |
package list |
Listar alla laddade paket och deras status |
Paketsystem (Lua-skript)
Onsets spelmekanik definieras helt av paket skrivna i Lua. Varje paket är en mapp inuti katalogen packages/ som innehåller Lua-skript som körs på server- och/eller klientsidan.
Paketstruktur
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 scripts
Installera paket
- Ladda ner paketet från Onset-communityforumen eller GitHub-repositorier
- Anslut till din server via SFTP
- Ladda upp paketmappen till katalogen
packages/ - Öppna
server_config.jsoni File Manager - Lägg till paketmappens namn i
"packages"-arrayen - Starta om servern via GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}
"packages"-arrayen laddas i den ordning de listas. Om ett paket är beroende av ett annat, se till att beroendet listas först.
Spelarhantering
Utöver de inbyggda kick- och ban-kommandona tillhandahåller de flesta spellägespaket ytterligare funktioner för spelarhantering. Vanliga paketspecifika kommandon inkluderar:
| Kommando (Paketberoende) | Beskrivning |
|---|---|
/tp <player> |
Teleportera till en annan spelare |
/bring <player> |
Teleportera en annan spelare till din plats |
/goto <x> <y> <z> |
Teleportera till specifika världskoordinater |
/setadmin <player> <level> |
Ställ in en spelares adminnivå (om paketet stöder nivåer) |
/announce <message> |
Skicka ett serveromfattande meddelande |
Fordonshantering
Onset har ett inbyggt fordonssystem som paket kan utöka. Admins behöver ofta hantera spawnade fordon för att förhindra serveröverbelastning.
- Fordonsspawning — De flesta RP-paket låter admins spawna fordon via kommandon som
/car <model> - Fordonsrensning — Vissa paket inkluderar automatisk despawning av övergivna fordon eller adminkommandon som
/destroyvehicles - Fordonsgränser — Konfigurera maximalt antal fordon per spelare för att förhindra lagg från för många spawnade entiteter
Databas (MariaDB)
Onset stöder MariaDB/MySQL-databasanslutningar för permanent datalagring. Detta används av roleplay och andra spellägespaket för att lagra spelardata, inventarier, egendomar med mera.
Databaskonfiguration hanteras inom ditt pakets konfigurationsfiler. En typisk uppsättning:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}
Felsökning
| Problem | Lösning |
|---|---|
| Servern startar men inget spelläge är tillgängligt | Du behöver minst ett spellägespaket installerat och listat i server_config.json. En tom Onset-server har inget inbyggt spelläge. |
| Paketet misslyckas att ladda | Kontrollera GPanel-konsolen efter Lua-felmeddelanden. Vanliga orsaker: saknad package.json, syntaxfel i Lua-filer eller saknade beroenden. |
| Databasanslutningsfel | Verifiera dina databasuppgifter, säkerställ att databasen finns och kontrollera att MariaDB-tjänsten körs. Testa anslutningen från konsolloggarna. |
| Servern syns inte i webbläsaren | Säkerställ att "visible": true är inställt i server_config.json. Verifiera även att port 7776 (TCP) är åtkomlig för query-porten. |
| Hög latens eller lagg | Sänk värdet för streamdistance, minska tickrate om CPU-användningen är hög och kontrollera om det finns ineffektiva Lua-skript i dina paket. |
Relaterade artiklar
- Onset Server Setup Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
Behöver du hjälp?
Om du upplever problem med din Onset-server eller behöver ytterligare hjälp är vårt supportteam här för att hjälpa till. Skicka in ett supportärende så återkommer vi så snart som möjligt.