Ce guide couvre les commandes de la console headless, la gestion des sessions, la configuration du chargeur de mods et le dépannage de votre serveur Resonite. Pour la configuration initiale, consultez le Guide de configuration du serveur headless Resonite.
1. Commandes de la console headless
Le serveur headless Resonite accepte les commandes via la console GPanel. Le serveur répond à la commande shutdown pour un arrêt gracieux.
| Commande | Description |
|---|---|
worlds |
Lister toutes les sessions de monde actives. |
focus <world_index> |
Se concentrer sur un monde spécifique pour les commandes. |
status |
Afficher le statut du monde sélectionné. |
users |
Lister les utilisateurs dans le monde sélectionné. |
kick <username> |
Expulser un utilisateur du monde sélectionné. |
ban <username> |
Bannir un utilisateur du monde sélectionné. |
silence <username> |
Rendre muet un utilisateur dans le monde sélectionné. |
unsilence <username> |
Rétablir le son d'un utilisateur. |
respawn <username> |
Faire réapparaître un utilisateur à l'origine du monde. |
role <username> <role> |
Définir le rôle d'un utilisateur (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Renommer la session sélectionnée. |
accessLevel <level> |
Changer qui peut rejoindre (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Changer le nombre maximum d'utilisateurs pour le monde sélectionné. |
save |
Sauvegarder le monde sélectionné. |
close |
Fermer le monde sélectionné. |
restart |
Redémarrer le monde sélectionné. |
invite <username> |
Inviter un utilisateur dans le monde sélectionné. |
message <text> |
Envoyer un message dans le monde sélectionné. |
shutdown |
Arrêter gracieusement l'ensemble du serveur headless. |
2. Niveaux d'accès
Contrôlez qui peut rejoindre vos sessions de monde avec le paramètre accessLevel :
| Niveau | Description |
|---|---|
| Anyone | Ouvert à tous les utilisateurs Resonite. |
| RegisteredUsers | Uniquement les comptes Resonite enregistrés. |
| Contacts | Uniquement les utilisateurs de la liste de contacts du compte headless. |
| ContactsPlus | Les contacts et les contacts de contacts. |
| Private | Sur invitation uniquement. |
3. Rôles des utilisateurs
Attribuez des rôles pour contrôler ce que les utilisateurs peuvent faire dans votre monde :
| Rôle | Description |
|---|---|
| Admin | Contrôle total sur le monde. |
| Builder | Peut construire et modifier des objets. |
| Moderator | Peut expulser/bannir des utilisateurs et modérer le chat. |
| Guest | Accès utilisateur standard. |
| Spectator | Peut observer mais pas interagir. |
Définissez les rôles par défaut dans Config.json en utilisant defaultUserRoles ou attribuez-les par utilisateur avec la commande console role.
4. Mondes multiples
Le serveur headless peut héberger plusieurs mondes simultanément. Ajoutez des entrées supplémentaires au tableau startWorlds dans Headless/Config/Config.json :
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]Utilisez focus 0 et focus 1 dans la console pour basculer entre les mondes.
5. Chargeur de mods
Resonite prend en charge les mods via ResoniteModLoader. Pour l'activer :
- Définissez
ENABLE_MODLOADERsurtruedans l'onglet Startup. - Réinstallez ou redémarrez le serveur -- les DLL du chargeur de mods seront téléchargées automatiquement.
- Placez les DLL de mods dans le répertoire
rml_mods/via SFTP. - Redémarrez le serveur pour charger les mods.
Fichiers du chargeur de mods :
Libraries/ResoniteModLoader.dll-- Le chargeur de mods principal.rml_libs/0Harmony.dll-- Dépendance requise.rml_mods/-- Placez vos DLL de mods ici.
6. Dépannage
- Le serveur ne démarre pas : Vérifiez que les identifiants de connexion dans
Config.jsonsont corrects. Le serveur headless doit s'authentifier avec un compte Resonite valide. - Le monde n'apparaît pas dans le navigateur : Vérifiez que
hideFromPublicListingn'est pas défini surtrue. Assurez-vous queaccessLevelautorise les utilisateurs qui recherchent. - "World running..." n'apparaît pas : Vérifiez les erreurs dans la console. Le nom du monde prédéfini est peut-être incorrect.
- Les mods ne se chargent pas : Vérifiez que
ENABLE_MODLOADERest surtrueet que les DLL de mods sont dansrml_mods/. Consultez la console pour les erreurs du chargeur de mods. - Utilisation élevée des ressources : Réduisez
tickRatedansConfig.jsonou diminuezmaxConcurrentAssetTransfers. Le contenu complexe créé par les utilisateurs peut être gourmand en ressources.
Articles connexes
- Guide de configuration du serveur headless Resonite
- Comment trouver l'IP et le port de votre serveur
- Comment transférer des fichiers via SFTP
Besoin d'aide ?
Si vous avez besoin d'une assistance supplémentaire, ouvrez un ticket de support avec les détails de votre serveur et les messages d'erreur de la console GPanel.
