OpenSimulator · FR

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.

Références et code source