Updated at Wed Aug 20 01:41:52 2025

Traps Proper

trap	o1	o2	o3	txt	docs
reset
deplete_airsupply	air supply				if return 1 to prevent standard airsupply depletion from occurring.
before_wander	wandered	dest			return 1 if we won't wander there
hourly	object experiencing time change	room in which time is changing			called when local planetary time advances an hour
daylight_change	room in which daylight changes should be described				called on outdoor rooms with gravity when local planetary time advances an hour. Return 1 to suppress further light change messages
mog_speech	mog template			speech being said by pl	return a string to alter /pl/'s speech.
format_currency	currency				return a formatted currency string, event.long_form==whether to use the long (wordy) form.
before_respawn	program	deck			Called before holo-death causes endprogram. return 1 to avert endprogram.
after_died	victim	corpse			after corpse created; mobile is now in 'dead'; etc
get_plural_name	object we want a plural name for				return the plural name to give, if any. Note that /pl/ isn't set to anything useful. Trap is const-exec'd... no side effects allowed.
get_name	object we want a name for				return the name to give, if any. Note that /pl/ isn't set to anything useful. Trap is const-exec'd... no side effects allowed.
get_plural_long	object we want a plural long name for				return the plural long name to give, if any. Note that /pl/ isn't set to anything useful. Trap is const-exec'd... no side effects allowed.
get_long	object we want a long name for				return the long name to give, if any. Note that /pl/ isn't set to anything useful. Trap is const-exec'd... no side effects allowed.
before_jam_comms	jammer				Called before communication attempt.
spacesuit	spacesuit				return 1 to let this object protect its wearer against vacuum
spacesuit	spacesuit				return 1 to let this object protect its wearer against vacuum
radiationsuit	radiationsuit				return 1 to let this object protect its wearer against vacuum
airsupply	air supply				return 0 to prevent this object supplying air.
minidestroy	minimission template	minimission instance			called just before a minimission instance is destroyed
after_leave	old room	new room			just after 'look'.
after_entry	new room	old room			just after 'look'.
after_go	thing moving	new room			just after 'look'.
after_moved		new room			return 1 to abort
arrival	everything in destination	old room			just after 'look'.
before_bar	barrer	new room			if return 1 then we won't bar, otherwise we will.
after_bar	barrer	new room			after the %M stops %m from going %s message.
before_long_drop	room falling into				if return 1 to abort long drop handling.
before_parachute	parachute	room falling to			if return 1 to act as a parachute.
parachuted_into	room falling into	parachute	room fallen from		called after landing but before parachute trap. Return 1 to stop parachute functioning
parachute	parachute	room fallen from			called after landing, return 1 to stop death checks and messaging.
long_drop	room falling into	room fallen from			called after landing, return 1 to stop death checks and messaging.
after_parachute	parachute				called after everything.
after_reset
after_reset
drop_in_pit	object being pitted	the pit			after messaging. called on contents of containers too.
batch_drop_in_here	this room				before anything other than droppability testing, return 1 to abort
drop_in_here	this room	object being dropped			before anything other than droppability testing, return 1 to abort
drop	object being dropped	this room			return 1 to abort
throw	missile	this room			return 1 to abort
before_throw_at	missile	target			return 1 to abort
before_thrown_with	target	missile			return 1 to abort
before_pit	object about to be pitted	the pit			return 1 to abort. not recursive - doesn't get called on objects inside containers that are to be pitted.
before_remove	clothing				after it is known to be worn, and not under any other clothing that needs removing first. return 1 to abort
after_remove	clothing				after worn and messaging
after_drop_in_here	this room	object being dropped			after drop messaging before additional messaging and special checks
after_throw	missile				after messaging, before specials
after_throw_at	missile	target			after messaging before specials
after_thrown_with	target	missile			after messaging before specials
after_drop	object dropped				after messaging, before specials
after_drop_on	object being dropped on	object dropped	room being dropped in		after messaging, before specials
before_smashed	fragile object				return 1 to not break
before_smash_on	floor or target of throw	fragile object	room where breakage is occurring		return 1 not to break fragile object
after_wield	weapon				after wielding but before 'you hold x in your y hand' messaging
after_hold	item				after holding but before 'you hold x in your y hand' messaging
after_unwield	weapon				after everything in wield/unwield, also triggered internally by set_owner and quitting with undefined messaging order. Coder beware!
after_unhold	item				after everything in hold/unhold, also triggered internally by set_owner and quitting with undefined messaging order. Coder beware!
act	object or mobile an action has been done on
before_act_in	location action was performed in	target of action	action prop	action text
mounted_act		object or mobile an action has been done on	action prop
before_act_held	who possession	target of action	action prop	action text
before_act	object or mobile an action has been done on
before_act	object or mobile an action has been done on				txt==action being performed, after validity checking but before messaging, return 1 to abort action handling
act_in	location action was performed in	target of action	action prop	action text
act_seen	object observing action
try_commline	commline object	sender			return 1 or "You can't use that commline because we hate you" to stop
join_combat	mobile that wants to join in	attacker	victim		return either attacker or victim to start fighting them
before_join_friendly	mobile that wants to join in	mobile it wants to attack	mobile it will be helping		return true to not join in fight on side of same nation
before_combat_kill	victim				before combat ends, messaging and corpse creation
fight_over	attacker				after a fight has finished however
after_slain	victim				after mobile killed in combat
wounded	victim				only triggered by non-fatal wounds with damage greater than zero
before_fight_in_room	room fight is starting in	victim			before fight starts. return 1 to stop fight
kill	victim				before fight started. o1 can be an object, o2 is the weapon, or nil, o3 is the second weapon, if any.
unjust	victim				return 1 if player killing o1 would be ok
before_opponent_flee	opponent	flee direction			before player flees. return 1 to prevent fleeing
tell	the mobile				return 1 to not do any more searching
telldefault	the mobile				return 1 to suppress normal telldefault response
hear	the object that heard			the text heard	called on every object resursively in pl.owner(), including pl and its contents. Currently works for'say' and 'yell'. Objects in airless containers hear nothing, objects in soundproof containers don't hear noises from outside.
before_say	this room			text to say	return 1 doesn't say it
say	this room			text said	return 1 to prevent tell or after_sayto trap handling
after_sayto	target			text said	return 1 to prevent handling the sayto as a tell
ignore_for_dynreset	all objects in zone we want to reset now				return 1 to tell dynresetter to ignore this object (like the noreset flag).
before_dynreset	all objects in zone we want to reset now				return 1 to hold up the reset.
before_effect_spawn	effect template	source of effec being spawned			called before any effect objects are created of modified. Return 1 to abort spawning process.
effect_combine	effect template		source of effect being combined		called when combining a new prefab effect instance with an old one
effect_spawn	effect template	new effect object	source of the effect		called when spawning a prefab effect
effect_timeout	effect target	effect object	source of the effect		return 1 to prevent default effect tidyup procedure
effect	effect object	effect object	source of the effect		called on an active effect every mud 'tick'. return 1 to timeout effect
before_wear	clothing				after already wearing check. return 1 to abort.
after_wear	clothing				after worn and messaging
sit_in_room	room				before anything; return 1 to abort
before_go_on					before messaging,
before_sit	the seat				before messaging, return 1 to abort
go_on					after messaging, before fragility handling, return 1 to abort
sit	the seat				after messaging, before fragility handling, return 1 to abort
lie_in_room	room				before anything; return 1 to abort
before_lie	the bed				before messaging, return 1 to abort
sit	the bed				after messaging, before fragility handling, return 1 to abort
after_sleep	room slept in				after everything
before_stand	the floor or other object we are about to stand on				return 1 to abort
after_stand
before_drag	potential draggable object				return 1 to abort
after_drag	the dragged object
before_mount	potential mount				return 1 to abort
after_mount	the mount
before_dismount	the mount				return 1 to abort
after_dismount	the former mount
before_hold	item				before most things, return 1 to abort
release	item				before messaging, return 1 to abort calls to release or hold commands. not triggered by throw, drop, disp, etc
release	item				before messaging, return 1 to abort calls to release or hold commands. not triggered by throw, drop, disp, etc
after_discovered	object being discovered	object examined to cause discovery
examine	thing examined				before "You examine..." messages, return 1 to abort
before_examine	thing examined				after "You examine...", you are wearing messages, but before main desc ; return 1 to abort
before_show_desc	thing examined				instead of printing the 'desc' when examined. returning 1 averts that, but will still print clothes etc.
after_show_desc	thing examined				after desc displayed but before clothing, contents, etc. Return 1 to hide those.
after_examine	thing examined				after everything
follow
after_followed	leader				after everything, including CanLeader or player check
leave
after_left	former leader				called after pl has stopped following o1
before_pour	from	into			called before messaging and checks. return 1 to abort pouring.
after_fill	container	source			called after everything including fluid object updating.
before_fountain	fountain	container to fill			called before messaging. return 1 to abort filling.
before_fill	container to fill	source			called before messaging or source-fluid checks but after basic validity checking. return 1 to abort filling.
newbie_start	their nation				return 1 to not clone default newbie kit for them
get_shortdesc					return the short description to give, if any.
before_descibe_light	room				Triggered before any lighting messages are sent. Return a string describing the light to suppress any further description
descibe_light_outdoors	room				Triggered on outdoor rooms after any lit objects are described. Return a string describing the light to suppress any further description
before_room_desc	room				before room desc printed. return 1 to not print room desc (but can't suppress daylight). don't use pl:send, as text will appear out of order to the player... use a room_desc trap for that instead
room_desc	room				return a string to override room description. don't use pl:send, as text will appear out of order to the player
after_room_desc	room				after room desc and daylight status printed. return a string to send text to the player, don't use pl:send as it will appear out of order
minican	the minimission template				return 1 to indicate that a minimission of this type can be created at the moment
minicreate	the minimission template	the minimission instance	the mission board it is being added to	any args passed to mmadd	set up an instance of this minimission using o2
mission_available	the mission object	the player being shown to			return 1 to indicate that the mission should not be visible on the board or acceptable by the player
accept	mission object
before_accept	mission object	board			return 1 to prevent acceptance
consume	what eaten				before everything, return 1 to abort
before_fountain	fountain				before someone uses a fountain. if on container, being drunken from. return 1 to abort.
after_consume
before_consume_wearing	item of clothing				before any edibility checking, messaging. return 1 to prevent any consumption.
get	object getting				before any checking, messaging. return 1 to abort.
before_getfrom	table or container	object being taken			return 1 to abort
handle	object gotten				after an object has been picked up in any way, or been given.
after_get	object gotten				after everything
after_getfrom	table or container	object that was taken
before_steal	object to steal	victim			return 1 to abort
after_steal	object stolen
before_paid	mobile paid	the currency			before messaging/cash transfer, return 1 to abort
after_paid	mobile paid	the currency
after_shown_to	object	mobile			return 1 if we saw it.
shown_mission	mobile	mission			return 0 to not want to see the mission. If you return 1, mission_shown will not be called.
mission_shown	mission	mobile			return 0 to not want to see the mission.
after_shown	mobile	object			return 0 to not want to see.
given	gift	mobile			after basic validity checking. return 1 to abort
give	mobile	gift			after basic validity checking. return 1 to abort
after_given	gift	mobile			after object given; return 1 to suppress an auto-give-back
after_give	mobile	gift			after object given; return 1 to suppress an auto-give-back
empty	container				before openness checking; return 1 to abort
before_poured_upon	onto	from			called before messaging. return 1 to abort pouring.
after_emptied	contents object	container			called after movement into new location, etc
after_empty	container				only called if something was actually emptied
light	object				before anything; return 1 to abort
extinguish	object				before anything; return 1 to abort
before_puton	table	object you are putting on it			called whether or not o1 is a table, return 1 to abort
before_putupon	object	table			called whether or not o2 is a table, return 1 to abort
after_puton	table	object you have put on it
after_putupon	object you have put on it	table
put	object	container			called whether or not o2 is a container, return 1 to abort
contain	container	object			called whether or not o1 is a container, return 1 to abort
after_put	object	container			called after everything
after_contain	container	object			called after everything
before_displace	room and every object in from room	destination			before we are about to move. return 1 to abort
get_cost	shopkeeper	item			return a number to override the default cost of /item/
before_trade	shop	shopkeeper			return 1 to abort the list process
wont_sellto	object	shopkeeper			return 1 (or a string for a reason) to not be allowed to sell. Invoked by list as well as buy. Must be silent. Trap is const-exec'd... no side effects allowed.
sell	shopkeeper	object offered			if the shopkeeper wants the item, return 1 and set !offered on o2 to the offer, if he doesn't want it, just return 1
before_sold	object	shopkeeper			if the shopkeeper wants the item, return 1 and set !offered on o2 to the offer, if he doesn't want it, just return 1
after_sell	shopkeeper	item			return 2 to NOT RESTOCK this item
after_sold	object	shopkeeper			return 1 to NOT VANISH the object and not stock the shop with this object; return 2 to merely not stock the item
preview	item being previewed	shopkeeper			return 1 to hide display of object's description
after_preview	item being previewed	shopkeeper			after object's description shown but before 'abilities' line. return 1 to hide abilities
vend_to_other	shopkeeper	person buying for	template		return 1 to abort, return a string to abort and use as tell message
bought_for	person being bought for	template	shopkeeper		return 1 to allow and suppress messaging
buy_for	template	person buying for	shopkeeper		return 1 to allow and suppress messaging
buy	template	shopkeeper			return 1 to abort. before anything is actually cloned. set !virtrade to 1 on o1 if you want it to not actually clone the items, but to do the paying thing.
before_vend	shopkeeper	object to buy			return 1 to abort.
bought	actual item	shopkeeper			return 1 if you don't want the shopkeeper to 'give' item to player
vend	shopkeeper	actual item			return 1 if you don't want the shopkeeper to 'give' item to player
after_bought	template bought	shopkeeper			after everything but before object removed from stock
after_buy	shopkeeper	template bought			after everything but before object removed from stock
after_bought_for	person who was bought for	template	shopkeeper		after everything
before_traverse	exit or door				before everything, including door openness checking. Return a string to send any messaging or return 1. Either aborts traversal, wandering or routefinding. Trap is const-exec'd... no side effects allowed.
before_try_traverse	traverser	exit or door			before everything except before_traverse, including door openness checking. Return a string to send any messaging or return 1. Either aborts traversal, wandering or routefinding. Trap is const-exec'd... no side effects allowed.
try_traverse	traverser	exit or door			before door openness checking. Return a string to send any messaging or return 1. Either aborts traversal.
traverse	exit or door				called after door and confined space checking. Return a string to send any messaging or return 1. Either aborts traversal.
before_moved		new room	exit followed		return 1 to abort
before_depart	every object in from room	destination			before we are about to move. return 1 to abort.
before_go	thing moving	new room			before we are about to move. return 1 to abort.
before_leave	old room	new room			before we are about to move. return 1 to abort.
before_entry	new room	old room			before we are about to move. return 1 to abort.
after_party_entry	new room	old room			after all party has arrived
after_party_leave	old room	new room			after all party has arrived
party_arrival	every object in dest	old room			after all party has arrived
before_try_unlock	object we want to lock				return 1 to abort. before everything, including testing that it is locked
before_unlock	object to be unlocking				return 1 to abort
before_try_lock	object we want to lock				return 1 to abort. before everything, including testing that it is unlocked
before_lock	object to be locking				return 1 to abort
after_lock	object locked
before_try_open	object we want to open				return 1 to abort. before everything, including testing that it is even openable
before_try_close	object we want to close				return 1 to abort. before everything, including testing that it is even closeable
open	object to open				return 1 to abort. if o1=='other' of the object really being opened, o2==the real object, and return 1 doesn't abort.
close	object to close				return 1 to abort. if o1=='other' of the object really being closed, o2==the real object, and return 1 doesn't abort.
after_open	object opened
after_component_opened	composite object	component object
after_close	object closed
after_component_opened	composite object	component object
before_inject	object to inject	thing to inject into			return 1 to not give error
inject	object to inject				return 1 to not give error message
push					return 1 to abort
press					return 1 to abort
push_mount	object being mounted by someone who has been pushed	the person themself			return 1 to abort
push_upon	object target is upon	person being pushed			return 1 to abort
combine	an object	another object			called both ways; return 1 to abort
tie	object	object to			return 1 to abort
untie	object				return 1 to abort
clean					return 1 to abort
dig	room				return 1 to abort
wilderness	the default wilderness object	the new wilderness room being described	the wilderness template being used		only ever used on wilderness_default
wild_create	the zone object	the wilderness that has just had a description made from it			probably before exits are made.
wild_terrain_create	the new wilderness room				called after all wilderness logic has completed
before_screenreader_map	player owner or zone it belongs to				called before before_map, return 1 to not do any further map handling
before_map	player owner or zone it belongs to				return 1 to not do any further map handling
before_dive	current loc	destination loc			return 1 to abort dive
before_surface	current loc	destination loc			return 1 to abort surface
after_discard_in_room	the room				after a discard
ship_landed	passenger or cargo	ship	place it landed		called before the door has opened.
landed	ship	place it landed			called before the door has opened.
landed_here	place ship landed	ship			called before the door has opened.
after_ship_landed	passenger or cargo	ship	place it landed		called after the door has opened and LeaveShip flagged mobiles have left.
after_landed	ship	place it landed			called after the door has opened.
after_landed_here	place ship landed	ship			called after the door has opened.
before_takeoff	ship				before doors close, return 1 to abort takeoff and reschedule in 5 seconds time
after_takeoff	ship	place it took off from
forbid_docking	which dock				return 1 to forbid /pl/ from docking a ship at /o1/
start_program	a holo object				called on every holoobject when created
before_start_program	a holo program				called before any objects clone but after crystal inserted, return 1 to abort program start. crystal will not be altered or removed
after_startprogram	the instance of the holo container				Called after the green glow, but before they 'look'
before_endprogram	program	deck			If you return 1, doesn't let player end program, just moves them to the deck.
before_insert_crystal	slot	crystal			After valid crystal checks. Return 1 to abort
before_crystal_inserted	program	crystal			After valid crystal checks. Return 1 to abort
caught_smuggling	contraband item	customs officer	smuggler destination		return 1 to smuggle this item safely
caught_smuggler	customs officer	contraband item	smuggler destination		return 1 to ignore this smuggling attempt
after_caught_smuggling	contraband item	customs officer	smuggler destination		return 1 to not be punished and suppress messaging, return 2 to allow past as well
after_caught_smuggler	customs officer	contraband item	smuggler destination		return 1 to not be punished and suppress messaging, return 2 to allow past as well
pressurise	room being pressurised				called on members of a roomgroup being pressurised
depressurise	room being depressurised				called on members of a roomgroup being depressurised
depressurise	room being depressurised				called on members of a roomgroup being depressurised
charge	object mounted	thing charged			return 1 if you handled it.
climb	object to climb				return 1 to abort
cut	object to cut	object to cut with or weapon or nil			return 1 to abort
after_deposit	banker mobile	currency object for type of currency being handled
jump_mount	object that you are mounting				return 1 to abort
jump_over	object that you are jumping over				return 1 to allow
jump_into	object that you are jumping into				return 1 to allow
jump_on	object to jump on				return 1 to abort
jump_standing	object that you are standing upon				return 1 to abort
jump	room you are in				return 1 to abort
kick	target				return 1 to abort
after_kick	target
lift	object to lift				return 1 to abort
pull	object to pull				return 1 to abort
rent	the room someone tried to rent in				return 1 if you handled it
sign	object to sign on				return 1 to abort
swing	object to swing on				return 1 to abort
trap
turn	object to turn				return 1 to abort
after_withdraw	banker mobile	currency object for type of currency being handled

Undocumented or Unused Traps

after_component_closed

batch_vend
lay_in_room
lay
before_lay
before_died
before_jump_mount
before_wield
unwield
unhold
exit_invisible
state
after_post
before_heal
after_heal
wild_name
wild_name_over
wild_name_under
wild_desc
wild_exit
wild_desc_near
wild_desc_near_plural
wild_desc_far
wild_desc_far_plural
wild_desc_same
wild_desc_same_all
wild_desc_over
wild_desc_under
get_dragging_verb
get_riding_verb
before_describe_light
describe_light_outdoors
describe_container
hazardsuit
get_min_rank
get_offer
stock_list
temp_stock_list
mplex
random_name
before_ranks
calc_level
verb
action
kicked_off_stool
get_trading_inventory
schema
lib
lib
primitives
targets
helpers
verb
verb
try_lift