Une standalone chez soi

• ouvrez le fichier OpenSim.ini.example dans un éditeur de texte ;
• configurez votre éditeur de texte pour que les lignes soient numérotées. Ce sera plus simple, tant pour vous que pour moi.

Version OpenSim 0.7.1

• À la ligne 171, décommentez la ligne et remplacez false par true comme ceci :
  Code : Ini

  1	serverside_object_permissions = true

  
  
  Dans un fichier ini, les lignes qui commencent pas un point virgule sont des commentaires. Ces lignes ne sont pas prises en compte par le programme. Lorsqu'on décommente une ligne, on enlève ce point virgule. Inversement, si le but est de la commenter, on la fait précéder d'un point virgule.
  
  
• À la ligne 201, pour obtenir un affichage plus détaillé de la carte, décommentez la ligne et remplacez false par true comme ceci :
  Code : Ini

  1	TextureOnMapTile = true

  
  
• Si votre simulation n'utilise pas le port 9000, décommentez la ligne 267 et remplacez 9000 par le port que vous utilisez :
  Code : Ini

  1	http_listener_port = <port que vous utilisez>

  
  
• Vérifiez que la ligne 738 est bien décommentée comme ceci :
  Code : Ini

  1	Include-Architecture = "config-include/Standalone.ini"

  
  
Voilà, c'est tout pour OpenSim.ini. C'est beaucoup plus simple qu'avec la version précédente.
• Enregistrez votre fichier dans le même répertoire, mais cette fois sous le nom « OpenSim.ini ».
  
  Faites attention, le « s » de OpenSim est toujours majuscule.
  
  

Première étape

1

Include-Standalone    = "config-include/Standalone.ini"

Deuxième étape

1
2
3

;; S'il vous plaît, ne modifiez pas ce fichier.
;; Toutes les options de configuration sont dans le fichier StandaloneCommon.ini.example,
;; Vous pouvez en faire une copie et le modifier.

Troisième étape

1
2
3
4

;; Choisissez 0 ou 1 module de cache, et le fichier de configuration correspondant, s'il existe.
;; Copiez le fichier de configuration d'exemple dans votre dossier de configuration et 
;;faites les modification que vous désirez à ce niveau.
;; Nous vous recommandons d'utiliser FlotsamAssetCache depuis qu'il est maintenu plus activement.

1
2

AssetCaching = "FlotsamAssetCache"
Include-FlotsamCache = "config-include/FlotsamCache.ini"

Quatrième étape

Lancer la région dans une console

Commande de lancement

• sous windows : faites un clic droit sur le fichier OpenSim.exe et exécutez-le en tant qu'administrateur. Une fenêtre s'ouvre, c'est la console.
  
• sous Linux et Mac OS : ouvrez une console puis dirigez-vous dans le dossier où est placé OpenSim.exe, et lancez OpenSim.exe avec mono :
  Code : Console

  cd <chemin vers le dossier de l'archive OpenSim>/bin   mono OpenSim.exe

Puis tapez Entrée. Si tout se passe bien, une suite ininterrompue d'informations défilent dans la console. Vous ne devriez pas avoir de messages écrits en rouge.

Entrer les paramètres de la région

=====================================
Nous allons maintenant vous poser quelques questions au sujet de votre région.

Vous pouvez presser 'entrée' sans taper quoi que ce soit pour utiliser 

les valeurs par défaut proposées entre crochets [ ].
=====================================

• Le nom de la nouvelle région : entrez n'importe quel nom, par exemple « Chez moi », et tapez Entrée.
  Code : Console

  New region name []: Chez moi

  
  
• UUID de la région, n'écrivez rien pour utiliser celui qui est proposé.
  Code : Console

  Region UUID [17f06c5c-bda4-4f08-9804-796ca98acc16]:

  
  
  Un UUID (Universal Unique Identifier) est un identifiant unique codé sur 128 bits et produit en utilisant des composantes pseudo-aléatoires ainsi que les caractéristiques d'un ordinateur. Vous trouverez facilement sur internet des générateurs d'UUID ; par exemple à cette adresse.
  
  
  Si vous voulez entrer une autre valeur, ne mettez pas les crochets.
  
  
• Les coordonnées de votre région : conservez les coordonnées proposées.
  Code : Console

  Region Location [1000,1000]:

  
  
• L'adresse IP interne utilisée : gardez cette IP.
  Code : Console

  Internal IP address [0.0.0.0]:

  
  
• Le port : port par défaut 9000.
  Code : Console

  Internal port [9000]:

  
  
• Autorisation d'autres ports : ils ne seront pas autorisés ; laissez la valeur false.
  Code : Console

  Allow alternate ports [False]:

  
  
• L'adresse IP externe.
  
  Nous installons un monde virtuel local sur votre ordinateur. Hôte local en anglais se dit localhost. C'est un nom utilisé pour se référer à l'ordinateur local. On s'en sert pour communiquer avec notre machine par l'intermédiaire du protocole IP. Le nom localhost est associé à l'adresse IPv4 127.0.0.1.
  
  Ici vous pourrez entrer soit l'adresse IP 127.0.0.1, soit « localhost ».
  Code : Console

  External host name [SYSTEMIP]: 127.0.0.1

  
  
• Nom du nouveau domaine : choisissez un nom pour le domaine.
  Code : Console

  New estate name [My Estate]: Mon domaine

  
  
• Le prénom de votre avatar : choisissez un prénom pour votre avatar.
  Code : Console

  Estate owner first name [Test]: votre_prénom

  
  
• Le nom de votre avatar : choisissez un nom pour votre avatar.
  Code : Console

  Estate owner last name [User] : votre_nom

  
  
• Votre mot de passe : entrez votre mot de passe.
  Code : Console

  Password: mot_de_passe

  
  
Attention : lorsque vous entrez votre mot de passe, il ne s'affiche pas dans la console. Il vous sera impossible de le récupérer. Si vous vous êtes trompé et si vous ne vous rappelez plus ce que vous avez tapé, vous pouvez utiliser la flèche « retour » de votre clavier pour le supprimer complètement et le retaper. En revanche, si vous avez déjà utilisé la touche « Entrée », il faudra recommencer l'installation car votre mot de passe est indispensable pour vous connecter.
• Votre adresse e-mail est facultative
Maintenant, vous avez réellement terminé la configuration de votre monde virtuel. Dans votre console, vous devriez vous trouver face à une invite comme ceci : Code : Console

20:12:36 - [INTERGRID]: Informing 0 neighbours that this region is up Region (Chez moi) #

Le fichier ini d'une région

1
2
3
4
5
6
7

[chez moi] 
RegionUUID = 2d7d91bc-9aa5-4515-97a2-224bd04cfee3 
Location = 1000,1000 
InternalAddress = 0.0.0.0 
InternalPort = 9000 
AllowAlternatePorts = False 
ExternalHostName = 127.0.0.1

Visite du monde virtuel avec votre viewer

Configurer votre viewer Hippo

Configurer Emerald pour les utilisateurs de Mac OS

1

-loginuri http://localhost:9000/

Votre monde virtuel à sa première seconde d'existence

Il faudra encore beaucoup travailler et sans doute affronter quelques petites difficultés. C'est l'aventure.

Une installation et plusieurs régions

Mais attention, gardez bien en tête que plus vous aurez de régions, d'objets, de scripts, d'avatars sur ces régions, plus vous aurez besoin de ressources matérielles. À vous de voir ce que vous pouvez faire avec votre configuration.

Éditez votre nouveau fichier ini dans un éditeur de texte

1
2
3
4
5
6
7

[chez moi] 
RegionUUID = 2d7d91bc-9aa5-4515-97a2-224bd04cfee3 
Location = 1000,1000 
InternalAddress = 0.0.0.0 
InternalPort = 9000 
AllowAlternatePorts = False 
ExternalHostName = 127.0.0.1

Modifier le fichier ini

1
2
3
4
5
6
7

[Ailleurs] 
RegionUUID =f48695f0-f22b-11de-8a39-0800200c9a66
Location = 1000,1001 
InternalAddress = 0.0.0.0 
InternalPort = 9001 
AllowAlternatePorts = False 
ExternalHostName = 127.0.0.1

Modifier le terrain

Terraformer à partir de votre viewer

• Select land : activez cette option pour sélectionner une parcelle de votre terrain. Il vous suffira ensuite de faire un clic droit avec la souris puis de la déplacer. Une zone entourée de jaune apparaîtra à l'écran.
  
  Cette fonction sert à définir une zone de terraformation ou à délimiter des parcelles que vous pourrez configurer différemment.
  
• Flatten : option qui sert à aplatir le terrain.
• Raise : option pour élever le terrain.
• Lower : sert à abaisser le terrain.
• Smooth  : pour lisser le terrain.
• Roughen : utilisez cette option si vous voulez que votre terrain soit moins régulié.
• Revert : pour annuler les modifications.
• À droite, size permet de régler la taille de la zone modifiée et strength la force du Bulldozer..
  
• Apply to selection : si vous avez sélectionné une zone de terraformation et une option de déformation, cliquez sur « Apply » (appliquer) pour appliquer la déformation à cette zone.
  Vous pouvez également terraformer votre région en utilisant la souris. Son curseur dépendra de la taille de terraformation sélectionnée. Il se présentera comme sur cette image.
  

Terraformer depuis la console

help terrain

=== terrain ===
* terrain load - Loads a terrain from a specified file.
* terrain load-tile - Loads a terrain from a section of a larger file.
* terrain save - Saves the current heightmap to a specified file.
* terrain save-tile - Saves the current heightmap to the larger file.
* terrain fill - Fills the current heightmap with a specified value.
* terrain elevate - Raises the current heightmap by the specified amount.
* terrain lower - Lowers the current heightmap by the specified amount.
* terrain multiply - Multiplies the heightmap by the value specified.
* terrain bake - Saves the current terrain into the regions revert map.
* terrain revert - Loads the revert map terrain into the regions heightmap.
* terrain newbrushes - Enables experimental brushes which replace the standard terrain brushes. WARNING: This is a debug setting and may be removed at any time.
* terrain stats - Shows some information about the regions heightmap for debugging purposes.
* terrain effect - Runs a specified plugin effect
* terrain flip - Flips the current terrain about the X or Y axis
* terrain rescale - Rescales the current terrain to fit between the given min and max heights

• Pour élever toute la surface de la région à un même niveau, entrez dans la console :
  Code : Console

  terrain fill 21

  
  21 est un exemple. En dessous de 21, votre terrain sera sous les eaux.
  
  
• Pour élever le terrain de 1 utilisez la commande :
  Code : Console

  terrain elevate 1

  
  
  
• Inversement, si vous voulez abaisser votre terrain, par exemple de 1, utilisez :
  Code : Console

  terrain lower 1

  
  
  
• Si votre dernière modification ne vous plaît pas, vous pouvez revenir en arrière en utilisant la commande :
  Code : Console

  terrain revert

  
  
  
• Vous avez terraformé votre terrain à la perfection, vous avez réalisé le chef-d'oeuvre de votre vie, mais vous êtes tout de même tenté par une nouvelle modification. Pas de souci : vous pouvez sauvegarder votre terrain sous forme d'une image png. Pour cela il suffira d'entrer la commande suivante dans votre console :
  Code : Console

  terrain save Nom_du_fichier.png

  
  Le fichier de sauvegarde de votre terraformation se placera dans le dossier « bin » de votre installation OpenSim. C'est une image en dégradé de gris de 256x256 pixels qui dessine la carte de votre région. Les tons les plus clairs représentent les zones les plus hautes, et inversement. En voici un exemple :
  
  
  
• Bien entendu, comme vous avez fait une sauvegarde, il est possible de la restaurer. Une commande a été prévue à cet effet.
  Code : Console

  terrain load Nom_du_fichier.png

  
  
  Vous pouvez tester la texture que j'ai donnée en exemple ci-dessus. Mais pensez à placer cette image dans le dossier « bin » de votre installation et utilisez son nom dans la commande.
  
  
  Vous pouvez également créer ou modifier des textures de terrain dans votre logiciel de dessin préféré (Gimp, par exemple).
  
  

Modifier la texture du terrain

Sauvegarder ou restaurer une région

Sauvegarder votre région

Region (Chez moi) # save oar nom_de_la_sauvegarde.tar.gz

Region (root) # change region Chez moi

Restaurer une région

Region (Chez moi) # load oar nom_de_la_sauvegarde.tar.gz

Region (root) # change region Chez moi

Les autres commandes de console

Lister les commandes

Region (Chez moi) # help

alert <message> - Send an alert to everyone
alert-user <first> <last> <message> - Send an alert to a user
appearance show - Show appearance information for each avatar in the simulator.
backup - Persist objects to the database now
bypass permissions <true / false> - Bypass permission checks
change region <region name> - Change current console region
command-script <script> - Run a command script from file
config get [<section>] [<key>] - Synonym for config show
config save <path> - Save current configuration to a file at the given path
config set <section> <key> <value> - Set a config option.  In most cases this is not useful since changed parameters are not dynamically reloaded.  Neither do changed parameters persist - you will have to change a config file manually and restart.
config show [<section>] [<key>] - Show config information
create region ["region name"] <region_file.ini> - Create a new region.
create user [<first> [<last> [<pass> [<email>]]]] - Create a new user
debug packet <level> - Turn on packet debugging
debug permissions <true / false> - Enable permissions debugging
debug scene <cripting> <collisions> <physics> - Turn on scene debugging
delete asset <ID> - Delete asset from database
delete object creator <UUID> - Delete object by creator
delete object name <name> - Delete object by name
delete object outside - Delete all objects outside boundaries
delete object owner <UUID> - Delete object by owner
delete object uuid <UUID> - Delete object by uuid
delete-region <name> - Delete a region from disk
dump asset <ID> - Dump asset to a file
edit scale <name> <x> <y> <z> - Change the scale of a named prim
emergency-monitoring - Go on/off emergency monitoring mode
estate - Execute subcommand for plugin 'estate'
export-map [<path>] - Save an image of the world map
fcache assets - Attempt a deep scan and cache of all assets in all scenes
fcache clear [file] [memory] - Remove all assets in the cache.  If file or memory is specified then only this cache is cleared.
fcache expire <datetime> - Purge cached assets older then the specified date/time
fcache status - Display cache status
force permissions <true / false> - Force permissions on or off
force update - Force the update of all objects on clients
help [<command>] - Get general command list or more detailed help on a specific command
help estate - Get help on plugin command 'estate'
help land - Get help on plugin command 'land'
help terrain - Get help on plugin command 'terrain'
help tree - Get help on plugin command 'tree'
help windlight - Get help on plugin command 'windlight'
kick user <first> <last> [message] - Kick a user off the simulator
kill uuid <UUID> - Kill an object by UUID
land - Execute subcommand for plugin 'land'
link-mapping [<x> <y>] - Set local coordinate to map HG regions to
link-region <Xloc> <Yloc> <ServerURI> [<RemoteRegionName>] - Link a HyperGrid Region. Examples for <ServerURI>: http://grid.net:8002/ or http://example.org/path/foo.php
load iar [-m|--merge] <first> <last> <inventory path> <password> [<IAR path>] - Load user inventory archive (IAR).
load oar [--merge] [--skip-assets] [<OAR path>] - Load a region's data from an OAR archive.
load xml [-newIDs [<x> <y> <z>]] - Load a region's data from XML format
load xml2 - Load a region's data from XML2 format
login disable - Disable simulator logins
login enable - Enable simulator logins
login level <level> - Set the minimum user level to log in
login reset - Reset the login level to allow all users
login status - Show login status
login text <text> - Set the text users will see on login
modules list - List modules
modules load <name> - Load a module
modules unload <name> - Unload a module
monitor report - Returns a variety of statistics about the current region and/or simulator
physics get - Get physics parameter from currently selected region
Invocation: physics get [<param>|ALL]
physics list - List settable physics parameters
Invocation: physics list
physics set - Set physics parameter from currently selected region
Invocation: physics set <param> [<value>|TRUE|FALSE] [localID|ALL]
quit - Quit the application
region restart abort [<message>] - Abort a region restart
region restart bluebox <message> <delta seconds>+ - Schedule a region restart
region restart notice <message> <delta seconds>+ - Schedule a region restart
reload estate - Reload the estate data
remove-region <name> - Remove a region from this simulator
reset user password [<first> [<last> [<password>]]] - Reset a user password
restart - Restart all sims in this instance
save iar [--p|-profile=<url>] [--noassets] <first> <last> <inventory path> <password> [<IAR path>] [--v|-verbose] - Save user inventory archive (IAR).
save oar [-p|--profile=<url>] [--noassets] [--perm=<permissions>] [<OAR path>] - Save a region's data to an OAR archive.
save prims xml2 [<prim name> <file name>] - Save named prim to XML2
save xml - Save a region's data in XML format
save xml2 - Save a region's data in XML2 format
set log level <level> - Set the console logging level
set region flags <Region name> <flags> - Set database flags for region
set terrain heights <corner> <min> <max> [<x>] [<y>] - Sets the terrain texture heights on corner #<corner> to <min>/<max>, if <x> or <y> are specified, it will only set it on regions with a matching coordinate. Specify -1 in <x> or <y> to wildcard that coordinate. Corner # SW = 0, NW = 1, SE = 2, NE = 3.
set terrain texture <number> <uuid> [<x>] [<y>] - Sets the terrain <number> to <uuid>, if <x> or <y> are specified, it will only set it on regions with a matching coordinate. Specify -1 in <x> or <y> to wildcard that coordinate.
set user level [<first> [<last> [<level>]]] - Set user level. If >= 200 and 'allow_grid_gods = true' in OpenSim.ini, this account will be treated as god-moded. It will also affect the 'login level' command. 
show account <first> <last> - Show account details for the given user
show caps - Shows all registered capabilities
show circuits - Show agent circuit data
show connections - Show connection data
show digest <ID> - Show asset digest
show http-handlers - Show all registered http handlers
show hyperlinks - List the HG regions
show info - Show general information about the server
show modules - Show module data
show names - Show the bindings between user UUIDs and user names
show neighbours - Shows the local regions' neighbours
show pending-objects - Show # of objects on the pending queues of all scene viewers
show pqueues [full] - Show priority queue data for each client
show queues [full] - Show queue data for each client
show ratings - Show rating data
show region <Region name> - Show details on a region
show regions - Show region data
show stats - Show statistics
show threads - Show thread status
show throttles [full] - Show throttle settings for each client and for the server overall
show uptime - Show server uptime
show users [full] - Show user data for users currently on the region
show version - Show server version
shutdown - Quit the application
sun - Usage: sun [param] [value] - Get or Update Sun module paramater
terrain - Execute subcommand for plugin 'terrain'
tree - Execute subcommand for plugin 'tree'
unlink-region <local name> - Unlink a hypergrid region
windlight - Execute subcommand for plugin 'windlight'

Détail de quelques commandes

• alert <message> : envoie un message à tous les utilisateurs. Remplacez <message> par votre message.
  
  
• alert-user <first> <last> <message> : envoie un message à un utilisateur. Remplacez <first> par son prénom, <last> par son nom et <message> par votre message.
  
  
• change region <region name> : Change la région courante de la console.
  
  
• create region ["region name"] <region_file.ini> : crée une nouvelle région pendant que la simulation est démarrée. Vous aurez à entrer son UUID, son port et ses coordonnées. Si vous entrez des paramètres déjà utilisés, la simulation s'arrête.
  
  
• create user [<first> [<last> [<pass> [<email>]]]] : crée un nouvel utilisateur. Entrez respectivement son prénom, son nom, un mot de passe et éventuellement son adresse e-mail.
  
  
• delete object name <name> : supprime un objet défini par son nom.
  
  
• delete-region <name> : supprime une région. Il est peut être plus prudent de renommer le fichier de configuration de la région puis de redémarrer la simulation. Par exemple, vous pourriez renommer regions.ini en regions.ini-old.
  
  
• help [<command>] : Affiche de l'aide au sujet d'une commande de console.
  
  
• help windlight : aide pour le plugin windlight.
  
  
• kick user <first> <last> [message] : Fait sortir un utilisateur de la simulation.
  
  
• load iar [-m|--merge] <first> <last> <inventory path> <password> [<IAR path>] : restaure l'archive de l'inventaire d'un utilisateur avec l'option -m ou --merge pour fusionner l'inventaire chargé avec l'inventaire de l'avatar. <first> est le prénom de l'avatar, <last> son nom, <inventory path> est le dossier où charger l'inventaire, <password> le mot de passe de l'avatar et [<IAR path>] est l'adresse du fichier qui sera importé.
  
  
• load oar [--merge] [--skip-assets] [<OAR path>] : restaure une région à partir d'une archive OAR. L'option --merge fusionne l'OAR avec la scène existante, --skip-assets ignore les assets de l'oar, [<OAR path>] est l'adresse du fichier qui sera importé.
  
  
• login disable : désactive la connexion à la simulation.
  
  
• login enable : active la connexion à la simulation.
  
  
• login status : affiche le statut de la connexion, selon qu'elle soit activée ou désactivée.
  
  
• login text <text> : définit le texte que les utilisateurs voient à la connexion.
  
  
• modules list : affiche la liste des modules installés.
  
  
• monitor report : renvoie quelques statistiques concernant la région courante et/ou la simulation.
  
  
• quit : quitte l'application.
  
  
• reset user password [<first> [<last> [<password>]]] : réinitialise le mot de passe d'un utilisateur.
  
  
• restart : redémarre toutes les simulations.
  
  
• save iar [--p|-profile=<url>] [--noassets] <first> <last> <inventory path> <password> [<IAR path>] [--v|-verbose] : sauvegarde l'inventaire d'un utilisateur. -p|--profile=<url> ajoute l'url du service de profil pour sauvegarder les informations de l'utilisateur. [--noassets] permet de faire une sauvegarde sans les assets.
  
  
• save oar [-p|--profile=<url>] [--noassets] [--perm=<permissions>] [<OAR path>] : sauvegarde une région dans une archive OAR. [--noassets] permet de faire une sauvegarde sans les assets.
  
  
• show info : donne des informations générales au sujet de l'installation.
  
  
• show neighbours : affiche les régions voisines de chaque région.
  
  
• terrain : exécute des sous-commandes pour le plugin « terrain ». Référez-vous au paragraphe « Terraformer depuis la console » plus haut dans ce même chapitre.
  
  
• tree : sous-commandes exécutées pour le plugin « tree ».
  
  
• windlight : Sous-commandes exécutées pour le plugin « windlight ».