Ce guide couvre la configuration admin, les commandes de console, le système de packages Lua, la gestion des joueurs et des véhicules, ainsi que la configuration de la base de données pour votre serveur dédié Onset sur Legion Hosting. Pour la configuration initiale du serveur, consultez notre Guide de configuration du serveur Onset.
Configuration admin
Onset gère les privilèges d'administrateur via des scripts Lua dans vos packages de mode de jeu. Contrairement à de nombreux jeux avec des systèmes d'administration intégrés, Onset s'appuie sur vos packages pour définir qui dispose de permissions élevées et ce que ces permissions autorisent.
La plupart des packages de mode de jeu communautaires incluent un système d'administration. En général, la configuration admin implique :
- Ouvrez le File Manager dans GPanel
- Naviguez vers le répertoire de votre package (ex. :
packages/mygamemode/) - Localisez le fichier de configuration admin (souvent
config.lua,admins.lua, ou un fichier de configuration JSON) - Ajoutez votre Steam64 ID ou votre identifiant joueur en jeu à la liste des administrateurs
- Enregistrez le fichier et redémarrez le serveur
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Commandes de la console serveur
Onset fournit des commandes de console serveur intégrées qui fonctionnent indépendamment des packages installés. Elles peuvent être saisies directement dans la console GPanel.
| Commande | Description |
|---|---|
help |
Liste toutes les commandes de console disponibles |
stop |
Arrête le serveur proprement |
restart |
Redémarre le serveur |
players |
Liste tous les joueurs connectés avec leurs identifiants |
kick <playerid> [reason] |
Expulse un joueur du serveur |
ban <playerid> [reason] |
Bannit un joueur du serveur |
unban <steamid> |
Supprime le bannissement pour le Steam ID spécifié |
package reload <name> |
Recharge un package sans redémarrer le serveur |
package start <name> |
Démarre un package qui n'est pas en cours d'exécution |
package stop <name> |
Arrête un package en cours d'exécution |
package list |
Liste tous les packages chargés et leur statut |
Système de packages (scripts Lua)
Le gameplay d'Onset est entièrement défini par des packages écrits en Lua. Chaque package est un dossier dans le répertoire packages/ contenant des scripts Lua qui s'exécutent côté serveur et/ou côté client.
Structure d'un package
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 scriptsInstaller des packages
- Téléchargez le package depuis les forums communautaires Onset ou les dépôts GitHub
- Connectez-vous à votre serveur via SFTP
- Téléversez le dossier du package dans le répertoire
packages/ - Ouvrez
server_config.jsondans le File Manager - Ajoutez le nom du dossier du package au tableau
"packages" - Redémarrez le serveur via GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" sont chargés dans l'ordre où ils sont listés. Si un package dépend d'un autre, assurez-vous que la dépendance est listée en premier.
Gestion des joueurs
Au-delà des commandes intégrées de kick et de bannissement, la plupart des packages de mode de jeu fournissent des fonctionnalités supplémentaires de gestion des joueurs. Les commandes courantes fournies par les packages incluent :
| Commande (dépend du package) | Description |
|---|---|
/tp <player> |
Se téléporter vers un autre joueur |
/bring <player> |
Téléporter un autre joueur à votre position |
/goto <x> <y> <z> |
Se téléporter à des coordonnées spécifiques du monde |
/setadmin <player> <level> |
Définir le niveau d'administrateur d'un joueur (si le package supporte les niveaux) |
/announce <message> |
Envoyer une annonce à l'ensemble du serveur |
Gestion des véhicules
Onset dispose d'un système de véhicules intégré que les packages peuvent étendre. Les administrateurs doivent souvent gérer les véhicules générés pour éviter l'encombrement du serveur.
- Génération de véhicules — La plupart des packages RP permettent aux administrateurs de générer des véhicules via des commandes comme
/car <model> - Nettoyage des véhicules — Certains packages incluent la suppression automatique des véhicules abandonnés ou des commandes admin comme
/destroyvehicles - Limites de véhicules — Configurez le nombre maximum de véhicules par joueur pour éviter les ralentissements dus à trop d'entités générées
Base de données (MariaDB)
Onset prend en charge les connexions à une base de données MariaDB/MySQL pour le stockage persistant des données. Cela est utilisé par les packages de roleplay et d'autres modes de jeu pour stocker les données des joueurs, les inventaires, les propriétés, et plus encore.
La configuration de la base de données est gérée dans les fichiers de configuration de votre package. Une configuration typique :
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Dépannage
| Problème | Solution |
|---|---|
| Le serveur démarre mais aucun gameplay n'est disponible | Vous devez avoir au moins un package de mode de jeu installé et listé dans server_config.json. Un serveur Onset nu n'a pas de gameplay intégré. |
| Le package ne se charge pas | Vérifiez les messages d'erreur Lua dans la console GPanel. Causes courantes : package.json manquant, erreurs de syntaxe dans les fichiers Lua, ou dépendances manquantes. |
| Erreurs de connexion à la base de données | Vérifiez vos identifiants de base de données, assurez-vous que la base de données existe et que le service MariaDB est en cours d'exécution. Testez la connectivité depuis les journaux de la console. |
| Le serveur n'est pas visible dans le navigateur | Assurez-vous que "visible": true est défini dans server_config.json. Vérifiez également que le port 7776 (TCP) est accessible pour le port de requête. |
| Latence élevée ou ralentissements | Réduisez la valeur de streamdistance, diminuez le tickrate si l'utilisation du CPU est élevée, et vérifiez les scripts Lua inefficaces dans vos packages. |
Articles connexes
- Guide de configuration du serveur Onset
- Comment trouver l'IP et le port de votre serveur
- Comment téléverser des fichiers via SFTP
- Premiers pas avec votre nouveau serveur
Besoin d'aide ?
Si vous rencontrez des problèmes avec votre serveur Onset ou avez besoin d'aide supplémentaire, notre équipe de support est là pour vous aider. Soumettez un ticket de support et nous vous répondrons dans les plus brefs délais.
