Configuring Regions/fr
From OpenSimulator
Contents[hide] |
OpenSimulator 0.9 et plus
Par défaut, les régions sont configurées dans un fichier nommé Regions.ini dans le répertoire bin/Regions. Si vous avez commencé une installation complètement nouvelle d'OpenSim, il vous posera une série de questions pour configurer votre première région.
Voici un exemple de fichier Regions.ini
[Ma belle region] RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072 Location = 1000,1000 InternalAddress = 0.0.0.0 InternalPort = 9000 AllowAlternatePorts = False ExternalHostName = mymachine.something.org SizeX = 512 SizeY = 512
Il s'agit d'une liste de paramètres qui doivent être présents pour qu'une région puisse fonctionner. Lorsque vous démarrez OpenSimulator pour la première fois sans fichier Regions.ini existant, une question vous sera posée dans la console pour chaque paramètre afin de configurer votre région initiale. Pour plus de détails, voir Configuration#Lancer OpenSimulator pour la première fois.
Attribut
 |
Description
|
|---|---|
| [Ma belle region] | Le nom de la région. |
| RegionUUID | L'identifiant unique de la région. |
| Location | L'emplacement (x, y) de la région sur la grille. |
| InternalAddress | 0.0.0.0 si vous avez plus d'une carte réseau sur le serveur et que vous ne vous souciez pas de l'adresse IP sur laquelle OpenSimulator écoute (c'est le paramètre habituel). Vous pouvez également définir une adresse IP spécifique. |
| InternalPort | Port IP pour toutes les connexions clients entrantes. |
| AllowAlternatePorts | Non utilisé. Laissez toujours False. |
| ExternalHostName | Adresse IP externe du routeur ou FQDN (nom de domaine pleinement qualifié), identique pour toutes les régions du simulateur. |
| SizeX et SizeY | La taille de la région, doit être un multiple de 256, et égale. Si elle n'est pas présente, elle sera de 256m |
Si vous voulez ajouter une autre région, vous pouvez soit :
- entrer une autre section dans Regions.ini
- créer un autre fichier .ini séparé dans bin/Regions
- Créez un fichier xml OpenSimulator de l'ancien format (ceux-ci fonctionnent toujours avec OpenSim actuel).
- ou utiliser la commande create region sur la console region (je ne recommande pas cette méthode car elle semble être un peu boguée).
Voici un exemple où une deuxième région a été ajoutée à Regions.ini
[Ma belle region] RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072 Location = 1000,1000 InternalAddress = 0.0.0.0 InternalPort = 9000 AllowAlternatePorts = False ExternalHostName = mymachine.something.org
[Greek Wedding] RegionUUID = 5c445740-6460-43d3-ba4c-444444445555 Location = 1000,1001 InternalAddress = 0.0.0.0 InternalPort = 9001 AllowAlternatePorts = False ExternalHostName = mymachine.something.org
Comme vous pouvez le voir, la deuxième région s'appelle Greek Wedding et a un UUID différent. Elle a un emplacement différent (1000,1001) et un InternalPort différent (9001). A part cela, les détails sont les mêmes.
Pour créer un nouvel UUID, vous pouvez soit modifier un UUID existant à la main (par exemple en changeant un caractère pour que le nouveau soit dans la plage [0-9][A-F] ou un générateur peut être trouvé sur la page web uuidgen. Sous Unix, vous pouvez également utiliser la commande uuidgen.
En plus des entrées obligatoires ci-dessus, il existe d'autres entrées facultatives qui peuvent modifier les propriétés d'une région. Il s'agit des éléments suivants
| Attribut
|
Description
|
|---|---|
| MaxAgents | Le nombre maximum d'agents pouvant se trouver dans la région à un moment donné. La valeur par défaut est 100. A partir du 22/04/2011, cette option n'existe que dans le master git. |
| MaxPrims | Le nombre maximum de prims que la région pourra supporter. Actuellement, cette limite n'est pas appliquée par OpenSimulator. En raison des contraintes du protocole LL, la limite maximale qui peut être affichée est de 45000 prims. |
| MaxPrimsPerUser | Nombre maximum de prims par utilisateur (par parcelle). Une valeur négative désactive la commande. |
| PhysicalPrimMax | Les dimensions maximales d'un prim physique. Il s'agit d'un nombre unique qui s'applique aux coordonnées X, Y et Z. Ceci affectera le redimensionnement des prims existantes. La valeur par défaut est 10. Ce paramètre peut également être utilisé dans la section [Startup] d'OpenSim.ini. Si le paramètre de la région existe, il remplacera le paramètre d'OpenSim.ini. |
| NonPhysicalPrimMax | Les dimensions maximales d'une primitive non physique. Il s'agit d'un nombre unique qui s'applique aux coordonnées X, Y et Z. Ceci affectera le redimensionnement des prims existantes. La valeur par défaut est 256. Ce paramètre peut également être utilisé dans la section [Startup] d'OpenSim.ini. Si le paramètre de la région existe, il remplacera le paramètre d'OpenSim.ini. |
| ClampPrimSize | Si ce paramètre est true alors, si un viewer tente de créer une prim dont la dimension est supérieure à NonphysicalPrimMax, alors cette dimension est réduite à NonphysicalPrimMax. La valeur par défaut est false ; ce paramètre peut également être utilisé dans la section [Startup] du fichier OpenSim.ini. Si le paramètre de la région existe, il remplacera le paramètre d'OpenSim.ini. |
| RegionType | Le type de région tel qu'il apparaît dans l'onglet Covenant de la boîte de dialogue Region/Estate dans un viewer standard de Second Life. Peut être utilisé pour spécifier Mainland, Estate, etc. en fonction du type de grille. |
| MaptileStaticUUID | UUID de la texture à utiliser comme miniature de carte pour cette région. Uniquement défini si vous avez désactivé la génération dynamique de la miniature de la carte à partir du contenu de la région dans OpenSim.ini ainsi :
MapImageModule = "MapImageModule" GenerateMaptiles = false |
| MaptileStaticFile | Fichier image de taille adéquate à utiliser comme miniature de carte pour cette région. Formats pris en charge (bmp, png, jpg au format RGB 24bpp). Pour cela, les éléments suivants doivent être définis dans la section [Map] d'OpenSim.ini :
MapImageModule = "MapImageModule" GenerateMaptiles = true Exemple : MaptileStaticFile = "maptiles/UnFichier.png" |
Autres Tâches
Configuration de plusieurs régions sur une seule instance de serveur
Pour configurer plusieurs régions sur un serveur (par exemple, un serveur 4x4), éditez le fichier Regions.ini afin d'ajouter plusieurs entrée unique à celle qui existe déjà. Assurez-vous que les RegionUUID et InternalPort sont différents pour chacune d'entre elles, sinon cela ne fonctionnera pas. Pour charger des fichiers OAR individuels dans chaque région, utilisez la commande 'change region [nom-de-la-region]' et ensuite 'load oar [oar-location]'.
Chargement depuis le web
OpenSim.exe peut lire les définitions de région à partir du Web en utilisant les paramètres suivants :
[Startup]
region_info_source = "web"
regionload_webserver_url = "http://example.com/regions.xml";
Le format suivant a été signalé comme fonctionnant avec OpenSimulator 0.8.* :
<Nini>
<Section Name="My region Name">
<Key Name="RegionUUID" Value="4208aa66-ce9b-4f49-a4da-06a27d95f001" />
<Key Name="Location" Value="7000,7000" />
<Key Name="InternalAddress" Value="0.0.0.0" />
<Key Name="InternalPort" Value="9016" />
<Key Name="AllowAlternatePorts" Value="False" />
<Key Name="ExternalHostName" Value="mygrid.org" />
<Key Name="MaxPrims" Value="15000" />
<Key Name="MaxAgents" Value="40" />
<Key Name="RegionType" Value="0" />
<Key Name="SizeX" Value="256" />
<Key Name="SizeY" Value="256" />
<Key Name="MaptileStaticUUID" Value="00000000-0000-0000-0000-000000000000" />
</Section>
</Nini>
Outils
- Un puissant générateur de régions est disponible à l'adresse suivante: RegionGenerator
