OpenSimulator · FR

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

OptionSignificationAttention
--noassetsNe pas inclure les assetsRestauration dépendante de la présence des assets
-h, --home=URLRenseigner l’URL de service d’origineRéservé aux cas qui en ont besoin
--publishEffacer les informations de propriété lors de l’exportModifie les métadonnées exportées
--perm=CTMFiltrer selon les permissions Copy/Transfer/ModifyPeut exclure des objets
--allDemander un export étendu selon le codeFonctionnement à confirmer selon la version

Restaurer une archive

ATTENTION : une restauration sans fusion peut remplacer les objets, le terrain ou les parcelles de la région cible. Faites un OAR de secours et testez sur une région jetable.

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

OptionSignificationAttention
--merge, -mFusionner au lieu de remplacerVérifier doublons et objets déjà présents
--mergeReplaceObjectsFusion avec remplacement des objets correspondantsRisque d’écraser des objets présents
--skip-assets, -sNe pas importer les assets de l’OARDifférent de --noassets à la sauvegarde
--force-assetsForcer le traitement des assets de l’archiveÉvaluer l’impact avant utilisation
--merge-terrainPrendre aussi en compte le terrain en fusionPeut modifier les hauteurs
--merge-parcelsPrendre en compte les parcelles en fusionPeut modifier les parcelles existantes
--no-objectsNe pas restaurer les objetsUtile pour des restaurations sélectives
--displacement="<x,y,z>"Décaler les positions importéesValeurs en mètres
--rotation=DEGREESAppliquer une rotationDe -360 à 360 degrés
--bounding-origin="<x,y,z>"Origine de la zone d’importUsage avancé, tester avant production
--bounding-size="<x,y,z>"Dimensions de la zone d’importUsage avancé, tester avant production
--default-user=NAMEPropriétaire de substitution lors de l’importSensible pour les permissions
--debug, -dActiver les messages de débogagePeut 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.

Avant tout téléchargement ou import : vérifier l’origine et les droits de redistribution ou d’utilisation des contenus. « Gratuit » ne veut pas forcément dire « libre de droits ». Contrôler la compatibilité, la taille de la région et les assets, puis charger d’abord dans une région de test après sauvegarde de la région cible. Les scripts et contenus tiers ne doivent pas être supposés fiables.

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.

ArchiverModule.cs · OpenSimulator Archives Wiki