Ce guide couvre les commandes de la console headless, la gestion des mondes, les rôles utilisateurs, le NeosModLoader et le dépannage pour votre serveur dédié NeosVR. NeosVR est un métavers social en VR avec de puissants outils de création. Pour la configuration initiale, la configuration de Config.json et les instructions de connexion, consultez le Guide de Configuration du Serveur NeosVR.
1. Accéder à la Console
Gérez votre serveur headless NeosVR via l'onglet Console dans GPanel. Toutes les commandes sont saisies directement dans la console.
2. Commandes de la Console Headless
Gestion des Mondes
| Commande | Description |
|---|---|
worlds | Lister tous les mondes en cours d'exécution avec leurs indices. |
focus <world_index> | Basculer le focus sur un monde spécifique par index. |
startWorldURL <record_url> | Démarrer un nouveau monde à partir d'une URL d'enregistrement Neos. |
startWorldTemplate <template> | Démarrer un monde à partir d'un modèle intégré (ex. : SpaceWorld). |
save | Sauvegarder le monde actuellement sélectionné. |
close | Fermer le monde actuellement sélectionné. |
restart | Redémarrer le monde actuellement sélectionné. |
Gestion des Sessions
| Commande | Description |
|---|---|
sessionURL | Afficher l'URL de session pour le monde sélectionné. |
sessionID | Afficher l'ID de session pour le monde sélectionné. |
name <new_name> | Changer le nom de session du monde sélectionné. |
accessLevel <level> | Changer le niveau d'accès : Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Définir le nombre maximum d'utilisateurs pour la session. |
hideFromListing <true/false> | Activer/désactiver la visibilité dans le navigateur de sessions publiques. |
description <text> | Définir la description de la session. |
Gestion des Utilisateurs
| Commande | Description |
|---|---|
users | Lister tous les utilisateurs dans le monde sélectionné. |
kick <username> | Expulser un utilisateur du monde. |
ban <username> | Bannir un utilisateur du monde. |
silence <username> | Rendre muet un utilisateur (couper sa voix). |
unsilence <username> | Rétablir le son d'un utilisateur précédemment rendu muet. |
respawn <username> | Faire réapparaître un utilisateur au point de spawn du monde. |
role <username> <role> | Attribuer un rôle à un utilisateur (voir Section 3). |
Contrôle du Serveur
| Commande | Description |
|---|---|
status | Afficher l'état du serveur et l'utilisation des ressources. |
shutdown | Arrêter proprement le serveur headless. |
gc | Forcer le ramasse-miettes pour libérer de la mémoire. |
tickRate <rate> | Changer le tick rate du serveur en cours d'exécution. |
3. Rôles Utilisateurs
NeosVR utilise une hiérarchie de rôles pour les permissions des mondes :
| Rôle | Description |
|---|---|
Admin | Contrôle total du monde. Peut tout modifier, gérer les utilisateurs et changer les paramètres du monde. |
Builder | Peut créer et modifier des objets dans le monde. |
Moderator | Peut expulser/bannir des utilisateurs et gérer les paramètres de session. |
Guest | Accès de base. Peut interagir avec les objets existants mais ne peut pas construire. |
Spectator | Accès en lecture seule. Ne peut pas interagir avec le monde. |
Attribuez les rôles via la console : role <username> Admin
Vous pouvez également définir les rôles par défaut dans Config.json en utilisant le paramètre defaultUserRoles.
4. NeosModLoader
NeosModLoader permet de charger des mods créés par la communauté dans le serveur headless.
- Définissez ENABLE_MODLOADER sur
truedans les variables Startup de GPanel. - Téléchargez les mods depuis le GitHub de NeosModLoader.
- Transférez les fichiers
.dlldes mods dans le répertoirenml_mods/via SFTP. - Redémarrez le serveur pour charger les mods.
5. Dépannage
Le Serveur ne Démarre Pas
- Vérifiez que vos STEAM_USER et STEAM_PASS sont corrects.
- Assurez-vous que le SRCDS_BETAPASS (mot de passe bêta headless) est à jour depuis le Discord Patreon de Neos.
- Si vous utilisez Steam Guard 2FA, fournissez le code dans STEAM_AUTH et redémarrez rapidement.
Le Monde ne se Charge Pas
- Vérifiez que
Config.jsonest un JSON valide (pas de virgules en fin de ligne, crochets corrects). - Vérifiez que
loginCredentialetloginPasswordsont correctement définis dansConfig/Config.json. - Assurez-vous que l'URL du monde ou le nom du preset est valide.
Les Utilisateurs ne Peuvent Pas Rejoindre
- Vérifiez que
accessLeveln'est pas défini surPrivatesauf si c'est intentionnel. - Vérifiez que
maxUsersn'a pas été atteint. - Assurez-vous que le serveur headless est connecté (vérifiez la sortie console pour la confirmation de connexion).
Articles Connexes
- Guide de Configuration du Serveur NeosVR
- 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 NeosVR qui ne sont pas couverts ici, ouvrez un ticket de support en incluant l'IP de votre serveur, une description du problème et tout message d'erreur pertinent de la console GPanel.
