Skip to content
Second Life Creation

llTransferOwnership

integer llTransferOwnership(key AgentID, integer Flags, list Params)

Transfers ownership of an object, or a copy of the object to a new agent.

Parameters
AgentID (key)
An agent in the region.
Flags (integer)
Flags to control type of inventory transfer.
Params (list)
Extra parameters to llTransferOwnership. None are defined at this time.
Technical Details
  • Return Type: integer
  • Energy: 10

Transfers ownership of an object rezzed in world to the specified agent. The object must be transferable by its current owner and must not be an attachment.

Optionally this function may force the object to derez itself into the destination agent’s inventory, or make a copy of itself directly into inventory.

Examples

Section titled “Examples”
default
{
    touch_start(integer total_number)
    {
        llTransferOwnership(llDetectedKey(0), TRANSFER_FLAG_COPY, []);
    }
}

Caveats

Section titled “Caveats”
  • The agent must be in the region
  • There is no way to detect if the receiver ignored, rejected or blocked the transaction (aside from a changed event never occurring)
  • The function fails with a return code of TRANSFER_NO_PERMS if:
    • The object is no-transfer
    • The object is no-copy and the flags include the TRANSFER_FLAG_COPY flag
  • Calling this function from an attachment will fail and return TRANSFER_NO_ATTACHMENT
  • WARNING: Any no-trans items in the transferred object will be removed from the object received by the target agent. If the transfer is of the object itself, these items are lost.
  • WARNING: If the transfer is a copy, any no-copy inventory items will be present in the object received by the target agent and removed from the original.

See Also

Section titled “See Also”