Editing OpenSimulator Internals/Code Map/AttachmentsModule (section)

== AttachObjectInternal() ==

Attaches a SOG already in the scene to an avatar.

# Rejects if any avatars are sitting on the object.
# Resolves attachment point: uses explicit point, or stored LastAttachPoint, or left hand as fallback.
# Rejects if > Constants.MaxAgentAttachments already attached.
# If not appending (WearReplacesAll): collects existing SOGs at same attach point for removal.
# Calls DetachSingleAttachmentToInv() for each displaced attachment.
# Calls UpdateUserInventoryWithAttachment() -- updates inventory item to reflect new attach point.
# Calls AttachToAgent() -- physically attaches SOG to avatar in scene.
# If resumeScripts: CreateScriptInstances() + ResumeScripts().
# Fires EventManager.TriggerOnAttach().

----