llRemoteLoadScriptPin(key target, string name, integer pin, integer running, integer start_param)
In SL 1.12 a serious bug was introduced in this function, causing the bytecode to be stripped from the source code and loaded as a seperate, unnamed inventory object that would be named "Old Script". Any scripts that used llRemoteLoadScriptPin() between the deployment of 1.12 on 8/23/2006 to the rolling restart on Friday 8/25/2006 created these... problems. llGetScriptName() is unable to differentiate between the different scripts as they're ALL named "Old Script", and any inventory functions will only work on the first instance in inventory. Future update scripts will need to be written to look for these "Old Scripts" and their uncompiled properly named source stubs and handle them accordingly. -
DragonEccleston
If the
owner of the
object containing this
script can modify the object identified by the key
target,
and if the
pin matches the PIN previously set using
llSetRemoteScriptAccessPin (on the target prim), then the script
name will be copied into
target.
If the target prim already contains a script with the same name as
name, it will be
replaced without any warning.
Note: target must be a different prim than the one containing this script.
llRemoteLoadScriptPin cannot copy a script into itself. Also,
target must identify a
rezzed prim, existing in the
world. It cannot be in the
inventory of an object.
If
running is
TRUE, start the copied script with
start_param.
start_param can be retrieved using
llGetStartParameter in the copied script's
state_entry.
Note: this function
delays the
script for 3 seconds.
Example:
Note: llRemoteLoadScriptPin only works if both prims are in the same
sim.
This is presumably because of limitations in the way that sims are currently set up, but may be a "political" limitation imposed by the Lindens in an effort to curb intra-grid communications somewhat.
If copying fails, (for instance, if
key == llGetKey()) the script will
shout (yes, really!) "Unable to add item!" on
channel 0. It makes three attempts
(check this out--and then what?).
If an incorrect pin is used, the script sends the following error to the
DEBUG_CHANNEL: "Object: Task Object trying to illegally load script onto task Other_Object!"
This function replaces the
deprecated llRemoteLoadScript.
See
llGetScriptState and
llResetOtherScript for other fun things you can do with this.
If you need to update scripts for your end users, consider putting the updated scripts inside of an object which is then delivered directly to end users via llGiveInventory. This object, if rezzed in the same sim as the item being updated, can then negotiate a PIN with the object and the scripts can be updated/enabled automatically.
-- DirtyMcLean
Functions |
Inventory