http://osimdev.org/wiki/index.php?action=history&feed=atom&title=OpenSimulator_Internals%2FWalkthroughs%2FAvatar_Removes_From_Inventory 2026-08-04T15:37:14Z Revision history for this page on the wiki MediaWiki 1.45.3 http://osimdev.org/wiki/index.php?title=OpenSimulator_Internals/Walkthroughs/Avatar_Removes_From_Inventory&diff=89&oldid=prev 2026-07-07T13:15:48Z

<p>first</p> <p><b>New page</b></p><div>= OpenSimulator Internals/Walkthroughs/Avatar Removes From Inventory =<br /> <br /> == Overview ==<br /> <br /> Traces what happens when an avatar deletes an item from inventory, moves it to trash, or purges the trash folder. Also covers the Return Object path (estate/parcel manager returning an object to owner&#039;s Lost and Found).<br /> <br /> ----<br /> <br /> == Case 1: Delete Item (Move to Trash) ==<br /> <br /> Avatar selects an item and deletes it (moves to Trash folder).<br /> <br /> === 1. Client Sends RemoveInventoryItem ===<br /> <br /> OpenSim/Region/Framework/Scenes/Scene.cs -- RemoveInventoryItem()<br /> <br /> # Viewer sends RemoveInventoryItem packet.<br /> # Scene.RemoveInventoryItem() calls InventoryService.DeleteItems(agentID, [itemID]) if permitted.<br /> <br /> Wait -- DeleteItems moves to trash in v2 protocol or deletes directly depending on implementation. In OpenSim&#039;s XInventoryService, DeleteItems() marks the item deleted (moves to system trash folder or removes depending on config).<br /> <br /> ; DB writes:<br /> * inventoryitems -- UPDATE or DELETE depending on server config<br /> <br /> ----<br /> <br /> == Case 2: Purge Folder (Empty Trash) ==<br /> <br /> Avatar right-clicks Trash folder and selects Empty Trash.<br /> <br /> === 1. Client Sends PurgeInventoryDescendents ===<br /> <br /> # Viewer sends PurgeInventoryDescendents packet with folderID = Trash folder UUID.<br /> # Scene.HandlePurgeInventoryDescendents() calls InventoryService.PurgeFolder(folder).<br /> # ROBUST XInventoryService: deletes all items and subfolders recursively from inventoryitems and inventoryfolders tables.<br /> <br /> ; DB writes:<br /> * inventoryitems -- DELETE: all items in folder and subfolders<br /> * inventoryfolders -- DELETE: all subfolders (not the trash folder itself)<br /> <br /> ----<br /> <br /> == Case 3: Delete Object from World (DeRez to Trash) ==<br /> <br /> Avatar right-clicks object in world and selects Delete (not Take).<br /> <br /> === 1. Client Sends DeRezObject with action=Delete ===<br /> <br /> BasicInventoryAccessModule -- CopyToInventory(DeRezAction.Delete)<br /> <br /> # If deleting own object: destination folder = Trash (FolderType.Trash).<br /> # If deleting another&#039;s object (estate manager): destination = owner&#039;s Lost and Found (FolderType.LostAndFound).<br /> # CopyBundleToInventory() runs: serialises object, creates asset, inserts inventory item in appropriate folder.<br /> # Scene.DeleteSceneObject() removes object from scene and region storage.<br /> <br /> ; DB writes:<br /> * assets -- INSERT: serialised object XML<br /> * inventoryitems -- INSERT: item in Trash or LostAndFound<br /> * prims/primshapes/primitems -- DELETE: object removed from region<br /> <br /> ----<br /> <br /> == Case 4: Return Object (Parcel/Estate Manager) ==<br /> <br /> Estate manager or parcel owner returns an object to its owner&#039;s inventory.<br /> <br /> === 1. Return Triggered ===<br /> <br /> OpenSim/Region/Framework/Scenes/Scene.cs -- returnObjects()<br /> <br /> # Parcel manager calls returnObjects() for objects on the parcel.<br /> # Calls IInventoryAccessModule.CopyToInventory(DeRezAction.Return, UUID.Zero, objlist, null, false).<br /> #* remoteClient is null -- return is server-initiated.<br /> #* Destination folder: owner&#039;s Lost and Found (FolderType.LostAndFound).<br /> # AddPermissions() with null remoteClient: same-owner path, perms preserved.<br /> # Asset created, item inserted.<br /> # Scene.AddReturn() queues a notification message to the owner.<br /> # Scene.DeleteSceneObject() removes from scene.<br /> <br /> On next backup cycle, Scene.Backup() processes m_returns:<br /> * Sends GridInstantMessage to the owner: &quot;Your object X was returned from parcel Y in region Z due to [reason].&quot;<br /> <br /> ; DB writes:<br /> * assets -- INSERT: serialised object XML<br /> * inventoryitems -- INSERT: item in Lost and Found<br /> * prims/primshapes/primitems -- DELETE<br /> <br /> ----<br /> <br /> == Summary: DB Tables Touched ==<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Case !! Table !! Operation<br /> |-<br /> | Delete item || inventoryitems || UPDATE/DELETE<br /> |-<br /> | Purge folder || inventoryitems, inventoryfolders || DELETE recursive<br /> |-<br /> | Delete object || assets, inventoryitems || INSERT; prims DELETE<br /> |-<br /> | Return object || assets, inventoryitems || INSERT; prims DELETE<br /> |}<br /> <br /> ----<br /> <br /> == See Also ==<br /> <br /> * [[OpenSimulator Internals/Walkthroughs]]<br /> * [[OpenSimulator Internals/Code Map/InventoryAccessModule]]<br /> * [[OpenSimulator Internals/Walkthroughs/Avatar Acquires Inventory]]<br /> * [[OpenSimulator Internals/Walkthroughs/Avatar Derezzes Object]]</div>

Jwbshaw