Options - Revision history

Joes: copy 38 new options from v5 Guidebook

2026-05-20T15:31:36Z

copy 38 new options from v5 Guidebook

2026-01-20T18:03:29Z

3.7: add many new options, enough to break this into sections

2026-01-20T17:44:14Z

‎menu_objsyms: 3.7: expansion of this option into a compound

2026-01-20T13:53:02Z

‎menu_headings: 3.7: can now specify color in this option

2025-05-03T09:41:20Z

‎pickup_burden: refsrc

2025-05-03T09:40:24Z

‎altmeta: copyedit

2025-04-30T21:10:35Z

‎fixinv: The "false" behavior is more significant than what the article implied.

2025-03-10T09:46:03Z

‎scores: own scores

2024-12-28T02:04:48Z

‎pauper: fix this not being marked as upcoming

2024-12-28T02:03:58Z

3.7: Add tips option

@@ Line 674: / Line 674: @@
 {{upcoming|NetHack 3.7.0|This options list should be compared with the guidebook for any added or removed options; this box is not a comprehensive summary.
-* There is now a "mention_map" option, which prints messages when the hero notices a change to or discovers a new interesting map location (terrain types that are not stone, walls, or normal floor). It is primarily for accessibility.
-* There are a pair of options "showvers" and "versinfo", which can be used to show the game's name, version, and development branch on the [[status line]]; recommended for streaming or taking screenshots.
+Many new accessibility options (some of which may be useful for general use):
-* There is now a "showdamage" option, which shows the amount of HP you just lost and how much is left, for accessibility.
+* "accessiblemsg", which defaults to off. When on, it provides supplemental direction information to messages, such as "(northwest) You find a hidden door."
-* There is now a "customcolors" option, which somehow allows you to assign custom colors to glyphs.
+* "mention_map", which prints messages when the hero notices a change to or discovers a new interesting map location (terrain types that are not stone, walls, or normal floor). Can be combined with accessiblemsg.
 }}

@@ Line 287: / Line 287: @@
 ===menu_objsyms===
 Show object symbols in menu headings in menus where the object symbols act as menu accelerators. Boolean option, defaults to FALSE.
 ===menu_overlay===

@@ Line 270: / Line 270: @@
 ===menu_headings===
 Controls how the headings in a menu are highlighted. Compound option, with possible values of <tt>none</tt>, <tt>bold</tt>, <tt>dim</tt>, <tt>underline</tt>, <tt>blink</tt>, or <tt>inverse</tt>. Not all ports can actually display all types.
 ===menu_invert_all===

@@ Line 439: / Line 439: @@
 ===pickup_burden===
-Prompt for confirmation before picking up items that will push the character's [[encumbrance]] past a given level -- <tt>Unencumbered</tt>, <tt>Burdened</tt>, <tt>streSsed</tt>, <tt>straiNed</tt>, <tt>Overtaxed</tt>, or <tt>overLoaded</tt>. This will '''not''' prompt the player when picking up a [[loadstone]].{{refsrc|src/pickup.c|1404|version=NetHack 3.6.6}} Defaults to <tt>S</tt>. Persistent.
+Prompt for confirmation before picking up items that will push the character's [[encumbrance]] past a given level -- <tt>Unencumbered</tt>, <tt>Burdened</tt>, <tt>streSsed</tt>, <tt>straiNed</tt>, <tt>Overtaxed</tt>, or <tt>overLoaded</tt>. This will '''not''' prompt the player when picking up a [[loadstone]].{{refsrc|src/pickup.c|1404|version=NetHack 3.6.7}} Defaults to <tt>S</tt>. Persistent.
 ===pickup_thrown===

@@ Line 819: / Line 819: @@
 ===altmeta===
-Enables [[extended command]] shortcuts, such as {{kbd|alt|d}} to [[dip]].<ref name="unixesc">{{kbd|esc}} followed by {{kbd|d}} on unix systems also works</ref> Boolean option, default is off, except on Amiga. Can be set in-game. Is saved into the savefile.{{refsrc|src/options.c|54|nethack=3.6.0}}
+Enables [[extended command]] shortcuts, such as {{kbd|alt|d}} (or {{kbd|esc}} followed by {{kbd|d}} on unix systems) to [[dip]]. Boolean option, default is off, except on Amiga.{{refsrc|src/options.c|63|nethack=3.6.7}} Can be set in-game. Is saved into the savefile.{{refsrc|src/options.c|69|nethack=3.6.7}}
 ===BIOS===

@@ Line 168: / Line 168: @@
 ===fixinv===
-An object's inventory letter sticks to it when it's dropped, so when you pick it up again, it will have the same inventory letter, unless there is already another item in your inventory using that letter. Boolean option, defaults to TRUE. Can be set in-game. Persistent.
+If true, items in the inventory will keep their assigned letters. Dropped or thrown items will be given their old letter on pickup if possible. If false, removing an item from the inventory will reassign the inventory letters to remove any gaps. Boolean option, defaults to TRUE. Can be set in-game. Persistent.
 ===force_invmenu===

@@ Line 501: / Line 501: @@
 ===scores===
 Control what part of hiscore list to show at the end of game. Compound option. Can be set in-game. Persistent. Accept the following options, separated by spaces:
-*<tt>o</tt> - show my own score. Can be prefixed with <tt>!</tt> to not show own score.
+*<tt>o</tt> - show all own scores (user ID or character name depending on [[Sysconf#PERS_IS_UID|PERS_IS_UID]]). Can be prefixed with <tt>!</tt> to not show own scores.
-*<tt>Xa</tt> - show X scores around own score
+*<tt>Xa</tt> - show X scores around the current score.
-*<tt>Xt</tt> - show X scores from the top
+*<tt>Xt</tt> - show X scores from the top.
 For example:
   OPTIONS=scores:10t 2a o

@@ Line 428: / Line 428: @@
 ===pauper===
-{{main|Pauper}}
+{{upcoming|NetHack 3.7.0|{{main|Pauper}}
-Start the character with no items, skills, spells, or (most) discoveries. Boolean option, defaults to FALSE. Persistent.
+Start the character with no items, skills, spells, or (most) discoveries. Boolean option, defaults to FALSE. Persistent.}}
 ===perm_invent===

← Older revision		Revision as of 02:03, 28 December 2024
Line 595:		Line 595:

	Boolean option, defaults to TRUE if configured into the program. Can be set in-game. Persistent.		Boolean option, defaults to TRUE if configured into the program. Can be set in-game. Persistent.
		+
		+	===tips===
		+
		+	{{upcoming\|NetHack 3.7.0\|Display tips aimed at helping newer players figure out non-obvious interface actions in several scenarios: enhancing a skill after gaining enough training, using 'm' to step into liquid, how to interact with a getpos prompt, and a few more.
		+
		+	Boolean option, defaults to TRUE. Can be set in-game. Persistent.}}

	===tombstone===		===tombstone===