Diese Anleitung behandelt die Admin-Einrichtung, Konsolenbefehle, das Lua-Paketsystem, Spieler- und Fahrzeugverwaltung sowie die Datenbankkonfiguration für Ihren Onset Dedicated Server bei Legion Hosting. Für die Ersteinrichtung des Servers siehe unsere Onset Server-Einrichtungsanleitung.
Admin-Einrichtung
Onset verwaltet Admin-Berechtigungen über Lua-Scripting innerhalb Ihrer Spielmodus-Pakete. Anders als viele Spiele mit eingebauten Admin-Systemen setzt Onset auf Ihre Pakete, um festzulegen, wer erweiterte Berechtigungen hat und was diese erlauben.
Die meisten Community-Spielmodus-Pakete beinhalten ein Admin-System. Typischerweise umfasst die Admin-Einrichtung:
- Öffnen Sie den File Manager in GPanel
- Navigieren Sie zu Ihrem Paketverzeichnis (z.B.
packages/mygamemode/) - Suchen Sie die Admin-Konfigurationsdatei (oft
config.lua,admins.luaoder eine JSON-Konfigurationsdatei) - Fügen Sie Ihre Steam64-ID oder In-Game-Spieler-ID zur Admin-Liste hinzu
- Speichern Sie die Datei und starten Sie den Server neu
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Server-Konsolenbefehle
Onset bietet eingebaute Server-Konsolenbefehle, die unabhängig von installierten Paketen funktionieren. Diese können direkt in der GPanel-Konsole eingegeben werden.
| Befehl | Beschreibung |
|---|---|
help |
Listet alle verfügbaren Konsolenbefehle auf |
stop |
Stoppt den Server ordnungsgemäß |
restart |
Startet den Server neu |
players |
Listet alle verbundenen Spieler mit ihren IDs auf |
kick <playerid> [reason] |
Kickt einen Spieler vom Server |
ban <playerid> [reason] |
Bannt einen Spieler vom Server |
unban <steamid> |
Hebt den Ban für die angegebene Steam-ID auf |
package reload <name> |
Lädt ein Paket neu, ohne den Server neu zu starten |
package start <name> |
Startet ein Paket, das derzeit nicht läuft |
package stop <name> |
Stoppt ein laufendes Paket |
package list |
Listet alle geladenen Pakete und ihren Status auf |
Paketsystem (Lua-Scripting)
Das Gameplay von Onset wird vollständig durch Pakete definiert, die in Lua geschrieben sind. Jedes Paket ist ein Ordner im Verzeichnis packages/, der Lua-Skripte enthält, die auf der Server- und/oder Client-Seite ausgeführt werden.
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 scriptsPakete installieren
- Laden Sie das Paket aus den Onset-Community-Foren oder GitHub-Repositories herunter
- Verbinden Sie sich per SFTP mit Ihrem Server
- Laden Sie den Paketordner in das Verzeichnis
packages/hoch - Öffnen Sie
server_config.jsonim File Manager - Fügen Sie den Paketordnernamen zum
"packages"-Array hinzu - Starten Sie den Server über GPanel neu
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages"-Array werden in der aufgelisteten Reihenfolge geladen. Wenn ein Paket von einem anderen abhängt, stellen Sie sicher, dass die Abhängigkeit zuerst aufgelistet ist.
Spielerverwaltung
Über die eingebauten Kick- und Ban-Befehle hinaus bieten die meisten Spielmodus-Pakete zusätzliche Spielerverwaltungsfunktionen. Häufige paketbasierte Befehle umfassen:
| Befehl (paketabhängig) | Beschreibung |
|---|---|
/tp <player> |
Zu einem anderen Spieler teleportieren |
/bring <player> |
Einen anderen Spieler zu Ihrem Standort teleportieren |
/goto <x> <y> <z> |
Zu bestimmten Weltkoordinaten teleportieren |
/setadmin <player> <level> |
Admin-Stufe eines Spielers festlegen (wenn das Paket Stufen unterstützt) |
/announce <message> |
Eine serverweite Ankündigung senden |
Fahrzeugverwaltung
Onset verfügt über ein eingebautes Fahrzeugsystem, das Pakete erweitern können. Admins müssen häufig gespawnte Fahrzeuge verwalten, um Server-Unordnung zu vermeiden.
- Fahrzeug-Spawning — Die meisten RP-Pakete ermöglichen Admins das Spawnen von Fahrzeugen über Befehle wie
/car <model> - Fahrzeug-Bereinigung — Einige Pakete beinhalten Auto-Despawn für verlassene Fahrzeuge oder Admin-Befehle wie
/destroyvehicles - Fahrzeuglimits — Maximale Fahrzeuge pro Spieler konfigurieren, um Lag durch zu viele gespawnte Objekte zu vermeiden
Datenbank (MariaDB)
Onset unterstützt MariaDB/MySQL-Datenbankverbindungen für persistente Datenspeicherung. Diese wird von Roleplay- und anderen Spielmodus-Paketen verwendet, um Spielerdaten, Inventare, Grundstücke und mehr zu speichern.
Die Datenbankkonfiguration erfolgt in den Konfigurationsdateien Ihres Pakets. Ein typisches Setup:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Fehlerbehebung
| Problem | Lösung |
|---|---|
| Server startet, aber kein Gameplay verfügbar | Sie benötigen mindestens ein Spielmodus-Paket, das installiert und in server_config.json aufgelistet ist. Ein blanker Onset-Server hat kein eingebautes Gameplay. |
| Paket lässt sich nicht laden | Überprüfen Sie die GPanel-Konsole auf Lua-Fehlermeldungen. Häufige Ursachen: fehlende package.json, Syntaxfehler in Lua-Dateien oder fehlende Abhängigkeiten. |
| Datenbankverbindungsfehler | Überprüfen Sie Ihre Datenbank-Zugangsdaten, stellen Sie sicher, dass die Datenbank existiert, und prüfen Sie, ob der MariaDB-Dienst läuft. Testen Sie die Konnektivität über die Konsolen-Logs. |
| Server im Browser nicht sichtbar | Stellen Sie sicher, dass "visible": true in server_config.json gesetzt ist. Überprüfen Sie außerdem, ob Port 7776 (TCP) für den Query-Port erreichbar ist. |
| Hohe Latenz oder Lag | Verringern Sie den streamdistance-Wert, reduzieren Sie die tickrate bei hoher CPU-Auslastung und prüfen Sie Ihre Pakete auf ineffiziente Lua-Skripte. |
Verwandte Artikel
- Onset Server-Einrichtungsanleitung
- So finden Sie Ihre Server-IP und Port
- So laden Sie Dateien über SFTP hoch
- Erste Schritte mit Ihrem neuen Server
Brauchen Sie Hilfe?
Wenn Sie Probleme mit Ihrem Onset Server haben oder weitere Unterstützung benötigen, ist unser Support-Team für Sie da. Erstellen Sie ein Support-Ticket und wir melden uns so schnell wie möglich bei Ihnen.
