Configuring Regions/fr

From OpenSimulator

Jump to: navigation, search

Contents

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. (doit être le même pour toutes les régions du fichier)
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
  • osRegionsgenerator - Générateur de régions pour PHP, prêt pour PHP7 (inc. var régions, position).
Personal tools
General
About This Wiki