LlRemoteLoadScriptPin
From Second Life Wiki
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Tutorials |
Contents |
Summary
Function: llRemoteLoadScriptPin( key target, string name, integer pin, integer running, integer start_param );| 253 | Function ID |
| 3.0 | Delay |
| 10.0 | Energy |
Copy script name into target and if running start with start_param.
| • key | target | – | prim UUID that is in the same region | |
| • string | name | – | a script in the prim's inventory | |
| • integer | pin | – | Must match pin set by llSetRemoteScriptAccessPin | |
| • integer | running | – | boolean, if the script is to be set as running. | |
| • integer | start_param | – | value returned by llGetStartParameter in the target script. |
Only works if the owner of the object this script is in can modify target.
Caveats
- This function causes the script to sleep for 3.0 seconds.
- If target is not owned by the same person, and name cannot be transferred, an error is shouted on DEBUG_CHANNEL.
- If name cannot be copied then an error is shouted on DEBUG_CHANNEL.
- If target is not in the same region an error is shouted on DEBUG_CHANNEL.
- If name is missing from the prim's inventory or it is not a script then an error is shouted on DEBUG_CHANNEL.
- If name is present in the target prim's inventory then it is silently replaced.
- start_param only lasts until the script is reset.
- If target is an attachment owned by a different user, regardless of object modify rights granted, this function will silently (bug?) fail.[1]
- If pin fails to match, the error "Task ~Prim~ trying to illegally load script onto task ~Other_Prim~!" is shouted on DEBUG_CHANNEL. "~Prim~" and "~Other_Prim~" are substituted with the applicable prim names.
- If target is the scripts parent (target == llGetKey()) then "Unable to add item!" is shouted on DEBUG_CHANNEL.
- In case the object containing the script with llRemoteLoadScriptPin() is deeded to a group, the script which is supposed to be transfered needs transfer permissions even when it's supposed to be transfered to another object which is deeded to the same group.
Important Issues
~ Search JIRA for related Bugs| | | SVC-3321 | [c] | stack trace error while running scripts after llRemoteLoadScriptPin |
Examples
//Child Prim PIN setter integer PIN=1341134; default { state_entry() { llOwnerSay(llGetObjectName()+" : "+(string)llGetKey()+" is ready to accept a describer script using the agreed upon PIN."); llSetRemoteScriptAccessPin(PIN); } }
Deep Notes
History
- Added in 1.2.6
- In SL 1.25.4 this function will not copy/move any script into an attachment unless the script is full perm. (SVC-3725)
- SL 1.25.5 will allow this function to copy/move a script into an attachment so long as the target has matching (or more restrictive) copy and transfer permissions. (SVC-3738)
Issues
~ Search JIRA for related Issues| | | SVC-3321 | [c] | stack trace error while running scripts after llRemoteLoadScriptPin |
Footnotes
- ^ Attachments can only be modified by their owner.
This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.

