OpenSimulator · EN

IAR archives: inventory, flags and merge

Full or selective backups, with or without assets, and restoring into an inventory folder.

Understanding IAR

An IAR backs up avatar inventory items and folders. It does not back up terrain or rezzed region objects: use OAR for those.

Replace First Last with the account name, PASSWORD with its password and paths with your real locations. Never publish credentials in documentation or console screenshots.

Saving an inventory

Back up the inventory root including assets.

save iar First Last "/" PASSWORD /backups/avatar-full.iar

Save without assets: smaller archive, but restoration relies on assets already present.

save iar --noassets First Last "/" PASSWORD /backups/avatar-noassets.iar

Permission-filtered example: export only entries matching the requested permission criteria.

save iar --perm=CTM First Last "/" PASSWORD /backups/avatar-perms.iar

Example excluding a folder named Trash. Verify the actual folder name.

save iar --excludefolder=Trash First Last "/" PASSWORD /backups/avatar-clean.iar

save iar flags

OptionMeaningCaution
--noassetsDo not export asset dataAssets must be available to use objects
--skipbadassetsSkip items whose main asset is missingRecovery option for damaged inventory; may lose items
--creators, -cPreserve foreign creator informationUseful for Hypergrid content
--home=URL, -hSet profile service URLVerify the URL
--exclude=NAME/UUID, -eExclude an inventory itemCheck name or UUID
--excludefolder=NAME/UUID, -fExclude a folder and contentsDo not exclude required folders
--perm=CTMFilter by Copy, Transfer and ModifyReview permissions before sharing
--verbose, -vShow extra messagesLogs can be large

Restoring an IAR

Restore into the account inventory. Check content and destination path first.

load iar First Last "/" PASSWORD /backups/avatar-full.iar

Tries to merge with existing folders rather than always creating new folders.

load iar --merge First Last "/" PASSWORD /backups/avatar-full.iar
OptionMeaningCaution
--merge, -mMerge existing folders when possibleCheck for duplicate items after import

Limitations and precautions

An archive without assets is not self-contained. Permissions, creator references and asset availability may affect the outcome. Keep dated backups and test with a disposable account.

InventoryArchiverModule.cs · Inventory Archives Wiki