llCreateLink

Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

CreateLink

llCreateLink

Summary

Function: llCreateLink( key target, integer parent );

141	Function ID
1.0	Forced Delay
10.0	Energy

Attempt to link the script's object with target.

• key	target	–	A prim in the same region.
• integer	parent	–	If FALSE, then target becomes the root.

To run this function the script must request the PERMISSION_CHANGE_LINKS permission with llRequestPermissions and it must be granted by the owner. target must be modifiable and have the same owner.
This object must also be modifiable.

Caveats

• This function causes the script to sleep for 1.0 seconds.

Permissions

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event. If the script lacks the permission PERMISSION_CHANGE_LINKS, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run). If PERMISSION_CHANGE_LINKS is granted by anyone other than the owner, then when the function is called an error will be shouted on DEBUG_CHANNEL. Once the PERMISSION_CHANGE_LINKS permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.

• Shouts an error on DEBUG_CHANNEL if target isn't in the region or an object.
• If either the object or the target are not modifiable or of different owners, then an error is shouted on DEBUG_CHANNEL.
• The maximum distance between linkable objects depends on the size of the objects as explained by Andrew Linden in this post.

All Issues ~ Search JIRA for related Bugs

Examples

See Also

Events

•

run_time_permissions

–

Permission receiving event

Functions

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llBreakLink	–	Break a link
•	llBreakAllLinks	–	Break all links

Articles

•

Script permissions

Deep Notes

Search JIRA for related Issues

Signature
function void llCreateLink( key target, integer parent );