Functions are what make your IF checks work. They can be fairly simple, and they can be massively complicated. There are quite a few of them, but knowing how and where to use them is rewarding if you want to have truly unique and intelligent scripts.

Logical Operators

These operators are found in many of the functions below. Here are their meanings.
==                                             This operator means ‘equal to’
!=                                              This operator means ‘not equal to’
>                                              This operator means ‘greater than’
<                                               This operator means ‘less than’
>=                                             This operator means ‘equal or greater than’
<=                                             This operator means ‘equal or less than’

affected

Usage:
affected(character spellid)

This checks whether the character is under the effects of the given spell. The spellid must be the full Java name of the spell, skill, prayer, property, chant, or whatever.

EXAMPLE:

if affected($n, Spell_Sleep)
mpecho The actor triggering me is asleep.
else
mpecho The actor triggering me is not under the effects of the sleep spell.
endif

baseclass

Usage:
baseclass(character == baseclassname)

This checks whether the character is a class which is part of the given baseclass. Where '==' may be another logical operator from above. Valid baseclasses include Archon, Artisan, Fighter, Druid, Mage, Cleric, Thief, or Bard.

EXAMPLE:

if baseclass($n == Archon)
mpecho The actor triggering me is an Archon.
else
mpecho The actor triggering me is not an Archon.
endif

callfunc

Usage:
callfunc(myfunctionname parm1 parm2...parmn)

This function, similar to the MPCALLFUNC statement above, will cause the script block with the trigger type FUNCTION_PROG and the given name to execute. The parameters passed into the callfunc can be referenced using the $g and $G codes. See the MPCALLFUNC statement above for more information on creating functions.

The callfunc function returns true ONLY if the FUNCTION_PROG includes a RETURN statement that includes a non-empty string parameter.

EXAMPLE:

function_prog myfunc
return $g
~

once_prog
if callfunc(myfunc ASTRING)
    mpecho This callfunc function will always return true.
    mpecho This is because myfunc just returns the parameter it is given.
    mpecho And this callfunc is passing in a non-empty string as a parameter.
endif

if !callfunc(myfunc)
    mpecho This callfunc function will always return false, since my parmeters are empty.
endif
~

clan

Usage:
clan(character == clanname)

This checks the name of the clan of the character variable. Where '==' may be another logical operator from above.

EXAMPLE:

if clan($n == 'The Unholy Goobers')
mpecho The actor triggering me appears to be an Unholy Goober.
else
mpecho The actor triggering me appears not to be a Goober.
endif

clandata

Usage:
clandata(clan variable == value)

This checks the value of a piece of datum about the given clan. The clan parameter may be either a mob to denote the mobs clan, or a clan name. Where variable should be one of the following ACCEPTANCE, DETAIL, DONATEROOM, EXP, GOVT, MORGUE, POLITICS, PREMISE, RECALL, SIZE, STATUS, TAXES, TROPHIES, TYPE, AREAS, MEMBERLIST, or TOPMEMBER. Where '==' may be another logical operator from above. The value may be any numeric, string, or literal.

EXAMPLE:

if clandata($n SIZE <= 1)
mpecho The actor triggering me appears to be the only solitary member of the clan.
else
mpecho The actor triggering me appears to be part of a clan larger than 1 member.
endif

clanrank

Usage:
clanrank(character == integer)

This checks the rank of the character in their clan. Where '==' may be another logical operator from above. Valid values include: APPLICANT=0, MEMBER=1, STAFF=2, ENCHANTER=4, TREASURER=8, LEADER=16, BOSS=32

EXAMPLE:

if clanrank($n == 0)
mpecho The actor triggering me appears to be an APPLICANT.
else
mpecho The actor triggering me appears not to be an APPLICANT.
endif

class

Usage:
class(character == classname)

This checks the class of the character variable. For players, this is their class, or in the case of a multi-classed character, the class they multied into. For disguised characters, this is the class they appear to be. Where '==' may be another logical operator from above.

EXAMPLE:

if class($n == Gaian)
mpecho The actor triggering me appears to be a Gaian.
else
mpecho The actor triggering me appears not to be a Gaian.
endif

deity

Usage:
deity(character == deityname)

This checks the name of the deity of the character variable. Where '==' may be another logical operator from above.

EXAMPLE:

if deity($n == 'Gothon')
mpecho The actor triggering me appears to worship an Unholy Goober.
else
mpecho The actor triggering me appears not to worship Gothon.
endif

eval

Usage:
eval(expression == expression)

This powerful function compares the first expression to the second expression. Expressions may be codes, literal strings, or literal numbers. This function also allows you to compare variables. Where '==' may be any other logical operator from above. This is an extremely powerful function that can, if used properly, take care of all of the evaluation needs which other functions do not provide. Examine carefully the section on codes above to see all the different things you can evaluate.

EXAMPLE:

if eval($n == an orc) or eval('$<$i VAR>' != 7)

goldamt

Usage:
goldamt(character > amount)

This evaluates the amount of gold that the character variable has on hand. Where '==' may be any other logical operator from above.

EXAMPLE:

if goldamt($n < 10000)
mpecho The actor has less than 10000 coins on hand
else
mpecho The actor has 10000 coins or more on hand
endif

gstat

Usage:
gstat(target variable == value)

This is another powerful function which allows you to make comparisons based on numerous characteristics of the target. The target may be any code, including mobs or items. The variable may be any of those listed above under MPGSET in the section on Scriptable Commands. The '==' may be any of the above logical operators, and the value any expression, including codes.

EXAMPLES:

if gstat($n CHARISMA > 10)
mpecho The actor has a charisma greater than 10.
endif

has

Usage:
has(character item)

This checks whether the character has the given item in their inventory or on their person.

EXAMPLE:

if has($n a long sword)
mpecho The actor has a long sword.
else
mpecho The actor does not have anything called 'a long sword'.
endif

hastattoo

Usage:
hastattoo(character item)

This checks whether the character has had the given tattoo assigned to them.

EXAMPLE:

if hastattoo($n beastmark)
mpecho The actor has the tattoo called beastmark.
else
mpecho The actor does not have the tattoo called beastmark.
endif

hitprcnt

Usage:
hitprcnt(character == amount)

This checks compares the character's percentage of hitpoints remaining with the amount give. Where '==' may be any logical operator from above. The amount must evaluate to something between 1 and 100.

EXAMPLE:

if hitprcnt($n <= 20)
mpecho The actor has 20% of their hit points or less remaining.
else
mpecho The actor has more than 20% of their hit points less.
endif

incontainer

Usage:
incontainer(character container/mount)

This checks whether the character is on the given mount, or, if the character is an item, whether the item is in the given container.

EXAMPLES:

if incontainer($n a chair)
mpecho The actor is sitting on a chair
else
mpecho The actor is not sitting on a chair
endif

if incontainer($p a sack)
mpecho The item is in a sack.
else
mpecho The item is not in a sack.
endif

inlocale

Usage:
inlocale(character roomclass)

This checks whether the character is presently standing in a room of a given class. The roomclass must be a specific Java name for a Room flass. Values like CaveMaze, Jungle, InTheAir, Plains, etc are what we are after here.

EXAMPLES:

if inlocale($n InTheAir)
mpecho The actor either flying or falling.
else
mpecho The actor is not up in the air.
endif

inroom

Usage:
inroom(target == roomcode)

This checks to see if the target is in the room specified by the room code. The room code may be a room id, a mob name, or text from the rooms name or description. The '==' may also be '!='.

EXAMPLES:

if inroom($i == a bathroom)
mpecho This means I am in a bathroom.
else
mpecho I am not in a bathroom.
endif

if inroom($i != MyArea#20001)
mpecho I am not in room MyArea#20001.
else
mpecho I am in room MyArea#20001.
endif

ipaddress

Usage:
ipaddress(character == string)

This compares the player characters ipaddress to the string. The '==' may also be '!='.

EXAMPLE:

if ipaddress($n == '127.0.0.1')
mpecho You are logging on from the mud server
else
mpecho You must be someone else.
endif

isable

Usage:
isable(character spellid)

This checks whether the character has the given spell. The spellid may be any key word from any spell, skill, prayer, property, chant, or whatever.

EXAMPLE:

if isable($n Write)
mpecho The actor has the writing skill.
else
mpecho The actor triggering me does not have the writing skill.
endif

isalive

Usage:
isalive(character)

This checks whether the character is alive.

EXAMPLE:

if isalive($i)
mpecho I am NOT dead!
end

isbehave

Usage:
isbehave(character behaviorid)

This checks whether the character has a given behavior. The behaviorid must be the full Java name of the behavior.

EXAMPLE:

if isbehave($n Mobile)
mpecho The actor triggering me is mobile.
else
mpecho The actor triggering me is not mobile.
endif

ischarmed

Usage:
ischarmed(character)

This checks to see if the character variable is charmed.

EXAMPLE:

if ischarmed($n)
mpecho This means the person triggering me is charmed.
else
mpecho This person triggering my prog is not charmed.
endif

isday

Usage:
isday(number)

This checks whether the current day of the month is the one given.

EXAMPLE:

if isday(10)
mpecho It is the 10th of the month.
end

isevil

Usage:
isevil(character)

This checks whether the character is evil.

EXAMPLE:

if isevil($i)
mpecho I am evil!
else
mpecho I am either neutral or good.
end

isfight

Usage:
isfight(character)

This checks to see if the character variable is in combat.

EXAMPLE:

if isfight($i)
mpecho I am fighting right now.
else
mpecho I am not fighting.
endif

isfollow

Usage:
isfollow(character)

This checks to see if the character variable’s master (the person they are following) is in the room.

EXAMPLE:

if isfollow($i)
mpecho I am following someone and they are in the room with me.
else
mpecho I am not following someone, or they are not in the room.
endif

isgood

Usage:
isgood(character)

This checks whether the character is good.

EXAMPLE:

if isgood($i)
mpecho I am good!
else
mpecho I am either neutral or evil.
end

ishere

Usage:
ishere(name)

This checks whether a mob or item of the given name is in the room. Obviously, checking for $i will always return true when a mob is being scripted, so the best choice for an argument is a literal string.

EXAMPLE:

if ishere(a happy frog)
mpecho A happy frog is in the room.
else
mpecho A happy frog is not in the room.
end

isimmort

Usage:
isimmort(character)

This checks to see if the character variable is immortal. In CoffeeMud, that means they have the security code IMMORT, which makes them unable to die.

EXAMPLE:

if isimmort($n)
mpecho The person triggering my prog is an immortal or lord.
else
mpecho The person triggering my prog is a mortal.
endif

islocked

Usage:
islocked(target)
islocked(direction)

This checks to see if the target container or exit is closed and locked. The target may be either an item, or an item code ($o, $p), or a direction name (north, south, east, west, etc.), or a direction code ($x, $xN, $xS, etc..)

EXAMPLE:

if islocked(the chest)
mpecho The chest is locked.
else
mpecho The chest is not locked.
endif

ismoon

Usage:
ismoon()
ismoon(phase)

If no parameter is given, this function checks whether the moon can be seen by the monster. Typically this means that it is nighttime, they are outside, and the sky is clear. With a parameter, this function only checks the phase of the moon, regardless of whether or not it can be seen. Accepted phases are: "NEW", "WAXCRESCENT", "WAXQUARTER", "WAXGIBBOUS", "FULL", "WANEGIBBOUS", "WANEQUARTER", "WANECRESCENT", or "BLUE".

EXAMPLE:

if ismoon(waxquarter)
mpecho There is a waxing quarter moon in the sky.
else
mpecho There is not a waxing warter moon in the sky.
endif

isname

Usage:
isname(character keyword)

This function returns whether the keyword appears in the name of the character.

EXAMPLES:

if isname($n goober)
mpecho The actor who caused the trigger is named goober.
else
mpecho The actor who caused the trigger is not named goober.
endif

if isname($n $i)
mpecho I, or someone with my name, is the actor!
else
mpecho Someone else is the actor.
endif

isneutral

Usage:
isneutral(character)

This checks whether the character is neutral.

EXAMPLE:

if isneutral($i)
mpecho I am neutral!
else
mpecho I am either good or evil.
end

isnpc

Usage:

isnpc(character)

This checks to see if a character variable is a mob.

EXAMPLE:

if isnpc($n)
mpecho The actor setting my prog off is a mob.
else
mpecho The actor setting my prog off is a player character.
endif

isopen

Usage:
isopen(target)
isopen(direction)

This checks to see if the target container or exit is open. The target may be either an item, or an item code ($o, $p), or a direction name (north, south, east, west, etc.), or a direction code ($x, $xN, $xS, etc..)

EXAMPLE:

if isopen(the chest)
mpecho The chest is open.
else
mpecho The chest is not open.
endif

ispc

Usage:
ispc(character)

This checks to see if a character variable is a player character.

EXAMPLE:

if ispc($n)
mpecho The actor setting my prog off is a player character.
else
mpecho The actor setting my prog off is not a player character.
endif

ispkill

Usage:
ispc(character)

This checks to see if a character has their pkill flag set. Only really matters with pcs, so it is best to use this function in conjunction with ispc(character).

EXAMPLE:

if ispc($n) and ispkill($n)
mpecho The actor setting my prog off is a player killer.
else
mpecho The actor setting my prog off is not a player killer.
endif

isquestmobalive

Usage:
isquestmobalive(number questname)
isquestmobalive(mobname questname)

This function only works if the script was assigned to a mob as part of the ADDBEHAVIOR quest command. It checks to see if a mob of the given number or name is alive. The numbers refer to the order in which they were designated in the quest script.

EXAMPLE:

if isquestmobalive(1 myquest)
mpecho The first set mob in the quest myquest is still alive.
else
mpecho He's not dead yet.
endif

isseason

Usage:
isseason(seasonname)

This function is used to check the season of the year. Valid seasonnames include "WINTER", "SPRING", "SUMMER", or "FALL".

EXAMPLE:

if isseason(summer)
mpecho Yea, its summertime!
else
mpecho Boo! It's not summer yet.
endif

istime

Usage:
istime(integer)
istime(todword)

This function is used to check the time. You may either specify a numeric hour of the day, or a time of day description, such as "DAY", "DAWN", "DUSK", or "NIGHT".

EXAMPLE:

if istime(night)
mpecho It is nighttime.
else
mpecho It must be dawn, dusk, or daytime.
endif

isweather

Usage:
isweather(weathername)

This function is used to check the weather where the monster is at. If the monster is indoors, this function will only return true for "CLEAR". Other valid weathernames include: "CLOUDY", "WINDY", "RAIN", "THUNDERSTORM", "SNOW", "HAIL", "HEAT", "SLEET", "BLIZZARD", "DUST", "DROUGHT", "COLD"

EXAMPLE:

if isweather(rain)
mpecho Rain, rain go away...
else
mpecho We can play! No Rain!
endif

level

Usage:
level(character == number)

This checks the total level of the character variable. Where '==' may be any of the logical operators mentioned above.

EXAMPLES:

if level($n <= 15)
mpecho The actor triggering me is 15th level or less.
else
mpecho The actor triggering me is above 15th level.
endif

if level($n > $%level($i)%)
mpecho The actor triggering me is higher level than me.
else
mpecho The actor triggering me is my level or under.
endif

mobitem

Usage:
mobitem(character number keywords)

This infrequently used function checks whether the numberth item in characters inventory has keywords in its name.

EXAMPLE:

if mobitem($n 1 sword) or mobitem ($n $g.1 sword)
mpecho Either the actors first item is a sword, or an item whose cardinality is represented by the code $g.1 is a sword.
else
mpecho Neither of those items is a sword.
endif

number

Usage:
number(string)

This function returns whether the string given is a number.

EXAMPLES:

if number($g.2)
mpecho The second parameter to this function_prog is a number.
else
mpecho The second parameter to this function_prog is not a number.
endif

numitemsmob

Usage:
numitemsmob(character == number)

This function compares the total number of items in the characters inventory to the number given. This function only counts items not in a container, or sheathed. It does count worn items. The '==' may also be any of the logical operators from above.

EXAMPLES:

if numitemsmob($n > 10)
mpecho The actor has an inventory size greater than 10.
else
mpecho The actor has an inventory size less than or equal to 10.
endif

numitemsroom

Usage:
numitemsroom( == number)

This function compares the total number of items in the same room as the monster to the number given. This function only counts items not in a container. The '==' may also be anyof the logical operators from above.

EXAMPLES:

if numitemsroom( > 10)
mpecho There are more than 10 items in this room.
else
mpecho There are 10 or less items in the room .
endif

nummobs

Usage:
nummobs(name == number)

This function compares the total number of mobs with the given name to the number. This function counts every single mob in the whole world, whether they are seen or detectable or not. The '==' may also be any of the logical operators from above.

EXAMPLES:

if nummobs(goobers > 10)
mpecho There are more than 10 goobers in the world.
else
mpecho There are 10 or less goobers in the world .
endif

nummobsinarea

Usage:
nummobsinarea(name == number)

This function compares the total number of mobs with the given name to the number. This function counts every single mob in the same area as the scripted monster or object, whether they are seen or detectable or not. The '==' may also be any of the logical operators from above.

EXAMPLES:

if nummobsinarea(goobers > 10)
mpecho There are more than 10 goobers in this area.
else
mpecho There are 10 or less goobers in this area.
endif

nummobsroom

Usage:
nummobsroom( == number)

This function compares the total number of mobs in the same room as the monster to the number given. This function counts players, npcs, and the hidden and undetectable. The '==' may also be any of the logical operators from above.

EXAMPLES:

if nummobsroom( > 10)
mpecho There are more than 10 mobs in this room.
else
mpecho There are 10 or less mobs in the room .
endif

numpcsroom

Usage:
numpcsroom( == number)

This function compares the total number of players in the same room as the monster to the number given. This function counts players only, including the hidden and undetectable. The '==' may also be any of the logical operators from above.

EXAMPLES:

if numpcsroom( > 10)
mpecho There are more than 10 pcs in this room.
else
mpecho There are 10 or less pcs in the room .
endif

numraces

Usage:
nummobs(race== number)

This function compares the total number of mobs with the given race to the number. This function counts every single mob in the whole world, whether they are seen or detectable or not. The '==' may also be any of the logical operators from above.

EXAMPLES:

if numraces(Goblin> 10)
mpecho There are more than 10 goblins in the world.
else
mpecho There are 10 or less goblins in the world .
endif

numracesinarea

Usage:
numracesinarea(race== number)

This function compares the total number of mobs with the given race to the number. This function counts every single mob in the same area as the scripted monster or object, whether they are seen or detectable or not. The '==' may also be any of the logical operators from above.

EXAMPLES:

if numracesinarea(Goblin > 10)
mpecho There are more than 10 goblins in this area.
else
mpecho There are 10 or less goblins in this area.
endif

position

Usage:
position(character == posword)

This checks the position of the character variable. The position is a word, either SITTING, STANDING, or SLEEPING. The '==' may also be another of the logical operators from above.

EXAMPLES:

if position($n == STANDING)
mpecho This means that the actor is standing.
else
mpecho This means the actor is not standing.
endif

questitem

Usage:
questitem(item questname)

This checks whether the given item is an official item created by a quest of the given questname.

EXAMPLES:

if questitem($o myquest)
mpecho This means that item is a quest item for quest myquest.
else
mpecho This means the item is not a quest item for quest myquest.
endif

questmob

Usage:
questmob(character questname)

This checks whether the given character is an official mob created by a quest of the given questname.

EXAMPLES:

if questmob($n myquest)
mpecho This means that the actor is a quest mob for quest myquest.
else
mpecho This means the the actor is not a quest mob for quest myquest.
endif

questwinner

Usage:
questmob(character questname)

This checks whether the given character has been declared a winner of the quest in the past via the MPQUESTWIN command.

EXAMPLES:

if questwinner($n myquest)
mpecho This means that the actor has been a winner of the quest myquest.
else
mpecho This means the the actor hss not been a winner of the quest myquest.
endif

race

Usage:
race(character == race)

This function compares the race of the character variable with the race name given. For a list of race names, do LIST RACES from the command line in the mud. The '==' may also be another of the logical operators from above.

EXAMPLE:

if race($n == Goblin)
mpecho The actor is a goblin.
else
mpecho The actor is not a goblin.
endif

racecat

Usage:
race(character == category)

This function compares the racial category of the race of the character variable with the racial category given. For a list of racial categories, do LIST RACES from the command line in the mud. The '==' may also be another of the logical operators from above.

EXAMPLE:

if racecat($n == Elf)
mpecho The actor is an Elf, or Elf-kin.
else
mpecho The actor is not an Elf-Kin.
endif

rand

Usage:
rand(integer)

This generates a random number and checks to see if it is under the integer. This is best used for random events where there are only two outcomes.

EXAMPLE:

if rand(40)
mpecho This is under 40% chance for me to echo this.
else
mpecho Not under 40%.
endif

rand0num

Usage:
rand0num(integer == integer)

This generates a random number from 0 to the first integer given minus 1, and checks to see if it is under the value give in the second integer. This is best used not in its pure function form, but as a string variable (see the $% format above). It allows one to randomly grab an item in a string list. See the example below.

EXAMPLE:

if rand0num(2 == 0)
MPSETVAR $i GREETINGLIST hi howdy hello greetings ho
say I just wanted to say $<$i GREETINGLIST>.$%RAND0NUM(5)%!
endif

randnum

Usage:
randnum(integer == integer)

This generates a random number from 1 to the first integer given, and checks to see if it is under the value give in the second integer. This is best used for random events where there are only two outcomes.

EXAMPLE:

if rand(1000 == 5)
mpecho This is under a 5 in 1000 chance for me to echo this.
else
mpecho Not under 5 in 1000.
endif

roomitem

Usage:
roomitem(number keywords)

This infrequently used function checks whether the numberth item in the room has keywords in its name.

EXAMPLE:

if roomitem(1 sword) or roomitem ($g.1 sword)
mpecho Either the rooms first item is a sword, or an item whose cardinality is represented by the code $g.1 is a sword.
else
mpecho Neither of those items is a sword.
endif

roommob

Usage:
roommob(number keywords)

This infrequently used function checks whether the numberth mob in the room has keywords in its name.

EXAMPLE:

if roommob(1 joe) or roommob($g.1 joe)
mpecho Either the rooms first mob is named joe, or a mob whose cardinality is represented by the code $g.1 is joe.
else
mpecho Neither of those mobs is joe.
endif

sex

Usage:
sex(character == letter)

This compares the sex of the character variable to the letter given. The letter may be "M", "F", or "N". The '==' may also be another of the logical operators from above.

EXAMPLES:

if sex($n == M)
mpecho The actor triggering me is a male.
else
mpecho The actor triggering me is not a male.
endif

if sex($n != $%sex($n)%)
mpecho The actor triggering me is not the same sex as me.
else
mpecho The actor triggering me is the same sex as me.
endif

stat

Usage:
stat(target variable == value)

This is a powerful function which allows you to make comparisons based on numerous characteristics of the target. The target may be any code, including mobs or items. The variable may be any of those listed above under MPGSET in the section on Scriptable Commands. The '==' may be any of the above logical operators, and the value any expression, including codes. This function is like gstat, with one important difference: stat respects only the variables which the target has available. For Generic mobs and items, this will be many more than for Standard mobs and items. For this reason, it is almost always preferable to use gstat.

EXAMPLES:

if stat($n CHARISMA > 10)
mpecho The actor, if a generic mob, has a charisma greater than 10.
endif

strin

Usage:
strin(string string)

This function searches the first string to see if the second string appears as a whole word within it. If so, this function returns true.

EXAMPLE:

if strin('one two three four' 'three')
mpecho The word three appears in the list of words.
else
mpecho Since no variables were used in the example, this is technically impossible.
endif

var

Usage:
var(character variable == value)

This function compares the variable belonging to the character to the given value. The character is almost always a code of some sort, where the variable is almost always a literal string. The value may be anything necessary. Where '==' may be any of the above logical operators. See MPSETVAR for information on settings variables.

EXAMPLE:

if var($n KILLS > 10)
mpecho The actor's KILLS variable is greater than 10.
else
mpecho The actor's KILLS variable is equal to or less than 10.
endif

worn

Usage:
worn(character item)

This function checks whether the character is wearing an item of the given name.

EXAMPLE:

if worn($n brass shirt)
mpecho The actor is wearing a brass shirt somewhere.
else
mpecho The actor is not wearing a brass shirt.
endif

$a	Name of the area the monsters in.
$i	The Monsters name.
$I	The Monsters display text.
$n	The Source of the triggers name.
$N	The Source of the triggers name.
$t	The Target of the triggers name.
$T	The Target of the triggers name.
$r	A random pc inhabitants name.
$R	A random pc inhabitants name.
$j	The pronoun he/she of the monster.
$e	The pronoun he/she of the source of the trigger.
$f	Name of the person which the monster follows.
$E	The pronoun he/she of the trigger target.
$F	The he/she of the person which the monster follows.
$J	The pronoun he/she of a random pc inhabitant.
$k	The possessive pronoun his/her of the monster.
$l	A list of all mobs (excluding monster). See "." syntax below.
$L	A list of all Items in room. See "." syntax below.
$m	The pronoun his/her of the source of the trigger.
$M	The pronoun his/her of the target of the trigger.
$d	The title of the room of the scripted monster.
$D	The long description of the room of the scripted monster.
$K	The pronoun his/her of a random pc inhabitant.
$o	The name of item#1.
$O	The name of item#1.
$p	The name of item#2.
$P	The name of item#2.
$w	The name of the owner of item#1.
$W	The name of the owner of item#2.
$g	The lowercase form of the message or parameters from a MPCALLFUNC, MASK_PROG or SPEECH_PROG.
$G	The uppercase form of the message or parameters from a MPCALLFUNC, MASK_PROG or SPEECH_PROG.
$x	A random valid exit's direction name (north, south, east, west, up, or down).
$X	A random valid exit's name (a door, a walkway, etc).
$xN	The specified directions name (Where N may be N, S, E, W, U, or D)
$<[CODE] [VAR NAME]>		The variable of the given name, and the given code. Where code is $i, $n, $t, $o, $w, $W, or $p. See MPSETVAR below.
${[NUM] [QUEST NAME]}		A mob name from the given quest, if the quest is running. The number corresponds to the order in which mobs were designated in the quest script. Counting starts at 1.
$[[NUM] [QUEST NAME]]		An item name from the given quest, if the quest is running. The number corresponds to the order in which items were designated in the quest script. Counting starts at 1.

AFFECTED([code])	Returns the name of a random spell affect on the given mob or item.
BASECLASS([code])	Returns the base class of the given mob.
CALLFUNC([function name] [parms])	Calls the FUNCTION_PROG of the given name, with the given parameters, and returns the value returned by the program using the RETURN statement.
CLAN([code])	Returns the clan of the given mob.
CLANRANK([code])	Returns the rank of the given mob in their clan.
CLANDATA([clan code] [variable])	Returns data about the given clan. See CLANDATA function below for variables.
CLASS([code])	Returns the class of the given mob.
DEITY([code])	Returns the deity of the given mob.
EVAL()	Not implemented -- do not use.
GOLDAMT([code])	Returns the number of gold coins the given mob has.
GSTAT([code] [stat variable])	Value of the given stat variable for the given mob or item. For example: $%GSTAT($i strength)% See the MPGSET command below for a complete list of variables.
HAS([code])	Returns the name of a random item in the scripted monsters inventory.
HASTITLE([code])	Returns the selected title of the given player mob.
HITPRCNT([code])	Return the % of hit points remaining for the given mob.
INCONTAINER([code])	Teturns the name of the container of the given item, or the mount of the given mob, depending on the code.
INLOCALE()	Returns the name of the room type the monster is in (plains, city, mountains, hills, watersurface, etc).
INROOM()	Returns the raw id of the room the scripted monster is in.
IPADDRESS([code])	Returns the ipaddress of the player.
ISABLE([code] [skill name])	Returns the given mobs profficiency in the given skill/spell/ability.
ISALIVE([code])	Returns the health of the given mob.
ISBEHAVE([code])	Returns the class ids of the behaviors on the given mob or item.
ISCHARMED([code])	Returns the name of the charm spell the mob is under.
ISDAY()	Returns word the word day or the word evening.
ISEVIL([code])	Returns the short alignment string of the given mob.
ISFIGHT([code])	Returns the name of the creature the given mob is fighting, or nothing otherwise.
ISFOLLOW([code])	Returns the name of the creature the given mob is following, or nothing otherwise.
ISGOOD([code])	Returns the alignment string of the given mob.
ISHERE()	Returns the name of the area the scripted monster is in.
ISIMMORT([code])	not implemented.
ISLOCKED([code or direction])	Returns the key name if the given container name or direction has a lock. The code may refer to an item container with a lock, or a direction name, such as north, south, east, etc.
ISMOON()	Returns the moon phase description.
ISNAME([code])	Returns the real/full name of the given object.
ISNEUTRAL([code])	Returns the alignment number of the given mob (0-1000).
ISNPC([code])	Not implemented -- do not use.
ISOPEN([code or direction])	Returns "true" if the container item is open, or the exit in the given direction name is open.
ISPC([code])	Not implemented -- do not use..
ISQUESTMOBALIVE()	Not implemented -- do not use..
ISSEASON()	Returns the name of the season.
ISTIME()	Returns the approximate time of day in words.
ISWEATHER()	Returns a description of the weather in a short sentence.
LEVEL([code])	Returns the level of the given mob.
MOBITEM([code] [integer number])	Returns the nth item owned by the given mob.
NUMBER([integer number or code])	Returns the numberic value of the given argument.
NUMITEMSMOB([code])	Returns the number of items the given mob has.
NUMITEMSROOM()	Returns the number of items in the room.
NUMMOBS([name])	Returns the number of mobs in the world matching the given mob name.
NUMMOBSINAREA([name])	Returns the number of mobs in the scripted monsters area matching the given mob name.
NUMMOBSROOM()	Returns the number of mobs in the same room as the scripted monster, including the monster.
NUMPCSROOM()	Returns the number of pcs in the same room as the scripted monster.
NUMRACEINAREA([race name])	Returns the number of mobs in the same area as the scripted monster whose race matches the given string.
NUMRACES([race name])	Returns the number of mobs in the world whose race matches the given string.
POSITION([code])	Returns the sitting/standing/sleeping position name of the given mob.
QUESTITEM()	Not implemented -- do not use.
QUESTMOB()	Not implemented -- do not use.
QUESTWINNER()	Not implemented -- do not use.
RACE([code])	Returns the name of the race of the given mob.
RACECAT([code])	Returns the racial category of the given mob.
RAND()	Returns random number between 1 and 100.
RAND0NUM([integer number or code])	Returns a random number from 0..given value-1.
RANDNUM([integer number or code])	Returns a random number from 1..given value.
ROOMITEM([integer number])	Returns the name of the nth item in the same room as the scripted monster.
ROOMMOB([integer number])	Returns the name of the nth mob in the same room as the scripted monster.
SEX([code])	Returns the sex of the given mob.
STAT([code] [stat variable])	Returns the value of the given stat for the given object, mob, or item. See MPSTAT in the section on Commands for more information.
STRIN([string] [string])	Returns the word number (0..n) where the second string appears in the first. This function deals in whole words only.
VAR([code] [variable name])	Retturns the value of the given variable. See MPSETVAR in the section on Commands for more information.
WORN([code])	The name of a random worn item in the given mobs inventory.