Editing OpenSimulator Internals/Walkthroughs/Avatar Rezzes Box (section)

== 1. Rezzing the Box ==

Avatar drags "Box" from inventory to the world.

Scene.RezObject() → BasicInventoryAccessModule.RezObject():
# InventoryService.GetItem() -- fetches the box's inventory record from inventoryitems table.
# AssetService.Get(assetID) -- fetches the serialised object XML from assets table.
# Scene.GetObjectsToRez() -- deserialises XML into SceneObjectGroup (1 prim).
# GetNewRezLocation() -- raycasts to ground surface for position.
# DoPreRezWhenFromItem() -- sets name/description, links FromUserInventoryItemID if copyable.
# Scene.AddNewSceneObject() -- adds to scene graph.
# SimulationDataService.StoreObject() called immediately on add -- writes prim to DB.
# CreateScriptInstances() -- no scripts in a plain box, so no-op.
# Schedules full update to all clients.

; DB reads:
* inventoryitems -- SELECT: box item record
* assets -- SELECT: object XML asset

; DB writes (immediate on AddNewSceneObject):
* prims -- INSERT: 1 row (UUID, SceneGroupID = same UUID for root, Name="Box", GroupPositionX/Y/Z, etc.)
* primshapes -- INSERT: 1 row (shape data: PCode=9 box, ProfileShape=0, etc.)

; DB writes (on next backup cycle, ~18s later):
* prims -- UPDATE: position/state confirmed
* primitems -- INSERT: empty (no task inventory yet)

----