This is an old revision of the document!
Get | Set | Field | Type | Note | Possible values |
x | x | name | string | Set for NPCs only | |
x | x | level | number | Set for NPCs only | |
x | x | hp | number | Set for NPCs only | |
x | x | maxhp | number | ||
x | x | mana | number | Set for NPCs only | |
x | x | maxmana | number | ||
x | x | move | number | Set for NPCs only | |
x | x | maxmove | number | ||
x | x | gold | number | Set for NPCs only | |
x | x | silver | number | Set for NPCs only | |
x | money | number | total money converted to silver | ||
x | x | sex | string | Set for NPCs only | none,male,female,either |
x | x | size | string | Set for NPCs only | tiny,small,medium,larg,huge,giant |
x | position | string | dead,mort,incap,stun,sleep,rest,sit,fight,stand | ||
x | x | align | number | ||
x | x | str | number | Set for NPCs only. Range 1-200. | |
x | x | con | number | Set for NPCs only. Range 1-200. | |
x | x | vit | number | Set for NPCs only. Range 1-200. | |
x | x | agi | number | Set for NPCs only. Range 1-200. | |
x | x | dex | number | Set for NPCs only. Range 1-200. | |
x | x | int | number | Set for NPCs only. Range 1-200. | |
x | x | wis | number | Set for NPCs only. Range 1-200. | |
x | x | dis | number | Set for NPCs only. Range 1-200. | |
x | x | cha | number | Set for NPCs only. Range 1-200. | |
x | x | luc | number | Set for NPCs only. Range 1-200. | |
x | x | hitroll | number | Get returns current value including all bonuses. Set for NPCs only. Set will set the mob's hitroll percentage, not the direct value. | |
x | x | damroll | number | Get returns current value including all bonuses. Set for NPCs only. Set will set the mob's damroll percentage, not the direct value. | |
x | x | attacktype | string | Set for NPCs only. | See 'attack_table' table. Value corresponds to 'Name' column. |
x | damnoun | string | See 'attack_table' table. Value corresponds to 'Damtype' column. | ||
x | damtype | string | See 'attack_table' table. Value corresponds to 'Noun' column. | ||
x | clan | string | |||
x | class | string | |||
x | x | race | string | Set for NPCs only. | |
x | ispc | boolean | Whether is a player | ||
x | isnpc | boolean | Whether is a mob | ||
x | isgood | boolean | Whether is good (align>=350) | ||
x | isevil | boolean | Whether is evil (align⇐-350) | ||
x | isneutral | boolean | Whether is neutral (-350 | ||
x | isimmort | boolean | Whether is immortal | ||
x | ischarm | boolean | Whether is charmed | ||
x | isfollow | boolean | Whether is following someone | ||
x | isactive | boolean | Whether position is > than sleeping (resting,sitting,fighthing,or standing) | ||
x | fighting | CH | Mob or player the CH is fighting, nil if none. | ||
x | heshe | string | he/she/it for the character. | ||
x | himher | string | him/her/it for the character. | ||
x | hisher | string | his/her/its for the character. | ||
x | inventory | array of OBJ | |||
x | room | ROOM | |||
x | groupsize | number | 0 for no group, 1 for 1 other person, etc. | ||
x | stance | ||||
x | x | description | Set for NPCs only. | ||
x | pet | CH | |||
x | affects | array of AFFECT | |||
x | clanrank | number | PC only | ||
x | remorts | number | PC only | ||
x | explored | number | PC only | ||
x | beheads | number | PC only | ||
x | pkills | number | PC only | ||
x | pkdeaths | number | PC only | ||
x | questpoints | number | PC only | ||
x | bank | number | PC only | ||
x | mobkills | number | PC only | ||
x | mobdeaths | number | PC only | ||
x | vnum | number | NPC only | ||
x | proto | MOBPROTO | NPC only | ||
x | ingame | boolean | NPC only | ||
x | x | shortdescr | string | NPC only | |
x | x | longdescr | string | NPC only |
Function | Argument | Result | Note | Valid args |
mdo | string | none | interpret argument as if mob typed it | mdo(“string”) |
say | string | none | accepts variables | say(“Hi %s”, ch.name) |
emote | string | none | ||
asound | string | none | accepts variables | asound [string] : echo to all the rooms around the mobile |
gecho | string | none | gecho [string] : echo to all active players in the game | |
zecho | string | none | zecho [string] : echo to all players in the same area | |
kill | string | none | kill [victim] : start combat with a player | |
assist | string | none | assist [victim] : assist another mob or player | |
junk | string | none | junk [item | |
echo | string | none | echo [string] : echo to room | |
echoaround | string | none | echoaround [victim] [string] : echo to all in room save victim | |
echoat | string | none | echoat [victim] (string) : echo to victim (in same room) | |
mload | string | CH | mload [vnum/rvnum] : load a mobile | |
oload | number | OBJ | oload(vnum): load an object to inventory, function returns the OBJ | |
purge | string | none | purge (target) : purge all objs and mobs in room or target | |
goto | string | none | goto [location] : go to location, wrandom for random room in world, random for random room in area | |
at | string | none | at [location] [command] : execute command at location | |
transfer | string | none | transfer [victim | |
gtransfer | string | none | gtransfer [victim] [location] : move group of victim to location | |
otransfer | string | none | otransfer [object] [location] : move object from room | |
force | string | none | force [victim] [command] : victim executes command | |
gforce | string | none | gforce [victim] [command] : victim's group executes command | |
vforce | string | none | vforce [vnum] [command] : all mobs of vnum execute command | |
cast | string | none | cast [spell] (target) : cast spell without failure and cost | |
damage | string | none | damage [victim | |
remove | string | none | remove [victim] [vnum | |
remort | string | none | remort [victim] : remort a player | |
qset | string | none | qset [victim] [id] [value] [time limit] : set quest-state for player | |
qadvance | string | none | qadvance [victim] [id] (increment) : increase quest-state | |
reward | string | none | reward [victim] [exp | |
peace | string | none | peace (victim) : stop combat and make mobs non-aggro | |
restore | string | none | restore [victim] : restore victim | |
setact | string | none | set or remove an act-flag | setact(“safe”)/setact(“safe”,false) |
hit | string | none | hit (victim) : do one attack | hit(ch.name) – must be in battle with victim |
tell | string | none | send a tell | tell(“somebody something”) |
describe | string | none | do | something |
addaffect | string | none | do | something |
removeaffect | string | none | do | something |
Other goodies
Function | Argument | Result | Note | ||
randchar | none | CH | Returns a random PC in room with the mob. | ||
setlevel | number | none | Sets mob level, restores the mob to full health. | ||
destroy | none | none | Destroy the CH, error if attempted on player | mob:destroy() | |
qstatus | number | number | Return the value of the given qset on the CH | ||
qtimer | number | number | Return the timer value of the given qset on the CH | ||
loadprog | number | none | Argument is vnum. Runs target mprog script in the CH's script space | ||
loadscript | string[subfolder],string[filename] | none | runs the script in the file in the subfolder given using the CH's script space | ch:loadscript(“vodur”,“testscript”) | |
loadstring | string | none | runs the argument as a script in the CH's env | ||
loadfunction | |||||
savetbl | string[filename],table | none | creates a file in area specific subdir with filename as the name and saves arg2 to it | ||
loadtbl | string[filename] | table | opens file in area specific subdir with the filename and returns the table loaded from it, nil if file doesn't exist | ||
tprint | table | none | prints the content of a table using say. Good for debug. | ||
olc | string | none | Send command to current olc editor if any. | olc(“name hammy”) – Need to already entered editor, e.g mdo(“redit”) | |
delay | number, function[, string] | none | Set a timer to run arg2 after arg1 seconds, optional arg 3 sets a string tag that can be used for targetted cancelling. | ||
cancel | string[optional] | none | Cancel pending functions that were queued with 'delay'. See cancel | ||
setval | string | none | setval(arg1,arg2,arg3) | ch:setval(_fckg_QUOTfckg_QUOT_, , [arg3]) |ch:setval(“serpent_killed”, 1, true) |getval |string |none |getval(arg1,arg2) |ch:getval(_fckg_QUOTfckg_QUOT_, ) |
Function | Argument | Result | Note | Valid args | Example |
canattack | CH | boolean | whether can attack arg | ||
cansee | CH | boolean | whether can see arg | ||
ccarries | string | boolean | Whether carries arg in a container. | ||
skilled | string | boolean | Whether has skill. | ||
act | string | boolean | if mob:act('safe') then | ||
carries | string | boolean | Whether carries arg (vnum or keyword). | ||
wears | string | boolean | Whether wears arg (vnum or keyword). | ||
has | string | boolean | Whether is carrying an item of type arg. | See Flags | |
uses | string | boolean | Whether is wearing equipment of type arg. | See Flags | |
affected | string | boolean | Check if affected by argument. | See Flags | if (ch:affected(“fade”)) then |
offensive | string | boolean | Check if specific offensive flag is set | See Flags | |
immune | string | boolean | Check if immune to argument | See Flags | |
resist | string | boolean | Check if resist argument | See Flags | |
vuln | string | boolean | Check if vuln to argument | See Flags | |
mobhere | string/number | boolean | Whether mob with keyword(s)/vnum is in the room. | ||
objhere | string/number | boolean | Whether obj with keyword(s)/vnum is in the room. | ||
mobexists | string | boolean | Whether mob with name exists in game. | ||
objexists | string/number | boolean | Whether object with name exists in game. |