Mobile Program Commands

This page documents all 167 commands available in mobile programs. Most commands are shared across all entity types and are documented in detail in the Shared Commands Reference. This page provides a quick reference for every mob-available command plus full documentation for mob-only commands.

Table of Contents

All mob program commands use the mob prefix. For example: mob echo, mob transfer, mob oload.

Command Quick Reference

All 167 commands available in mob programs:

Command Description Mob-Only Restricted
addaffect Add a spell-like affect (by skill number) to a character or object   yes
addaffectname Add a named affect (by string name) to a character or object   yes
addaura Add a magical aura effect to a character   yes
addspell Add a spell to a character’s known spell list   yes
addstache Add a mustache/cosmetic customization to a character   yes
alteraffect Modify fields of an existing affect on a target entity   yes
alterexit Modify properties of a room exit (flags, key, destination, etc.)   yes
altermob Modify properties of a mobile/NPC (stats, flags, race, etc.)   yes
alterobj Modify properties of an object (values, flags, weight, etc.)   yes
alterroom Modify properties of a room (flags, sector, name, etc.)   yes
appear Make the scripting entity become visible (remove invisibility) yes  
applytoxin Apply a poison/toxin effect to a target character   yes
asound Send a sound/message to all adjacent rooms (not the current room)   yes
assist Force the mobile to assist another character in combat yes yes
at Execute a command at a different room location temporarily   yes
attach Attach a script program to an entity (mob, obj, room, token)   yes
award Award experience points or quest completion credit to a player   yes
breathe Force the entity to perform a breath attack   yes
call Call another script as a subroutine with return value   yes
cancel Cancel a previously set delay timer on the current entity    
cast Force the entity to cast a spell on a target   yes
chargebank Deduct money from a player’s bank account   yes
chargemoney Deduct money from a player’s carried coins yes yes
checkpoint Set a dungeon/instance checkpoint for player respawn   yes
churchannouncetheft Announce a theft to members of a church/religion organization   yes
cloneroom Create a dynamic copy/clone of a room template   yes
condition Set or modify the condition/durability value of an object or NPC stat   yes
crier Make a town crier NPC announce a message   yes
damage Inflict hit point damage on a target character   yes
deduct Deduct currency, XP, or other resource from a player   yes
delay Set a delayed trigger (in pulses) on the current entity   yes
dequeue Remove all queued/owned events from the current entity    
destroyroom Remove/destroy a dynamically created room   yes
detach Detach/remove a script program from an entity   yes
disappear Make the entity disappear (become invisible/hidden) yes  
dungeoncommence Start/begin a dungeon encounter or phase   yes
dungeoncomplete Mark a dungeon as successfully completed   yes
dungeonfailure Mark a dungeon as failed   yes
echo Send a message to all characters in the current room   yes
echoaround Send a message to all characters in the room except the target   yes
echoat Send a message to a specific target character only   yes
echobattlespam Send a combat-flagged message (respects battlespam filtering)   yes
echochurch Send a message to all online members of a church/religion   yes
echogrouparound Send a message to everyone in the room except target’s group   yes
echogroupat Send a message to all members of the target’s group   yes
echoleadaround Send a message to everyone in room except the group leader   yes
echoleadat Send a message to the group leader only   yes
echonotvict Send a message to everyone in the room except the victim   yes
echoroom Send a message to a specific room (may differ from entity’s room)   yes
ed Add or modify an extra description on an entity   yes
entercombat Force a character into combat state with a target   yes
event Interact with the event system (create, modify, query, manage events)   yes
fade Gradually make the entity disappear (fade out effect)   yes
fixaffects Recalculate and fix all affects on a character   yes
flee Force the entity to flee from combat    
force Force another character to execute a command against their will   yes
forget Clear the entity’s remembered target (set by remember)   yes
gdamage Inflict damage on all characters in a group or area   yes
gecho Send a message to all players in the entire game world   yes
gforce Force all members of a target’s group to execute a command   yes
goto Teleport the scripting entity to a specified room   yes
grantclass Grant a character access to a class   yes
grantskill Grant a character knowledge of a specific skill   yes
grantsong Grant a character knowledge of a bard song   yes
group Force grouping operations (join, add, leave)   yes
gtransfer Transfer an entire group of characters to a destination room   yes
hunt Set the mobile to track/hunt a target character yes yes
input Queue a script command as if the entity typed it (delayed input)   yes
inputstring Send a string as if the entity typed it (raw input injection)   yes
instancecomplete Mark the current dungeon instance as completed   yes
instancefailure Mark the current dungeon instance as failed   yes
interrupt Interrupt a target character’s current action (casting, etc.)   yes
junk Silently destroy an object in the entity’s inventory   yes
kill Force the entity to attack a target (alias for hit) yes yes
link Create or modify an exit link between two rooms   yes
loadinstanced Load a mob/object into the current dungeon instance context   yes
lockadd Add a lock to a door or container   yes
lockremove Remove a lock from a door or container   yes
mail Send an in-game mail message to a player   yes
mload Load/create a mobile by vnum into the game world   yes
mute Mute a character (prevent them from speaking)   yes
oload Load/create an object by vnum into the game world   yes
otransfer Transfer an object to a different location (char, room, container)   yes
pageat Send a paginated message to a specific character   yes
peace Stop all combat in the current room    
persist Mark a script variable for persistent storage (survives reboots)   yes
phaseevent Advance an event to its next phase   yes
prompt Display a custom prompt message to a target character   yes
purge Remove entities (mobs/objects) from a room, optionally by vnum    
questaccept Accept/begin a quest for a player   yes
questcancel Cancel an active quest for a player   yes
questcomplete Mark a quest as completed for a player   yes
questgenerate Procedurally generate a quest (random quest system)   yes
questpartcustom Add a custom quest objective/part   yes
questpartgetitem Add a “collect item” quest objective   yes
questpartgoto Add a “go to location” quest objective   yes
questpartrescue Add a “rescue NPC” quest objective   yes
questpartslay Add a “kill mob” quest objective   yes
questscroll Create a quest scroll item for a player   yes
queue Schedule a delayed script execution via the event queue system   yes
raisedead Resurrect a dead character   yes
rawkill Kill a character instantly bypassing normal death processing   yes
reckoning Trigger a reckoning event (world event system)   yes
remaura Remove a magical aura from a character   yes
remember Store a target character in the entity’s memory for later recall   yes
remort Remort a character (rebirth at higher tier)   yes
remove Remove (unequip and extract) an object from a character   yes
remspell Remove a spell from a character’s known spell list   yes
remstache Remove a mustache/cosmetic customization from a character   yes
resetdice Reset the dice/random values on a target object   yes
resetroom Reset a room to its default/template state   yes
restore Fully restore a character’s HP, mana, and movement to maximum   yes
revokeclass Revoke a character’s access to a class   yes
revokeskill Revoke a character’s knowledge of a skill   yes
revokesong Revoke a character’s knowledge of a bard song   yes
saveplayer Force-save a player character to disk   yes
scriptwait Pause script execution for a specified duration   yes
selfdestruct Cause the scripting entity to destroy itself    
sendfloor Send a dungeon floor transition to players   yes
setclass Set a character’s class   yes
setclasslevel Set a character’s level in a specific class   yes
setposition Set a character’s position (standing, sitting, sleeping, etc.)   yes
setrace Set a character’s race   yes
setrecall Set a player’s recall point (home room)   yes
settimer Set a countdown timer on a token or entity   yes
settrait Set a specific trait value on a character   yes
shop Interact with the shop system (buy, sell, list)   yes
showcommand Display a command’s output to a player without executing it   yes
showroom Display a remote room’s description to a player (scrying/preview)   yes
skimprove Trigger a skill improvement check for a character   yes
spawndungeon Create and initialize a new dungeon instance   yes
specialkey Create or manage a special key item (dungeon keys)   yes
startcombat Initiate combat between two characters   yes
startevent Start a world/area event   yes
startreckoning Start a reckoning world event sequence   yes
stopcombat Force stop combat for a character   yes
stopevent Stop/end an active world/area event   yes
stopreckoning Stop an active reckoning event   yes
stringmob Modify string properties (name, short, long desc) of a mobile   yes
stringobj Modify string properties (name, short, long desc) of an object   yes
stripaffect Remove an affect (by skill number) from a character or object   yes
stripaffectname Remove a named affect (by string name) from a character or object   yes
take Force the mobile to take an object from a character yes yes
teleport Teleport all characters in the room to a destination yes  
transfer Teleport one or more characters to a destination room   yes
treasuremap Create or interact with a treasure map item   yes
ungroup Force a character to leave their group   yes
unlockarea Unlock a locked area (make it accessible)   yes
unlockdungeon Unlock a dungeon (make it accessible to players)   yes
unmute Unmute a previously muted character   yes
usecatalyst Consume a catalyst component and check if requirements are met   yes
varclear Clear/delete a script variable from the current entity   yes
varclearon Clear a variable on a different entity (quest, event, mob, etc.)   yes
varcopy Copy a variable from one name to another on the current entity   yes
varsave Mark a variable for persistent save (supports quest/event targets)   yes
varsaveon Mark a variable on a different entity for persistent save   yes
varset Set a variable value (supports quest/event variable targeting)   yes
varseton Set a variable on a different entity (quest, event target)   yes
vforce Force all instances of a mobile vnum to execute a command   yes
wildernessmap Generate or modify a wilderness map overlay   yes
wildsoverlay Apply a tile overlay to the wilderness map   yes
wildstile Set or modify a specific wilderness tile   yes
wiretransfer Transfer money between bank accounts   yes
wiznet Send a message to the immortal communication channel (wiznet)   yes
xcall Execute a cross-entity script call (call script on another entity)   yes
zecho Send a message to all players in the same area/zone   yes
zot Zot (smite) a character with divine punishment damage   yes

Restricted commands require elevated script security to use. See Scripting Basics for details on security levels.

Mob-Only Commands

These commands are exclusive to mobile programs and are not available in other script types.

appear 

mob appear

Makes the NPC become visible if it was invisible or hidden. Removes any invisibility flags from the mobile. Often used with disappear to create appearing/vanishing NPCs.

Example:

** Make a ghost appear when players enter
mob appear
mob echo {WA spectral figure materializes before you!{x

assist 

mob assist <target>

Forces the mobile to join combat on the side of the specified target. The mob will begin attacking whoever the target is fighting.

Example:

** Guard assists the king when he is attacked
mob assist king
say I will defend you, my liege!

chargemoney 

mob chargemoney <target> <amount> <currency>

Deducts money directly from a player’s carried coins. Unlike chargebank (which takes from the bank), this removes coins the player is physically carrying. Sets lastreturn to indicate success or failure.

Example:

** Charge the player 500 gold for a service
mob chargemoney $n 500 gold
if lastreturn == 1
  say Thank you for your payment, $n.
else
  say You don't have enough gold, $n.
endif

disappear 

mob disappear

Makes the NPC vanish from sight. Sets invisibility flags on the mobile so players cannot see or interact with it. Useful for scripted events where an NPC should appear only at certain times.

Example:

** Vanish after delivering a message
say Remember what I told you...
mob echo {D$I fades into the shadows.{x
mob disappear

hunt 

mob hunt <target>

Sets the mobile to track and pursue the specified target character across rooms. The mob will pathfind toward the target each tick until it reaches them or the hunt is cancelled. Use mob forget to stop hunting.

Example:

** Start hunting a player who stole something
say Thief! You will not escape!
mob hunt $n

kill 

mob kill <target>

Forces the mobile to initiate combat with the specified target. This is the standard way to make an NPC attack a player or another NPC from within a script.

Example:

** Attack intruders who don't have the right token
if tokenvalue $n 50100 0 < 1
  say You are not welcome here!
  mob kill $n
endif

take 

mob take <object> <target>

Forces the mobile to take an object directly from a character’s inventory. Unlike mob remove (which extracts and destroys), this transfers the object to the mob’s inventory.

Example:

** Confiscate a forbidden item
say That weapon is not allowed here, $n.
mob take sword $n
mob junk sword

teleport 

mob teleport <room vnum>

Teleports all player characters in the mob’s current room to the specified destination room. The mob itself does not move. Useful for trap rooms or scripted transitions.

Example:

** Teleport all players to the arena
mob echo {YA blinding flash envelopes the room!{x
mob teleport 50200

Shared Commands by Category

The following commands are shared across multiple entity types. Each entry links to the full documentation in the Shared Commands Reference.

Output

Command Description
mob asound Send a sound/message to all adjacent rooms (not the current room)
mob crier Make a town crier NPC announce a message
mob echo Send a message to all characters in the current room
mob echoaround Send a message to all characters in the room except the target
mob echoat Send a message to a specific target character only
mob echobattlespam Send a combat-flagged message (respects battlespam filtering)
mob echochurch Send a message to all online members of a church/religion
mob echogrouparound Send a message to everyone in the room except target’s group
mob echogroupat Send a message to all members of the target’s group
mob echoleadaround Send a message to everyone in room except the group leader
mob echoleadat Send a message to the group leader only
mob echonotvict Send a message to everyone in the room except the victim
mob echoroom Send a message to a specific room (may differ from entity’s room)
mob gecho Send a message to all players in the entire game world
mob mail Send an in-game mail message to a player
mob pageat Send a paginated message to a specific character
mob prompt Display a custom prompt message to a target character
mob wiznet Send a message to the immortal communication channel (wiznet)
mob zecho Send a message to all players in the same area/zone

Movement & Transfer

Command Description
mob at Execute a command at a different room location temporarily
mob flee Force the entity to flee from combat
mob goto Teleport the scripting entity to a specified room
mob gtransfer Transfer an entire group of characters to a destination room
mob otransfer Transfer an object to a different location (char, room, container)
mob transfer Teleport one or more characters to a destination room

Combat

Command Description
mob applytoxin Apply a poison/toxin effect to a target character
mob breathe Force the entity to perform a breath attack
mob cast Force the entity to cast a spell on a target
mob damage Inflict hit point damage on a target character
mob entercombat Force a character into combat state with a target
mob gdamage Inflict damage on all characters in a group or area
mob interrupt Interrupt a target character’s current action (casting, etc.)
mob peace Stop all combat in the current room
mob rawkill Kill a character instantly bypassing normal death processing
mob startcombat Initiate combat between two characters
mob stopcombat Force stop combat for a character
mob zot Zot (smite) a character with divine punishment damage

Entity Creation & Destruction

Command Description
mob cloneroom Create a dynamic copy/clone of a room template
mob destroyroom Remove/destroy a dynamically created room
mob fade Gradually make the entity disappear (fade out effect)
mob junk Silently destroy an object in the entity’s inventory
mob loadinstanced Load a mob/object into the current dungeon instance context
mob mload Load/create a mobile by vnum into the game world
mob oload Load/create an object by vnum into the game world
mob purge Remove entities (mobs/objects) from a room, optionally by vnum
mob remove Remove (unequip and extract) an object from a character
mob resetroom Reset a room to its default/template state

Entity Modification

Command Description
mob alterexit Modify properties of a room exit (flags, key, destination, etc.)
mob altermob Modify properties of a mobile/NPC (stats, flags, race, etc.)
mob alterobj Modify properties of an object (values, flags, weight, etc.)
mob alterroom Modify properties of a room (flags, sector, name, etc.)
mob condition Set or modify the condition/durability value of an object or NPC stat
mob ed Add or modify an extra description on an entity
mob link Create or modify an exit link between two rooms
mob lockadd Add a lock to a door or container
mob lockremove Remove a lock from a door or container
mob resetdice Reset the dice/random values on a target object
mob setposition Set a character’s position (standing, sitting, sleeping, etc.)
mob shop Interact with the shop system (buy, sell, list)
mob stringmob Modify string properties (name, short, long desc) of a mobile
mob stringobj Modify string properties (name, short, long desc) of an object

Affects & Auras

Command Description
mob addaffect Add a spell-like affect (by skill number) to a character or object
mob addaffectname Add a named affect (by string name) to a character or object
mob addaura Add a magical aura effect to a character
mob alteraffect Modify fields of an existing affect on a target entity
mob fixaffects Recalculate and fix all affects on a character
mob remaura Remove a magical aura from a character
mob stripaffect Remove an affect (by skill number) from a character or object
mob stripaffectname Remove a named affect (by string name) from a character or object

Character Resources

Command Description
mob award Award experience points or quest completion credit to a player
mob chargebank Deduct money from a player’s bank account
mob deduct Deduct currency, XP, or other resource from a player
mob restore Fully restore a character’s HP, mana, and movement to maximum
mob wiretransfer Transfer money between bank accounts

Skills & Classes

Command Description
mob addspell Add a spell to a character’s known spell list
mob grantclass Grant a character access to a class
mob grantskill Grant a character knowledge of a specific skill
mob grantsong Grant a character knowledge of a bard song
mob remspell Remove a spell from a character’s known spell list
mob revokeclass Revoke a character’s access to a class
mob revokeskill Revoke a character’s knowledge of a skill
mob revokesong Revoke a character’s knowledge of a bard song
mob setclass Set a character’s class
mob setclasslevel Set a character’s level in a specific class
mob setrace Set a character’s race
mob settrait Set a specific trait value on a character
mob skimprove Trigger a skill improvement check for a character

Variables & Data

Command Description
mob persist Mark a script variable for persistent storage (survives reboots)
mob varclear Clear/delete a script variable from the current entity
mob varclearon Clear a variable on a different entity (quest, event, mob, etc.)
mob varcopy Copy a variable from one name to another on the current entity
mob varsave Mark a variable for persistent save (supports quest/event targets)
mob varsaveon Mark a variable on a different entity for persistent save
mob varset Set a variable value (supports quest/event variable targeting)
mob varseton Set a variable on a different entity (quest, event target)

Script Control

Command Description
mob call Call another script as a subroutine with return value
mob cancel Cancel a previously set delay timer on the current entity
mob delay Set a delayed trigger (in pulses) on the current entity
mob dequeue Remove all queued/owned events from the current entity
mob input Queue a script command as if the entity typed it (delayed input)
mob inputstring Send a string as if the entity typed it (raw input injection)
mob queue Schedule a delayed script execution via the event queue system
mob scriptwait Pause script execution for a specified duration
mob selfdestruct Cause the scripting entity to destroy itself
mob xcall Execute a cross-entity script call (call script on another entity)

Script Entity Management

Command Description
mob attach Attach a script program to an entity (mob, obj, room, token)
mob detach Detach/remove a script program from an entity
mob forget Clear the entity’s remembered target (set by remember)
mob remember Store a target character in the entity’s memory for later recall
mob settimer Set a countdown timer on a token or entity

Quest System

Command Description
mob event Interact with the event system (create, modify, query, manage events)
mob questaccept Accept/begin a quest for a player
mob questcancel Cancel an active quest for a player
mob questcomplete Mark a quest as completed for a player
mob questgenerate Procedurally generate a quest (random quest system)
mob questpartcustom Add a custom quest objective/part
mob questpartgetitem Add a “collect item” quest objective
mob questpartgoto Add a “go to location” quest objective
mob questpartrescue Add a “rescue NPC” quest objective
mob questpartslay Add a “kill mob” quest objective
mob questscroll Create a quest scroll item for a player

Dungeon & Instance

Command Description
mob checkpoint Set a dungeon/instance checkpoint for player respawn
mob dungeoncommence Start/begin a dungeon encounter or phase
mob dungeoncomplete Mark a dungeon as successfully completed
mob dungeonfailure Mark a dungeon as failed
mob instancecomplete Mark the current dungeon instance as completed
mob instancefailure Mark the current dungeon instance as failed
mob sendfloor Send a dungeon floor transition to players
mob spawndungeon Create and initialize a new dungeon instance
mob specialkey Create or manage a special key item (dungeon keys)

Events & Reckoning

Command Description
mob phaseevent Advance an event to its next phase
mob reckoning Trigger a reckoning event (world event system)
mob startevent Start a world/area event
mob startreckoning Start a reckoning world event sequence
mob stopevent Stop/end an active world/area event
mob stopreckoning Stop an active reckoning event

Social & Appearance

Command Description
mob addstache Add a mustache/cosmetic customization to a character
mob remstache Remove a mustache/cosmetic customization from a character
mob showcommand Display a command’s output to a player without executing it
mob showroom Display a remote room’s description to a player (scrying/preview)

Group & Targeting

Command Description
mob force Force another character to execute a command against their will
mob gforce Force all members of a target’s group to execute a command
mob group Force grouping operations (join, add, leave)
mob ungroup Force a character to leave their group
mob vforce Force all instances of a mobile vnum to execute a command

Religion & Organizations

Command Description
mob churchannouncetheft Announce a theft to members of a church/religion organization
mob setrecall Set a player’s recall point (home room)

Player Management

Command Description
mob mute Mute a character (prevent them from speaking)
mob remort Remort a character (rebirth at higher tier)
mob saveplayer Force-save a player character to disk
mob unmute Unmute a previously muted character

Wilderness

Command Description
mob treasuremap Create or interact with a treasure map item
mob wildernessmap Generate or modify a wilderness map overlay
mob wildsoverlay Apply a tile overlay to the wilderness map
mob wildstile Set or modify a specific wilderness tile

Misc

Command Description
mob unlockarea Unlock a locked area (make it accessible)
mob unlockdungeon Unlock a dungeon (make it accessible to players)
mob usecatalyst Consume a catalyst component and check if requirements are met

Other Commands

Command Description
mob raisedead Resurrect a dead character