OAR archives: backup, import and merge
Detailed commands, options checked against OpenSimulator source code and restore examples.
Understanding an OAR
An OAR holds region data (objects, terrain, parcels and optionally assets). Save it through a region console. Do not confuse it with an IAR inventory archive.
Saving a region
Normal backup including assets.
save oar /backups/MyRegion.oar
Backup omitting asset data. Referenced UUIDs still need to resolve for a full restore.
save oar --noassets /backups/MyRegion-noassets.oar
The save implementation accepts --all; check its precise implications for your version.
save oar --all /backups/MyRegion-all.oar
save oar flags
| Option | Meaning | Caution |
|---|---|---|
--noassets | Omit asset data | Restore depends on asset availability |
-h, --home=URL | Attach a home service URL | Use only when applicable |
--publish | Clear ownership information while exporting | Changes exported metadata |
--perm=CTM | Permission-based export filter | Can exclude objects |
--all | Request extended export per implementation | Verify release-specific behavior |
Restoring an archive
Basic restore to the selected region.
load oar /backups/MyRegion.oar
Merges archive content into an existing region rather than a full replacement.
load oar --merge /backups/MyRegion.oar
Merge with explicit handling of terrain and parcels.
load oar --merge --merge-terrain --merge-parcels /backups/MyRegion.oar
Skip importing assets from the archive; those assets must already be available.
load oar --skip-assets /backups/MyRegion.oar
Offsets imported objects by 256 m on X. Check bounds and placement before the final import.
load oar --merge --displacement "<256,0,0>" /backups/MyRegion.oar
Rotates imported content (degrees). Test on an isolated region.
load oar --merge --rotation 90 /backups/MyRegion.oar
load oar flags
| Option | Meaning | Caution |
|---|---|---|
--merge, -m | Merge rather than replace | Check duplicates and existing objects |
--mergeReplaceObjects | Merge with matching object replacement | May overwrite existing objects |
--skip-assets, -s | Do not import assets from the OAR | Different from --noassets during save |
--force-assets | Force processing of archived assets | Assess impact before use |
--merge-terrain | Include terrain during merge | May change terrain heights |
--merge-parcels | Include parcels during merge | May alter existing parcels |
--no-objects | Skip object restoration | Useful for selective restores |
--displacement="<x,y,z>" | Offset imported positions | Values in metres |
--rotation=DEGREES | Apply a rotation | From -360 to 360 degrees |
--bounding-origin="<x,y,z>" | Origin of import bounds | Advanced: test before production |
--bounding-size="<x,y,z>" | Size of import bounds | Advanced: test before production |
--default-user=NAME | Fallback owner during import | Permission-sensitive |
--debug, -d | Enable debug messages | May produce extra logs |
Example: restoring into a varregion
Create a varregion with the required SizeX/SizeY first, back up the target region, then use merge and displacement only after calculating the target position. An OAR does not automatically change the target region SizeX and SizeY.
Illustrative import of a region archive into a larger varregion, within its bounds.
load oar --merge --displacement "<256,256,0>" /backups/region256.oar
Where to find OAR archives?
The OAR Shop is a third-party website offering OpenSimulator region archives, including a free OAR library and a marketplace for paid creations. Listings may include region size, previews, creator, source and available license information. Public free OAR archives can be browsed and downloaded without an account.
Commands and sources
The flags above come from the command parser in the OpenSimulator fork’s ArchiverModule.cs. Placement examples must be validated for the target terrain.