Ce guide explique comment configurer votre serveur headless Resonite hébergé chez Legion Hosting. Resonite est une plateforme sociale VR où les utilisateurs peuvent construire, créer et socialiser dans des mondes générés par les utilisateurs. Pour la gestion des sessions et les commandes d'administration, consultez le Guide d'administration du serveur Resonite.
1. Accéder à votre serveur
- Connectez-vous à GPanel.
- Sélectionnez votre serveur Resonite dans la liste des serveurs.
- Votre serveur est géré via l'onglet Console dans GPanel et la configuration headless de Resonite.
2. Variables de démarrage
Configurez ces paramètres depuis l'onglet Startup dans GPanel :
| Variable | Nom d'environnement | Par défaut | Description |
|---|---|---|---|
| Activer le chargeur de mods | ENABLE_MODLOADER |
false | Activer ResoniteModLoader pour les mods personnalisés (true/false). |
| Mise à jour automatique | AUTO_UPDATE |
1 | Mettre à jour automatiquement le serveur au démarrage (1=oui, 0=non). |
/headlessCode) est requis pour l'installation. Ceci est configuré par le fournisseur d'hébergement.
3. Fichier de configuration
Le fichier de configuration principal est Headless/Config/Config.json. Modifiez-le via SFTP. Paramètres clés :
{
"tickRate": 60.0,
"maxConcurrentAssetTransfers": 4,
"loginCredential": "your_username",
"loginPassword": "your_password",
"startWorlds": [
{
"isEnabled": true,
"sessionName": "My World",
"maxUsers": 32,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld",
"autoRecover": true,
"autoSleep": true,
"saveOnExit": false
}
]
}4. Référence des paramètres de Config.json
| Paramètre | Par défaut | Description |
|---|---|---|
tickRate | 60.0 | Taux de simulation du serveur. |
maxConcurrentAssetTransfers | 4 | Nombre maximum de téléchargements d'assets simultanés. |
loginCredential | (vide) | Nom d'utilisateur du compte Resonite pour le serveur headless. |
loginPassword | (vide) | Mot de passe du compte Resonite. |
5. Configuration des mondes
Chaque entrée dans le tableau startWorlds définit une session de monde. Paramètres clés des mondes :
| Paramètre | Par défaut | Description |
|---|---|---|
isEnabled | true | Indique si ce monde doit démarrer. |
sessionName | null | Nom d'affichage de la session. |
maxUsers | 32 | Nombre maximum d'utilisateurs dans le monde. |
accessLevel | Anyone | Qui peut rejoindre : Anyone, RegisteredUsers, Contacts, ContactsPlus, Private. |
loadWorldPresetName | SpaceWorld | Monde prédéfini à charger (ex. SpaceWorld, Grid, BasicEmpty). |
loadWorldURL | null | URL d'un monde personnalisé à charger à la place d'un prédéfini. |
autoRecover | true | Récupérer automatiquement le monde après un crash. |
autoSleep | true | Mettre le monde en veille lorsqu'aucun utilisateur n'est présent. |
saveOnExit | false | Sauvegarder l'état du monde lorsque le serveur s'arrête. |
autosaveInterval | -1.0 | Intervalle de sauvegarde automatique en secondes (-1 = désactivé). |
hideFromPublicListing | null | Masquer cette session de la liste publique. |
awayKickMinutes | -1.0 | Minutes avant l'expulsion des utilisateurs inactifs (-1 = désactivé). |
idleRestartInterval | -1.0 | Redémarrer le monde après ce nombre de secondes d'inactivité (-1 = désactivé). |
forcedRestartInterval | -1.0 | Forcer le redémarrage après ce nombre de secondes, indépendamment des utilisateurs (-1 = désactivé). |
6. Se connecter à votre serveur
- Lancez Resonite sur votre PC ou casque VR.
- Ouvrez le navigateur de sessions (Menu Dash > Worlds).
- Recherchez votre serveur par nom de session.
- Cliquez sur Rejoindre pour entrer dans le monde.
Pour les sessions privées, le compte headless doit inviter les utilisateurs ou utiliser autoInviteUsernames dans la configuration.
7. Liste de vérification pour la première configuration
- Modifiez
Headless/Config/Config.jsonpour définirloginCredentialetloginPasswordde votre compte Resonite. - Définissez un
sessionNamepour votre monde. - Choisissez un
loadWorldPresetNameou fournissez unloadWorldURLpour un monde personnalisé. - Définissez le
accessLevelpour contrôler qui peut rejoindre. - Démarrez le serveur et vérifiez qu'il affiche
World running...dans la console.
Articles connexes
- Guide d'administration du serveur Resonite
- Comment trouver l'IP et le port de votre serveur
- Comment transférer des fichiers via SFTP
Besoin d'aide ?
Si vous rencontrez des problèmes avec votre serveur Resonite, ouvrez un ticket de support en incluant les détails de votre serveur, une description du problème et les messages d'erreur de la console GPanel.
