FutureMUD Function Reference

ENDINFLUENCEBYTEMPLATE

boolean endinfluencebytemplate()

Parameter	Variable Type	Parameter Help

Character

CHECK

number check(character character, trait trait, number difficulty)

Parameter	Variable Type	Parameter Help
character	character	the character whose trait you want to check against
trait	trait	the trait you want to check
difficulty	number	the difficulty of the check. 0 = automatic, 10 = impossible, 5 = normal

This function allows you to roll a check against a trait at a defined difficulty for a character, and see the result. The return values are -3 = Major Fail, -2 = Fail, -1 = Minor Fail, 1 = Minor Pass, 2 = Pass, 3 = Major Pass

GETPATH

text collection getpath(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want directions for
destination	location	the destination room to path them to

Returns a list of direction commands between the character and the target, if one exists.

GETPATHIGNOREDOORS

text collection getpathignoredoors(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want directions for
destination	location	the destination room to path them to

Returns a list of direction commands between the character and the target, if one exists, but ignores any doors (open, closed, locked or otherwise).

GETPATHRESPECTDOORS

text collection getpathrespectdoors(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want directions for
destination	location	the destination room to path them to

Returns a list of direction commands between the character and the target, if one exists, but respects any closed doors as untraversable.

GETPATHUNLOCKED

text collection getpathunlocked(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want directions for
destination	location	the destination room to path them to

Returns a list of direction commands between the character and the target, if one exists, but respects any locked and closed doors as untraversable.

GETTRAIT

number gettrait(toon who, trait trait)

Parameter	Variable Type	Parameter Help
who	toon	the person whose traits you would like to interrogate
trait	trait	the trait you want to know the value of

This function returns the current trait value of the selected trait on the specified person

GETTRAITCAP

number gettraitcap(character who, trait trait)

Parameter	Variable Type	Parameter Help
who	character	the person whose traits you would like to interrogate
trait	trait	the trait you want to know the cap value of

This function returns the trait cap of the selected trait on the specified person

GIVEACCENT

boolean giveaccent(character who, accent accent)

Parameter	Variable Type	Parameter Help
who	character	the character to give the accent to
accent	accent	the accent to give the character

Gives an accent to a character at automatic. Returns true if given, false if already had it.

GIVEKNOWLEDGE

boolean giveknowledge(character who, knowledge knowledge)

Parameter	Variable Type	Parameter Help
who	character	the character to give the knowledge to
knowledge	knowledge	the knowledge to give the character

Gives a knowledge to a character. Returns true if given, false if already had it.

GIVEMERIT

boolean givemerit(character who, merit merit)

Parameter	Variable Type	Parameter Help
who	character	the character to give the merit to
merit	merit	the merit to give the character

Gives a merit to a character. Returns true if given, false if already had it.

GIVETRAIT

number givetrait(character who, trait trait)

Parameter	Variable Type	Parameter Help
who	character	the character to give the trait to
trait	trait	the trait to give the character

Gives a trait (skill or attribute) to a player. Uses the opening value as if the trait had branched (for skills) or minimum value (for attributes). Returns the value of the trait

GIVETRAIT

number givetrait(character who, trait trait, number value)

Parameter	Variable Type	Parameter Help
who	character	the character to give the trait to
trait	trait	the trait to give the character
value	number	the value of the trait

Gives a trait (skill or attribute) to a player with the specified value. If they already have the trait, sets the value if it is higher. Returns the value of the trait

IMPROVETRAIT

number improvetrait(character who, trait trait)

Parameter	Variable Type	Parameter Help
who	character	the character to improve the trait of
trait	trait	the trait to improve

Gives a trait improvement tick to a trait. This is as if the player had rolled an improvement naturally. Returns the new value.

ISADMIN

boolean isadmin(toon toon)

Parameter	Variable Type	Parameter Help
toon	toon	the character or toon whose status as an admin you want to test

This function tells you if the person you specify, which can be a character, chargen or NPC template, is an admin

ONLINEACTORS

character collection onlineactors()

Parameter	Variable Type	Parameter Help

Returns all of the Actors (PC and NPC characters) that are loaded into the game.

ONLINECHARACTERS

character collection onlinecharacters()

Parameter	Variable Type	Parameter Help

Returns all of the PC characters that are online.

ONLINENPCS

character collection onlinenpcs()

Parameter	Variable Type	Parameter Help

Returns all of the NPC characters that are loaded into the game.

REMOVEKNOWLEDGE

boolean removeknowledge(character who, knowledge knowledge)

Parameter	Variable Type	Parameter Help
who	character	the character to remove the knowledge from
knowledge	knowledge	the knowledge to remove from the character

Takes a knowledge from a character. Returns true if taken, false if they didn't have it.

REMOVEMERIT

boolean removemerit(character who, merit merit)

Parameter	Variable Type	Parameter Help
who	character	the character to take the merit from
merit	merit	the merit to take from the character

Takes a merit from a character. Returns true if taken, false if didn't have it.

SETTRAIT

number settrait(character who, trait trait, number value)

Parameter	Variable Type	Parameter Help
who	character	the character to give the trait to
trait	trait	the trait to give the character
value	number	the value of the trait

Sets the value of a trait (skill or attribute) for a player with the specified value. Gives them the trait if they don't have it but can lower the value if they already have it but it is higher than the value you specify. Returns the value of the trait

TELEPORT

boolean teleport(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to

Teleports a character to the ground level (or closest layer) in a new room. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TELEPORT

boolean teleport(character character, location destination, text layer)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to
layer	text	the room layer to teleport to

Teleports a character to the specified layer in a new room. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TELEPORTALL

boolean teleportall(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to

Teleports a character and all their followers/drag targets to the ground level (or closest layer) in a new room. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TELEPORTALL

boolean teleportall(character character, location destination, text layer)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to
layer	text	the room layer to teleport to

Teleports a character and all their followers/drag targets to the specified layer in a new room. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TELEPORTALLNOECHO

boolean teleportallnoecho(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to

Teleports a character and all their followers/drag targets to the ground level (or closest layer) in a new room, with no echoes. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TELEPORTALLNOECHO

boolean teleportallnoecho(character character, location destination, text layer)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to
layer	text	the room layer to teleport to

Teleports a character and all their followers/drag targets to the specified layer in a new room, with no echoes. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TELEPORTNOECHO

boolean teleportnoecho(character character, location destination)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to

Teleports a character to the ground level (or closest layer) in a new room, with no echoes. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TELEPORTNOECHO

boolean teleportnoecho(character character, location destination, text layer)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to teleport
destination	location	the destination room to teleport them to
layer	text	the room layer to teleport to

Teleports a character to the specified layer in a new room, with no echoes. Returns false if the teleportation fails (if invalid character, room, or layer is specified).

TEMPTRAITBONUS

effect temptraitbonus(character who, trait trait, number bonus, text reference, timespan duration)

Parameter	Variable Type	Parameter Help
who	character	the character who has the trait
trait	trait	the trait to give the bonus to
bonus	number	the bonus to give to the trait
reference	text	a reference text to group similar bonuses (will overwrite anything with the same)
duration	timespan	the time for this effect to apply before expiring

Adds an effect to a character that gives a bonus to a trait. You also supply a reference bit of text. Each character can only have one effect with a specific reference, so you can use this to ensure that bonuses don't get stacked. You also use it to remove the specific bonus later. Returns the effect that it adds.

TEMPTRAITBONUS

effect temptraitbonus(character who, trait trait, number bonus, text reference, text prog, timespan duration)

Parameter	Variable Type	Parameter Help
who	character	the character who has the trait
trait	trait	the trait to give the bonus to
bonus	number	the bonus to give to the trait
reference	text	a reference text to group similar bonuses (will overwrite anything with the same)
prog	text	the name of a prog that controls if the bonus applies
duration	timespan	the time for this effect to apply before expiring

TEMPTRAITBONUS

effect temptraitbonus(character who, trait trait, number bonus, text reference, number prog, timespan duration)

Parameter	Variable Type	Parameter Help
who	character	the character who has the trait
trait	trait	the trait to give the bonus to
bonus	number	the bonus to give to the trait
reference	text	a reference text to group similar bonuses (will overwrite anything with the same)
prog	number	the id of a prog that controls if the bonus applies
duration	timespan	the time for this effect to apply before expiring

TRAITBONUS

effect traitbonus(character who, trait trait, number bonus, text reference)

Parameter	Variable Type	Parameter Help
who	character	the character who has the trait
trait	trait	the trait to give the bonus to
bonus	number	the bonus to give to the trait
reference	text	a reference text to group similar bonuses (will overwrite anything with the same)

TRAITBONUS

effect traitbonus(character who, trait trait, number bonus, text reference, text prog)

Parameter	Variable Type	Parameter Help
who	character	the character who has the trait
trait	trait	the trait to give the bonus to
bonus	number	the bonus to give to the trait
reference	text	a reference text to group similar bonuses (will overwrite anything with the same)
prog	text	the name of a prog that controls if the bonus applies

TRAITBONUS

effect traitbonus(character who, trait trait, number bonus, text reference, number prog)

Parameter	Variable Type	Parameter Help
who	character	the character who has the trait
trait	trait	the trait to give the bonus to
bonus	number	the bonus to give to the trait
reference	text	a reference text to group similar bonuses (will overwrite anything with the same)
prog	number	the id of a prog that controls if the bonus applies

Characteristics

CHARACTERISTICID

text characteristicid(character character, number characteristic)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you are interested in probing
characteristic	number	the id number of the characteristic definition you want to probe the value of

This function returns the ID of the supplied character's intrinsic characteristic for the supplied definition. E.g. If you supplied the ID number of the colour characteristic, you might get the ID 435 as a return value.

CHARACTERISTICID

text characteristicid(item item, number characteristic)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you are interested in probing
characteristic	number	the id number of the characteristic definition you want to probe the value of

This function returns the ID of the supplied items's intrinsic characteristic for the supplied definition. E.g. If you supplied the ID number of the colour characteristic, you might get the ID 435 as a return value.

CHARACTERISTICID

text characteristicid(character character, text characteristic)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you are interested in probing
characteristic	text	the name of the characteristic definition you want to probe the value of

CHARACTERISTICID

text characteristicid(item item, text characteristic)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you are interested in probing
characteristic	text	the name of the characteristic definition you want to probe the value of

CHARACTERISTICVALUE

text characteristicvalue(character character, number characteristic)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you are interested in probing
characteristic	number	the id number of the characteristic definition you want to probe the value of

This function returns the name of the supplied character's intrinsic characteristic for the supplied definition. E.g. If you supplied the ID number of the eyecolour characteristic, you might get the 'emerald green' as a return value.

CHARACTERISTICVALUE

text characteristicvalue(item item, number characteristic)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you are interested in probing
characteristic	number	the id number of the characteristic definition you want to probe the value of

This function returns the name of the supplied items's intrinsic characteristic for the supplied definition. E.g. If you supplied the ID number of the colour characteristic, you might get the 'hot pink' as a return value.

CHARACTERISTICVALUE

text characteristicvalue(character character, text characteristic)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you are interested in probing
characteristic	text	the name of the characteristic definition you want to probe the value of

CHARACTERISTICVALUE

text characteristicvalue(item item, text characteristic)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you are interested in probing
characteristic	text	the name of the characteristic definition you want to probe the value of

GETCHARACTERISTIC

text getcharacteristic(unknown type thing, text target, perceiver perceiver)

Parameter	Variable Type	Parameter Help
thing	unknown type	the thing whose characteristics you want to interrogate
target	text	the name of the characteristic you want, including fancy or basic forms
perceiver	perceiver	the perceiver through whose perspective these characteristics should be interpreted

This function allows you to return the text value of a specified characteristic of a character, chargen or item. It returns the same result as if you had used $name in a description.

GETREALCHARACTERISTIC

text getrealcharacteristic(unknown type thing, text target)

Parameter	Variable Type	Parameter Help
thing	unknown type	the thing whose characteristics you want to interrogate
target	text	the name of the characteristic you want, including fancy or basic forms

This function allows you to return the text value of a specified characteristic of a character, chargen or item. It returns the same result as if you had used $name in a description. This version returns the true value of a characteristic, unhindered by the lens of a perceiver.

SETCHARACTERISTIC

boolean setcharacteristic(character character, number definition, number value)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to set
definition	number	the id number of the characteristic definition you want to use
value	number	the id number of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTIC

boolean setcharacteristic(character character, text definition, number value)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to set
definition	text	the name of the characteristic definition you want to use
value	number	the id number of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTIC

boolean setcharacteristic(character character, number definition, text value)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to set
definition	number	the id number of the characteristic definition you want to use
value	text	the name of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTIC

boolean setcharacteristic(character character, text definition, text value)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to set
definition	text	the name of the characteristic definition you want to use
value	text	the name of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTIC

boolean setcharacteristic(item item, number definition, number value)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to set
definition	number	the id number of the characteristic definition you want to use
value	number	the id number of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTIC

boolean setcharacteristic(item item, text definition, number value)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to set
definition	text	the name of the characteristic definition you want to use
value	number	the id number of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTIC

boolean setcharacteristic(item item, number definition, text value)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to set
definition	number	the id number of the characteristic definition you want to use
value	text	the name of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTIC

boolean setcharacteristic(item item, text definition, text value)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to set
definition	text	the name of the characteristic definition you want to use
value	text	the name of the characteristic value that you want to set

Sets the intrinsic characteristic value for the characteristic definition on the supplied target. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(character character, number definition, number profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to randomly set
definition	number	the id number of the characteristic definition you want to use
profile	number	the id number of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(character character, text definition, number profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to randomly set
definition	text	the name of the characteristic definition you want to use
profile	number	the id number of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(character character, number definition, text profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to randomly set
definition	number	the id number of the characteristic definition you want to use
profile	text	the name of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(character character, text definition, text profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
character	character	the character whose characteristics you want to randomly set
definition	text	the name of the characteristic definition you want to use
profile	text	the name of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(item item, number definition, number profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to randomly set
definition	number	the id number of the characteristic definition you want to use
profile	number	the id number of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(item item, text definition, number profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to randomly set
definition	text	the name of the characteristic definition you want to use
profile	number	the id number of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(item item, number definition, text profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to randomly set
definition	number	the id number of the characteristic definition you want to use
profile	text	the name of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

SETCHARACTERISTICRANDOM

boolean setcharacteristicrandom(item item, text definition, text profile, boolean forcenew)

Parameter	Variable Type	Parameter Help
item	item	the item whose characteristics you want to randomly set
definition	text	the name of the characteristic definition you want to use
profile	text	the name of the characteristic profile that you want to use to give the range of possible values
forcenew	boolean	if true, excludes the current result from the outcome. i.e. the value must change. if false or if there is only 1 value to choose from on the profile, the result may still be the old value

Sets the intrinsic characteristic value for the characteristic definition on the supplied target to a random value selected from the profile you supply. Returns true if successful.

Characters

CANMOUNT

boolean canmount(character character, character mount)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to be the rider
mount	character	the mount you want them to mount

Returns true if a character can mount the mount.

DISMOUNT

boolean dismount(character character)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to force to dismount

Forceably removes a character from their mount. Does not do any echoes.

KILL

item kill(character victim, boolean makecorpse)

Parameter	Variable Type	Parameter Help
victim	character	the character who you want to kill
makecorpse	boolean	if true, leaves a corpse behind. otherwise disposes of corpse.

Kills the specified character, and optionally leaves a corpse. Returns the corpse as an item.

MOUNT

boolean mount(character character, character mount)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to force to mount
mount	character	the mount you want them to mount

Makes a character mount an available mount. Returns true if successful. Does handle echoes.

WHYCANTMOUNT

boolean whycantmount(character character, character mount)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to be the rider
mount	character	the mount you want them to mount

Returns an error message about why a character cannot mount the mount.

Chargen

GETRESOURCE

number getresource(toon character, text resource)

Parameter	Variable Type	Parameter Help
character	toon	the character whose account you want to look up
resource	text	the name of the resource you want to look up

Returns the amount of the specified chargen resources (karma, RPP, BP, etc) that an account has

GIVERESOURCE

number giveresource(toon character, text resource, number amount)

Parameter	Variable Type	Parameter Help
character	toon	the character whose account should get the resources
resource	text	the resource to give that account
amount	number	the amount of resource to give

This function gives (or takes if you use a negative number) a specified amount of chargen resource (Karma, RPP, BP, etc) to an account. It returns the new amount of resource that account has after the change.

Clans

CLANAPPOINT

boolean clanappoint(character character, clan clan, appointment appointment)

Parameter	Variable Type	Parameter Help
character	character	the characer to be invited to the clan
clan	clan	the clan to invite them into
appointment	appointment	the appointment for them to be appointed to

This function appoints a character to a position in a clan they're already in. It returns false if the character was not in the clan.

CLANINVITE

boolean claninvite(character character, clan clan, rank rank, character manager)

Parameter	Variable Type	Parameter Help
character	character	the characer to be invited to the clan
clan	clan	the clan to invite them into
rank	rank	the rank for them to be set to
manager	character	the manager (or person considered to have invited them)

This function adds a character to a clan. It returns false if the character was already in the clan.

CLANINVITE

boolean claninvite(character character, clan clan, rank rank)

Parameter	Variable Type	Parameter Help
character	character	the characer to be invited to the clan
clan	clan	the clan to invite them into
rank	rank	the rank for them to be set to

This function adds a character to a clan. It returns false if the character was already in the clan.

CLANINVITE

boolean claninvite(character character, clan clan)

Parameter	Variable Type	Parameter Help
character	character	the characer to be invited to the clan
clan	clan	the clan to invite them into

This function adds a character to a clan at the default rank. It returns false if the character was already in the clan.

Collections

CONTAINS

boolean contains(void collection collection, collectionitem item)

Parameter	Variable Type	Parameter Help
collection	void collection	the collection you want to check
item	collectionitem	the item you are looking for in the collection

This function allows you to test whether a given item is in a collection. True if the collection contains the item.

GETINDEX

collectionitem getindex(void collection collection, number index)

Parameter	Variable Type	Parameter Help
collection	void collection	a collection of anything
index	number	the zero-based index of the element you want to retrieve from the collection

This function returns the element at the specified index of a collection, or null if an incorrect index is specified. The return type depends on the return type of the collection. You may need to convert the result. See CONVERT function.

INDEXOF

number indexof(void collection collection, collectionitem item)

Parameter	Variable Type	Parameter Help
collection	void collection	a collection of anything
item	collectionitem	the item whose position in the collection you want to know

This function returns the zero-based index of a specified item in the collection, if present. If not present it returns -1.

Combat

STARTCOMBAT

boolean startcombat(text reference, text description, text gerund, boolean friendly, character combatant1, character combatant2, text joinprog, text leaveprog, text endprog, text moveprog, text hitprog)

Parameter	Variable Type	Parameter Help
reference	text	a unique reference that is passed to each of the progs when executed
description	text	the description of the combat that appears in combat status
gerund	text	the gerund used in combat descriptions, e.g. fighting, sparring, boxing, etc.
friendly	boolean	whether this combat counts as friendly and uses the spar rules or not
combatant1	character	the first combatant
combatant2	character	the second combatant
joinprog	text	a prog to execute when someone joins the combat. it must accept a character (the joiner) and a text parameter (the reference).
leaveprog	text	a prog to execute when someone leaves the combat. it must accept a character (the leaver) and a text parameter (the reference).
endprog	text	a prog to execute when the combat ends. it must accept a text parameter (the reference).
moveprog	text	a prog to execute when someone makes a move in combat. it must accept a character (the attacker), another character (the target) and a text parameter (the reference).
hitprog	text	a prog to execute when someone hits someone in combat. it must accept a character (the attacker), another character (the target) and a text parameter (the reference).

Starts a combat that executes progs when various things happen.

Conversion

CONVERT

character convert(magicresourcehaver from, character to)

Parameter	Variable Type	Parameter Help
from	magicresourcehaver	the variable that you want to convert. can be null.
to	character	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

toon convert(magicresourcehaver from, toon to)

Parameter	Variable Type	Parameter Help
from	magicresourcehaver	the variable that you want to convert. can be null.
to	toon	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

item convert(magicresourcehaver from, item to)

Parameter	Variable Type	Parameter Help
from	magicresourcehaver	the variable that you want to convert. can be null.
to	item	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

location convert(magicresourcehaver from, location to)

Parameter	Variable Type	Parameter Help
from	magicresourcehaver	the variable that you want to convert. can be null.
to	location	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

character convert(perceiver from, character to)

Parameter	Variable Type	Parameter Help
from	perceiver	the variable that you want to convert. can be null.
to	character	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

item convert(perceiver from, item to)

Parameter	Variable Type	Parameter Help
from	perceiver	the variable that you want to convert. can be null.
to	item	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

character convert(perceivable from, character to)

Parameter	Variable Type	Parameter Help
from	perceivable	the variable that you want to convert. can be null.
to	character	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

item convert(perceivable from, item to)

Parameter	Variable Type	Parameter Help
from	perceivable	the variable that you want to convert. can be null.
to	item	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

location convert(perceivable from, location to)

Parameter	Variable Type	Parameter Help
from	perceivable	the variable that you want to convert. can be null.
to	location	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

zone convert(perceivable from, zone to)

Parameter	Variable Type	Parameter Help
from	perceivable	the variable that you want to convert. can be null.
to	zone	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

shard convert(perceivable from, shard to)

Parameter	Variable Type	Parameter Help
from	perceivable	the variable that you want to convert. can be null.
to	shard	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

character convert(referencetype from, character to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	character	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

location convert(referencetype from, location to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	location	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

item convert(referencetype from, item to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	item	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

shard convert(referencetype from, shard to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	shard	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

zone convert(referencetype from, zone to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	zone	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

race convert(referencetype from, race to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	race	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

culture convert(referencetype from, culture to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	culture	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

chargen convert(referencetype from, chargen to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	chargen	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

trait convert(referencetype from, trait to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	trait	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

clan convert(referencetype from, clan to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	clan	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

rank convert(referencetype from, rank to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	rank	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

appointment convert(referencetype from, appointment to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	appointment	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

paygrade convert(referencetype from, paygrade to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	paygrade	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

currency convert(referencetype from, currency to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	currency	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

exit convert(referencetype from, exit to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	exit	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

language convert(referencetype from, language to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	language	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

accent convert(referencetype from, accent to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	accent	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

merit convert(referencetype from, merit to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	merit	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

calendar convert(referencetype from, calendar to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	calendar	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

clock convert(referencetype from, clock to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	clock	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

effect convert(referencetype from, effect to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	effect	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

knowledge convert(referencetype from, knowledge to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	knowledge	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

role convert(referencetype from, role to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	role	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

ethnicity convert(referencetype from, ethnicity to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	ethnicity	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

drug convert(referencetype from, drug to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	drug	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

weatherevent convert(referencetype from, weatherevent to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	weatherevent	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

shop convert(referencetype from, shop to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	shop	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

merchandise convert(referencetype from, merchandise to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	merchandise	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

outfit convert(referencetype from, outfit to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	outfit	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

outfititem convert(referencetype from, outfititem to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	outfititem	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

project convert(referencetype from, project to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	project	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

overlaypackage convert(referencetype from, overlaypackage to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	overlaypackage	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

terrain convert(referencetype from, terrain to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	terrain	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

solid convert(referencetype from, solid to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	solid	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

liquid convert(referencetype from, liquid to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	liquid	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

gas convert(referencetype from, gas to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	gas	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

magicspell convert(referencetype from, magicspell to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	magicspell	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

magicschool convert(referencetype from, magicschool to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	magicschool	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

magiccapability convert(referencetype from, magiccapability to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	magiccapability	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

bank convert(referencetype from, bank to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	bank	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

bankaccount convert(referencetype from, bankaccount to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	bankaccount	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

bankaccounttype convert(referencetype from, bankaccounttype to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	bankaccounttype	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

legalauthority convert(referencetype from, legalauthority to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	legalauthority	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

law convert(referencetype from, law to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	law	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

crime convert(referencetype from, crime to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	crime	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

market convert(referencetype from, market to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	market	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

marketcategory convert(referencetype from, marketcategory to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	marketcategory	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

script convert(referencetype from, script to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	script	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

writing convert(referencetype from, writing to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	writing	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

area convert(referencetype from, area to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	area	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

perceivable convert(referencetype from, perceivable to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	perceivable	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

perceiver convert(referencetype from, perceiver to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	perceiver	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

toon convert(referencetype from, toon to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	toon	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

magicresourcehaver convert(referencetype from, magicresourcehaver to)

Parameter	Variable Type	Parameter Help
from	referencetype	the variable that you want to convert. can be null.
to	magicresourcehaver	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

text convert(anything from, text to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	text	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

number convert(anything from, number to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	number	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

boolean convert(anything from, boolean to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	boolean	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

character convert(anything from, character to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	character	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

location convert(anything from, location to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	location	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

item convert(anything from, item to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	item	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

shard convert(anything from, shard to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	shard	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

gender convert(anything from, gender to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	gender	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

zone convert(anything from, zone to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	zone	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

void collection convert(anything from, void collection to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	void collection	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

race convert(anything from, race to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	race	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

culture convert(anything from, culture to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	culture	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

chargen convert(anything from, chargen to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	chargen	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

trait convert(anything from, trait to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	trait	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

clan convert(anything from, clan to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	clan	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

rank convert(anything from, rank to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	rank	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

appointment convert(anything from, appointment to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	appointment	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

paygrade convert(anything from, paygrade to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	paygrade	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

currency convert(anything from, currency to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	currency	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

exit convert(anything from, exit to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	exit	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

void convert(anything from, void to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	void	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

datetime convert(anything from, datetime to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	datetime	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

timespan convert(anything from, timespan to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	timespan	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

language convert(anything from, language to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	language	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

accent convert(anything from, accent to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	accent	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

merit convert(anything from, merit to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	merit	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

muddatetime convert(anything from, muddatetime to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	muddatetime	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

calendar convert(anything from, calendar to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	calendar	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

clock convert(anything from, clock to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	clock	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

effect convert(anything from, effect to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	effect	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

knowledge convert(anything from, knowledge to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	knowledge	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

role convert(anything from, role to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	role	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

ethnicity convert(anything from, ethnicity to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	ethnicity	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

drug convert(anything from, drug to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	drug	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

weatherevent convert(anything from, weatherevent to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	weatherevent	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

shop convert(anything from, shop to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	shop	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

merchandise convert(anything from, merchandise to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	merchandise	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

outfit convert(anything from, outfit to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	outfit	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

outfititem convert(anything from, outfititem to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	outfititem	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

project convert(anything from, project to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	project	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

overlaypackage convert(anything from, overlaypackage to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	overlaypackage	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

terrain convert(anything from, terrain to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	terrain	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

solid convert(anything from, solid to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	solid	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

liquid convert(anything from, liquid to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	liquid	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

gas convert(anything from, gas to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	gas	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

void dictionary convert(anything from, void dictionary to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	void dictionary	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

void collectiondictionary convert(anything from, void collectiondictionary to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	void collectiondictionary	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

magicspell convert(anything from, magicspell to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	magicspell	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

magicschool convert(anything from, magicschool to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	magicschool	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

magiccapability convert(anything from, magiccapability to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	magiccapability	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

bank convert(anything from, bank to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	bank	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

bankaccount convert(anything from, bankaccount to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	bankaccount	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

bankaccounttype convert(anything from, bankaccounttype to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	bankaccounttype	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

legalauthority convert(anything from, legalauthority to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	legalauthority	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

law convert(anything from, law to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	law	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

crime convert(anything from, crime to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	crime	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

market convert(anything from, market to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	market	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

marketcategory convert(anything from, marketcategory to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	marketcategory	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

liquidmixture convert(anything from, liquidmixture to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	liquidmixture	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

script convert(anything from, script to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	script	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

writing convert(anything from, writing to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	writing	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

CONVERT

area convert(anything from, area to)

Parameter	Variable Type	Parameter Help
from	anything	the variable that you want to convert. can be null.
to	area	a dummy variable of the type that you want to convert to.

This function allows you to convert a variable from one type to another type.

TOCHARACTER

character tocharacter(perceiver character)

Parameter	Variable Type	Parameter Help
character	perceiver	the perceiver to convert to a character.

Converts a perceiver to a character, if possible. Otherwise returns null.

TOCHARACTER

character tocharacter(perceivable character)

Parameter	Variable Type	Parameter Help
character	perceivable	the perceivable to convert to a character.

Converts a perceivable to a character, if possible. Otherwise returns null.

TOCHARACTER

character tocharacter(toon character)

Parameter	Variable Type	Parameter Help
character	toon	the toon to convert to a character.

Converts a toon to a character, if possible. Otherwise returns null.

TOCHARACTER

character tocharacter(collectionitem character)

Parameter	Variable Type	Parameter Help
character	collectionitem	the collection item to convert to a character.

Converts a collection item to a character, if possible. Otherwise returns null.

Crime

ALLCRIMES

crime collection allcrimes(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character to fetch crimes for
authority	legalauthority	the authority to check crimes in, or if null, all authorities

Returns a list of all the crimes a character has committed in the specified authority (or authorities)

INCUSTODYOFENFORCER

boolean incustodyofenforcer(character character)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to check for being in custody

This function checks if the character is currently in the physical custody of any enforcers

INPRISON

boolean inprison(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to check for being in prison
authority	legalauthority	the legal authority to check in, or null for all

This function checks if the character is currently serving a prison sentence

ISENFORCER

boolean isenforcer(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character you want to check
authority	legalauthority	the legal authority to check in, or if null, checks all of the authorities

Returns true if the character is an enforcer in the specified legal authority or authorities

ISFELON

boolean isfelon(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character to check
authority	legalauthority	the legal authority in which to check, or all authorities if null

This function checks to see if the character has ever had a serious crime (one that incurred jail time or capital punishment) recorded against them

ISFELON

boolean isfelon(character character)

Parameter	Variable Type	Parameter Help
character	character	the character to check

This function checks to see if the character has ever had a serious crime (one that incurred jail time or capital punishment) recorded against them

ISWANTED

boolean iswanted(character character, legalauthority legalauthority)

Parameter	Variable Type	Parameter Help
character	character	the character whose wanted status you want to know
legalauthority	legalauthority	the legal authority you're checking against, or null if checking against all

This function determines if the supplied character is wanted for arrest in the specified legal authority

KNOWNCRIMES

crime collection knowncrimes(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character to fetch crimes for
authority	legalauthority	the authority to check crimes in, or if null, all authorities

Returns a list of all the unresolved crimes known to authorities in the specified authority (or authorities)

ONBAIL

boolean onbail(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to check for bail
authority	legalauthority	the legal authority to check in, or null for all

This function checks if the character is currently on bail for any crimes

ONGOODBEHAVIORBOND

boolean ongoodbehaviorbond(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to check for being on good behavior
authority	legalauthority	the legal authority to check in, or null for all

This function checks if the character is currently on a good behavior bond for a previous crime. Alternate spelling version for US English proggers.

ONGOODBEHAVIOURBOND

boolean ongoodbehaviourbond(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to check for being on good behaviour
authority	legalauthority	the legal authority to check in, or null for all

This function checks if the character is currently on a good behaviour bond for a previous crime

RESOLVEDCRIMES

crime collection resolvedcrimes(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character to fetch crimes for
authority	legalauthority	the authority to check crimes in, or if null, all authorities

Returns a list of all the resolved crimes in the specified authority (or authorities)

UNKNOWNCRIMES

crime collection unknowncrimes(character character, legalauthority authority)

Parameter	Variable Type	Parameter Help
character	character	the character to fetch crimes for
authority	legalauthority	the authority to check crimes in, or if null, all authorities

Returns a list of all the unresolved crimes unknown to authorities in the specified authority (or authorities)

WARNEDBYENFORCER

boolean warnedbyenforcer(character character)

Parameter	Variable Type	Parameter Help
character	character	the character who you want to check for warnings

This function checks if the character is currently under a warning to surrender from any enforcers

Currency

TAKECURRENCY

boolean takecurrency(currency currency, number amount, location from, boolean useget, boolean givechange)

Parameter	Variable Type	Parameter Help
currency	currency	the currency that you want to take
amount	number	the amount that you want to take
from	location	who or what you want to take it from
useget	boolean	whether to use the get rules (i.e. don't take from locked containers etc)
givechange	boolean	whether to give change or not

This function lets you take currency from currency piles in a room, held by a character or in an item. Returns true if it succeeds.

TAKECURRENCY

boolean takecurrency(currency currency, text amount, location from, boolean useget, boolean givechange)

Parameter	Variable Type	Parameter Help
currency	currency	the currency that you want to take
amount	text	the amount that you want to take
from	location	who or what you want to take it from
useget	boolean	whether to use the get rules (i.e. don't take from locked containers etc)
givechange	boolean	whether to give change or not

This function lets you take currency from currency piles in a room, held by a character or in an item. Returns true if it succeeds.

TAKECURRENCY

boolean takecurrency(currency currency, number amount, character from, boolean useget, boolean givechange)

Parameter	Variable Type	Parameter Help
currency	currency	the currency that you want to take
amount	number	the amount that you want to take
from	character	who or what you want to take it from
useget	boolean	whether to use the get rules (i.e. don't take from locked containers etc)
givechange	boolean	whether to give change or not

This function lets you take currency from currency piles in a room, held by a character or in an item. Returns true if it succeeds.

TAKECURRENCY

boolean takecurrency(currency currency, text amount, character from, boolean useget, boolean givechange)

Parameter	Variable Type	Parameter Help
currency	currency	the currency that you want to take
amount	text	the amount that you want to take
from	character	who or what you want to take it from
useget	boolean	whether to use the get rules (i.e. don't take from locked containers etc)
givechange	boolean	whether to give change or not

This function lets you take currency from currency piles in a room, held by a character or in an item. Returns true if it succeeds.

TAKECURRENCY

boolean takecurrency(currency currency, number amount, item from, boolean useget, boolean givechange)

Parameter	Variable Type	Parameter Help
currency	currency	the currency that you want to take
amount	number	the amount that you want to take
from	item	who or what you want to take it from
useget	boolean	whether to use the get rules (i.e. don't take from locked containers etc)
givechange	boolean	whether to give change or not

This function lets you take currency from currency piles in a room, held by a character or in an item. Returns true if it succeeds.

TAKECURRENCY

boolean takecurrency(currency currency, text amount, item from, boolean useget, boolean givechange)

Parameter	Variable Type	Parameter Help
currency	currency	the currency that you want to take
amount	text	the amount that you want to take
from	item	who or what you want to take it from
useget	boolean	whether to use the get rules (i.e. don't take from locked containers etc)
givechange	boolean	whether to give change or not

This function lets you take currency from currency piles in a room, held by a character or in an item. Returns true if it succeeds.

Dictionaries

SET

boolean set(void dictionary dictionary, text key, text item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	text	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, number item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	number	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, boolean item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	boolean	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, character item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	character	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, location item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	location	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, item item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	item	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, shard item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	shard	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, gender item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	gender	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, zone item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	zone	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, race item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	race	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, culture item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	culture	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, chargen item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	chargen	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, trait item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	trait	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, clan item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	clan	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, rank item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	rank	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, appointment item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	appointment	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, paygrade item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	paygrade	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, currency item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	currency	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, exit item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	exit	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, datetime item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	datetime	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, timespan item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	timespan	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, language item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	language	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, accent item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	accent	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, merit item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	merit	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, muddatetime item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	muddatetime	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, calendar item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	calendar	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, clock item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	clock	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, effect item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	effect	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, knowledge item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	knowledge	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, role item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	role	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, ethnicity item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	ethnicity	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, drug item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	drug	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, weatherevent item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	weatherevent	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, shop item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	shop	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, merchandise item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	merchandise	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, outfit item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	outfit	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, outfititem item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	outfititem	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, project item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	project	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, overlaypackage item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	overlaypackage	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, terrain item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	terrain	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, solid item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	solid	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, liquid item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	liquid	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, gas item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	gas	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, magicspell item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	magicspell	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, magicschool item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	magicschool	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, magiccapability item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	magiccapability	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, bank item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	bank	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, bankaccount item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	bankaccount	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, bankaccounttype item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	bankaccounttype	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, legalauthority item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	legalauthority	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, law item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	law	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, crime item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	crime	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, market item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	market	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, marketcategory item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	marketcategory	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, liquidmixture item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	liquidmixture	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, script item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	script	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

SET

boolean set(void dictionary dictionary, text key, writing item)

Parameter	Variable Type	Parameter Help
dictionary	void dictionary	the dictionary you want to set the item in
key	text	the text key at which you want to store that item
item	writing	the item that you want to add to the dictionary

Sets the specified text key in the dictionary to be the item specified. Returns true if the set succeeded (the types were compatible), and false if not.

Disfigurements

ADDTATTOO

boolean addtattoo(character character, number tattooid, text bodypart, character tattooist, number tattooistskill, number completion)

Parameter	Variable Type	Parameter Help
character	character	the character who is getting the tattoo
tattooid	number	the id number of the tattoo template to apply
bodypart	text	the name of the bodypart to install the tattoo on
tattooist	character	the tattooist who is responsible for the tattoo. can be null
tattooistskill	number	the skill of the tattooist. if it is null, checks the tattooist's skill
completion	number	the completion percentage between 0.0 and 1.0

This command attempts to add the specified tattoo to a character. Returns true if it was successful.

Echoes

SENDLOC

boolean sendloc(location location, text text)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text text, perceivable perceivable1)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text text, perceivable perceivable1, perceivable perceivable2)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5, perceivable perceivable6)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.
perceivable8	perceivable	a perceivable to use dynamically in the echoes. use $8 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text layer, text text)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text layer, text text, perceivable perceivable1)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text layer, text text, perceivable perceivable1, perceivable perceivable2)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text layer, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text layer, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text layer, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

boolean sendloc(location location, text layer, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5, perceivable perceivable6)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOC

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.
perceivable8	perceivable	a perceivable to use dynamically in the echoes. use $8 to refer.

This function sends a specified message to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

boolean sendlocfixed(location location, text text)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

boolean sendlocfixed(location location, text text, perceivable perceivable1)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

boolean sendlocfixed(location location, text text, perceivable perceivable1, perceivable perceivable2)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

boolean sendlocfixed(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

boolean sendlocfixed(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

boolean sendlocfixed(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

boolean sendlocfixed(location location, text text, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5, perceivable perceivable6)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCFIXED

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.
perceivable8	perceivable	a perceivable to use dynamically in the echoes. use $8 to refer.

This function sends a specified message to every perceiver in the location - the format is fixed, it does not wrap / process in any way. You can use the colour tags (#0, #1 etc) in this echo.

SENDLOCLANG

boolean sendloclang(location location, text text, language language, accent accent)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message

This function sends a specified message (including potentially language/accent bound spoken information) to every perceiver in the location. You can use the colour tags (#0, #1 etc) in this echo. Anything inside double quotes will be interpreted as language.

SENDLOCLANG

boolean sendloclang(location location, text text, language language, accent accent, perceivable perceivable1)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.

SENDLOCLANG

boolean sendloclang(location location, text text, language language, accent accent, perceivable perceivable1, perceivable perceivable2)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.

SENDLOCLANG

boolean sendloclang(location location, text text, language language, accent accent, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.

SENDLOCLANG

boolean sendloclang(location location, text text, language language, accent accent, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.

SENDLOCLANG

boolean sendloclang(location location, text text, language language, accent accent, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.

SENDLOCLANG

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.

SENDLOCLANG

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.

SENDLOCLANG

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.
perceivable8	perceivable	a perceivable to use dynamically in the echoes. use $8 to refer.

SENDLOCLANGLAYER

boolean sendloclanglayer(location location, text layer, text text, language language, accent accent)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message

SENDLOCLANGLAYER

boolean sendloclanglayer(location location, text layer, text text, language language, accent accent, perceivable perceivable1)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.

SENDLOCLANGLAYER

boolean sendloclanglayer(location location, text layer, text text, language language, accent accent, perceivable perceivable1, perceivable perceivable2)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.

SENDLOCLANGLAYER

boolean sendloclanglayer(location location, text layer, text text, language language, accent accent, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.

SENDLOCLANGLAYER

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.

SENDLOCLANGLAYER

boolean sendloclanglayer(location location, text layer, text text, language language, accent accent, perceivable perceivable1, perceivable perceivable2, perceivable perceivable3, perceivable perceivable4, perceivable perceivable5)

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.

SENDLOCLANGLAYER

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.

SENDLOCLANGLAYER

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.

SENDLOCLANGLAYER

Parameter	Variable Type	Parameter Help
location	location	the location to send the message to
layer	text	the layer to send the message to
text	text	the message to send to the location
language	language	the language that the language content of the message should be understood in
accent	accent	the spoken accent of the language content of the message
perceivable1	perceivable	a perceivable to use dynamically in the echoes. use $1 to refer.
perceivable2	perceivable	a perceivable to use dynamically in the echoes. use $2 to refer.
perceivable3	perceivable	a perceivable to use dynamically in the echoes. use $3 to refer.
perceivable4	perceivable	a perceivable to use dynamically in the echoes. use $4 to refer.
perceivable5	perceivable	a perceivable to use dynamically in the echoes. use $5 to refer.
perceivable6	perceivable	a perceivable to use dynamically in the echoes. use $6 to refer.
perceivable7	perceivable	a perceivable to use dynamically in the echoes. use $7 to refer.
perceivable8	perceivable	a perceivable to use dynamically in the echoes. use $8 to refer.

Effects

ADDHEALINGEFFECT

effect addhealingeffect(perceivable perceivable, number multiplier, number stages, number progid, timespan duration)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable to whom the healing effect is being added
multiplier	number	the healing multiplier for the effect
stages	number	the number of difficulty stages to stage the healing difficulty checks by. negative is a bonus, positive is a penalty.
progid	number	the id of the prog to whether the effect applies
duration	timespan	the duration of the effect

This function adds an effect to a perceivable (character or item) that changes the rate and difficulty of healing. Returns the effect it creates.

ADDHEALINGEFFECT

effect addhealingeffect(perceivable perceivable, number multiplier, number stages, text progid, timespan duration)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable to whom the healing effect is being added
multiplier	number	the healing multiplier for the effect
stages	number	the number of difficulty stages to stage the healing difficulty checks by. negative is a bonus, positive is a penalty.
progid	text	the name of the prog to whether the effect applies
duration	timespan	the duration of the effect

This function adds an effect to a perceivable (character or item) that changes the rate and difficulty of healing. Returns the effect it creates.

ADDINVISEFFECT

effect addinviseffect(perceivable perceivable, number prog)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable to add the invisibility effect to
prog	number	the id of a prog to control whether the effect applies. parameters are perceivable,perceivable and returns boolean.

This function adds an invisibility effect to a perceivable. Returns the effect it creates.

ADDINVISEFFECT

effect addinviseffect(perceivable perceivable, text prog)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable to add the invisibility effect to
prog	text	the name of a prog to control whether the effect applies. parameters are perceivable,perceivable and returns boolean.

This function adds an invisibility effect to a perceivable. Returns the effect it creates.

Grids

CONNECTTOGRID

boolean connecttogrid(number grid, item item)

Parameter	Variable Type	Parameter Help
grid	number	the id of the grid you want to connect the item to
item	item	the grid-interfacing item you want to connect

This function takes a grid-interfacing item like a grid feeder or grid outlet and connects it. Returns true if it succeeded.

EXTENDGRID

boolean extendgrid(number grid, location location)

Parameter	Variable Type	Parameter Help
grid	number	the id of the grid you want to extend
location	location	the location you want to extend the grid to

This function allows you to extend a grid (electrical, gas, liquid etc) to a new location. Returns true if the extension happened, false implies the grid was already present or there was another error.

WITHDRAWGRID

boolean withdrawgrid(number grid, location location)

Parameter	Variable Type	Parameter Help
grid	number	the id of the grid you want to withdraw from
location	location	the location you want to withdraw the grid from

This function allows you to withdraw a grid (electrical, gas, liquid etc) from a new location. Returns true if the withdrawal happened, false implies the grid was not present or there was another error.

Health

WOUND

boolean wound(perceiver thing, text type, text formula)

Parameter	Variable Type	Parameter Help
thing	perceiver	the thing to be wounded
type	text	the damage type to be applied
formula	text	the dice formula of how much damage to do

Creates a wound on a target item or character

WOUND

boolean wound(perceiver thing, text type, number amount)

Parameter	Variable Type	Parameter Help
thing	perceiver	the thing to be wounded
type	text	the damage type to be applied
amount	number	the amount of damage to do

Creates a wound on a target item or character

WOUND

boolean wound(character thing, text type, text formula, text bodypart)

Parameter	Variable Type	Parameter Help
thing	character	the thing to be wounded
type	text	the damage type to be applied
formula	text	the dice formula of how much damage to do
bodypart	text	the bodypart to damage

Creates a wound on a target character

WOUND

boolean wound(character thing, text type, number amount, text bodypart)

Parameter	Variable Type	Parameter Help
thing	character	the thing to be wounded
type	text	the damage type to be applied
amount	number	the amount of damage to do
bodypart	text	the bodypart to damage

Creates a wound on a target character

Hooks

ADDHOOK

boolean addhook(perceivable perceivable, number hookid)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable for whom you want to install a hook
hookid	number	the id of the hook that you want to install.

This function installs a 'hook' on a perceivable. See in game help for hooks for more info.

ADDHOOK

boolean addhook(perceivable perceivable, text hookname)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable for whom you want to install a hook
hookname	text	the name of the hook that you want to install.

This function installs a 'hook' on a perceivable. See in game help for hooks for more info.

Items

CLEARMORPHTIMER

boolean clearmorphtimer(item item)

Parameter	Variable Type	Parameter Help
item	item	the item who's morph timer you want to clear

This function stops an item from morphing. Its timer will not resume unless specifically made to do so via SetMorphTimer. This function returns true unless there was a problem, e.g. item was null.

DELETEITEM

boolean deleteitem(item item)

Parameter	Variable Type	Parameter Help
item	item	the item that you want to delete

Permanently deletes the specified item. Warning: this is unrecoverable. Returns true if the delete is successful.

FORCEOPEN

boolean forceopen(item item, boolean locked, boolean echo)

Parameter	Variable Type	Parameter Help
item	item	the item to be opened or closed
locked	boolean	if true, set to open, otherwise set to closed
echo	boolean	whether to echo the change in state

Changes an openable item from open to closed or the reverse. True if the change was successfully applied. Ignores game rules about whether something can be opened.

LOADCOMMODITY

item loadcommodity(number material, number weight)

Parameter	Variable Type	Parameter Help
material	number	the id of the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(text material, number weight)

Parameter	Variable Type	Parameter Help
material	text	the name of the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(number material, text weight)

Parameter	Variable Type	Parameter Help
material	number	the id of the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(text material, text weight)

Parameter	Variable Type	Parameter Help
material	text	the name of the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(solid material, number weight)

Parameter	Variable Type	Parameter Help
material	solid	the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(solid material, text weight)

Parameter	Variable Type	Parameter Help
material	solid	the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(number material, number weight, number tag)

Parameter	Variable Type	Parameter Help
material	number	the id of the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.
tag	number	the id of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(text material, number weight, number tag)

Parameter	Variable Type	Parameter Help
material	text	the name of the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.
tag	number	the id of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(number material, text weight, number tag)

Parameter	Variable Type	Parameter Help
material	number	the id of the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc
tag	number	the id of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(text material, text weight, number tag)

Parameter	Variable Type	Parameter Help
material	text	the name of the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc
tag	number	the id of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(solid material, number weight, number tag)

Parameter	Variable Type	Parameter Help
material	solid	the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.
tag	number	the id of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(solid material, text weight, number tag)

Parameter	Variable Type	Parameter Help
material	solid	the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc
tag	number	the id of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(number material, number weight, text tag)

Parameter	Variable Type	Parameter Help
material	number	the id of the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.
tag	text	the name of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(text material, number weight, text tag)

Parameter	Variable Type	Parameter Help
material	text	the name of the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.
tag	text	the name of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(number material, text weight, text tag)

Parameter	Variable Type	Parameter Help
material	number	the id of the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc
tag	text	the name of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(text material, text weight, text tag)

Parameter	Variable Type	Parameter Help
material	text	the name of the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc
tag	text	the name of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(solid material, number weight, text tag)

Parameter	Variable Type	Parameter Help
material	solid	the material that you want to load
weight	number	the weight of the material to load in base units for this mud. see mud owner for configuration info.
tag	text	the name of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADCOMMODITY

item loadcommodity(solid material, text weight, text tag)

Parameter	Variable Type	Parameter Help
material	solid	the material that you want to load
weight	text	the weight of the material to load, e.g. 15.3kg, 12lb etc
tag	text	the name of the tag that you want to load

This function loads a new commodity item into the game. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADITEM

item loaditem(number id)

Parameter	Variable Type	Parameter Help
id	number	the id of the item prototype that you want to load

This function loads a new item into the game based on the ID that you supply. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADITEM

item loaditem(number id, number quantity)

Parameter	Variable Type	Parameter Help
id	number	the id of the item prototype that you want to load
quantity	number	the quantity of the item you want to load. if this item is not stackable, this input is ignored.

This function loads a new item into the game based on the ID that you supply. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADITEM

item loaditem(number id, text variables)

Parameter	Variable Type	Parameter Help
id	number	the id of the item prototype that you want to load
variables	text	the default values for any variables on this item. this syntax is as per using the item load command in game, which means the general syntax is varname=value or varname="longer value", with multiple variables separated by spaces

This function loads a new item into the game based on the ID that you supply. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

LOADITEM

item loaditem(number id, number quantity, text variables)

Parameter	Variable Type	Parameter Help
id	number	the id of the item prototype that you want to load
quantity	number	the quantity of the item you want to load. if this item is not stackable, this input is ignored
variables	text	the default values for any variables on this item. this syntax is as per using the item load command in game, which means the general syntax is varname=value or varname="longer value", with multiple variables separated by spaces

This function loads a new item into the game based on the ID that you supply. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory.

SETCONDITION

boolean setcondition(item item, number condition)

Parameter	Variable Type	Parameter Help
item	item	the item whose condition you wish to set
condition	number	the condition of the item, between 0.0 and 1.0

This function sets the condition percentage of an item to whatever amount you specify.

SETFLIPPED

boolean setflipped(item item, boolean flipped)

Parameter	Variable Type	Parameter Help
item	item	the item that you want to flip or unflip
flipped	boolean	a boolean representing whether this item is flipped or not

If an item is a flippable (e.g. a table), this command sets the flipped state according to an argument you pass in. Returns true if the item was changed, false if it was already in the desired state or wasn't a flippable.

SETLOCKED

boolean setlocked(item lock, boolean locked, boolean echo)

Parameter	Variable Type	Parameter Help
lock	item	the item to be locked or unlocked
locked	boolean	if true, set to locked. if false, set to unlocked
echo	boolean	whether to echo the change in state

Changes a lock or lockable item from locked to unlocked if specified. True if the change was successfully applied.

SETMATERIAL

boolean setmaterial(item item, solid material)

Parameter	Variable Type	Parameter Help
item	item	the item whose primary material you want to set
material	solid	the material you want to set

This function sets the primary material of an item to the specified material. It returns true if this succeeds.

SETMATERIAL

boolean setmaterial(item item, number material)

Parameter	Variable Type	Parameter Help
item	item	the item whose primary material you want to set
material	number	the id of the material that you want to set

This function sets the primary material of an item to the specified material. It returns true if this succeeds.

SETMATERIAL

boolean setmaterial(item item, text material)

Parameter	Variable Type	Parameter Help
item	item	the item whose primary material you want to set
material	text	the name of the material that you want to set

This function sets the primary material of an item to the specified material. It returns true if this succeeds.

SETMORPHTIMER

boolean setmorphtimer(item item, timespan timer)

Parameter	Variable Type	Parameter Help
item	item	the item who's morph timer you want to set
timer	timespan	the amount of time from now you want the morph timer to expire in

This function allows you to set the morph timer on an item, overwriting whatever it currently is and setting it if it doesn't have one. What happens depends on the prototype. If an item is not set to morph normally, this can still make it morph but most likely morph to nothing. Returns false if anything went wrong like passed a null item.

SETMORPHTIMER

boolean setmorphtimer(item item, number timer)

Parameter	Variable Type	Parameter Help
item	item	the item who's morph timer you want to set
timer	number	a number of seconds from now you want the morph timer to expire in

SETOPEN

boolean setopen(item item, boolean locked, boolean echo)

Parameter	Variable Type	Parameter Help
item	item	the item to be opened or closed
locked	boolean	if true, set to open, otherwise set to closed
echo	boolean	whether to echo the change in state

Changes an openable item from open to closed or the reverse. True if the change was successfully applied. Respects game rules about whether something can be opened.

SETQUALITY

boolean setquality(item item, number quality)

Parameter	Variable Type	Parameter Help
item	item	the item whose quality you wish to set
quality	number	the quality of the item. 0 = terribly, 11 = legendary

This function sets the quality of an item to whatever quality you specify.

SETQUALITY

boolean setquality(item item, text quality)

Parameter	Variable Type	Parameter Help
item	item	the item whose quality you wish to set
quality	text	the quality of the item. valid qualities are terrible, extremely bad, bad, poor, substandard, standard, good, very good, great, excellent, heroic, legendary.

This function sets the quality of an item to whatever quality you specify.

SPLITCOMMODITY

item splitcommodity(item item, number weight)

Parameter	Variable Type	Parameter Help
item	item	the item to take the weight from
weight	number	the weight of the material to split off in base units for this mud. see mud owner for configuration info

This function takes weight from one commodity pile and creates a new commodity pile item with the taken weight, which it then returns. It does not put the item anywhere, so you must then insert it somewhere like in a room or a character's inventory. If the quantity is the whole weight of the original item or larger, it will just return the original item and no new item will be created.

SPLITCOMMODITY

item splitcommodity(item item, text weight)

Parameter	Variable Type	Parameter Help
item	item	the item to take the weight from
weight	text	the weight of the material to split off, e.g. 120kg, 15lb 3oz, etc

TAKE

item take(item item)

Parameter	Variable Type	Parameter Help
item	item	the item to take

Takes an item from its inventory or container. Returns the item.

TAKE

item take(item item, number quantity)

Parameter	Variable Type	Parameter Help
item	item	the item to take
quantity	number	the quantity to take. use 0 for all

Takes an item from its inventory or container. Returns the new item, which may be the same as the original item if the quantity is equal to the existing quantity.

TAKECOMMODITY

boolean takecommodity(item item, number weight)

Parameter	Variable Type	Parameter Help
item	item	the item to take the weight from
weight	number	the weight of the material to take in base units for this mud. see mud owner for configuration info

This function takes a certain weight off of a commodity pile. If the weight is equal to or higher than the weight of the commodity pile, it deletes the pile. Returns true if it succeeded at taking the weight.

TAKECOMMODITY

boolean takecommodity(item item, text weight)

Parameter	Variable Type	Parameter Help
item	item	the item to take the weight from
weight	text	the weight of the material to take, e.g. 120kg, 15lb 3oz, etc

TAKEDELETE

item takedelete(item item)

Parameter	Variable Type	Parameter Help
item	item	the item to take

Takes an item from its inventory or container and deletes it. Returns null.

TAKEDELETE

item takedelete(item item, number quantity)

Parameter	Variable Type	Parameter Help
item	item	the item to take
quantity	number	the quantity to take. use 0 for all

Takes an item from its inventory or container. Deletes the item and returns null.

Logical

IN

boolean in(text target, text item1, text item2)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4, text item5)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare
item5	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4, text item5, text item6)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare
item5	text	an item to compare
item6	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4, text item5, text item6, text item7)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare
item5	text	an item to compare
item6	text	an item to compare
item7	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4, text item5, text item6, text item7, text item8)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare
item5	text	an item to compare
item6	text	an item to compare
item7	text	an item to compare
item8	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4, text item5, text item6, text item7, text item8, text item9)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare
item5	text	an item to compare
item6	text	an item to compare
item7	text	an item to compare
item8	text	an item to compare
item9	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4, text item5, text item6, text item7, text item8, text item9, text item10)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare
item5	text	an item to compare
item6	text	an item to compare
item7	text	an item to compare
item8	text	an item to compare
item9	text	an item to compare
item10	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

IN

boolean in(text target, text item1, text item2, text item3, text item4, text item5, text item6, text item7, text item8, text item9, text item10, text item11)

Parameter	Variable Type	Parameter Help
target	text	the item you want to check is equal to any of the other supplied items
item1	text	an item to compare
item2	text	an item to compare
item3	text	an item to compare
item4	text	an item to compare
item5	text	an item to compare
item6	text	an item to compare
item7	text	an item to compare
item8	text	an item to compare
item9	text	an item to compare
item10	text	an item to compare
item11	text	an item to compare

This function determines whether the first supplied argument is 'in' the list of other arguments. It will return true if any of the other supplied text items match the first.

NOT

boolean not(boolean item)

Parameter	Variable Type	Parameter Help
item	boolean	the boolean you want to change

This function takes a boolean and transforms it into the opposite value - e.g. True becomes False, False becomes True.

Lookup

TOACCENT

accent toaccent(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOACCENT

accent toaccent(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOAPPOINTMENT

appointment toappointment(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOAPPOINTMENT

appointment toappointment(clan clan, text name)

Parameter	Variable Type	Parameter Help
clan	clan	the clan in which you want to search
name	text	the name to look up

Converts a name into the specified type, if one exists

TOAREA

area toarea(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOAREA

area toarea(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOBANK

bank tobank(number id)

Parameter	Variable Type	Parameter Help
id	number	the id of the bank

Returns the bank referenced by the ID, or null if not found

TOBANK

bank tobank(text name)

Parameter	Variable Type	Parameter Help
name	text	the name of the bank

Returns the bank referenced by the name, or null if not found

TOBANKACCOUNT

bankaccount tobankaccount(number id)

Parameter	Variable Type	Parameter Help
id	number	the id of the bank account

Returns the bank account referenced by the ID, or null if not found

TOBANKACCOUNT

bankaccount tobankaccount(text code)

Parameter	Variable Type	Parameter Help
code	text	the code of the bank account in the form bank:accn

Returns the bank account referenced by the code, or null if not found

TOBANKACCOUNT

bankaccount tobankaccount(bank bank, text code)

Parameter	Variable Type	Parameter Help
bank	bank	the home bank
code	text	the code of the bank account in the form bank:accn or just an accn for the bank

Returns the bank account referenced by the code, or null if not found

TOCHARACTER

character tocharacter(number id)

Parameter	Variable Type	Parameter Help
id	number	the id of the character to retrieve or load

Retrieves or loads a character by their ID. Does not add them to the gameworld if it does load them. Can return null if no character with that ID is found.

TOCLAN

clan toclan(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOCLAN

clan toclan(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOCULTURE

culture toculture(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOCULTURE

culture toculture(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TODRUG

drug todrug(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TODRUG

drug todrug(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOETHNICITY

ethnicity toethnicity(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOETHNICITY

ethnicity toethnicity(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOGENDER

gender togender(text gender)

Parameter	Variable Type	Parameter Help
gender	text	the textual representation of the gender you want to load.

This function takes some text and returns a gender based on the text. The valid genders are male, female, neuter, non-binary and indeterminate.

TOKNOWLEDGE

knowledge toknowledge(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOKNOWLEDGE

knowledge toknowledge(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOLANGUAGE

language tolanguage(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOLANGUAGE

language tolanguage(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOLEGALAUTHORITY

legalauthority tolegalauthority(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOLEGALAUTHORITY

legalauthority tolegalauthority(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOLOCATION

location tolocation(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOLOCATION

location tolocation(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOMERIT

merit tomerit(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOMERIT

merit tomerit(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOOVERLAYPACKAGE

overlaypackage tooverlaypackage(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOOVERLAYPACKAGE

overlaypackage tooverlaypackage(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOOVERLAYPACKAGE

overlaypackage tooverlaypackage(number id, number revision)

Parameter	Variable Type	Parameter Help
id	number	the id to look up
revision	number	the revision number to look up

Converts an ID number into the specified type, if one exists

TOOVERLAYPACKAGE

overlaypackage tooverlaypackage(text name, number revision)

Parameter	Variable Type	Parameter Help
name	text	the name to look up
revision	number	the revision number to look up

Converts a name into the specified type, if one exists

TOPAYGRADE

paygrade topaygrade(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOPAYGRADE

paygrade topaygrade(clan clan, text name)

Parameter	Variable Type	Parameter Help
clan	clan	the clan in which you want to search
name	text	the name to look up

Converts a name into the specified type, if one exists

TORACE

race torace(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TORACE

race torace(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TORANK

rank torank(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TORANK

rank torank(clan clan, text name)

Parameter	Variable Type	Parameter Help
clan	clan	the clan in which you want to search
name	text	the name to look up

Converts a name and clan into the specified type, if one exists

TORANK

rank torank(clan clan, text rank #)

Parameter	Variable Type	Parameter Help
clan	clan	the clan in which you want to search
rank #	text	the rank number of the rank

Converts a rank number and clan into the specified type, if one exists

TOROLE

role torole(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOROLE

role torole(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOSCRIPT

script toscript(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOSCRIPT

script toscript(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOSHARD

shard toshard(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOSHARD

shard toshard(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOTERRAIN

terrain toterrain(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOTERRAIN

terrain toterrain(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOTRAIT

trait totrait(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOTRAIT

trait totrait(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOWRITING

writing towriting(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOWRITING

writing towriting(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

TOZONE

zone tozone(number id)

Parameter	Variable Type	Parameter Help
id	number	the id to look up

Converts an ID number into the specified type, if one exists

TOZONE

zone tozone(text name)

Parameter	Variable Type	Parameter Help
name	text	the name to look up

Converts a name into the specified type, if one exists

Manipulation

ATTACH

boolean attach(item attachable, item attachto)

Parameter	Variable Type	Parameter Help
attachable	item	the item to be attached
attachto	item	the item the first thing it to be attached to

Causes an item to become attached to another item. Returns true if it succeeded.

CANGET

boolean canget(character who, item thing)

Parameter	Variable Type	Parameter Help
who	character	the character doing the getting
thing	item	the thing being gotten

This function tells you if a player could pick up an item into hands/inventory. Returns true if so. Respects all normal inventory rules.

CANGET

boolean canget(character who, item thing, number quantity)

Parameter	Variable Type	Parameter Help
who	character	the character doing the getting
thing	item	the thing being gotten
quantity	number	the number of things being gotten, or 0 for the full stack

This function tells you if a player could pick up a specified quantity of item into hands/inventory. Returns true if so. Respects all normal inventory rules.

CANGET

boolean canget(character who, item thing, item container)

Parameter	Variable Type	Parameter Help
who	character	the character doing the getting
thing	item	the thing being gotten
container	item	the container to get it from

This function tells you if a player could pick up an item into hands/inventory from a container. Returns true if so. Respects all normal inventory rules.

CANGET

boolean canget(character who, item thing, item container, number quantity)

Parameter	Variable Type	Parameter Help
who	character	the character doing the getting
thing	item	the thing being gotten
container	item	the container to get it from
quantity	number	the number of things being gotten, or 0 for the full stack

This function tells you if a player could pick up a specified quantity of an item into hands/inventory from a container. Returns true if so. Respects all normal inventory rules.

DETATCH

boolean detatch(item attachable, item belt)

Parameter	Variable Type	Parameter Help
attachable	item	the item to detach from the belt
belt	item	the belt the item is attached to

Detaches an item from a belt. Returns true if successful.

DROP

boolean drop(character character, item item, text emote)

Parameter	Variable Type	Parameter Help
character	character	the character dropping the item
item	item	the item to be dropped
emote	text	an optional emote performed while dropping

Drops an item from a character, optionally with an emote.

FORCEPUT

boolean forceput(item thing, item container)

Parameter	Variable Type	Parameter Help
thing	item	the thing being put into something else
container	item	the container the thing is being put into

This function puts an item into a container (ignoring normal inventory rules), does not echo anything, and returns true if successful.

GET

boolean get(character who, item thing, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten
emote	text	an optional emote to accompany the action

Has a character pick up an item. Returns true if successful.

GET

boolean get(character who, item thing, number quantity, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten
quantity	number	the number of items to get, or 0 for the whole stack
emote	text	an optional emote to accompany the action

Has a character pick up an item. Returns true if successful.

GET

boolean get(character who, item thing, item container, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten
container	item	the container the item is being taken from
emote	text	an optional emote to accompany the action

Has a character get an item from a container. Returns true if successful.

GET

boolean get(character who, item thing, item container, number quantity, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten
container	item	the container the item is being taken from
quantity	number	the number of items to get, or 0 for the whole stack
emote	text	an optional emote to accompany the action

Has a character get an item from a container. Returns true if successful.

PUT

boolean put(character who, item thing, item container, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character doing the putting
thing	item	the thing being put into something else
container	item	the container the thing is being put into
emote	text	the optional player emote to add to the standard echo

This function causes a player to put an item into a container using the ordinary inventory code. It echoes to all, and returns true if successful.

PUT

boolean put(item thing, item container)

Parameter	Variable Type	Parameter Help
thing	item	the thing being put into something else
container	item	the container the thing is being put into

This function puts an item into a container (respecting normal inventory rules), does not echo anything, and returns true if successful.

PUT

boolean put(item item, location location)

Parameter	Variable Type	Parameter Help
item	item	the item you want to drop
location	location	the location you want to put the item in

This function puts an item in a room, using the GroundLevel (or closest layer to).

PUT

boolean put(item item, location location, text layer)

Parameter	Variable Type	Parameter Help
item	item	the item you want to drop
location	location	the location you want to put the item in
layer	text	the layer of the location that you want to put the item in

This function puts an item in a room in the specified layer. Possible values for layers are VeryDeepUnderwater, DeepUnderwater, Underwater, GroundLevel, OnRooftops, InTrees, HighInTrees, InAir, HighInAir. See function ROOMLAYERS for how to obtain the list of room layers for a location.

REMOVE

boolean remove(character who, item item, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character removing the item
item	item	the item to be removed
emote	text	an optional emote to accompany the action

Has a character remove a worn item. Returns true if successful.

SILENTDROP

boolean silentdrop(character character, item item)

Parameter	Variable Type	Parameter Help
character	character	the character dropping the item
item	item	the item to be dropped

Drops an item from a character with no associated emote.

SILENTGET

boolean silentget(character who, item thing)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten

Has a character pick up an item with no associated emote.

SILENTGET

boolean silentget(character who, item thing, number quantity)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten
quantity	number	the number of items to get, or 0 for the whole stack

Has a character pick up an item with no associated emote.

SILENTGET

boolean silentget(character who, item thing, item container)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten
container	item	the container the item is being taken from

Has a character get an item from a container with no associated emote.

SILENTGET

boolean silentget(character who, item thing, item container, number quantity)

Parameter	Variable Type	Parameter Help
who	character	the character getting the item
thing	item	the item being gotten
container	item	the container the item is being taken from
quantity	number	the number of items to get, or 0 for the whole stack

Has a character get an item from a container with no associated emote.

SILENTPUT

boolean silentput(character who, item thing, item container)

Parameter	Variable Type	Parameter Help
who	character	the character doing the putting
thing	item	the thing being put into something else
container	item	the container the thing is being put into

This function causes a player to put an item into a container using the ordinary inventory code. It does not echo to anyone, and returns true if successful.

SILENTREMOVE

boolean silentremove(character who, item item)

Parameter	Variable Type	Parameter Help
who	character	the character removing the item
item	item	the item to be removed

Has a character remove a worn item with no associated emote.

SILENTUNWIELD

boolean silentunwield(character who, item item)

Parameter	Variable Type	Parameter Help
who	character	the character unwielding the item
item	item	the item to be unwielded

Has a character unwield an item with no associated emote.

SILENTWEAR

boolean silentwear(character who, item item)

Parameter	Variable Type	Parameter Help
who	character	the character wearing the item
item	item	the item to be worn

Has a character wear an item with no associated emote.

SILENTWIELD

boolean silentwield(character who, item item)

Parameter	Variable Type	Parameter Help
who	character	the character wielding the item
item	item	the item to be wielded

Has a character wield an item with no associated emote.

UNWIELD

boolean unwield(character who, item item, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character unwielding the item
item	item	the item to be unwielded
emote	text	an optional emote to accompany the action

Has a character unwield an item. Returns true if successful.

WEAR

boolean wear(character who, item item, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character wearing the item
item	item	the item to be worn
emote	text	an optional emote to accompany the action

Has a character wear an item. Returns true if successful.

WIELD

boolean wield(character who, item item, text emote)

Parameter	Variable Type	Parameter Help
who	character	the character wielding the item
item	item	the item to be wielded
emote	text	an optional emote to accompany the action

Has a character wield an item. Returns true if successful.

Markets

BEGININFLUENCE

number begininfluence(number market, number template, muddatetime start, muddatetime end)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	number	the id of the market influence template you want to use
start	muddatetime	the mud datetime of when the influence should start
end	muddatetime	the mud datetime of when the influence should end

Creates a market influence based on the supplied template. Returns the ID of the influence or 0 if there is any error.

BEGININFLUENCE

number begininfluence(number market, number template, muddatetime start, timespan duration)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	number	the id of the market influence template you want to use
start	muddatetime	the mud datetime of when the influence should start
duration	timespan	a duration for the influence to last

Creates a market influence based on the supplied template. Returns the ID of the influence or 0 if there is any error.

BEGININFLUENCE

number begininfluence(number market, number template, muddatetime start)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	number	the id of the market influence template you want to use
start	muddatetime	the mud datetime of when the influence should start

Creates a market influence based on the supplied template. This influence is indefinite until revoked. Returns the ID of the influence or 0 if there is any error.

BEGININFLUENCE

number begininfluence(number market, number template)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	number	the id of the market influence template you want to use

Creates a market influence based on the supplied template. This influence begins immediately and is indefinite until revoked. Returns the ID of the influence or 0 if there is any error.

BEGININFLUENCE

number begininfluence(number market, text template, muddatetime start, muddatetime end)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	text	the name of the market influence template you want to use
start	muddatetime	the mud datetime of when the influence should start
end	muddatetime	the mud datetime of when the influence should end

Creates a market influence based on the supplied template. Returns the ID of the influence or 0 if there is any error.

BEGININFLUENCE

number begininfluence(number market, text template, muddatetime start, timespan duration)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	text	the name of the market influence template you want to use
start	muddatetime	the mud datetime of when the influence should start
duration	timespan	a duration for the influence to last

Creates a market influence based on the supplied template. Returns the ID of the influence or 0 if there is any error.

BEGININFLUENCE

number begininfluence(number market, text template, muddatetime start)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	text	the name of the market influence template you want to use
start	muddatetime	the mud datetime of when the influence should start

Creates a market influence based on the supplied template. This influence is indefinite until revoked. Returns the ID of the influence or 0 if there is any error.

BEGININFLUENCE

number begininfluence(number market, text template)

Parameter	Variable Type	Parameter Help
market	number	the id of the market you want to begin an influence in
template	text	the name of the market influence template you want to use

Creates a market influence based on the supplied template. This influence begins immediately and is indefinite until revoked. Returns the ID of the influence or 0 if there is any error.

ENDINFLUENCE

boolean endinfluence(number influence)

Parameter	Variable Type	Parameter Help
influence	number	the id of the influence to end

Ends the specified market influence, if it exists

NPCs

LOADNPC

character loadnpc(number id, location location)

Parameter	Variable Type	Parameter Help
id	number	the id of the npc template to load
location	location	the location into which they will be loaded

This function loads an NPC from a specified template into a location.

LOADNPC

character loadnpc(number id, location location, text layer)

Parameter	Variable Type	Parameter Help
id	number	the id of the npc template to load
location	location	the location into which they will be loaded
layer	text	the layer into which to load the npc

This function loads an NPC from a specified template into a location.

Null Handling

IFNULL

collectionitem ifnull(collectionitem item, collectionitem fallback)

Parameter	Variable Type	Parameter Help
item	collectionitem	the item that you want to test to see if it is null
fallback	collectionitem	the item you want to return if the first item is null

This function accepts an item of a broad variety of types, and tests to see if it is currently null. If it is not null, it returns the item you supplied in the first parameter. If it is null, it returns the item specified in the second parameter.

ISNULL

boolean isnull(collectionitem item)

Parameter	Variable Type	Parameter Help
item	collectionitem	the item that you want to test to see if it is null

This function accepts an item of a broad variety of types, and tests to see if it is currently null.

NULL

anything null(text type)

Parameter	Variable Type	Parameter Help
type	text	a text literal specifying the type of null variable.

Returns a null variable of the type specified.

Numbers

CEILING

number ceiling(number number)

Parameter	Variable Type	Parameter Help
number	number	the number to find the ceiling of

Rounds a function up to the next highest integral number

FLOOR

number floor(number number)

Parameter	Variable Type	Parameter Help
number	number	the number to find the floor of

Rounds a function down to the next lowest integral number

ROUND

number round(number number)

Parameter	Variable Type	Parameter Help
number	number	the number to round

Rounds a function to zero decimal places

ROUND

number round(number number, number decimals)

Parameter	Variable Type	Parameter Help
number	number	the number to round
decimals	number	the number of decimal places

Rounds a function to the specified amount of decimal places

OpenAI

GPTREQUEST

boolean gptrequest(text thread, text message, character user, number maximumhistory, text function)

Parameter	Variable Type	Parameter Help
thread	text	the gptthread to call
message	text	the message to send to gpt
user	character	the user whose history is being invoked
maximumhistory	number	the maximum history entries
function	text	a prog to call with the results of this request

This function will schedule a call to GPT including a thread history, and call the specified prog with the outcome. Returns true if successfully queued.

GPTREQUEST

boolean gptrequest(number thread, text message, character user, number maximumhistory, text function)

Parameter	Variable Type	Parameter Help
thread	number	the gptthread to call
message	text	the message to send to gpt
user	character	the user whose history is being invoked
maximumhistory	number	the maximum history entries
function	text	a prog to call with the results of this request

This function will schedule a call to GPT including a thread history, and call the specified prog with the outcome. Returns true if successfully queued.

Outfits

ADDITEMTOOUTFIT

outfititem additemtooutfit(outfit outfit, item item)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit to add the item to
item	item	the item to add to the outfit

This function adds an item to an outfit through a prog. It is the equivalent of a player using the OUTFIT SET ADD command. Returns the outfititem that is added, or null if there is an error.

ADDITEMTOOUTFIT

outfititem additemtooutfit(outfit outfit, item item, item container)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit to add the item to
item	item	the item to add to the outfit
container	item	the preferred container for the item

This function adds an item to an outfit through a prog. It is the equivalent of a player using the OUTFIT SET ADD command. Returns the outfititem that is added, or null if there is an error.

ADDITEMTOOUTFIT

outfititem additemtooutfit(outfit outfit, item item, item container, text profile)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit to add the item to
item	item	the item to add to the outfit
container	item	the preferred container for the item
profile	text	the preferred wear profile for the item

This function adds an item to an outfit through a prog. It is the equivalent of a player using the OUTFIT SET ADD command. Returns the outfititem that is added, or null if there is an error.

ADDITEMTOOUTFIT

outfititem additemtooutfit(outfit outfit, item item, text profile)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit to add the item to
item	item	the item to add to the outfit
profile	text	the preferred wear profile for the item

This function adds an item to an outfit through a prog. It is the equivalent of a player using the OUTFIT SET ADD command. Returns the outfititem that is added, or null if there is an error.

CLONEOUTFIT

outfit cloneoutfit(outfit outfit, character character, text name)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit that you want to clone
character	character	the character who should get the outfit
name	text	the name of the new cloned outfit

This function takes an existing outfit and clones it to a new one. This is one way that you can copy an outfit from one player to another for example. Returns the outfit that it creates. Can return null if the name is not valid.

NEWOUTFIT

outfit newoutfit(character character, text name)

Parameter	Variable Type	Parameter Help
character	character	the character who owns the new outfit
name	text	the name of the outfit

Creates a new blank outfit for a character. Returns the outfit it creates. Can return null if the name is not valid.

REMOVEOUTFIT

boolean removeoutfit(character character, outfit outfit)

Parameter	Variable Type	Parameter Help
character	character	the character to remove the outfit from
outfit	outfit	the outfit to remove

This function removes all items in an outfit from a character, as if the character had used the OUTFIT REMOVE command.

REMOVEOUTFIT

boolean removeoutfit(character character, outfit outfit, item container)

Parameter	Variable Type	Parameter Help
character	character	the character to remove the outfit from
outfit	outfit	the outfit to remove
container	item	the container to put removed items into

This function removes all items in an outfit from a character, as if the character had used the OUTFIT REMOVE command.

REMOVEOUTFITFORCE

boolean removeoutfitforce(character character, outfit outfit)

Parameter	Variable Type	Parameter Help
character	character	the character to remove the outfit from
outfit	outfit	the outfit to remove

This function removes all items in an outfit from a character, as if the character had used the OUTFIT REMOVE command. This version of the command ignores the inventory and container rules, so it guarantees that the items will come off and they will go in the container.

REMOVEOUTFITFORCE

boolean removeoutfitforce(character character, outfit outfit, item container)

Parameter	Variable Type	Parameter Help
character	character	the character to remove the outfit from
outfit	outfit	the outfit to remove
container	item	the container to put removed items into

RENAMEOUTFIT

boolean renameoutfit(outfit outfit, text name)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit to rename
name	text	the new name for the outfit

This function renames an outfit. Returns true if the name was changed and was valid.

SETOUTFITDESCRIPTION

outfit setoutfitdescription(outfit outfit, text description)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit to redescribe
description	text	the new description for the outfit

This function redescribes an outfit. Returns the outfit parameter.

SWAPOUTFITITEMS

boolean swapoutfititems(outfit outfit, outfititem item1, outfititem item2)

Parameter	Variable Type	Parameter Help
outfit	outfit	the outfit whose items you want to swap the order of
item1	outfititem	the first item
item2	outfititem	the second item

Swaps the order of two outfit items in an outfit, so they are worn or removed in a different order. Returns true if the items were swapped.

WEAROUTFIT

boolean wearoutfit(character character, outfit outfit)

Parameter	Variable Type	Parameter Help
character	character	the character to wear the outfit
outfit	outfit	the outfit to be worn

Has a character wear an outfit as if they'd type OUTFIT WEAR. Returns true if it succeeds. Can fail if items are missing.

WEAROUTFITFORCE

boolean wearoutfitforce(character character, outfit outfit)

Parameter	Variable Type	Parameter Help
character	character	the character to wear the outfit
outfit	outfit	the outfit to be worn

Has a character wear an outfit as if they'd type OUTFIT WEAR. Returns true if it succeeds. Ignores missing items.

Perception

CLEARDESC

boolean cleardesc(perceivable perceivable)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered

Clears all custom full Desc overrides set by progs from this perceivable

CLEARDESC

boolean cleardesc(perceivable perceivable, text tag)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect set by the original overridedesc call

Clears a custom full Desc override with the specified tag set by progs from this perceivable

CLEARSDESC

boolean clearsdesc(perceivable perceivable)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered

Clears all custom SDesc overrides set by progs from this perceivable

CLEARSDESC

boolean clearsdesc(perceivable perceivable, text tag)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect set by the original overridesdesc call

Clears a custom SDesc override with the specified tag set by progs from this perceivable

GETLIGHT

number getlight(perceiver perceiver)

Parameter	Variable Type	Parameter Help
perceiver	perceiver	the perceiver for whom you would like to know the current light levels

This function returns the current light level that a specified perceiver is exposed to. For characters, this would be the light levels in their room. For items, it is the maximum light levels in any room they are part of.

HOWSEEN

text howseen(perceivable thing, perceiver perceiver, boolean proper, boolean coloured)

Parameter	Variable Type	Parameter Help
thing	perceivable	the thing for which you want a description
perceiver	perceiver	the perceiver through whose perception you want to filter the description
proper	boolean	whether or not to change the output to proper case
coloured	boolean	whether or not to include colour in the description

This function gets the short description of something as if it was seen in the engine by the specified perceiver.

HOWSEENFULL

text howseenfull(perceivable thing, perceiver perceiver, boolean proper, boolean coloured)

Parameter	Variable Type	Parameter Help
thing	perceivable	the thing for which you want a description
perceiver	perceiver	the perceiver through whose perception you want to filter the description
proper	boolean	whether or not to change the output to proper case
coloured	boolean	whether or not to include colour in the description

This function gets the full (i.e. look) description of something as if it was seen in the engine by the specified perceiver.

HOWSEENLONG

text howseenlong(perceivable thing, perceiver perceiver, boolean proper, boolean coloured)

Parameter	Variable Type	Parameter Help
thing	perceivable	the thing for which you want a description
perceiver	perceiver	the perceiver through whose perception you want to filter the description
proper	boolean	whether or not to change the output to proper case
coloured	boolean	whether or not to include colour in the description

This function gets the long (i.e. room) description of something as if it was seen in the engine by the specified perceiver.

HOWSEENSDESC

text howseensdesc(perceivable thing, perceiver perceiver, boolean proper, boolean coloured)

Parameter	Variable Type	Parameter Help
thing	perceivable	the thing for which you want a description
perceiver	perceiver	the perceiver through whose perception you want to filter the description
proper	boolean	whether or not to change the output to proper case
coloured	boolean	whether or not to include colour in the description

This function gets the short description of something as if it was seen in the engine by the specified perceiver.

OVERRIDEDESC

boolean overridedesc(perceivable perceivable, text tag, text description)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups

This function adds an override to the target's full description, which applies to all perceivers. Lasts until the ClearDesc function is used on this perceivable.

OVERRIDEDESC

boolean overridedesc(perceivable perceivable, text tag, text description, timespan time)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever

This function adds an override to the target's full description, which applies to all perceivers. Lasts until the specified duration, or until ClearDesc called if null.

OVERRIDEDESC

boolean overridedesc(perceivable perceivable, text tag, text description, timespan time, perceiver perceiver)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever
perceiver	perceiver	if specified, the description is only overriden for this perceiver. if null, applies to everyone

This function adds an override to the target's full description, which applies to the specified perceiver only (or all perceivers if null). Lasts until the specified duration, or until ClearDesc called if null.

OVERRIDEDESC

boolean overridedesc(perceivable perceivable, text tag, text description, timespan time, perceiver perceiver, text prog)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever
perceiver	perceiver	if specified, the description is only overriden for this perceiver. if null, applies to everyone
prog	text	a prog taking a perceivable and perceiver input (or just a single perceivable) and returning boolean that controls whether this applies

This function adds an override to the target's full description, which applies to the specified perceiver only (or all perceivers if null) and only when the filter prog applies. Lasts until the specified duration, or until ClearDesc called if null.

OVERRIDEDESC

boolean overridedesc(perceivable perceivable, text tag, text description, timespan time, perceiver perceiver, number prog)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever
perceiver	perceiver	if specified, the description is only overriden for this perceiver. if null, applies to everyone
prog	number	a prog taking a perceivable and perceiver input (or just a single perceivable) and returning boolean that controls whether this applies

OVERRIDESDESC

boolean overridesdesc(perceivable perceivable, text tag, text description)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups

This function adds an override to the target's short description, which applies to all perceivers. Lasts until the ClearSDesc function is used on this perceivable.

OVERRIDESDESC

boolean overridesdesc(perceivable perceivable, text tag, text description, timespan time)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever

This function adds an override to the target's short description, which applies to all perceivers. Lasts until the specified duration, or until ClearSDesc called if null.

OVERRIDESDESC

boolean overridesdesc(perceivable perceivable, text tag, text description, timespan time, perceiver perceiver)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever
perceiver	perceiver	if specified, the description is only overriden for this perceiver. if null, applies to everyone

This function adds an override to the target's short description, which applies to the specified perceiver only (or all perceivers if null). Lasts until the specified duration, or until ClearSDesc called if null.

OVERRIDESDESC

boolean overridesdesc(perceivable perceivable, text tag, text description, timespan time, perceiver perceiver, text prog)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever
perceiver	perceiver	if specified, the description is only overriden for this perceiver. if null, applies to everyone
prog	text	a prog taking a perceivable and perceiver input (or just a single perceivable) and returning boolean that controls whether this applies

This function adds an override to the target's short description, which applies to the specified perceiver only (or all perceivers if null) and only when the filter prog applies. Lasts until the specified duration, or until ClearSDesc called if null.

OVERRIDESDESC

boolean overridesdesc(perceivable perceivable, text tag, text description, timespan time, perceiver perceiver, number prog)

Parameter	Variable Type	Parameter Help
perceivable	perceivable	the perceivable who's description is being altered
tag	text	a short bit of text identifying this specific effect and allowing you to remove it later
description	text	the overriden description for this perceivable. can include description markups
time	timespan	the time that this effect will apply for. if null, applies forever
perceiver	perceiver	if specified, the description is only overriden for this perceiver. if null, applies to everyone
prog	number	a prog taking a perceivable and perceiver input (or just a single perceivable) and returning boolean that controls whether this applies

GETREGISTER

collectionitem getregister(collectionitem thing, text variable)

Parameter	Variable Type	Parameter Help
thing	collectionitem	the thing whose register variables you want to retrieve
variable	text	the register variable that you want to get. must be a string literal.

This function retrieves the 'register variable' specified for a thing that you specify. Which register variables are available are defined on a per-type basis. See the REGISTER command in game for more information. The return type is as it appears in the register command, not actually a CollectionItem.

Rooms

APPROVEOVERLAY

boolean approveoverlay(overlaypackage package, character builder)

Parameter	Variable Type	Parameter Help
package	overlaypackage	the package that you want to approve
builder	character	the builder who is approving the package, or null for 'system'

Approves the specified overlay package as ready for use. Returns true if successful

APPROVEOVERLAY

boolean approveoverlay(overlaypackage package, character builder, text comment)

Parameter	Variable Type	Parameter Help
package	overlaypackage	the package that you want to approve
builder	character	the builder who is approving the package, or null for 'system'
comment	text	a comment for the builder approval log

Approves the specified overlay package as ready for use. Returns true if successful

CREATECELL

location createcell(overlaypackage package, zone zone)

Parameter	Variable Type	Parameter Help
package	overlaypackage	the package that you want to approve
zone	zone	the zone to create the room in

Creates a new blank room in the specified package and zone

CREATECELL

location createcell(overlaypackage package, zone zone, location template)

Parameter	Variable Type	Parameter Help
package	overlaypackage	the package that you want to approve
zone	zone	the zone to create the room in
template	location	a room to copy as the basic template of the new room

Creates a new room based on the template room in the specified package and zone

CREATEOVERLAY

overlaypackage createoverlay(character builder, text name)

Parameter	Variable Type	Parameter Help
builder	character	the builder who is creating the package
name	text	the name of the package you want to create. must be unique.

Creates a new cell overlay package with the specified name and builder, as if you had done CELL PACKAGE NEW. Can return null if the name is already taken so be sure to check for that.

CREATEROOM

location createroom(overlaypackage package, zone zone)

Parameter	Variable Type	Parameter Help
package	overlaypackage	the package that you want to approve
zone	zone	the zone to create the room in

Creates a new blank room in the specified package and zone. Alias for CreateCell.

CREATEROOM

location createroom(overlaypackage package, zone zone, location template)

Parameter	Variable Type	Parameter Help
package	overlaypackage	the package that you want to approve
zone	zone	the zone to create the room in
template	location	a room to copy as the basic template of the new room

Creates a new room based on the template room in the specified package and zone. Alias for CreateCell.

DESCRIBECELL

boolean describecell(location room, overlaypackage package, text description)

Parameter	Variable Type	Parameter Help
room	location	the room you want to describe
package	overlaypackage	the package that the description change belongs to
description	text	the description that you are setting for that room

Sets the description of a room as if you had done CELL SET DESCRIPTION.

DESCRIBEROOM

boolean describeroom(location room, overlaypackage package, text description)

Parameter	Variable Type	Parameter Help
room	location	the room you want to describe
package	overlaypackage	the package that the description change belongs to
description	text	the description that you are setting for that room

Sets the description of a room as if you had done CELL SET DESCRIPTION. Alias for DescribeCell.

EXITSFOROVERLAY

exit collection exitsforoverlay(location room, overlaypackage package)

Parameter	Variable Type	Parameter Help
room	location	the room you want to get exits for
package	overlaypackage	the package that you want exits for. if null, uses currently approved package.

Returns a collection of the exits for a room, in the specified package.

ISSWIMLAYER

boolean isswimlayer(location location, text layer)

Parameter	Variable Type	Parameter Help
location	location	the location whose layers you want to check for being a swimming layer
layer	text	the room layer that you want to test for being a swimming layer

This function allows you to test whether a particular room layer in a location is currently a swimming layer. Possible values for layers are VeryDeepUnderwater, DeepUnderwater, Underwater, GroundLevel, OnRooftops, InTrees, HighInTrees, InAir, HighInAir. See function ROOMLAYERS for how to obtain the list of room layers for a location.

ISUNDERWATER

boolean isunderwater(location location, text layer)

Parameter	Variable Type	Parameter Help
location	location	the location whose layers you want to check for being underwater
layer	text	the room layer that you want to test for being underwater

This function allows you to test whether a particular room layer in a location is currently underwater. Possible values for layers are VeryDeepUnderwater, DeepUnderwater, Underwater, GroundLevel, OnRooftops, InTrees, HighInTrees, InAir, HighInAir. See function ROOMLAYERS for how to obtain the list of room layers for a location.

LAYERCHARACTERS

character collection layercharacters(location location, text layer)

Parameter	Variable Type	Parameter Help
location	location	the location whose characters you want to return
layer	text	the layer where you want characters from

This function returns the characters that are present at a specified layer in a room. See the ROOMLAYERS function for information on how to determine what layers are present.

LAYEREXITS

exit collection layerexits(location location, text layer)

Parameter	Variable Type	Parameter Help
location	location	the location whose exits you are interested in
layer	text	the layer whose exits you want

This function returns the exits that exist at a particular layer in a location you specify. See the ROOMLAYERS function for information on how to determine what layers are present.

LAYEREXITS

exit collection layerexits(location location, character character)

Parameter	Variable Type	Parameter Help
location	location	the location whose exits you are interested in
character	character	the character whose layer exits you want

This function returns the exits that exist at a particular layer in a location you specify. See the ROOMLAYERS function for information on how to determine what layers are present.

LAYEREXITS

exit collection layerexits(location location, item item)

Parameter	Variable Type	Parameter Help
location	location	the location whose exits you are interested in
item	item	the item whose layer exits you want

This function returns the exits that exist at a particular layer in a location you specify. See the ROOMLAYERS function for information on how to determine what layers are present.

LAYERITEMS

item collection layeritems(location location, text layer)

Parameter	Variable Type	Parameter Help
location	location	the location whose items you want to return
layer	text	the layer where you want items from

This function returns the items that are present at a specified layer in a room. See the ROOMLAYERS function for information on how to determine what layers are present.

NAMECELL

boolean namecell(location room, overlaypackage package, text name)

Parameter	Variable Type	Parameter Help
room	location	the room you want to name
package	overlaypackage	the package that the name change belongs to
name	text	the name that you are setting for that room

Sets the name of a room as if you had done CELL SET NAME.

NAMEROOM

boolean nameroom(location room, overlaypackage package, text name)

Parameter	Variable Type	Parameter Help
room	location	the room you want to name
package	overlaypackage	the package that the name change belongs to
name	text	the name that you are setting for that room

Sets the name of a room as if you had done CELL SET NAME. Alias for NameCell.

REVISEOVERLAY

overlaypackage reviseoverlay(overlaypackage package, character builder)

Parameter	Variable Type	Parameter Help
package	overlaypackage	the package that you want to revise
builder	character	the builder who is doing the revision

Creates a new revision for an overlay package.

ROOMLAYERS

text collection roomlayers(location location)

Parameter	Variable Type	Parameter Help
location	location	the location whose layers you want to determine

This function returns a collection of text values representing all the layers in the specified cell. Possible values for layers are VeryDeepUnderwater, DeepUnderwater, Underwater, GroundLevel, OnRooftops, InTrees, HighInTrees, InAir, HighInAir.

ROOMLAYERS

text collection roomlayers(location location, overlaypackage package)

Parameter	Variable Type	Parameter Help
location	location	the location whose layers you want to determine
package	overlaypackage	the package you want to use to evaluate what terrain type this location is

SETATMOSPHERE

boolean setatmosphere(location room, overlaypackage package, number gas)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
gas	number	the id number of the gas you want to set as the atmosphere here

Sets the atmosphere of a room as if you had done CELL SET ATMOSPHERE.

SETATMOSPHERE

boolean setatmosphere(location room, overlaypackage package, text gas)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
gas	text	the name of the gas you want to set as the atmosphere here

Sets the atmosphere of a room as if you had done CELL SET ATMOSPHERE.

SETATMOSPHERELIQUID

boolean setatmosphereliquid(location room, overlaypackage package, number liquid)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
liquid	number	the id number of the liquid you want to set as the atmosphere here

Sets the atmosphere of a room as if you had done CELL SET ATMOSPHERE.

SETATMOSPHERELIQUID

boolean setatmosphereliquid(location room, overlaypackage package, text liquid)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
liquid	text	the name of the liquid you want to set as the atmosphere here

Sets the atmosphere of a room as if you had done CELL SET ATMOSPHERE.

SETCELLADDEDLIGHT

boolean setcelladdedlight(location room, overlaypackage package, number light)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
light	number	the added light in lux

Sets the added light level of a room as if you had done CELL SET LIGHTLEVEL.

SETCELLLIGHTMULTIPLIER

boolean setcelllightmultiplier(location room, overlaypackage package, number multiplier)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
multiplier	number	a multiplier for natural light levels - 1.0 = full natural light, 0.0 = no natural light

Sets the light level multiplier of a room as if you had done CELL SET LIGHTMULTIPLIER.

SETHEARINGPROFILE

boolean sethearingprofile(location room, overlaypackage package, number profile)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
profile	number	the id number of the hearing profile to use

Sets the hearing profile of the room as if you had done CELL SET HEARING.

SETHEARINGPROFILE

boolean sethearingprofile(location room, overlaypackage package, text profile)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
profile	text	the name of the hearing profile to use

Sets the hearing profile of the room as if you had done CELL SET HEARING.

SETINDOORS

boolean setindoors(location room, overlaypackage package)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to

Sets the indoors-type of the room to 'Indoors', as if you had done CELL SET TYPE INDOORS.

SETINDOORSCLIMATEEXPOSED

boolean setindoorsclimateexposed(location room, overlaypackage package)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to

Sets the indoors-type of the room to 'Indoors But Climate Exposed', as if you had done CELL SET TYPE EXPOSED.

SETINDOORSNOLIGHT

boolean setindoorsnolight(location room, overlaypackage package)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to

Sets the indoors-type of the room to 'Indoors With No Light', as if you had done CELL SET TYPE CAVE.

SETINDOORSWITHWINDOWS

boolean setindoorswithwindows(location room, overlaypackage package)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to

Sets the indoors-type of the room to 'Indoors With Windows', as if you had done CELL SET TYPE WINDOWS.

SETLAYER

boolean setlayer(character character, text layer)

Parameter	Variable Type	Parameter Help
character	character	the character whose location you are setting
layer	text	the layer to change them to

This function changes the layer a character is currently at. Returns true if successful. See the ROOMLAYERS function for information on how to determine what layers are present.

SETLAYER

boolean setlayer(item item, text layer)

Parameter	Variable Type	Parameter Help
item	item	the item whose location you are setting
layer	text	the layer to change them to

This function changes the layer an item is currently at. Returns true if successful. See the ROOMLAYERS function for information on how to determine what layers are present.

SETOUTDOORS

boolean setoutdoors(location room, overlaypackage package)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to

Sets the indoors-type of the room to 'Outdoors', as if you had done CELL SET TYPE OUTDOORS.

SETTERRAIN

boolean setterrain(location room, overlaypackage package, terrain terrain)

Parameter	Variable Type	Parameter Help
room	location	the room you want to edit
package	overlaypackage	the package that the edit belongs to
terrain	terrain	the terrain to set

Sets the terrain type of a room as if you had done CELL SET TERRAIN.

SWAPOVERLAY

boolean swapoverlay(number overlay)

Parameter	Variable Type	Parameter Help
overlay	number	the id number of the overlay you want to swap

Swaps an approved overlay into the worldfile as if you had run the CELL SWAP command. Returns true if successful.

SWAPOVERLAY

boolean swapoverlay(text overlay)

Parameter	Variable Type	Parameter Help
overlay	text	the name of the overlay you want to swap

Swaps an approved overlay into the worldfile as if you had run the CELL SWAP command. Returns true if successful.

SWAPOVERLAY

boolean swapoverlay(number overlay, location room)

Parameter	Variable Type	Parameter Help
overlay	number	the id number of the overlay you want to swap
room	location	the room you want to swap this package in for only

Swaps an approved overlay for one room only into the worldfile as if you had run the CELL SWAP command. Returns true if successful. This use case is only recommended for advanced scenarios - in most cases you should swap the entire overlay in at once

SWAPOVERLAY

boolean swapoverlay(text overlay, location room)

Parameter	Variable Type	Parameter Help
overlay	text	the name of the overlay you want to swap
room	location	the room you want to swap this package in for only

SWAPOVERLAY

boolean swapoverlay(overlaypackage overlay)

Parameter	Variable Type	Parameter Help
overlay	overlaypackage	the overlay package that you want to swap

Swaps an approved overlay into the worldfile as if you had run the CELL SWAP command. Returns true if successful.

SWAPOVERLAY

boolean swapoverlay(overlaypackage overlay, location room)

Parameter	Variable Type	Parameter Help
overlay	overlaypackage	the overlay package that you want to swap
room	location	the room you want to swap this package in for only

ISTAGGED

boolean istagged(item thing, text tag)

Parameter	Variable Type	Parameter Help
thing	item	the thing whose tags you want to interrogate
tag	text	the name of the tag you want to test for

Returns whether or not the thing has or counts as the specified tag. For example, if you specify the tag 'Cutting Implement' and thing is tagged with the 'Knife' tag, and Knife is a Cutting Implement, then thing is a cutting implement.

ISTAGGED

boolean istagged(item thing, number tag)

Parameter	Variable Type	Parameter Help
thing	item	the thing whose tags you want to interrogate
tag	number	the id of the tag you want to test for

ISTAGGED

boolean istagged(location thing, text tag)

Parameter	Variable Type	Parameter Help
thing	location	the thing whose tags you want to interrogate
tag	text	the name of the tag you want to test for

ISTAGGED

boolean istagged(location thing, number tag)

Parameter	Variable Type	Parameter Help
thing	location	the thing whose tags you want to interrogate
tag	number	the id of the tag you want to test for

ISTAGGED

boolean istagged(terrain thing, text tag)

Parameter	Variable Type	Parameter Help
thing	terrain	the thing whose tags you want to interrogate
tag	text	the name of the tag you want to test for

ISTAGGED

boolean istagged(terrain thing, number tag)

Parameter	Variable Type	Parameter Help
thing	terrain	the thing whose tags you want to interrogate
tag	number	the id of the tag you want to test for

Text

BWTEXTTABLE

text bwtexttable(text collection headers, text collection values, number width)

Parameter	Variable Type	Parameter Help
headers	text collection	a collection of text values to use as the headers of the table
values	text collection	a collection of text values, each of which is a row, with columns separated by the tab (\t) character
width	number	the width of the table

This function displays a plain 'text table', essentially an ASCII representation of a table. The number of columns in the header MUST match the number of columns in each row.

BWTEXTTABLE

text bwtexttable(text headers, text collection values, number width)

Parameter	Variable Type	Parameter Help
headers	text	text with values separated by tab characters (\t) to use as the headers of the table
values	text collection	a collection of text values, each of which is a row, with columns separated by the tab (\t) character
width	number	the width of the table

This function displays a plain 'text table', essentially an ASCII representation of a table. The number of columns in the header MUST match the number of columns in each row.

CONCAT

text concat(text collection collection, text joiner)

Parameter	Variable Type	Parameter Help
collection	text collection	the collection of text values you want to concatenate
joiner	text	a joiner text to be inserted between each of the values, for example a comma or a space

This function takes a collection of text values and joins them together with a specified joiner (which can be blank)

SPLITTEXT

text collection splittext(text text, text split)

Parameter	Variable Type	Parameter Help
text	text	the text that you want to split up
split	text	the character or text sequence that should cause the split

Splits a text into a collection of smaller text fragments split by a particular character. Includes empty entries and doesn't include the splitting character.

SUBSTRING

text substring(text source, number index)

Parameter	Variable Type	Parameter Help
source	text	the source text to take a substring from
index	number	the 0-based index of where to start taking a substring from

This function allows you to get a portion of a text string out

SUBSTRING

text substring(text source, number index, number characters)

Parameter	Variable Type	Parameter Help
source	text	the source text to take a substring from
index	number	the 0-based index of where to start taking a substring from
characters	number	the number of characters to retrieve

This function allows you to get a portion of a text string out

TEXTTABLE

text texttable(text collection headers, text collection values, number width)

Parameter	Variable Type	Parameter Help
headers	text collection	a collection of text values to use as the headers of the table
values	text collection	a collection of text values, each of which is a row, with columns separated by the tab (\t) character
width	number	the width of the table

This function displays a coloured 'text table', essentially an ASCII representation of a table. The number of columns in the header MUST match the number of columns in each row.

TEXTTABLE

text texttable(text headers, text collection values, number width)

Parameter	Variable Type	Parameter Help
headers	text	text with values separated by tab characters (\t) to use as the headers of the table
values	text collection	a collection of text values, each of which is a row, with columns separated by the tab (\t) character
width	number	the width of the table

This function displays a coloured 'text table', essentially an ASCII representation of a table. The number of columns in the header MUST match the number of columns in each row.

TOROMAN

text toroman(number number)

Parameter	Variable Type	Parameter Help
number	number	the number you want to convert

Converts a number into a text representation of that number using roman numerals. Supports numbers up to 3999999.

Uncategorised