Deze handleiding behandelt beheerdersconfiguratie, consolecommando's, het Lua-pakketsysteem, speler- en voertuigbeheer en databaseconfiguratie voor je Onset dedicated server op Legion Hosting. Voor de initiële serverinstallatie, zie onze Onset Server Setup Guide.
Beheerdersconfiguratie
Onset regelt beheerdersrechten via Lua-scripting binnen je gamemode-pakketten. In tegenstelling tot veel games met ingebouwde beheerdersystemen, vertrouwt Onset op je pakketten om te bepalen wie verhoogde rechten heeft en wat die rechten toestaan.
De meeste community gamemode-pakketten bevatten een beheerdersysteem. Doorgaans omvat de beheerdersconfiguratie:
- Open de File Manager in GPanel
- Navigeer naar je pakketmap (bijv.
packages/mygamemode/) - Zoek het beheerdersconfiguratiebestand (vaak
config.lua,admins.luaof een JSON-configuratiebestand) - Voeg je Steam64 ID of in-game speler-ID toe aan de beheerderslijst
- Sla het bestand op en herstart de server
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Server consolecommando's
Onset biedt ingebouwde server consolecommando's die werken ongeacht de geïnstalleerde pakketten. Deze kunnen rechtstreeks worden ingevoerd in de GPanel console.
| Commando | Beschrijving |
|---|---|
help |
Toont alle beschikbare consolecommando's |
stop |
Stopt de server op een nette manier |
restart |
Herstart de server |
players |
Toont alle verbonden spelers met hun ID's |
kick <playerid> [reason] |
Verwijdert een speler van de server |
ban <playerid> [reason] |
Bant een speler van de server |
unban <steamid> |
Verwijdert een ban voor het opgegeven Steam ID |
package reload <name> |
Herlaadt een pakket zonder de server te herstarten |
package start <name> |
Start een pakket dat momenteel niet actief is |
package stop <name> |
Stopt een actief pakket |
package list |
Toont alle geladen pakketten en hun status |
Pakketsysteem (Lua-scripting)
De gameplay van Onset wordt volledig bepaald door pakketten geschreven in Lua. Elk pakket is een map binnen de packages/ directory met Lua-scripts die draaien aan de server- en/of clientzijde.
Pakketstructuur
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 scriptsPakketten installeren
- Download het pakket van de Onset communityforums of GitHub-repositories
- Verbind met je server via SFTP
- Upload de pakketmap naar de
packages/directory - Open
server_config.jsonin de File Manager - Voeg de naam van de pakketmap toe aan de
"packages"array - Herstart de server via GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" array worden geladen in de volgorde waarin ze zijn vermeld. Als een pakket afhankelijk is van een ander, zorg er dan voor dat de afhankelijkheid eerst wordt vermeld.
Spelerbeheer
Naast de ingebouwde kick- en ban-commando's bieden de meeste gamemode-pakketten extra spelerbeheer-functies. Veelvoorkomende pakketafhankelijke commando's zijn:
| Commando (pakketafhankelijk) | Beschrijving |
|---|---|
/tp <player> |
Teleporteer naar een andere speler |
/bring <player> |
Teleporteer een andere speler naar jouw locatie |
/goto <x> <y> <z> |
Teleporteer naar specifieke wereldcoördinaten |
/setadmin <player> <level> |
Stel het beheerdersniveau van een speler in (als het pakket niveaus ondersteunt) |
/announce <message> |
Stuur een serverbreed bericht |
Voertuigbeheer
Onset beschikt over een ingebouwd voertuigsysteem dat pakketten kunnen uitbreiden. Beheerders moeten vaak gespawnde voertuigen beheren om serverrommel te voorkomen.
- Voertuigen spawnen — De meeste RP-pakketten laten beheerders voertuigen spawnen via commando's zoals
/car <model> - Voertuigen opruimen — Sommige pakketten bevatten auto-despawn voor achtergelaten voertuigen of beheerderscommando's zoals
/destroyvehicles - Voertuiglimieten — Configureer het maximum aantal voertuigen per speler om lag door te veel gespawnde entiteiten te voorkomen
Database (MariaDB)
Onset ondersteunt MariaDB/MySQL databaseverbindingen voor persistente gegevensopslag. Dit wordt gebruikt door roleplay en andere gamemode-pakketten om spelergegevens, inventarissen, eigendommen en meer op te slaan.
Databaseconfiguratie wordt afgehandeld in de configuratiebestanden van je pakket. Een typische configuratie:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Probleemoplossing
| Probleem | Oplossing |
|---|---|
| Server start maar geen gameplay beschikbaar | Je hebt minstens één gamemode-pakket nodig dat is geïnstalleerd en vermeld in server_config.json. Een kale Onset server heeft geen ingebouwde gameplay. |
| Pakket wordt niet geladen | Controleer de GPanel console op Lua-foutmeldingen. Veelvoorkomende oorzaken: ontbrekend package.json, syntaxfouten in Lua-bestanden of ontbrekende afhankelijkheden. |
| Databaseverbindingsfouten | Controleer je databasegegevens, zorg ervoor dat de database bestaat en controleer of de MariaDB-service draait. Test de connectiviteit via de consolelogs. |
| Server niet zichtbaar in browser | Zorg ervoor dat "visible": true is ingesteld in server_config.json. Controleer ook of port 7776 (TCP) bereikbaar is voor de query port. |
| Hoge latentie of lag | Verlaag de streamdistance waarde, verlaag de tickrate als het CPU-gebruik hoog is, en controleer op inefficiënte Lua-scripts in je pakketten. |
Gerelateerde artikelen
- Onset Server Setup Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
Hulp nodig?
Als je problemen ondervindt met je Onset server of verdere hulp nodig hebt, staat ons supportteam voor je klaar. Dien een supportticket in en we nemen zo snel mogelijk contact met je op.
