Mprog Compendium - Revision history

Eightfold-Forgot-Her-Pswd at 04:18, 2 April 2026

2026-04-02T04:18:30Z

← Older revision		Revision as of 21:18, 1 April 2026
Line 587:		Line 587:
	This command forces the given target to perform the given command. The target can be anyone in the same room as the mobile, excluding the mobile itself. The target can also be "all," which will affect every character in the room that the mob can see and who is not staff. The command can be any regular command - or if the target is a mob, a mob command - but it cannot be an ifcheck. This can be a very powerful command.		This command forces the given target to perform the given command. The target can be anyone in the same room as the mobile, excluding the mobile itself. The target can also be "all," which will affect every character in the room that the mob can see and who is not staff. The command can be any regular command - or if the target is a mob, a mob command - but it cannot be an ifcheck. This can be a very powerful command.

	(~~''Eightfold's annoying details~~:~~'' the values of~~ variables ~~in a mob force command may be from the "perspective" of either the ''forcing'' mob~~ or ~~the ''forced'' mob.~~		(NOTE: if <command> involves variables such as $q, $g or $n, they seem to be determined by the forcing mob! This is generally what you want. However, note that (possibly because they're evaluated before being passed?), a <command> involving $i probably won't do what you want it to do -- because $i will generally evaluate to 'self', and so the forced mob will do <command> with a target of the string 'self', ie, the forced rather than forcing mob! ...or something like that.)
	~~For instance, if a roly does "force imp say~~ $I", ~~then the imp will say "roly": for the command "say," $i is~~ determined by the forcing mob (~~the roly~~).
	~~However~~, if a ~~roly does "force imp mob remember~~ $i~~" and then the imp does "say~~ $Q", the ~~imp~~ will ~~say "imp": for~~ the ~~command "mob remember~~,~~" $i is determined by~~ the forced mob ~~(the imp~~)~~. An incomplete list of each type:~~

	* Variables determined by forcing mob: say, mob echo, mob face, mob cast
	* Variables determined by forced mob: mob remember, mob call''

	Examples: 5660, 3130, 2710, 3014, 2387		Examples: 5660, 3130, 2710, 3014, 2387

Abysmal at 16:03, 2 March 2026

2026-03-02T16:03:45Z

← Older revision		Revision as of 09:03, 2 March 2026
Line 289:		Line 289:
	$a the amount of last successful mob damage OR mob award exp		$a the amount of last successful mob damage OR mob award exp
	$B the level of the mob remember target		$B the level of the mob remember target
	$z the counter of the acting mob		$z the counter of the acting mob
			$x the counter of the mob remember target

	For use in event mprogs:		For use in event mprogs:
Line 459:		Line 460:

	;OCLONE:mob oclone <target> [I]		;OCLONE:mob oclone <target> [I]
			*Note from Abysmal: This doesn't work right, don't use it until it's been confirmed to be fixed!!
	This command creates a perfect duplicate of a target object, including any modifications to it, such as restringed fields, affects, etc. By default, it will load the cloned object into the room, regardless of where the original object was. "I" can be added to the command to force the new object to appear in the mob's inventory instead.		This command creates a perfect duplicate of a target object, including any modifications to it, such as restringed fields, affects, etc. By default, it will load the cloned object into the room, regardless of where the original object was. "I" can be added to the command to force the new object to appear in the mob's inventory instead.

Admin at 23:00, 14 February 2026

2026-02-14T23:00:02Z

← Older revision		Revision as of 16:00, 14 February 2026
Line 140:		Line 140:
	roomaff2 if roomaff2 sphinx - room affect2 check ('? roomaffect2' in editor to see valid flags)		roomaff2 if roomaff2 sphinx - room affect2 check ('? roomaffect2' in editor to see valid flags)
	roomflag if roomflag dark - room flag check ('? room' in editor to see valid flags)		roomflag if roomflag dark - room flag check ('? room' in editor to see valid flags)
	~~area if area $i == 1 - is $i in the immortal area?~~
	align if align $n < -1000 - alignment check		align if align $n < -1000 - alignment check
	level if level $n < 5 - level check		level if level $n < 5 - level check

Admin at 02:34, 14 February 2026

2026-02-14T02:34:34Z

← Older revision		Revision as of 19:34, 13 February 2026
Line 138:		Line 138:
	room if room $i == 1233 - room virtual number		room if room $i == 1233 - room virtual number
	roomaff if roomaff sandstorm - room affect check ('? roomaff' in editor to see valid flags)		roomaff if roomaff sandstorm - room affect check ('? roomaff' in editor to see valid flags)
			roomaff2 if roomaff2 sphinx - room affect2 check ('? roomaffect2' in editor to see valid flags)
	roomflag if roomflag dark - room flag check ('? room' in editor to see valid flags)		roomflag if roomflag dark - room flag check ('? room' in editor to see valid flags)
	area if area $i == 1 - is $i in the immortal area?		area if area $i == 1 - is $i in the immortal area?
Line 174:		Line 175:
	objval3		objval3
	objval4		objval4
			objval5
			objval6
			objval7
	objcost if objcost $o >= 50 - cost of the obj in silver		objcost if objcost $o >= 50 - cost of the obj in silver
	objweight if objweight $o < 100 - weight of the obj in 1/10lbs		objweight if objweight $o < 100 - weight of the obj in 1/10lbs
Line 197:		Line 201:
	drunk if drunk $n >= 5 - drunkenness check		drunk if drunk $n >= 5 - drunkenness check
	khcount if khcount $n > 30 - did $n kill more than 30 things?		khcount if khcount $n > 30 - did $n kill more than 30 things?
	khexists if khexists $n 1234 - ~~did~~ $~~n kill~~ a mob of vnum 1234?		khexists if khexists 1234 - has the acting character (e.g. $i in event progs) killed a mob of vnum 1234? Only meaningful when the actor is a PC
	enchant if enchant $o > 10 - does $o have a total enchantment modifier of more than 10? NOTE: armor enchants are negative		enchant if enchant $o > 10 - does $o have a total enchantment modifier of more than 10? NOTE: armor enchants are negative
	recentdam if recentdam $i > 4 - is my recent_dam variable (aka $a) greater than 4?		recentdam if recentdam $i > 4 - is my recent_dam variable (aka $a) greater than 4?
	area if area $n truce.are - is character in Truce?		area if area $n truce.are - is character in Truce?
	localx if localx $i = 3 - is the current room at the localx 3 position?		localx if localx $i == 3 - is the current room at the localx 3 position?
	localy if localy $i = 10 - is the current room at the localy 10 position? Note that these are the variables for the protuna minimap, and they'll be zero in every room if the builder hasn't created a map and set them		localy if localy $i == 10 - is the current room at the localy 10 position? Note that these are the variables for the protuna minimap, and they'll be zero in every room if the builder hasn't created a map and set them
	islagged if islagged $q - is $q experiencing spell/skill lag? only PCs have this		islagged if islagged $q - is $q experiencing spell/skill lag? only PCs have this
	practices if practices $n > 4 - practice check		practices if practices $n > 4 - practice check
	trains if trains q > 2 - train check		trains if trains $q > 2 - train check
			dtypedam if dtypedam $i > 100 - is the damage that triggered a DAMTYPE prog greater than 100?

			=== Comparators ===
			Allowed comparison operators are ==, >=, <=, >, <, and !=
			* = by itself will not work

	=== Notes ===		=== Notes ===
Line 301:		Line 310:
	$c the name of the current combat target of the mob's remember target		$c the name of the current combat target of the mob's remember target
	$C the short desc of the current combat target of the mob's remember target		$C the short desc of the current combat target of the mob's remember target
	$d the name of a random player-~~aligned~~ mobile ~~(i.e. pet~~ or ~~charmie)~~ in the room		$d the name of a random player-targetable mobile or PKable player in the room
	$D the name of a random player-~~targetable~~ mobile or ~~PKable player~~ in the room		$D the name of a random player-aligned mobile (i.e. pet or charmie) in the room
	$e the subject pronoun of the mob's target		$e the subject pronoun of the mob's target
	$E the subject pronoun of the mob's secondary target*		$E the subject pronoun of the mob's secondary target*
Line 417:		Line 426:

	;DECHO:mob decho <string>		;DECHO:mob decho <string>
	As mob echo, but will not show the echo to the ~~user~~.		As mob echo, but will not show the echo to the acting mob or player.

	;GOTO:mob goto <location>		;GOTO:mob goto <location>
Line 736:		Line 745:
	Examples: 13275		Examples: 13275

	;ADDLOG: mob addlog		;ADDLOG: mob addlog <argument>
	This command allows a mob to write to the mud's log, for debug purposes. It will write the short desc and vnum of the mob, followed by the argument. It may be useful for debugging mprogs that have a lot of moving parts.		This command allows a mob to write to the mud's log, for debug purposes. It will write the short desc and vnum of the mob, followed by the argument. It may be useful for debugging mprogs that have a lot of moving parts.

			;MOVE: mob move <target> <min> <max>
			Reduces the movement points of one character (or everyone in the room) by a random amount. It does 'not' move anyone to another room.

			;HEAL: mob heal <target> <msgToTarget> <msgToRoom> <dice1> <dice2>
			Heals one character in the mob’s room by a random amount (dice1 d dice2) and prints messages.
			* Will restore HP to undead/zombified mobs or players, and not harm them.
			* Will trigger distribute, and any overflow will skip undead allies.

			;WIZNET: mob wiznet <string>
			Sends a message to the staff-only wiznet for debugging or other purposes. Uses the 'penalties' wiznet channel.

			;GHOSTWRITER: mob ghostwriter
			Calls the global ghostwriter routine exactly once; only Ushumgallu (vnum 18250) should use this.

	===MOB TRIGGERS===		===MOB TRIGGERS===

Admin at 12:39, 1 August 2025

2025-08-01T12:39:38Z

← Older revision		Revision as of 05:39, 1 August 2025
Line 35:		Line 35:

	rand if rand 30 - if random number between 1 and 100 is < 30		rand if rand 30 - if random number between 1 and 100 is < 30
	~~exists~~ if ~~exists $n~~ - ~~does $n exist somewhere~~ ''~~'This check~~ is ~~for use with variables, not names~~'''		mobhere if mobhere fido - is there a 'fido' mob in this room?
	~~ishere~~ if ~~ishere $q~~ - is $q in this room?		if mobhere 1233 - is there mob vnum 1233 in this room?
			objhere if objhere bottle - is there a 'bottle' obj in this room?
			-can't see in if objhere 1233 - is there obj vnum 1233 in this room?
			containers
	mobexists if mobexists 1233 - is there mob vnum 1233 somewhere		mobexists if mobexists 1233 - is there mob vnum 1233 somewhere
	if mobexists fido - is there a fido mob somewhere '''!!! WARNING !!!''' this is cpu-intensive. use a vnum instead if possible!		if mobexists fido - is there a fido mob somewhere '''!!! WARNING !!!''' this is cpu-intensive. use a vnum instead if possible!
Line 43:		Line 46:
	if objexists sword - is there a sword obj somewhere '''!!! WARNING !!!''' avoid this too, for the same reasons		if objexists sword - is there a sword obj somewhere '''!!! WARNING !!!''' avoid this too, for the same reasons
	if objexists 500.sword - are there at least 500 swords in the entire world? '''!!!''' and this		if objexists 500.sword - are there at least 500 swords in the entire world? '''!!!''' and this
	~~mobhere~~ if ~~mobhere fido~~ - ~~is there a~~ '~~fido~~' ~~mob in this room?~~		exists if exists $n - does $n exist somewhere '''This check is for use with variables, not names'''
	~~if mobhere 1233 -~~ is ~~there mob vnum 1233 in this room?~~		ishere if ishere $q - is $q in this room?
	~~objhere if objhere bottle - is there a~~ '~~bottle~~' ~~obj in this room?~~
	~~-can't see in~~ if ~~objhere 1233~~ - is ~~there obj vnum 1233~~ in this room?
	~~containers~~
	isself if isself $n - evaluate equivalence between a character and the acting mob		isself if isself $n - evaluate equivalence between a character and the acting mob
	people if people > 4 - does room contain > 4 people		people if people > 4 - does room contain > 4 people
Line 204:		Line 204:
	localy if localy $i = 10 - is the current room at the localy 10 position? Note that these are the variables for the protuna minimap, and they'll be zero in every room if the builder hasn't created a map and set them		localy if localy $i = 10 - is the current room at the localy 10 position? Note that these are the variables for the protuna minimap, and they'll be zero in every room if the builder hasn't created a map and set them
	islagged if islagged $q - is $q experiencing spell/skill lag? only PCs have this		islagged if islagged $q - is $q experiencing spell/skill lag? only PCs have this
			practices if practices $n > 4 - practice check
			trains if trains q > 2 - train check

	=== Notes ===		=== Notes ===

Slurmp at 03:01, 5 July 2025

2025-07-05T03:01:54Z

← Older revision		Revision as of 20:01, 4 July 2025
Line 575:		Line 575:
	This command forces the given target to perform the given command. The target can be anyone in the same room as the mobile, excluding the mobile itself. The target can also be "all," which will affect every character in the room that the mob can see and who is not staff. The command can be any regular command - or if the target is a mob, a mob command - but it cannot be an ifcheck. This can be a very powerful command.		This command forces the given target to perform the given command. The target can be anyone in the same room as the mobile, excluding the mobile itself. The target can also be "all," which will affect every character in the room that the mob can see and who is not staff. The command can be any regular command - or if the target is a mob, a mob command - but it cannot be an ifcheck. This can be a very powerful command.

	(~~Details~~: the values of variables in a mob force command may be from the "perspective" of either the ''forcing'' mob or the ''forced'' mob.		(''Eightfold's annoying details:'' the values of variables in a mob force command may be from the "perspective" of either the ''forcing'' mob or the ''forced'' mob.
	For instance, if a roly does "force imp say $I", then the imp will say "roly": for the command "say," $i is determined by the forcing mob (the roly).		For instance, if a roly does "force imp say $I", then the imp will say "roly": for the command "say," $i is determined by the forcing mob (the roly).
	However, if a roly does "force imp mob remember $i" and then the imp does "say $Q", the imp will say "imp": for the command "mob remember," $i is determined by the forced mob (the imp). An incomplete list of each type:		However, if a roly does "force imp mob remember $i" and then the imp does "say $Q", the imp will say "imp": for the command "mob remember," $i is determined by the forced mob (the imp). An incomplete list of each type:

	* Variables determined by forcing mob: say, mob echo, mob face, mob cast		* Variables determined by forcing mob: say, mob echo, mob face, mob cast
	* Variables determined by forced mob: mob remember, mob call		* Variables determined by forced mob: mob remember, mob call''

	Examples: 5660, 3130, 2710, 3014, 2387		Examples: 5660, 3130, 2710, 3014, 2387
Line 587:		Line 587:
	This command works just like force, except it forces everyone in the target's group as well as the target. The target must be in the same room as and not be the mob. Besides that, it is entirely identical to force.		This command works just like force, except it forces everyone in the target's group as well as the target. The target must be in the same room as and not be the mob. Besides that, it is entirely identical to force.

	''(Notes: gforce appears to not function under certain circumstances not listed here. Sometimes getting a third mob to gforce a separate group leader-follower pair seems to fail; other times, it seems certain mobs can't be gforced(? unclear). Testing has not fully elucidated what's causing this issue, but making one member of a leader-follower pair gforce the other seems to be the most consistent solution. --~~Slurmp~~)''		''(Notes: gforce appears to not function under certain circumstances not listed here. Sometimes getting a third mob to gforce a separate group leader-follower pair seems to fail; other times, it seems certain mobs can't be gforced(? unclear). Testing has not fully elucidated what's causing this issue, but making one member of a leader-follower pair gforce the other seems to be the most consistent solution. --Eightfold)''

	Examples: 5276		Examples: 5276

Slurmp at 02:58, 5 July 2025

2025-07-05T02:58:31Z

← Older revision		Revision as of 19:58, 4 July 2025
Line 579:		Line 579:
	However, if a roly does "force imp mob remember $i" and then the imp does "say $Q", the imp will say "imp": for the command "mob remember," $i is determined by the forced mob (the imp). An incomplete list of each type:		However, if a roly does "force imp mob remember $i" and then the imp does "say $Q", the imp will say "imp": for the command "mob remember," $i is determined by the forced mob (the imp). An incomplete list of each type:

	* Variables determined by forcer: say, mob echo, mob face, mob cast		* Variables determined by forcing mob: say, mob echo, mob face, mob cast
	* Variables determined by forcee: mob remember, mob call		* Variables determined by forced mob: mob remember, mob call

	Examples: 5660, 3130, 2710, 3014, 2387		Examples: 5660, 3130, 2710, 3014, 2387

Slurmp at 02:57, 5 July 2025

2025-07-05T02:57:25Z

← Older revision		Revision as of 19:57, 4 July 2025
Line 575:		Line 575:
	This command forces the given target to perform the given command. The target can be anyone in the same room as the mobile, excluding the mobile itself. The target can also be "all," which will affect every character in the room that the mob can see and who is not staff. The command can be any regular command - or if the target is a mob, a mob command - but it cannot be an ifcheck. This can be a very powerful command.		This command forces the given target to perform the given command. The target can be anyone in the same room as the mobile, excluding the mobile itself. The target can also be "all," which will affect every character in the room that the mob can see and who is not staff. The command can be any regular command - or if the target is a mob, a mob command - but it cannot be an ifcheck. This can be a very powerful command.

	''(~~Notes for nerds~~: ~~at least my testing suggests that, when~~ mob force'~~ing something to~~ "say," "~~mob echo,~~" ~~"mob face~~," ~~etc, it seems to use a value of '~~$i' determined by the forcing mob~~; when mob forcing to~~ "mob remember" or "mob ~~call~~," ~~it seems to use values of '~~$i~~' or '$n'~~ determined by the forced mob. ~~This may be related to when a variable is/is not abstracted to a name when passed. Further testing probably recommended. --Slurmp)''~~		(Details: the values of variables in a mob force command may be from the "perspective" of either the ''forcing'' mob or the ''forced'' mob.
			For instance, if a roly does "force imp say $I", then the imp will say "roly": for the command "say," $i is determined by the forcing mob (the roly).
			However, if a roly does "force imp mob remember $i" and then the imp does "say $Q", the imp will say "imp": for the command "mob remember," $i is determined by the forced mob (the imp). An incomplete list of each type:

			* Variables determined by forcer: say, mob echo, mob face, mob cast
			* Variables determined by forcee: mob remember, mob call

	Examples: 5660, 3130, 2710, 3014, 2387		Examples: 5660, 3130, 2710, 3014, 2387

Slurmp at 01:41, 5 July 2025

2025-07-05T01:41:28Z

← Older revision		Revision as of 18:41, 4 July 2025
Line 566:		Line 566:

	;PETIFY:mob petify <target> $i		;PETIFY:mob petify <target> $i
	This command makes the mob using the command the pet of the target. It works almost exactly like the staff command of the same name. Mob petify will not work if the target already has a pet. Mobs can only petify themselves, this command only works with 'self' (variable $i) as the victim.		This command makes the mob using the command the pet of the target. It works almost exactly like the staff command of the same name. Mob petify will not work if the target already has a pet. <del>Mobs can only petify themselves, this command only works with 'self' (variable $i) as the victim.</del>

			(Edit: this is seemingly incorrect -- see mobprog 3271, associated with eventitem 3236.)

	Examples: 2106, 3196, 700, 707, 715. This command is unique to CoD.		Examples: 2106, 3196, 700, 707, 715. This command is unique to CoD.

Slurmp at 01:25, 29 April 2025

2025-04-29T01:25:56Z

← Older revision		Revision as of 18:25, 28 April 2025
Line 384:		Line 384:
	;ECHO:mob echo <string>		;ECHO:mob echo <string>
	This command sends a text message to every player in the room. It is the basic command to output whatever you want via mobprogs. There are many more specialized versions of this command, all of which are listed below. Oftentimes echo is a better choice than having a mob say or emote something.		This command sends a text message to every player in the room. It is the basic command to output whatever you want via mobprogs. There are many more specialized versions of this command, all of which are listed below. Oftentimes echo is a better choice than having a mob say or emote something.

	By default, mob echo (and echoat, etc) capitalize the first letter of the echoed text (including if it's a variable, eg 'mob echo $I'). Beginning the echoed text with the "{x" character, which normally cancels color codes, will prevent this automatic capitalization (but won't force it lowercase). (eg 'mob echo {xhello' or 'mob echo {x$I')		By default, mob echo (and echoat, etc) capitalize the first letter of the echoed text (including if it's a variable, eg 'mob echo $I'). Beginning the echoed text with the "{x" character, which normally cancels color codes, will prevent this automatic capitalization (but won't force it lowercase). (eg 'mob echo {xhello' or 'mob echo {x$I')