Régions et varregions : guide technique
Fichiers Regions.ini, coordonnées, dimensions, ports, connexion et imports d’archives.
Région et simulateur : deux notions
Une région est un espace du monde virtuel, tandis qu’un processus simulateur peut héberger une ou plusieurs régions. Les fichiers de région définissent les caractéristiques de chacune ; OpenSim.ini configure le comportement du simulateur.
Structure d’un fichier de région
Un fichier situé dans bin/Regions/ contient des sections nommées après les régions. Chaque section identifie sa région, son emplacement, son adresse réseau et éventuellement ses dimensions. Les valeurs doivent correspondre à votre topologie réseau.
Exemple : adaptez les chemins et valeurs à votre installation.
[Example Region] RegionUUID = 00000000-0000-0000-0000-000000000001 Location = 1000,1000 InternalAddress = 0.0.0.0 InternalPort = 9000 ExternalHostName = SYSTEMIP SizeX = 512 SizeY = 512
RegionUUID
L’UUID identifie la région de manière unique. Copiez le modèle seulement après avoir créé un UUID adapté ; ne dupliquez pas celui d’une région existante. Une collision d’identifiants peut perturber l’enregistrement de la région.
Location
Location indique les coordonnées de la région sur la grille. Vérifiez qu’elle ne recouvre pas une région existante, en particulier avec les varregions de grandes dimensions.
InternalAddress et InternalPort
InternalAddress désigne l’interface locale d’écoute et InternalPort le port utilisé. Deux régions sur une même IP et dans un même contexte réseau ne doivent pas se disputer le même port d’écoute.
ExternalHostName
Cette valeur doit être joignable depuis les clients concernés. Un domaine incorrect ou mal résolu peut empêcher certaines connexions ou téléportations ; contrôlez DNS, NAT et pare-feu.
SizeX, SizeY et taille des varregions
Le code RegionInfo.cs du dépôt OpenSimulator de référence lit SizeX et SizeY, applique des contrôles sur les tailles et les multiples de 256. Il impose aussi des régions carrées dans cette version. Consultez la limite maximale du code plutôt que de supposer que toutes les tailles sont acceptées.
Taille et charge serveur
Passer de 256×256 à 512×512 augmente la surface disponible, mais pas mécaniquement la consommation de CPU dans le même rapport. Le nombre d’objets, scripts, collisions et avatars reste déterminant.
Restaurer une OAR de 256 m dans une varregion
Créez d’abord une région cible aux dimensions voulues. Faites une sauvegarde du terrain cible. Testez une fusion avec un décalage pour placer les objets de l’archive dans le quadrant voulu. Vérifiez les terrains et parcelles séparément.
Exemple : adaptez les chemins et valeurs à votre installation.
load oar --merge --displacement "<256,0,0>" /backups/source256.oar
Déplacement et rotation
--displacement utilise un vecteur à trois dimensions, par exemple <256,0,0>. --rotation reçoit un angle en degrés. Les objets importés doivent rester dans les dimensions de la région cible après transformation.
Exemple : adaptez les chemins et valeurs à votre installation.
load oar --merge --rotation 90 --displacement "<256,256,0>" /backups/source.oar
Pourquoi une restauration peut être incomplète
Le chargement dépend du contenu de l’archive, des assets disponibles, des permissions et de la version. Les réglages de région dans Regions.ini ne sont pas recréés automatiquement par l’OAR. Contrôlez la console et les logs.
Procédure de vérification
Après création ou importation : vérifiez le démarrage, la visibilité de la région, la téléportation, le terrain, les parcelles, les objets, les scripts et les assets. Conservez un OAR de secours et les logs de l’opération.