User Tools

Site Tools


lua:ch:members

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.


lua/ch/members.1403280271.txt.gz · Last modified: 2014/06/20 16:04 by vodur