diff --git a/doc/script_commands.txt b/doc/script_commands.txt index e85b964ef2..ebb53eb700 100644 --- a/doc/script_commands.txt +++ b/doc/script_commands.txt @@ -141,7 +141,7 @@ explanation, see 'setmapflag'. ** Create a permanent monster spawn: -,,,,%TAB%monster%TAB%%TAB%,,,, +,,,,%TAB%monster%TAB%%TAB%,,,,{,,} Map name is the name of the map the monsters will spawn on. x,y are the coordinates where the mob should spawn. If xs and ys are non-zero, they @@ -158,15 +158,6 @@ used, (which, in rAthena, actually contains an english name) if it's "--en--", it's the 'english name' from the monster database (which contains an uppercase name used to summon the monster with a GM command). -If you add 20000 to the monster ID, the monster will be spawned in a 'big -version', (monster size class will increase) and if you add 10000, the 'tiny -version' of the monster will be created. However, this method is deprecated -and not recommended, as the values to add can change at a later time (20000 -and 10000 actually stand for 2*MAX_MOB_DB and MAX_MOB_DB respectively, which -is defined on mob.h, and can change in the future as more mobs are created). -The recommended way to change a mob's size is to use the event-field (see -below). - Amount is the amount of monsters that will be spawned when this command is executed, it is affected by spawn rates in 'battle_athena.conf'. @@ -185,11 +176,12 @@ should start with "On". As with all events, if the NPC is an on-touch NPC, the player who triggers the script must be within 'trigger' range for the event to work. -The Event field can be used alternatively to specify other mob properties. Use -2 to specify that the mob should be small, 4 for big monsters, and 8 for -special ai mobs (which by default attack other monsters instead of players). -You can add these, so using 10 will spawn small monsters that attack other -mobs (if you specify both 2 and 4, the small version takes priority). +There are two optional fields for monster size and AI. Size can be 0 (medium), +1 (small), or 2 (big). AI can be 0 (default), 1 (attack/friendly), 2 (sphere), +3 (flora), or 4 (zanzou). + +Alternately, a monster spawned using 'boss_monster' instead of 'monster' is able +to be detected on the map with the SC_BOSSMAPINFO status (used by Convex Mirror). ** NPC names @@ -1151,30 +1143,34 @@ Returns the variable reference (since trunk r12870). *setd "",; -Works almost identical as set, just that the variable name is identified as a string, -thus can be constructed dynamically. +Works almost identically as set, except the variable name is identified as a string +and can thus be constructed dynamically. + This command is equivalent to: -set getd("variable name"),; + set getd("variable name"),; -Example: -set $var$, "Poring"; +Examples: -setd "$var$", "Poporing"; -mes $var$; // Will return Poporing + setd ".@var$", "Poporing"; + mes .@var$; // Displays "Poporing". -setd "$" + $var$ + "123$", "Poporing is cool"; -mes $Poporing123$; // Will return Poporing is cool. + setd ".@" + $var$ + "123$", "Poporing is cool"; + mes .@Poporing123$; // Displays "Poporing is cool". --------------------------------------- *getd("") Returns a reference to a variable, the name can be constructed dynamically. -Refer to setd for usage. +Refer to 'setd' for usage. -Example: -set getd("$varRefence"), 1; -set @i, getd("$pikachu"); +This can also be used to set an array dynamically: + setarray getd(".array[0]"), 1, 2, 3, 4, 5; + +Examples: + + set getd("$varRefence"), 1; + set @i, getd("$" + "pikachu"); --------------------------------------- @@ -2194,7 +2190,7 @@ You can also use this command to get stat values. *getcharid({,""}) This function will return a unique ID number of the invoking character, or, if a -character name is specified, of that character. +character name is specified, of that player. Type is the kind of associated ID number required: @@ -2423,21 +2419,20 @@ Available information types are: 1 - X coordinate 2 - Y coordinate - --------------------------------------- +--------------------------------------- - *getcharip{()} +*getcharip({""||}) - This function will return the IP address of the currently attached player - or the currently attached Character Name/Account ID/Character ID. This command - returns a blank str if there is no player attached. +This function will return the IP address of the invoking character, or, if a player +is specified, of that character. A blank string is returned if no player is attached. -Example 1: Sets the variable, @ip$, into the IP address of currently attached player. - - @ip$ = getcharip; +Examples: -Example 2: Sets the variable, @ip$, into the IP address of character "Silver". +// Outputs IP address of attached player. + mes "Your IP: " + getcharip(); - @ip$ = getcharip("Silver"); +// Outputs IP address of character "Silver". + mes "Silver's IP: " + getcharip("Silver"); --------------------------------------- \\ @@ -5151,25 +5146,26 @@ The main difference is that @follow can use character names, and this commands n Examples: -//This will make Aaron follow Bullah, when both of these characters are online. +// This will make Aaron follow Bullah, when both of these characters are online. PCFollow getCharID(3,"Aaron"),getCharID(3,"Bullah"); -//Makes Aaron stop following whoever he is following. +// Makes Aaron stop following whoever he is following. PCStopFollow getCharID(3,"Aaron"); --------------------------------------- *pcblockmove ,