Autopickup exception - Revision history

Umbire the Phantom: /* Corpses */ potholes, rephrase

2023-07-13T15:34:43Z

‎Corpses: potholes, rephrase

Infinigon: move "things too good to miss" higher up in the page... so people don't miss it

2021-01-13T22:20:17Z

move "things too good to miss" higher up in the page... so people don't miss it

Infinigon: move the config suggestion under strategy, and rephrase the intro a little

2021-01-13T22:19:01Z

move the config suggestion under strategy, and rephrase the intro a little

Infinigon: copyediting and fix some broken regexes

2021-01-13T21:59:03Z

copyediting and fix some broken regexes

Infinigon: link to wikipedia regex

2021-01-13T21:43:21Z

link to wikipedia regex

Hackerb9: grammar cleanup

2020-04-10T02:09:54Z

grammar cleanup

Vivit: /* Syntax */

2020-01-31T17:32:06Z

‎Syntax

Vivit: /* How to use it effectively */

2020-01-29T21:23:15Z

‎How to use it effectively

Vivit: /* Syntax */

2020-01-29T21:22:52Z

‎Syntax

Vivit: /* One of each kind of magical object */

2020-01-29T21:18:33Z

‎One of each kind of magical object

@@ Line 47: / Line 47: @@
 ===Corpses===
-The [[comestible]] item class includes [[food]], which you may well want to autopickup, but also [[corpses]], most of which are worthless, prohibitively heavy, and in the case of [[cockatrice]] and [[chickatrice]] corpses, extremely dangerous. If you want to pick up food, but not corpses, include <tt>%</tt> in your pickup_types and then add the following exception:
+The [[comestible]] item class includes [[food]], which you may well want to autopickup, but also includes [[corpses]], most of which are not worth carrying around - some corpses are also prohibitively heavy and, in the case of [[cockatrice]] and [[chickatrice]] corpses, extremely dangerous. If you want to pick up food, but not corpses, include <tt>%</tt> in your pickup_types and then add the following exception:
   AUTOPICKUP_EXCEPTION="> corpse"
-Corpses you ''will'' want to pick up include [[lichen]] and [[lizard]]s, which do not decay and the latter of which is invaluable in [[stoning|certain emergencies]].  You may also want to grab [[newts]], [[floating eyes]], and [[wraiths]], which are lightweight and have beneficial effects when eaten. If you want to pick up these, add the following lines beneath the corpse rule:
+Corpses you ''will'' want to pick up include [[lichen]] and [[lizard]]s, which do not decay and the latter of which is invaluable in [[stoning|certain emergencies]].  You may also want to grab [[newt]]s, [[floating eye]]s, and [[wraith]]s, which are lightweight and have beneficial effects when eaten. If you want to pick up these, add the following lines beneath the corpse rule:
   AUTOPICKUP_EXCEPTION="<lichen corpse"
   AUTOPICKUP_EXCEPTION="<lizard corpse"

@@ Line 56: / Line 56: @@
   AUTOPICKUP_EXCEPTION="<floating eye corpse"
   AUTOPICKUP_EXCEPTION="<wraith corpse"
 ===Define pickup / drop in-game===
@@ Line 130: / Line 150: @@
   AUTOPICKUP_EXCEPTION="<knife"
 ===Avoiding loadstones===

@@ Line 1: / Line 1: @@
 {{Tocright}}
-'''AUTOPICKUP_EXCEPTION''' is a configuration option that allows you to define what items are automatically picked up, with more precision than [[pickup_types]] gives. You also need to have [[autopickup]] on and [[pickup_types]] match the AUTOPICKUP_EXCEPTION -lines. Highly recommended — but not necessary — is adapting [[pickup_burden]].
+'''AUTOPICKUP_EXCEPTION''' is a configuration option that allows you to define what items are automatically picked up, based on the name of the item. This gives more precision on top of [[pickup_types]]. You need to have [[autopickup]] on for autopickup exceptions to be active.
- OPTIONS=autopickup
+In NetHack 3.6 autopickup exceptions are [[Compile-time options#AUTOPICKUP_EXCEPTIONS|compiled in by default]]. The [[Nethack.alt.org#NetHack 3.4.3 NAO|NAO version of NetHack 3.4.3]] has them as well.
 ==Syntax==
@@ Line 13: / Line 9: @@
 The regular expression is matched against the singular form of the name of the item, plus any preceding article or number: "a gold piece" matches a single gold piece, "2 gold piece" matches a stack of 2 gold pieces, but "2 gold pieces" would match nothing.{{reffunc|objnam.c|makesingular}} Any "called ..." or "named ..." suffixes added with the [[Name|#name]] command ''are'' included, so take note of your own naming habits and write your autopickup exceptions accordingly.
-As of version [[3.6.4]], autopickup exceptions override one another sequentially the same way menucolors and msgtypes do, with rules specified further down in the config file taking precedence over those specified earlier, and rules specified during play via the {{kbd|O}} command taking precedence over everything. Order is all that matters; neither <tt><</tt> nor <tt>></tt> takes precedence over the other. [[Pickup_types]] is consulted if and only if no matching rule is found.
+As of version [[3.6.4]], autopickup exceptions override one another sequentially the same way [[menucolors]] and [[MSGTYPE]]s do, with rules specified later in the config file taking precedence over those specified earlier, and rules specified during play via the {{kbd|O}} command taking precedence over everything. Order is all that matters; neither <tt><</tt> nor <tt>></tt> takes precedence over the other. [[Pickup_types]] is consulted if and only if no matching rule is found.
-In the [[configuration file]], exceptions are specified by the string <tt>AUTOPICKUP_EXCEPTION=</tt> followed by the rule enclosed in quotes. When adding an exception via the {{kbd|O}} command, you're just prompted for the rule.
+In the [[configuration file]], exceptions are specified by the string <tt>AUTOPICKUP_EXCEPTION=</tt> followed by the rule enclosed in double quotes. When adding an exception via the {{kbd|O}} command, you're just prompted for the rule without quotes.
 ==Strategy==
@@ Line 23: / Line 19: @@
 ===Suggested rules===
 Individually #[[name]] the real [[Amulet of Yendor]] right away and you'll never fall for a [[Cheap plastic imitation of the Amulet of Yendor|fake]]:
   AUTOPICKUP_EXCEPTION=">Amulet of Yendor"

@@ Line 17: / Line 17: @@
 In the [[configuration file]], exceptions are specified by the string <tt>AUTOPICKUP_EXCEPTION=</tt> followed by the rule enclosed in quotes. When adding an exception via the {{kbd|O}} command, you're just prompted for the rule.
-==Effective use==
+==Strategy==
 Autopickup exceptions can greatly simplify dungeon exploration. You can use them to keep dangerous items out of monsters' hands, to conveniently sort through large piles of loot, to automate things you might forget, to save a turn when fleeing or on [[speed run]]s, to remove good morphs from your [[polypiling]] line without paying attention, etc.
 Some items, such as [[gold]], are useful only in the early game. You can add and remove rules in-game with the {{kbd|O}} command, though the settings will revert the next time you run the program. If your needs change much over the course of a long game, the easiest way to update the exceptions is to comment or uncomment the lines in your [[nethackrc]], [[save]] the game, and restore. You can also use [[pickup_types]] as an in-game switch to distinguish between early-game and late-game configurations by simply not mentioning items you want to default to [[pickup_types]].
-===Easy ones===
+===Suggested rules===
-Individually-name the real Amulet right away and you'll never fall for a fake:
+Individually #[[name]] the real [[Amulet of Yendor]] right away and you'll never fall for a [[Cheap plastic imitation of the Amulet of Yendor|fake]]:
   AUTOPICKUP_EXCEPTION=">Amulet of Yendor"
   AUTOPICKUP_EXCEPTION="<Amulet of Yendor named"
-Avoid turning your scrolls of scare monster to dust:
+Avoid turning your [[Scroll of scare monster|scrolls of scare monster]] to dust:
   AUTOPICKUP_EXCEPTION=">scroll .* scare monster"
 Walk in peace over empty wands and [[wand of nothing|wands of nothing]]:
-  AUTOPICKUP_EXCEPTION=":0¥)"
+  AUTOPICKUP_EXCEPTION=">:0)"
   AUTOPICKUP_EXCEPTION="> named empty"
   AUTOPICKUP_EXCEPTION="> nothing"
-Good [[monster starting inventory|items left after a fight]] that careful weight watching:
+Good [[monster starting inventory|items left after a fight]], but requires careful weight watching:
   # AUTOPICKUP_EXCEPTION="<potion .* healing"
   # AUTOPICKUP_EXCEPTION="<potion .* gain level"
 Pick up formally [[identified]] artifacts. Don't blast yourself to death with a cross-aligned one — leave unidentified ones on the floor:
-  AUTOPICKUP_EXCEPTION="<[^| ]the "
+  AUTOPICKUP_EXCEPTION="<^the "
 Some people also want known-blessed items, though this likely picks up too much:
-  #  AUTOPICKUP_EXCEPTION="<blessed"
+  #  AUTOPICKUP_EXCEPTION="< blessed "
 ===Corpses===
@@ Line 69: / Line 68: @@
 Usually, you need only one of each type of magical armor / ring / amulet / spellbook / magical tool. Wouldn't it be nice if the game managed that for you? It can if you're willing to class-name all objects immediately.
-Below are the rules for armor. You could call the mine town watchmens' helmets "plain", turning it from its name from its unidentified description to "a helmet called plain" and removing it from the pickup list. See [[User:Tjr|Tjr]]'s [http://alt.org/nethack/userdata/tjr2/tjr2.nh343rc config] for other item types, although it needs to be updated for Nethack 3.6 regex format.
+Below are the rules for armor. You could call the Minetown watchmen's helmets "plain", turning it from its name from its unidentified description to "a helmet called plain" and removing it from the pickup list. See [[User:Tjr|Tjr]]'s [http://alt.org/nethack/userdata/tjr2/tjr2.nh343rc config] for other item types, although it needs to be updated for NetHack 3.6 regex format.
   # AUTOPICKUP_EXCEPTION="<robe"
@@ Line 180: / Line 179: @@
 {{featured}}
 [[Category:Options]]
-{{nethack-360|offset=1}}
+{{nethack-366|offset=1}}

@@ Line 9: / Line 9: @@
 ==Syntax==
-An autopickup exception rule is expressed as either a <tt><</tt> or a <tt>></tt>, followed by a [[regular expression]]. The leading character determines whether items whose names match the regular expression are picked up: a <tt><</tt> rule flags the matched item for pickup, while a <tt>></tt> rule ignores the matched item.
+An autopickup exception rule is expressed as either a <tt><</tt> or a <tt>></tt>, followed by a [[wikipedia:Regular expression|regular expression]]. The leading character determines whether items whose names match the regular expression are picked up: a <tt><</tt> rule flags the matched item for pickup, while a <tt>></tt> rule ignores the matched item.
 The regular expression is matched against the singular form of the name of the item, plus any preceding article or number: "a gold piece" matches a single gold piece, "2 gold piece" matches a stack of 2 gold pieces, but "2 gold pieces" would match nothing.{{reffunc|objnam.c|makesingular}} Any "called ..." or "named ..." suffixes added with the [[Name|#name]] command ''are'' included, so take note of your own naming habits and write your autopickup exceptions accordingly.

@@ Line 74: / Line 74: @@
   # AUTOPICKUP_EXCEPTION="<polished silver shield"
   # AUTOPICKUP_EXCEPTION="<smooth shield" # blind description
-−
   AUTOPICKUP_EXCEPTION=">helmet"
   AUTOPICKUP_EXCEPTION="<conical hat"