Difference between revisions of "Attachrid"
(Created page with "==Syntax== *'''attachrid'''(<rid>); *'''detachrid'''; ==Description== These commands allow the manipulation of the script's currently attached player. While '''...") |
Latest revision as of 22:23, 10 June 2013
Syntax
- attachrid(<rid>);
- detachrid;
Description
These commands allow the manipulation of the script's currently attached player. While attachrid allows attaching of a different player by using it's account id for the parameter rid, detachrid makes the following commands run, as if the script was never invoked by a player.
In case, that the player cannot be attached, such as, when the player went offline in the mean time, attachrid returns 0, otherwise 1.
Examples
mes "Enter a name of a player."; next; input .@playername$; set .@playerid,getcharid(3,.@playername$); // retrieve rid of another player set .@invokeid,getcharid(3); // retrieve rid of the current player detachrid; // detaches the current player, // although not necessary before attachrid if(.@playerid && attachrid(.@playerid)) // playerid is 0, if player is offline { dispbottom "Hello! *^__^*"; } else { set .@playerid,0; // indicate attachrid failure } if(attachrid(.@invokeid)) // attach back to the first player { if(.@playerid) { mes "I have said hello to "+.@playername$+"."; } else { mes "I was not able to reach "+.@playername$+"."; } close; } end;
This will allow one player to specify the name of an another, which is then greeted by the script. Afterwards the invoking player is informed, whether or not the player was told "hello". The return value of attachrid should be always checked for success, otherwise the script terminates on the next command, which requires an attached player, on failure.