Object detection - Revision history

Umbire the Phantom: detailing - forgot to dig into some clairvoyance-specific stuff prior, will do later

2026-02-28T16:05:37Z

detailing - forgot to dig into some clairvoyance-specific stuff prior, will do later

Umbire the Phantom: /* Description */ word choice

2026-02-28T15:49:52Z

‎Description: word choice

Umbire the Phantom: clairvoyance, citations, variants, etc.

2025-10-24T08:38:46Z

clairvoyance, citations, variants, etc.

Umbire the Phantom: fix

2025-10-24T07:06:47Z

fix

Umbire the Phantom: still more detailing - more than safe to de-stub atp

2025-10-24T07:06:01Z

still more detailing - more than safe to de-stub atp

Umbire the Phantom: continue expanding

2025-10-24T00:18:33Z

continue expanding

Umbire the Phantom: duped

2025-10-21T03:07:16Z

duped

Umbire the Phantom: /* Description */ expand

2025-10-21T03:01:02Z

‎Description: expand

Umbire the Phantom: mention crystal ball, describe object mapping

2025-10-20T12:20:49Z

mention crystal ball, describe object mapping

Umbire the Phantom: history

2025-10-20T12:13:32Z

history

@@ Line 5: / Line 5: @@
 Object detection can occur in multiple forms, depending on the source:
-* Quaffing a [[potion of object detection]] reveals all items on the current level (including [[buried]] and underwater objects) and [[exercises]] [[wisdom]], with the details and breadth of the detected objects dependent on the potion's beatitude.{{refsrc|src/potion.c|849|version=NetHack 3.6.7|name="peffects"|comment=both potion and spell use the same code}}{{refsrc|src/potion.c|853|version=NetHack 3.6.7}}{{refsrc|src/potion.c|851|version=NetHack 3.6.7|comment=calls <tt>object_detect()</tt> in detect.c}}{{refsrc|src/detect.c|582|version=NetHack 3.6.7|comment=<tt>object_detect()</tt> function}}
+* Quaffing a [[potion of object detection]] reveals all items on the current level (including [[buried]] and submerged objects) and [[exercises]] [[wisdom]], with the details and breadth of the detected objects dependent on the potion's beatitude.{{refsrc|src/potion.c|849|version=NetHack 3.6.7|name="peffects"|comment=both potion and spell use the same code}}{{refsrc|src/potion.c|853|version=NetHack 3.6.7}}{{refsrc|src/potion.c|851|version=NetHack 3.6.7|comment=calls <tt>object_detect()</tt> in detect.c}}{{refsrc|src/detect.c|582|version=NetHack 3.6.7|comment=<tt>object_detect()</tt> function}}
 ** A blessed potion will display detected items that are not in the inventory of a [[monster]] as though the hero has seen them up close when navigating the resulting screen, and will have the appearances of all items in their inventory revealed if applicable (e.g. they are currently [[blind]]){{refsrc|src/detect.c|589|version=NetHack 3.6.7}}{{refsrc|src/detect.c|619|version=NetHack 3.6.7}}{{refsrc|src/detect.c|630|version=NetHack 3.6.7}}{{refsrc|src/detect.c|641|version=NetHack 3.6.7}}{{refsrc|src/detect.c|655|version=NetHack 3.6.7}}&mdash;otherwise, the potion will give a generalized description of the item type for each object if they are not known to the hero. Cursed potions will treat cloaked [[mimic]]s as actual items, with the class of the "item" selected randomly per mimic.{{refsrc|src/detect.c|588|version=NetHack 3.6.7}}{{refsrc|src/detect.c|658|version=NetHack 3.6.7}}{{refsrc|src/detect.c|733|version=NetHack 3.6.7}}
 * [[Casting]] the [[spell of detect treasure]] replicates the effects of quaffing the non-cursed potion as detailed above, dependent on the caster's skill level.<ref name="peffects"/>
 * There are also some items that can detect specific object types:
-** Reading a non-cursed [[scroll of food detection]] will reveal all comestible items on the current level.{{refsrc|src/read.c|1477|nethack=3.6.7|name="food_detect"|comment=both the spell and scroll call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}}{{refsrc|src/detect.c|469|nethack=3.6.7}}{{refsrc|src/detect.c|476|nethack=3.6.7}}{{refsrc|src/detect.c|563-L570|nethack=3.6.7}} Reading a cursed scroll, or being [[confused]] and reading a scroll of any beatitude, will instead reveal all potions on the level.{{refsrc|src/detect.c|461-L463|nethack=3.6.7}}
+** Reading a non-cursed [[scroll of food detection]] will reveal all comestible items on the current level, including buried and submerged objects.{{refsrc|src/read.c|1477|nethack=3.6.7|name="food_detect"|comment=both the spell and scroll call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}}{{refsrc|src/detect.c|469|nethack=3.6.7}}{{refsrc|src/detect.c|476|nethack=3.6.7}}{{refsrc|src/detect.c|563-L570|nethack=3.6.7}} Reading a cursed scroll, or being [[confused]] and reading a scroll of any beatitude, will instead reveal all potions on the level.{{refsrc|src/detect.c|461-L463|nethack=3.6.7}}
 ** Casting the {{+ of|detect food}} spell replicates the effects of reading the non-cursed scroll as described above, dependent on the caster's skill level.<ref name="food_detect"/>
-** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally reveal [[Gold (material)|golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces, while a non-cursed scroll that is read while confused will detect traps and ''also'' mark them as traps.{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}}
+** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level, including buried and submerged objects.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally detect [[golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces, while a non-cursed scroll that is read while confused will detect traps and ''also'' mark them as traps.{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}}
-** If the hero [[applies]] a non-cursed [[crystal ball]] that has charges while they are not [[blind]], and the player selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level.{{refsrc|src/detect.c|1095|version=NetHack 3.6.7|comment=<tt>use_crystal_ball()</tt> function}}{{refsrc|src/detect.c|1102|version=NetHack 3.6.7|name="outlookblank"}}{{refsrc|src/detect.c|1179|version=NetHack 3.6.7}}{{refsrc|src/detect.c|1204-L1213|version=NetHack 3.6.7|comment=calls <tt>monster_detect()</tt> or <tt>object_detect()</tt> as needed}}
+** If the hero [[applies]] a non-cursed [[crystal ball]] that has charges while they are not [[blind]], and the player selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level (including buried and submerged objects).{{refsrc|src/detect.c|1095|version=NetHack 3.6.7|comment=<tt>use_crystal_ball()</tt> function}}{{refsrc|src/detect.c|1102|version=NetHack 3.6.7|name="outlookblank"}}{{refsrc|src/detect.c|1179|version=NetHack 3.6.7}}{{refsrc|src/detect.c|1204-L1213|version=NetHack 3.6.7|comment=calls <tt>monster_detect()</tt> or <tt>object_detect()</tt> as needed}}
-** [[Clairvoyance]] magically maps a roughly-circular 19-by-11 area centered on the [[hero]]'s location, and can be obtained from a few sources including the {{+ of|clairvoyance}} spell (which can affect mapping based on the hero's skill in [[divination spells]]).{{refsrc|src/spell.c|1186-L1190|nethack=3.6.7}}{{refsrc|src/detect.c|1306|nethack=3.6.7}}{{refsrc|src/detect.c|1316-L1320|nethack=3.6.7}} In both cases, clairvoyance does not detect buried objects unlike the other forms of object detection discussed.
+** [[Clairvoyance]] magically maps a roughly-circular 19-by-11 area centered on the hero's location, and can be obtained from a few sources including the {{+ of|clairvoyance}} spell (which can affect mapping based on the hero's skill in [[divination spells]]).{{refsrc|src/spell.c|1186-L1190|nethack=3.6.7}}{{refsrc|src/detect.c|1306|nethack=3.6.7}}{{refsrc|src/detect.c|1316-L1320|nethack=3.6.7}} In both cases clairvoyance does not detect buried objects, but can detect submerged objects.
-Most forms of object detection, if not all of them, [[exercise]] [[wisdom]].
+Most forms of object detection, if not all of them, will [[exercise]] [[wisdom]] when performed.
 ===Detection maps===
-Any form of object detection will mark the locations of the discovered objects against a black map, and stale object markings of the applicable type are always cleared when mapping item locations from this effect.{{refsrc|src/detect.c|284|nethack=3.6.7|comment=<tt>clear_stale_map()</tt>}}{{refsrc|src/detect.c|312|nethack=3.6.7|comment=call from <tt>gold_detect()</tt>}}{{refsrc|src/detect.c|465|nethack=3.6.7|comment=call from <tt>food_detect()</tt>}}{{refsrc|src/detect.c|666|nethack=3.6.7|comment=call from <tt>object_detect()</tt> if there were no stale markings to clear}}{{refsrc|src/detect.c|1325|nethack=3.6.7}}{{refsrc|src/detect.c|1363-L1365|nethack=3.6.7}}{{refsrc|src/detect.c|1396|nethack=3.6.7}} Floor items are mapped over buried items, items on the top of piles are mapped over the rest of the pile, and the first item in a monster's inventory is mapped over any items they are standing on.{{refsrc|src/detect.c|608|version=NetHack 3.6.7}}{{refsrc|src/detect.c|648|version=NetHack 3.6.7}}{{refsrc|src/detect.c|683|version=NetHack 3.6.7}}{{refsrc|src/detect.c|702|version=NetHack 3.6.7}}{{refsrc|src/detect.c|719|version=NetHack 3.6.7}}{{refsrc|src/detect.c|744|version=NetHack 3.6.7}} The hero can navigate the resulting screen from quaffing the potion by moving their cursor to highlight particular objects, and any other key that does not perform a navigation action will exit this screen{{refsrc|src/detect.c|679|version=NetHack 3.6.7}}{{refsrc|src/detect.c|762|version=NetHack 3.6.7|comment=temporary map navigation}}&mdash;the locations of those objects are recorded when returning to normal play.
+Detection of specific object types or all objects will mark the locations of the discovered objects against a black map, and stale object markings of the applicable type are always cleared when mapping item locations from this effect.{{refsrc|src/detect.c|284|nethack=3.6.7|comment=<tt>clear_stale_map()</tt>}}{{refsrc|src/detect.c|312|nethack=3.6.7|comment=call from <tt>gold_detect()</tt>}}{{refsrc|src/detect.c|465|nethack=3.6.7|comment=call from <tt>food_detect()</tt>}}{{refsrc|src/detect.c|666|nethack=3.6.7|comment=call from <tt>object_detect()</tt> if there were no stale markings to clear}}{{refsrc|src/detect.c|1325|nethack=3.6.7}}{{refsrc|src/detect.c|1363-L1365|nethack=3.6.7}}{{refsrc|src/detect.c|1396|nethack=3.6.7}} Floor items are mapped over buried items, items on the top of piles are mapped over the rest of the pile, and the first item in a monster's inventory is mapped over any items they are standing on.{{refsrc|src/detect.c|608|version=NetHack 3.6.7}}{{refsrc|src/detect.c|648|version=NetHack 3.6.7}}{{refsrc|src/detect.c|683|version=NetHack 3.6.7}}{{refsrc|src/detect.c|702|version=NetHack 3.6.7}}{{refsrc|src/detect.c|719|version=NetHack 3.6.7}}{{refsrc|src/detect.c|744|version=NetHack 3.6.7}} The hero can navigate the resulting screen from quaffing the potion by moving their cursor to highlight particular objects, and any other key that does not perform a navigation action will exit this screen{{refsrc|src/detect.c|679|version=NetHack 3.6.7}}{{refsrc|src/detect.c|762|version=NetHack 3.6.7|comment=temporary map navigation}}&mdash;the locations of those objects are recorded when returning to normal play.
-If these location markers disappear once they are in the hero's line of sight, the object in question is either buried, submerged or else has been moved.
+Clairvoyance that detects submerged objects nearby will display the map of the immediate area it covers around the hero, with the locations of detected items displayed temporarily.
 ==History==

@@ Line 11: / Line 11: @@
 ** Reading a non-cursed [[scroll of food detection]] will reveal all comestible items on the current level.{{refsrc|src/read.c|1477|nethack=3.6.7|name="food_detect"|comment=both the spell and scroll call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}}{{refsrc|src/detect.c|469|nethack=3.6.7}}{{refsrc|src/detect.c|476|nethack=3.6.7}}{{refsrc|src/detect.c|563-L570|nethack=3.6.7}} Reading a cursed scroll, or being [[confused]] and reading a scroll of any beatitude, will instead reveal all potions on the level.{{refsrc|src/detect.c|461-L463|nethack=3.6.7}}
 ** Casting the {{+ of|detect food}} spell replicates the effects of reading the non-cursed scroll as described above, dependent on the caster's skill level.<ref name="food_detect"/>
-** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally reveal [[Gold (material)|golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces, while a non-cursed scroll that is read while confused will detect traps ''and'' also appropriately mark them.{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}}
+** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally reveal [[Gold (material)|golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces, while a non-cursed scroll that is read while confused will detect traps and ''also'' mark them as traps.{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}}
 ** If the hero [[applies]] a non-cursed [[crystal ball]] that has charges while they are not [[blind]], and the player selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level.{{refsrc|src/detect.c|1095|version=NetHack 3.6.7|comment=<tt>use_crystal_ball()</tt> function}}{{refsrc|src/detect.c|1102|version=NetHack 3.6.7|name="outlookblank"}}{{refsrc|src/detect.c|1179|version=NetHack 3.6.7}}{{refsrc|src/detect.c|1204-L1213|version=NetHack 3.6.7|comment=calls <tt>monster_detect()</tt> or <tt>object_detect()</tt> as needed}}
 ** [[Clairvoyance]] magically maps a roughly-circular 19-by-11 area centered on the [[hero]]'s location, and can be obtained from a few sources including the {{+ of|clairvoyance}} spell (which can affect mapping based on the hero's skill in [[divination spells]]).{{refsrc|src/spell.c|1186-L1190|nethack=3.6.7}}{{refsrc|src/detect.c|1306|nethack=3.6.7}}{{refsrc|src/detect.c|1316-L1320|nethack=3.6.7}} In both cases, clairvoyance does not detect buried objects unlike the other forms of object detection discussed.

@@ Line 12: / Line 12: @@
 ** Casting the {{+ of|detect food}} spell replicates the effects of reading the non-cursed scroll as described above, dependent on the caster's skill level.<ref name="food_detect"/>
 ** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally reveal [[Gold (material)|golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces, while a non-cursed scroll that is read while confused will detect traps ''and'' also appropriately mark them.{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}}
-** If the hero [[applies]] a non-cursed [[crystal ball]] that has charges while they are not [[blind]], and the player selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level.{{refsrc|src/detect.c|1095|version=NetHack 3.6.7|comment=<tt>use_crystal_ball()</tt> function}}{{refsrc|src/detect.c|1102|version=NetHack 3.6.7|name="outlookblank"}}{{refsrc|src/detect.c|1179|version=NetHack 3.6.7}}{{refsrc|src/detect.c|1204-L1213|version=NetHack 3.6.7|comment=calls <tt>monster_detect()</tt> or <tt>object_detect()</tt> as needed}}{{refsrc|src/detect.c|582|version=NetHack 3.6.7|comment=<tt>object_detect()</tt> function}}
+** If the hero [[applies]] a non-cursed [[crystal ball]] that has charges while they are not [[blind]], and the player selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level.{{refsrc|src/detect.c|1095|version=NetHack 3.6.7|comment=<tt>use_crystal_ball()</tt> function}}{{refsrc|src/detect.c|1102|version=NetHack 3.6.7|name="outlookblank"}}{{refsrc|src/detect.c|1179|version=NetHack 3.6.7}}{{refsrc|src/detect.c|1204-L1213|version=NetHack 3.6.7|comment=calls <tt>monster_detect()</tt> or <tt>object_detect()</tt> as needed}}
 ===Detection maps===
-Any form of object detection will mark the locations of the discovered objects against a black map, and stale object markings of the applicable type are always cleared when mapping item locations from this effect.{{refsrc|src/detect.c|284|nethack=3.6.7|comment=<tt>clear_stale_map()</tt>}}{{refsrc|src/detect.c|312|nethack=3.6.7|comment=call from <tt>gold_detect()</tt>}}{{refsrc|src/detect.c|465|nethack=3.6.7|comment=call from <tt>food_detect()</tt>}}{{refsrc|src/detect.c|666|nethack=3.6.7|comment=call from <tt>object_detect()</tt> if there were no stale markings to clear}} Floor items are mapped over buried items, items on the top of piles are mapped over the rest of the pile, and the first item in a monster's inventory is mapped over any items they are standing on.{{refsrc|src/detect.c|608|version=NetHack 3.6.7}}{{refsrc|src/detect.c|648|version=NetHack 3.6.7}}{{refsrc|src/detect.c|683|version=NetHack 3.6.7}}{{refsrc|src/detect.c|702|version=NetHack 3.6.7}}{{refsrc|src/detect.c|719|version=NetHack 3.6.7}}{{refsrc|src/detect.c|744|version=NetHack 3.6.7}} The hero can navigate the resulting screen from quaffing the potion by moving their cursor to highlight particular objects, and any other key that does not perform a navigation action will exit this screen{{refsrc|src/detect.c|679|version=NetHack 3.6.7}}{{refsrc|src/detect.c|762|version=NetHack 3.6.7|comment=temporary map navigation}}&mdash;the locations of those objects are recorded when returning to normal play.
+Any form of object detection will mark the locations of the discovered objects against a black map, and stale object markings of the applicable type are always cleared when mapping item locations from this effect.{{refsrc|src/detect.c|284|nethack=3.6.7|comment=<tt>clear_stale_map()</tt>}}{{refsrc|src/detect.c|312|nethack=3.6.7|comment=call from <tt>gold_detect()</tt>}}{{refsrc|src/detect.c|465|nethack=3.6.7|comment=call from <tt>food_detect()</tt>}}{{refsrc|src/detect.c|666|nethack=3.6.7|comment=call from <tt>object_detect()</tt> if there were no stale markings to clear}}{{refsrc|src/detect.c|1325|nethack=3.6.7}}{{refsrc|src/detect.c|1363-L1365|nethack=3.6.7}}{{refsrc|src/detect.c|1396|nethack=3.6.7}} Floor items are mapped over buried items, items on the top of piles are mapped over the rest of the pile, and the first item in a monster's inventory is mapped over any items they are standing on.{{refsrc|src/detect.c|608|version=NetHack 3.6.7}}{{refsrc|src/detect.c|648|version=NetHack 3.6.7}}{{refsrc|src/detect.c|683|version=NetHack 3.6.7}}{{refsrc|src/detect.c|702|version=NetHack 3.6.7}}{{refsrc|src/detect.c|719|version=NetHack 3.6.7}}{{refsrc|src/detect.c|744|version=NetHack 3.6.7}} The hero can navigate the resulting screen from quaffing the potion by moving their cursor to highlight particular objects, and any other key that does not perform a navigation action will exit this screen{{refsrc|src/detect.c|679|version=NetHack 3.6.7}}{{refsrc|src/detect.c|762|version=NetHack 3.6.7|comment=temporary map navigation}}&mdash;the locations of those objects are recorded when returning to normal play.
 If these location markers disappear once they are in the hero's line of sight, the object in question is either buried, submerged or else has been moved.
@@ Line 24: / Line 27: @@
 ==Variants==
 Some [[variant]]s of ''NetHack'' may add either new forms of object detection or alternate sources of the effect.
 ===UnNetHack===
@@ Line 35: / Line 41: @@
 One of [[Itlachiayaque (xNetHack)|Itlachiayaque's]] invocation effects allows the holder to gaze into it for the same effect as a crystal ball of the same beatitude, akin to [[the Orb of Detection]] (which it replaces as the Archeologist quest artifact).
 ==References==

@@ Line 11: / Line 11: @@
 ** Reading a non-cursed [[scroll of food detection]] will reveal all comestible items on the current level.{{refsrc|src/read.c|1477|nethack=3.6.7|name="food_detect"|comment=both the spell and scroll call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}}{{refsrc|src/detect.c|469|nethack=3.6.7}}{{refsrc|src/detect.c|476|nethack=3.6.7}}{{refsrc|src/detect.c|563-L570|nethack=3.6.7}} Reading a cursed scroll, or being [[confused]] and reading a scroll of any beatitude, will instead reveal all potions on the level.{{refsrc|src/detect.c|461-L463|nethack=3.6.7}}
 ** Casting the {{+ of|detect food}} spell replicates the effects of reading the non-cursed scroll as described above, dependent on the caster's skill level.<ref name="food_detect"/>
-** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally reveal [[Gold (material)|golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}&mdash;reading a non-cursed scroll while confused will detect traps and also appropriately mark them.
+** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally reveal [[Gold (material)|golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces, while a non-cursed scroll that is read while confused will detect traps ''and'' also appropriately mark them.{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}}
 ** If the hero [[applies]] a non-cursed [[crystal ball]] that has charges while they are not [[blind]], and the player selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level.{{refsrc|src/detect.c|1095|version=NetHack 3.6.7|comment=<tt>use_crystal_ball()</tt> function}}{{refsrc|src/detect.c|1102|version=NetHack 3.6.7|name="outlookblank"}}{{refsrc|src/detect.c|1179|version=NetHack 3.6.7}}{{refsrc|src/detect.c|1204-L1213|version=NetHack 3.6.7|comment=calls <tt>monster_detect()</tt> or <tt>object_detect()</tt> as needed}}{{refsrc|src/detect.c|582|version=NetHack 3.6.7|comment=<tt>object_detect()</tt> function}}

@@ Line 5: / Line 5: @@
 Object detection can occur in multiple forms, depending on the source:
-* Quaffing a potion of object detection reveals all items on the current level (including [[buried]] and underwater objects) and [[exercises]] [[wisdom]], with the details and breadth of the detected objects dependent on the potion's beatitude.{{refsrc|src/potion.c|849|version=NetHack 3.6.7|name="peffects"|comment=both potion and spell use the same code}}{{refsrc|src/potion.c|853|version=NetHack 3.6.7}}{{refsrc|src/potion.c|851|version=NetHack 3.6.7|comment=calls <tt>object_detect()</tt> in detect.c}}{{refsrc|src/detect.c|582|version=NetHack 3.6.7|comment=<tt>object_detect()</tt> function}}
+* Quaffing a [[potion of object detection]] reveals all items on the current level (including [[buried]] and underwater objects) and [[exercises]] [[wisdom]], with the details and breadth of the detected objects dependent on the potion's beatitude.{{refsrc|src/potion.c|849|version=NetHack 3.6.7|name="peffects"|comment=both potion and spell use the same code}}{{refsrc|src/potion.c|853|version=NetHack 3.6.7}}{{refsrc|src/potion.c|851|version=NetHack 3.6.7|comment=calls <tt>object_detect()</tt> in detect.c}}{{refsrc|src/detect.c|582|version=NetHack 3.6.7|comment=<tt>object_detect()</tt> function}}
 ** A blessed potion will display detected items that are not in the inventory of a [[monster]] as though the hero has seen them up close when navigating the resulting screen, and will have the appearances of all items in their inventory revealed if applicable (e.g. they are currently [[blind]]){{refsrc|src/detect.c|589|version=NetHack 3.6.7}}{{refsrc|src/detect.c|619|version=NetHack 3.6.7}}{{refsrc|src/detect.c|630|version=NetHack 3.6.7}}{{refsrc|src/detect.c|641|version=NetHack 3.6.7}}{{refsrc|src/detect.c|655|version=NetHack 3.6.7}}&mdash;otherwise, the potion will give a generalized description of the item type for each object if they are not known to the hero. Cursed potions will treat cloaked [[mimic]]s as actual items, with the class of the "item" selected randomly per mimic.{{refsrc|src/detect.c|588|version=NetHack 3.6.7}}{{refsrc|src/detect.c|658|version=NetHack 3.6.7}}{{refsrc|src/detect.c|733|version=NetHack 3.6.7}}
-* [[Casting]] the {{+ of|detect treasure}} spell replicates the effects of quaffing the non-cursed potion as detailed above, dependent on the caster's skill level.<ref name="peffects"/>
+* [[Casting]] the [[spell of detect treasure]] replicates the effects of quaffing the non-cursed potion as detailed above, dependent on the caster's skill level.<ref name="peffects"/>
 * There are also some items that can detect specific object types:
 ** Reading a non-cursed [[scroll of food detection]] will reveal all comestible items on the current level.{{refsrc|src/read.c|1477|nethack=3.6.7|name="food_detect"|comment=both the spell and scroll call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}}{{refsrc|src/detect.c|469|nethack=3.6.7}}{{refsrc|src/detect.c|476|nethack=3.6.7}}{{refsrc|src/detect.c|563-L570|nethack=3.6.7}} Reading a cursed scroll, or being [[confused]] and reading a scroll of any beatitude, will instead reveal all potions on the level.{{refsrc|src/detect.c|461-L463|nethack=3.6.7}}
 ** Casting the {{+ of|detect food}} spell replicates the effects of reading the non-cursed scroll as described above, dependent on the caster's skill level.<ref name="food_detect"/>
-** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level. A blessed scroll will additionally reveal [[Gold (material)|golden]] items (i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring"). A cursed scroll will instead detect [[trap]]s and mark them as gold pieces&mdash;reading a non-cursed scroll while confused will detect traps and also appropriately mark them.
+** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] (and [[gold golem]]s) on the level.{{refsrc|src/read.c|1473|nethack=3.6.7|comment=call <tt>gold_detect()</tt> or <tt>trap_detect()</tt> in detect.c depending on beatitude and status}}{{refsrc|src/detect.c|303|nethack=3.6.7|name="gold_detect"|comment=<tt>gold_detect()</tt> function}}{{refsrc|src/detect.c|316|nethack=3.6.7}}{{refsrc|src/detect.c|319|nethack=3.6.7}}{{refsrc|src/detect.c|326|nethack=3.6.7}}{{refsrc|src/detect.c|341|nethack=3.6.7}} A blessed scroll will additionally reveal [[Gold (material)|golden]] items, i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring".{{refsrc|src/detect.c|328|nethack=3.6.7}}{{refsrc|src/detect.c|342|nethack=3.6.7}} A cursed scroll will instead detect [[trap]]s and mark them as gold pieces{{refsrc|src/detect.c|932|nethack=3.6.7|name="trap_detect"|comment=<tt>trap_detect()</tt> function}}{{refsrc|src/detect.c|899|nethack=3.6.7|comment=<tt>detect_obj_traps()</tt> function}}{{refsrc|src/detect.c|942|nethack=3.6.7}}{{refsrc|src/detect.c|946|nethack=3.6.7}}{{refsrc|src/detect.c|953|nethack=3.6.7}}{{refsrc|src/detect.c|959|nethack=3.6.7}}{{refsrc|src/detect.c|965|nethack=3.6.7}}{{refsrc|src/detect.c|975|nethack=3.6.7}}{{refsrc|src/detect.c|978|nethack=3.6.7}}{{refsrc|src/detect.c|998|nethack=3.6.7}&mdash;reading a non-cursed scroll while confused will detect traps and also appropriately mark them.
-** If the hero [[applies]] a [[crystal ball]] that has charges and selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level.
+** If the hero [[applies]] a non-cursed [[crystal ball]] that has charges while they are not [[blind]], and the player selects the glyph of an object type to look for, successfully passing the [[intelligence]] check will detect all items of that type on the current level.{{refsrc|src/detect.c|1095|version=NetHack 3.6.7|comment=<tt>use_crystal_ball()</tt> function}}{{refsrc|src/detect.c|1102|version=NetHack 3.6.7|name="outlookblank"}}{{refsrc|src/detect.c|1179|version=NetHack 3.6.7}}{{refsrc|src/detect.c|1204-L1213|version=NetHack 3.6.7|comment=calls <tt>monster_detect()</tt> or <tt>object_detect()</tt> as needed}}{{refsrc|src/detect.c|582|version=NetHack 3.6.7|comment=<tt>object_detect()</tt> function}}
-Stale object markings of the applicable type are always cleared when mapping item locations from this effect.{{refsrc|src/detect.c|284|nethack=3.6.7|comment=<tt>clear_stale_map()</tt>}}{{refsrc|src/detect.c|312|nethack=3.6.7|comment=call from <tt>gold_detect()</tt>}}{{refsrc|src/detect.c|465|nethack=3.6.7|comment=call from <tt>food_detect()</tt>}}{{refsrc|src/detect.c|666|nethack=3.6.7|comment=call from <tt>object_detect()</tt> if there were no stale markings to clear}} Floor items are mapped over buried items, items on the top of piles are mapped over the rest of the pile, and the first item in a monster's inventory is mapped over any items they are standing on.{{refsrc|src/detect.c|608|version=NetHack 3.6.7}}{{refsrc|src/detect.c|648|version=NetHack 3.6.7}}{{refsrc|src/detect.c|683|version=NetHack 3.6.7}}{{refsrc|src/detect.c|702|version=NetHack 3.6.7}}{{refsrc|src/detect.c|719|version=NetHack 3.6.7}}{{refsrc|src/detect.c|744|version=NetHack 3.6.7}} The hero can navigate the resulting screen from quaffing the potion by moving their cursor to highlight particular objects, and any other key that does not perform a navigation action will exit this screen{{refsrc|src/detect.c|679|version=NetHack 3.6.7}}{{refsrc|src/detect.c|762|version=NetHack 3.6.7|comment=temporary map navigation}}&mdash;the locations of those objects are recorded when returning to normal play.
+===Detection maps===
 ==History==
-Object detection is introduced with the potion of object detection in Hack 1.21, Hack for PDP-11 and PC/IX Hack, which are all based on [[Jay Fenlason's Hack]]. The potion is included in the initial item list for [[Hack 1.0]], along with the then-new scroll of food detection&mdash;their spell equivalents are introduced in [[NetHack 1.3d]].
+Object detection is introduced with the potion of object detection in Hack 1.21, Hack for PDP-11 and PC/IX Hack, which are all based on [[Jay Fenlason's Hack]]&mdash;the scroll of gold detection is also present in Hack 1.21 and Hack for PDP-11. Both items are included in the initial item list for [[Hack 1.0]], along with the then-new scroll of food detection&mdash;the spell equivalents for object detection and food detection are introduced in [[NetHack 1.3d]].
 ==Variants==
 ===UnNetHack===
 In [[UnNetHack]], [[reading]] the blessed [[scroll of magic mapping]] reveals the location of objects similar to an uncursed potion of object detection.
 ===dNetHack===
-In [[dNetHack]], [[notdNetHack]] and [[notnotdNetHack]], [[invoking]] [[The Marauder's Map (dNetHack)|The Marauder's Map]] detects objects identically to a potion of the same beatitude as the [[artifact]], then detects other artifacts on the level, mapping them over existing marked objects if necessary.
+In [[dNetHack]], [[notdNetHack]] and [[notnotdNetHack]], [[invoking]] [[The Marauder's Map (dNetHack)|The Marauder's Map]] detects objects identically to a potion of the same beatitude as the [[artifact]], and then detects other artifacts on the level, mapping them over existing marked objects if necessary.
 ==References==
 <references/>
 {{nethack-367}}
 [[Category:Properties]]

@@ Line 9: / Line 9: @@
 * Casting the {{+ of|detect treasure}} spell replicates the effects of quaffing the non-cursed potion as detailed above.<ref name="peffects"/>
 * There are also some items that can detect specific object types:
-** Reading a non-cursed [[scroll of food detection]] will reveal all comestible items on the current level.{{refsrc|src/read.c|1479|nethack=3.6.7|comment=call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}}{{refsrc|src/read.c|1479|nethack=3.6.7|comment=call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}} Reading a cursed scroll, or being [[confused]] and reading a scroll of any beatitude, will instead reveal all potions on the level.{{refsrc|src/detect.c|461-L463|nethack=3.6.7}}
+** Reading a non-cursed [[scroll of food detection]] will reveal all comestible items on the current level.{{refsrc|src/read.c|1477|nethack=3.6.7|name="food_detect"|comment=both the spell and scroll call <tt>food_detect</tt> in detect.c}}{{refsrc|src/detect.c|455|nethack=3.6.7|comment=<tt>food_detect</tt> function}} Reading a cursed scroll, or being [[confused]] and reading a scroll of any beatitude, will instead reveal all potions on the level.{{refsrc|src/detect.c|461-L463|nethack=3.6.7}}
 ** Casting the {{+ of|detect food}} spell behaves much like the effects of reading the scroll does, minus any ability to detect potions.
 ** Reading a non-cursed [[scroll of gold detection]] will reveal the current location of all [[gold pieces]] and ([[gold golem]]s) on the level. A blessed scroll will additionally reveal [[Gold (material)|golden]] items (i.e. the [[Candelabrum of Invocation]] and [[ring]]s that have the appearance of a "gold ring"). A cursed scroll will instead detect [[trap]]s and mark them as gold pieces&mdash;reading a non-cursed scroll while confused will detect traps and also appropriately mark them.