Wand of teleportation - Revision history

Phol ende wodan: /* Description */ 3.7: clarify how monster zapping at hero on object pile works, add opinion comment that the bugfix (like most bugfixes) should not be mentioned in the page content

2026-01-24T23:03:31Z

‎Description: 3.7: clarify how monster zapping at hero on object pile works, add opinion comment that the bugfix (like most bugfixes) should not be mentioned in the page content

Umbire the Phantom: upcoming text

2026-01-11T18:23:05Z

upcoming text

Umbire the Phantom: slightly more thorough touch-ups in this instance

2026-01-10T18:52:09Z

slightly more thorough touch-ups in this instance

Umbire the Phantom: /* History */ pothole

2025-03-08T01:10:54Z

‎History: pothole

Umbire the Phantom: /* Description */ more zap cites

2025-03-08T01:10:34Z

‎Description: more zap cites

Umbire the Phantom: /* Description */ cite zap.c, etc.

2025-03-08T00:46:06Z

‎Description: cite zap.c, etc.

Umbire the Phantom: /* History */ word choice

2025-03-06T22:00:18Z

‎History: word choice

Umbire the Phantom: history + move relevant code

2025-03-06T21:52:41Z

history + move relevant code

Umbire the Phantom: a message, more variant stuff, and I think we're set

2025-03-06T03:38:23Z

a message, more variant stuff, and I think we're set

Umbire the Phantom: spacing, potholes

2025-03-06T02:29:25Z

spacing, potholes

@@ Line 35: / Line 35: @@
 {{upcoming|NetHack 3.7.0|Per {{commit|6cbf8ccef49ef5a70bb146bca047ec2c88b1a1d3}} and {{commit|27b1a153d3383d9e27ac7870d60a6dfecd94635d}}, feedback is printed and properly sequenced whenever the hero is teleported by the wand.
-Per {{commit|475648bd02e2a781dc424efe9709a56dd958c59d}}, a bug is fixed that would cause any object zapped with a wand of teleportation to result in scrambled zap targeting, causing the beam to continue from one square beyond the object's destination, rather than one square beyond where it was originally hit&mdash;this meant that the beam could affect monsters and items that were not in its path of originally, with the reported case being a Rider that was teleported next to the hero from across the [[Astral Plane]].
+Per {{commit|475648bd02e2a781dc424efe9709a56dd958c59d}}, a bug is fixed that would cause any object zapped with a wand of teleportation to result in scrambled zap targeting, causing the beam to continue from one square beyond the object's destination, rather than one square beyond where it was originally hit&mdash;this meant that the beam could affect monsters and items that were not in its path of originally, with the reported case being a Rider that was teleported next to the hero from across the [[Astral Plane]]. <!-- Arguably, this should go on the Bug Hall of Fame; I don't think it's important enough to mention on this page, or perhaps not even get a place in the BHoF. -->
 Per {{commit|f83eaade321262b9272c65531a01074821f37ec9}}, monsters will use the wand of teleportation offensively to prevent a hero from escaping via stairs or ladders, or move them if they are standing on an engraving or scroll that scares monsters. Per {{commit|d7d4ed3dfe889ac01723ca3bcbf76b372922a02a}}, monsters will also zap the wand at the hero if they are situated at a choke-point and the monster zapping the wand is among a group of other monsters.
@@ Line 45: / Line 45: @@
 Per {{commit|d036116deec724b524615e6bf0a97acea6e87430}}, a bug is fixed that causes a [[hiding]] monster under an item to remain hiding even if the item is zapped by the wand and teleported away.
-Per {{commit|01928276d5e452e678d93e7dabe780c32e5abf1c}}, a monster will zap a wand of teleportation at the hero if they are near an item pile that the monster is interested in.}}
+Per {{commit|01928276d5e452e678d93e7dabe780c32e5abf1c}}, a monster will zap a wand of teleportation at the hero if they are standing on an item pile that the monster is interested in (implemented as any pile that has more than 3 stacks of objects, or which has 3 or less but the monster would like to pick up any of the items that are there). Such a zap will result in the pile's contents being randomly teleported around the level.}}
 ==Strategy==

@@ Line 33: / Line 33: @@
 [[Breaking wands|Breaking]] a charged wand of teleportation by [[applying]] it, or else wresting one last charge from an applied wand, will cause an explosion that deals anywhere between 1 and (4&times;<charges>) damage, and teleports monsters (including the hero) and items that are caught in the explosion.{{refsrc|src/apply.c|3353|version=NetHack 3.6.7}}{{refsrc|src/apply.c|3390|version=NetHack 3.6.7}}
-{{upcoming|NetHack 3.7.0|There is feedback for the hero being teleported by the wand.
+{{upcoming|NetHack 3.7.0|Per {{commit|6cbf8ccef49ef5a70bb146bca047ec2c88b1a1d3}} and {{commit|27b1a153d3383d9e27ac7870d60a6dfecd94635d}}, feedback is printed and properly sequenced whenever the hero is teleported by the wand.
 Per {{commit|475648bd02e2a781dc424efe9709a56dd958c59d}}, a bug is fixed that would cause any object zapped with a wand of teleportation to result in scrambled zap targeting, causing the beam to continue from one square beyond the object's destination, rather than one square beyond where it was originally hit&mdash;this meant that the beam could affect monsters and items that were not in its path of originally, with the reported case being a Rider that was teleported next to the hero from across the [[Astral Plane]].
@@ Line 39: / Line 39: @@
 Per {{commit|f83eaade321262b9272c65531a01074821f37ec9}}, monsters will use the wand of teleportation offensively to prevent a hero from escaping via stairs or ladders, or move them if they are standing on an engraving or scroll that scares monsters. Per {{commit|d7d4ed3dfe889ac01723ca3bcbf76b372922a02a}}, monsters will also zap the wand at the hero if they are situated at a choke-point and the monster zapping the wand is among a group of other monsters.
-Per {{commit|b0f3371147383c72aa024be3e2b30d0702069485}}, a monster that cannot move anywhere will use a wand of teleportation they have or other teleportation items to try and free themselves. Per {{commit|58031920dc6a9fff297a317ccb65de3cdfd90957}}, this will not occur in [[Fort Ludios]].
+Per {{commit|b0f3371147383c72aa024be3e2b30d0702069485}}, a monster that cannot move anywhere will use a wand of teleportation or other teleportation items that they have to try and free themselves. Per {{commit|58031920dc6a9fff297a317ccb65de3cdfd90957}}, this will not occur in [[Fort Ludios]].
 Per {{commit|886394c9c78f34ca988ee58857121c37dffba57a}}, a monster being zapped with the wand by either the hero or themselves produces feedback&mdash;the wand will auto-identify if the hero actually sees that exact monster end up on a square in their line of sight as a result of the wand zap.
-Per {{commit|d036116deec724b524615e6bf0a97acea6e87430}}, a bug is fixed that causes a [[hiding]] monster under an item to remain hiding even if the item is zapped by the wand and teleported away.}}
+Per {{commit|d036116deec724b524615e6bf0a97acea6e87430}}, a bug is fixed that causes a [[hiding]] monster under an item to remain hiding even if the item is zapped by the wand and teleported away.
 ==Strategy==
@@ Line 56: / Line 58: @@
 The wand of teleportation first appears in Hack 1.21 and Hack PDP-11, which are based on [[Jay Fenlason's Hack]], and is included in the initial item list for [[Hack 1.0]]. From these initial versions to [[Hack 1.0.1]], it is known as the '''wand of teleport monster''', and is given its current name in [[Hack 1.0.2]].
-In [[NetHack 3.4.3]] and earlier versions, including some variants based on those versions, code is present that allows monsters to use the wand of teleportation offensively against the hero, specifically if the hero does not have [[teleport control]] and is standing on a [[stair]], [[ladder]], an engraved [[Elbereth]], or a [[scroll of scare monster]]{{refsrc|src/muse.c|1157|version=NetHack 3.6.7|comment=as noted with other deferred code: "disabled because find_offensive() never picks WAN_TELEPORTATION"}}{{refsrc|src/muse.c|1279|version=NetHack 3.6.7}}{{refsrc|src/muse.c|1443|version=NetHack 3.6.7}}&mdash;however, the code is bugged and is deferred in [[NetHack 3.6.0]] via {{commit|8d1e0d17565ca7567cd6c75565a3e5c6e87f8db1}}, as the relevant function can never actually select a wand of teleportation as an offensive option.
+In [[NetHack 3.4.3]] and earlier versions, including some variants based on those versions, code is present that allows monsters to use the wand of teleportation offensively against the hero, specifically if the hero does not have [[teleport control]] and is standing on a [[stair]], [[ladder]], an engraved [[Elbereth]], or a [[scroll of scare monster]]{{refsrc|src/muse.c|1157|version=NetHack 3.6.7|comment=as noted with other deferred code: "disabled because <tt>find_offensive()</tt> never picks WAN_TELEPORTATION"}}{{refsrc|src/muse.c|1279|version=NetHack 3.6.7}}{{refsrc|src/muse.c|1443|version=NetHack 3.6.7}}&mdash;however, the code is bugged and is deferred in [[NetHack 3.6.0]] via {{commit|8d1e0d17565ca7567cd6c75565a3e5c6e87f8db1}}, as the relevant function can never actually select a wand of teleportation as an offensive option.
 ==Messages==
-{{upcoming|3.7.0|The following messages are added.}}
+{{upcoming|NetHack 3.7.0|The following messages are added as part of {{commit|6cbf8ccef49ef5a70bb146bca047ec2c88b1a1d3}}, {{commit|27b1a153d3383d9e27ac7870d60a6dfecd94635d}} and other commits.}}
 {{message|You materialize in a different location!|You were teleported by a wand of teleportation or other source.}}
-{{message|You materialize in the same location!|As above, but you have [[teleport control]] and chose your current square.}}
+{{message|You materialize in the same location!|As above, but you have [[teleport control]] and chose your current square, or else the current location was randomly selected with a very low chance.}}
 {{message|<The monster> vanishes!|A monster was zapped with a wand of teleportation and landed on a square out of your sight. This message can also occur if a monster is zapped by a wand of make invisible and you do not have see invisible.}}

@@ Line 9: / Line 9: @@
   |muse=def
 }}
 A '''wand of teleportation''' is a type of [[wand]] that appears in ''[[NetHack]]''.
@@ Line 32: / Line 31: @@
 Engraving with a wand of teleportation will make any engraving currently on that square vanish, teleporting it to another spot on the level.{{refsrc|src/engrave.c|740|version=NetHack 3.6.7}}
-[[Breaking wands|Breaking]] a [[charged]] wand of teleportation by [[applying]] it, or else wresting one last charge from an applied wand, will cause an explosion that deals anywhere between 1 and (4&times;<charges>) damage, and teleports monsters (including the hero) and items that are caught in the explosion.{{refsrc|src/apply.c|3353|version=NetHack 3.6.7}}{{refsrc|src/apply.c|3390|version=NetHack 3.6.7}}
+[[Breaking wands|Breaking]] a charged wand of teleportation by [[applying]] it, or else wresting one last charge from an applied wand, will cause an explosion that deals anywhere between 1 and (4&times;<charges>) damage, and teleports monsters (including the hero) and items that are caught in the explosion.{{refsrc|src/apply.c|3353|version=NetHack 3.6.7}}{{refsrc|src/apply.c|3390|version=NetHack 3.6.7}}
-{{upcoming|3.7.0|There is now feedback for the hero being teleported by the wand.
+{{upcoming|NetHack 3.7.0|There is feedback for the hero being teleported by the wand.
 Per {{commit|475648bd02e2a781dc424efe9709a56dd958c59d}}, a bug is fixed that would cause any object zapped with a wand of teleportation to result in scrambled zap targeting, causing the beam to continue from one square beyond the object's destination, rather than one square beyond where it was originally hit&mdash;this meant that the beam could affect monsters and items that were not in its path of originally, with the reported case being a Rider that was teleported next to the hero from across the [[Astral Plane]].
@@ Line 47: / Line 46: @@
 ==Strategy==
-The wand of teleportation is a versatile escape item: a hero can relocate a major threat further from the hero, or else teleport themselves out of a situation where they are surrounded by hostiles, and can also free themselves from [[engulfing]] monsters such as [[air elemental]]s; on a no-teleport level, the hero can instead zap the monster from inside to teleport it away without teleporting themselves as well; breaking the wand can also work for tight spots where you are surrounded or else need to clear some room to maneuver.
+The wand of teleportation is a versatile escape item: a hero can relocate a major threat further from the hero, or else teleport themselves out of a situation where they are surrounded by hostiles, and can also free themselves from [[engulfing]] monsters such as [[air elemental]]s; on a no-teleport level, the hero can instead zap the monster from inside to teleport it away without teleporting themselves as well; and breaking the wand can also work for tight spots where you are surrounded or else need to clear some room to maneuver.
 If you engrave-ID a "vanishing" wand, you can test it by zapping a monster or item&mdash;it is a wand of teleportation if the affected item disappears, or if the monster disappears and cannot be found by [[searching]] or moving into it.
 ==History==

@@ Line 56: / Line 56: @@
 The wand of teleportation first appears in Hack 1.21 and Hack PDP-11, which are based on [[Jay Fenlason's Hack]], and is included in the initial item list for [[Hack 1.0]]. From these initial versions to [[Hack 1.0.1]], it is known as the '''wand of teleport monster''', and is given its current name in [[Hack 1.0.2]].
-In [[NetHack 3.4.3]] and earlier versions, including some variants based on those versions, code is present that allows monsters to use the wand of teleportation offensively against the hero, specifically if the hero does not have [[teleport control]] and is standing on a [[stair]], [[ladder]], an [[engraved]] [[Elbereth]], or a [[scroll of scare monster]]{{refsrc|src/muse.c|1157|version=NetHack 3.6.7|comment=as noted with other deferred code: "disabled because find_offensive() never picks WAN_TELEPORTATION"}}{{refsrc|src/muse.c|1279|version=NetHack 3.6.7}}{{refsrc|src/muse.c|1443|version=NetHack 3.6.7}}&mdash;however, the code is bugged and is deferred in [[NetHack 3.6.0]] via {{commit|8d1e0d17565ca7567cd6c75565a3e5c6e87f8db1}}, as the relevant function can never actually select a wand of teleportation as an offensive option.
+In [[NetHack 3.4.3]] and earlier versions, including some variants based on those versions, code is present that allows monsters to use the wand of teleportation offensively against the hero, specifically if the hero does not have [[teleport control]] and is standing on a [[stair]], [[ladder]], an engraved [[Elbereth]], or a [[scroll of scare monster]]{{refsrc|src/muse.c|1157|version=NetHack 3.6.7|comment=as noted with other deferred code: "disabled because find_offensive() never picks WAN_TELEPORTATION"}}{{refsrc|src/muse.c|1279|version=NetHack 3.6.7}}{{refsrc|src/muse.c|1443|version=NetHack 3.6.7}}&mdash;however, the code is bugged and is deferred in [[NetHack 3.6.0]] via {{commit|8d1e0d17565ca7567cd6c75565a3e5c6e87f8db1}}, as the relevant function can never actually select a wand of teleportation as an offensive option.
 ==Messages==

@@ Line 24: / Line 24: @@
 ==Description==
-A [[hero]] [[zapping]] a wand of teleportation in a given direction will fire a beam in that direction which [[teleport]]s any [[monster]]s and [[item]]s it hits, angering [[peaceful]] monsters if the hero zaps them:{{refsrc|src/zap.c|295|version=NetHack 3.6.7}}{{refsrc|src/teleport.c|1561|version=NetHack 3.6.7}} [[aligned priest]]s in their [[temple]]s will always resist being teleported, and the [[Riders]] have a {{frac|12|13}} chance of being placed on a square that is close if not adjacent to the hero, while a Rider's [[corpse]] hit by a teleportation beam is ''not'' teleported and will immediately [[revive]].{{refsrc|src/teleport.c|1432|version=NetHack 3.6.7|comment=Rider corpses revive instead of relocating when teleported}}{{refsrc|src/teleport.c|1567|version=NetHack 3.6.7|comment=priests in their temples resist teleportation}}{{refsrc|src/teleport.c|1576|version=NetHack 3.6.7|comment=teleported riders will stick close to the hero}} A monster that is engulfing the hero and is zapped by a hero's wand of teleportation will also take the hero along with them, unless they are on a no-teleport level.
+A [[hero]] [[zapping]] a wand of teleportation in a given direction will fire a beam in that direction which [[teleport]]s any [[monster]]s and [[item]]s it hits, angering [[peaceful]] monsters if the hero zaps them:{{refsrc|src/zap.c|295|version=NetHack 3.6.7}}{{refsrc|src/zap.c|1995|version=NetHack 3.6.7}}{{refsrc|src/teleport.c|1561|version=NetHack 3.6.7}} [[aligned priest]]s in their [[temple]]s will always resist being teleported, and the [[Riders]] have a {{frac|12|13}} chance of being placed on a square that is close if not adjacent to the hero, while a Rider's [[corpse]] hit by a teleportation beam is ''not'' teleported and will immediately [[revive]].{{refsrc|src/teleport.c|1432|version=NetHack 3.6.7|comment=Rider corpses revive instead of relocating when teleported}}{{refsrc|src/teleport.c|1567|version=NetHack 3.6.7|comment=priests in their temples resist teleportation}}{{refsrc|src/teleport.c|1576|version=NetHack 3.6.7|comment=teleported riders will stick close to the hero}} A monster that is engulfing the hero and is zapped by a hero's wand of teleportation will also take the hero along with them, unless they are on a no-teleport level.
-A hero zapping themselves with a wand of teleportation will teleport themselves unless they are on a no-teleport level, [[auto-identify]]ing the wand. A hero zapping the wand downward will teleport all items on their square.
+A hero zapping themselves with a wand of teleportation will teleport themselves unless they are on a no-teleport level, [[auto-identify]]ing the wand.{{refsrc|src/zap.c|2438|version=NetHack 3.6.7}} A hero zapping the wand downward will teleport all items and [[engraving]]s on their square, and doing so while [[riding]] will teleport both the hero and their steed.{{refsrc|src/zap.c|2684|version=NetHack 3.6.7}}{{refsrc|src/zap.c|2968|version=NetHack 3.6.7}}
 Monsters will use this wand defensively:{{refsrc|src/muse.c|550|version=NetHack 3.6.7}} a hostile monster that is not a [[guard]], a [[shopkeeper]] or an aligned priest in their temple will zap themselves to escape from the hero while they are at low enough [[HP]], unless they are aware that the current level is no-teleport.{{refsrc|src/muse.c|675|version=NetHack 3.6.7}} This will auto-identify the wand. A monster's attempts to teleport itself this way will fail if it either has the [[Amulet of Yendor]], or else with a {{frac|3}} chance if it is inside the [[Wizard's Tower]].{{refsrc|src/muse.c|690|version=NetHack 3.6.7}} It is possible for a monster to zap a wand of teleportation defensively at the hero, but this is very rare and usually requires that monster to have the Amulet of Yendor, and the monster will not attempt it again if they zap the hero and teleportation fails (i.e. the hero is on a no-teleport level).{{refsrc|src/muse.c|699|version=NetHack 3.6.7}}{{refsrc|src/muse.c|1314|version=NetHack 3.6.7|comment=<tt>mbhit</tt> function}}{{refsrc|src/muse.c|1349|version=NetHack 3.6.7}}

@@ Line 59: / Line 59: @@
 {{upcoming|3.7.0|The following messages are added.}}
 {{message|You materialize in a different location!|You were teleported by a wand of teleportation or other source.}}
 {{message|<The monster> vanishes!|A monster was zapped with a wand of teleportation and landed on a square out of your sight. This message can also occur if a monster is zapped by a wand of make invisible and you do not have see invisible.}}
 ==References==
-<references />
+<references/>
 {{nethack-367}}
 [[Category:Wands|Teleportation]]