Archives OAR : sauvegarde, importation et fusion
Commandes détaillées, options contrôlées dans le code OpenSimulator et scénarios de restauration.
Comprendre une archive OAR
Un OAR contient les données d’une région (objets, terrain, parcelles et, selon les options, assets). L’enregistrement se fait depuis la console d’une région. Ne confondez pas archive région et archive d’inventaire IAR.
Sauvegarder une région
Sauvegarde habituelle avec assets.
save oar /backups/MyRegion.oar
Sauvegarde sans intégrer les données des assets. Les UUID référencés restent nécessaires à une restauration complète.
save oar --noassets /backups/MyRegion-noassets.oar
Option --all reconnue dans le code de sauvegarde ; vérifier les implications sur votre version avant utilisation.
save oar --all /backups/MyRegion-all.oar
Options de save oar
| Option | Signification | Attention |
|---|---|---|
--noassets | Ne pas inclure les assets | Restauration dépendante de la présence des assets |
-h, --home=URL | Renseigner l’URL de service d’origine | Réservé aux cas qui en ont besoin |
--publish | Effacer les informations de propriété lors de l’export | Modifie les métadonnées exportées |
--perm=CTM | Filtrer selon les permissions Copy/Transfer/Modify | Peut exclure des objets |
--all | Demander un export étendu selon le code | Fonctionnement à confirmer selon la version |
Restaurer une archive
Restauration classique dans la région sélectionnée.
load oar /backups/MyRegion.oar
Fusionne l’archive dans une région existante, au lieu d’effectuer un remplacement global.
load oar --merge /backups/MyRegion.oar
Fusion avec demande explicite de traitement du terrain et des parcelles.
load oar --merge --merge-terrain --merge-parcels /backups/MyRegion.oar
Ignore l’importation des assets contenus dans l’archive ; ils doivent déjà être accessibles.
load oar --skip-assets /backups/MyRegion.oar
Décale les objets importés de 256 m sur X. Contrôlez limites et positionnement avant import définitif.
load oar --merge --displacement "<256,0,0>" /backups/MyRegion.oar
Effectue une rotation pendant l’importation (en degrés). Tester le résultat sur une région isolée.
load oar --merge --rotation 90 /backups/MyRegion.oar
Options de load oar
| Option | Signification | Attention |
|---|---|---|
--merge, -m | Fusionner au lieu de remplacer | Vérifier doublons et objets déjà présents |
--mergeReplaceObjects | Fusion avec remplacement des objets correspondants | Risque d’écraser des objets présents |
--skip-assets, -s | Ne pas importer les assets de l’OAR | Différent de --noassets à la sauvegarde |
--force-assets | Forcer le traitement des assets de l’archive | Évaluer l’impact avant utilisation |
--merge-terrain | Prendre aussi en compte le terrain en fusion | Peut modifier les hauteurs |
--merge-parcels | Prendre en compte les parcelles en fusion | Peut modifier les parcelles existantes |
--no-objects | Ne pas restaurer les objets | Utile pour des restaurations sélectives |
--displacement="<x,y,z>" | Décaler les positions importées | Valeurs en mètres |
--rotation=DEGREES | Appliquer une rotation | De -360 à 360 degrés |
--bounding-origin="<x,y,z>" | Origine de la zone d’import | Usage avancé, tester avant production |
--bounding-size="<x,y,z>" | Dimensions de la zone d’import | Usage avancé, tester avant production |
--default-user=NAME | Propriétaire de substitution lors de l’import | Sensible pour les permissions |
--debug, -d | Activer les messages de débogage | Peut produire davantage de logs |
Exemple : restaurer dans une varregion
Commencez par créer une varregion avec SizeX/SizeY adaptés, sauvegardez la région cible, puis utilisez une fusion et un décalage uniquement après avoir calculé la position souhaitée. Un OAR ne modifie pas automatiquement SizeX et SizeY de la région.
Exemple pédagogique : insertion d’une archive de région dans une varregion, à l’intérieur de ses dimensions.
load oar --merge --displacement "<256,256,0>" /backups/region256.oar
Où trouver des archives OAR ?
The OAR Shop est un site tiers proposant des régions OAR pour OpenSimulator, avec une bibliothèque gratuite et une boutique de créations payantes. Les fiches peuvent présenter la taille de la région, des aperçus, le créateur, la provenance et les informations de licence disponibles. La section gratuite permet de consulter et télécharger des archives publiques sans compte.
The OAR Shop : chercher et télécharger
Commandes et sources
La liste des options de cette page provient du parseur de commandes ArchiverModule.cs de la version d’OpenSimulator utilisée pour ce guide. Les exemples de positionnement doivent être validés pour chaque terrain.