From 57dc8891d6d9263dab176053dd4dbcda832e856d Mon Sep 17 00:00:00 2001 From: nhmall Date: Tue, 27 Dec 2022 21:03:41 -0500 Subject: [PATCH] Guidebook datestamp --- doc/Guidebook.mn | 2 +- doc/Guidebook.tex | 2 +- doc/Guidebook.txt | 2144 ++++++++++++++++++++++----------------------- 3 files changed, 1074 insertions(+), 1074 deletions(-) diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn index eb7bab4d6..ee5694cbc 100644 --- a/doc/Guidebook.mn +++ b/doc/Guidebook.mn @@ -37,7 +37,7 @@ .ds f0 "\*(vr .ds f1 .\"DO NOT REMOVE NH_DATESUB .ds f2 "DATE(%B %-d, %Y) -.ds f2 "December 24, 2022 +.ds f2 "December 26, 2022 . .\" A note on some special characters: .\" \(lq = left double quote diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex index 0708fbed9..98e134d03 100644 --- a/doc/Guidebook.tex +++ b/doc/Guidebook.tex @@ -46,7 +46,7 @@ \author{Original version - Eric S. Raymond\\ (Edited and expanded for 3.7 by Mike Stephenson and others)} %DO NOT REMOVE NH_DATESUB \date{DATE(%B %-d, %Y)} -\date{December 24, 2022} +\date{December 26, 2022} \maketitle diff --git a/doc/Guidebook.txt b/doc/Guidebook.txt index e9dbed752..df4ae6f44 100644 --- a/doc/Guidebook.txt +++ b/doc/Guidebook.txt @@ -15,7 +15,7 @@ Original version - Eric S. Raymond (Edited and expanded for 3.7 by Mike Stephenson and others) - December 24, 2022 + December 26, 2022 @@ -126,7 +126,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -192,7 +192,7 @@ you have seen on the current dungeon level; as you explore more - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -258,7 +258,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -324,7 +324,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -390,7 +390,7 @@ you have available for spell casting. Again, resting will - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -456,7 +456,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -522,7 +522,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -588,7 +588,7 @@ ing a `*' lists your entire inventory, so you can see the - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -654,7 +654,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -720,7 +720,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -786,7 +786,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -852,7 +852,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -918,7 +918,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -984,7 +984,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1050,7 +1050,7 @@ for which one to take off. (Note that this treats a cloak - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1116,7 +1116,7 @@ that redundant, such as Caveman or Priestess), and - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1182,7 +1182,7 @@ (R)UNIX is a registered trademark of The Open Group. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1248,7 +1248,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1314,7 +1314,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1380,7 +1380,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1446,7 +1446,7 @@ Jump to another location. Autocompletes. Default key is - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1512,7 +1512,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1578,7 +1578,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1644,7 +1644,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1710,7 +1710,7 @@ Do a shell escape, switching from NetHack to a subprocess. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1776,7 +1776,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1842,7 +1842,7 @@ - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1859,13 +1859,15 @@ killed by traps and each other as well as by you, and omits any which got removed from the game without being killed (perhaps by genocide, or by a mollified shopkeeper dismiss- - ing summoned Kops). + ing summoned Kops) or were already corpses when placed on + the map. - Using the "request menu" prefix prior to #vanquished brings - up a menu of sorting orders available. Whichever one is - picked is remembered for subsequent #vanquished commands - during the current play session but not saved and restored - across sessions. During end-of-game disclosure, when asked + Using the "request menu" prefix prior to #vanquished brings + up a menu of sorting orders available (provided that the + vanquished monsters list contains at least two types of mon- + sters). Whichever ordering is picked gets assigned to the + sortvanquished option so is remembered for subsequent #van- + quished requests. During end-of-game disclosure, when asked whether to show vanquished monsters answering `a' will let you choose from the sort menu. @@ -1903,12 +1905,10 @@ Show what type of thing a symbol corresponds to. Default key is `/'. - #wield - Wield a weapon. Default key is `w'. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1918,6 +1918,9 @@ + #wield + Wield a weapon. Default key is `w'. + #wipe Wipe off your face. Autocompletes. Default key is `M-w'. @@ -1968,13 +1971,10 @@ Verify rumor boundaries by displaying first and last true rumors and first and last false rumors. - Also displays first, second, and last random engravings, - epitaphs, and hallucinatory monsters. - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -1984,6 +1984,9 @@ + Also displays first, second, and last random engravings, + epitaphs, and hallucinatory monsters. + Autocompletes. Debug mode only. #wizseenv @@ -2035,12 +2038,9 @@ M-? #? (not supported by all platforms) - M-2 #twoweapon (unless the number_pad option is enabled) - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2050,6 +2050,8 @@ + M-2 #twoweapon (unless the number_pad option is enabled) + M-a #adjust M-A #annotate @@ -2102,11 +2104,9 @@ - If the number_pad option is on, some additional letter com- - mands are available: - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2116,6 +2116,9 @@ + If the number_pad option is on, some additional letter com- + mands are available: + h #help j #jump @@ -2167,12 +2170,9 @@ if you attempt to open (via `o' or autoopen) a locked door while carrying an unlocking tool, you'll be asked whether to use it on the door's lock. Alternatively, you can break a closed door - (whether locked or not) down by kicking it via the `^D' (kick) - command. Kicking down a door destroys it and makes a lot of - noise which might wake sleeping monsters. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2182,6 +2182,10 @@ + (whether locked or not) down by kicking it via the `^D' (kick) + command. Kicking down a door destroys it and makes a lot of + noise which might wake sleeping monsters. + Some closed doors are booby-trapped and will explode if an attempt is made to open (when unlocked) or unlock (when locked) or kick down. Like kicking, an explosion destroys the door and @@ -2232,13 +2236,9 @@ Other traps can send you to different locations. Tele- porters send you elsewhere on the same dungeon level. Level teleporters send you to a random dungeon level, the destination - chosen from a few levels lower all the way to the top. These - traps choose a new destination each time they're activated. Trap - doors and holes also send you to another level, but one which is - always below the current level. Usually that will be the next - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2248,6 +2248,10 @@ + chosen from a few levels lower all the way to the top. These + traps choose a new destination each time they're activated. Trap + doors and holes also send you to another level, but one which is + always below the current level. Usually that will be the next level down but it can be farther. Unlike (level) teleporters, the destination level of a particular trap door or hole is per- sistent, so falling into one will bring you to the same level @@ -2298,13 +2302,9 @@ choose to do so), you'll need to climb back up to the main dun- geon. - When you traverse a set of stairs, or trigger a trap which - sends you to another level, the level you're leaving will be de- - activated and stored in a file on disk. If you're moving to a - previously visited level, it will be loaded from its file on disk - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2314,6 +2314,10 @@ + When you traverse a set of stairs, or trigger a trap which + sends you to another level, the level you're leaving will be de- + activated and stored in a file on disk. If you're moving to a + previously visited level, it will be loaded from its file on disk and reactivated. If you're moving to a level which has not yet been visited, it will be created (from scratch for most random levels, from a template for some "special" levels, or loaded from @@ -2364,13 +2368,9 @@ The `$' command, which reports the amount of gold you are carrying, will also show current shop debt or credit, if any. - The "Iu" command lists unpaid items (those which still belong to - the shop) if you are carrying any. The "Ix" command shows an in- - ventory-like display of any unpaid items which have been used up, - along with other shop fees, if any. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2380,6 +2380,11 @@ + The "Iu" command lists unpaid items (those which still belong to + the shop) if you are carrying any. The "Ix" command shows an in- + ventory-like display of any unpaid items which have been used up, + along with other shop fees, if any. + 5.4.1. Shop idiosyncrasies Several aspects of shop behavior might be unexpected. @@ -2429,14 +2434,9 @@ drawn on the map). This option also gives feedback when rushing or running stops for some non-obvious reason. - The mention_decor option controls whether you get feedback - when walking on "furniture." Normally stepping onto stairs or a - fountain or an altar or various other things doesn't elicit any- - thing unless it is covered by one or more objects so is obscured - on the map. Setting this option to true will describe such - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2446,6 +2446,11 @@ + The mention_decor option controls whether you get feedback + when walking on "furniture." Normally stepping onto stairs or a + fountain or an altar or various other things doesn't elicit any- + thing unless it is covered by one or more objects so is obscured + on the map. Setting this option to true will describe such things even when they aren't obscured. Doorless doorways and open doors aren't considered worthy of mention; closed doors (if you can move onto their spots) and broken doors are. Assuming @@ -2493,16 +2498,11 @@ The slight strangeness of this level is a feature, not a bug.... - 6. Monsters - - Monsters you cannot see are not displayed on the screen. - Beware! You may suddenly come upon one in a dark place. Some - magic items can help you locate them before they locate you - (which some monsters can do very well). - NetHack 3.7 December 24, 2022 + + NetHack 3.7 December 26, 2022 @@ -2512,6 +2512,13 @@ + 6. Monsters + + Monsters you cannot see are not displayed on the screen. + Beware! You may suddenly come upon one in a dark place. Some + magic items can help you locate them before they locate you + (which some monsters can do very well). + The commands `/' and `;' may be used to obtain information about those monsters who are displayed on the screen. The com- mand "#name" (by default bound to `C'), allows you to assign a @@ -2560,15 +2567,8 @@ feed it, too, by throwing it food. A properly trained pet can be very useful under certain circumstances. - Your pet also gains experience from killing monsters, and - can grow over time, gaining hit points and doing more damage. - Initially, your pet may even be better at killing things than - you, which makes pets useful for low-level characters. - - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2578,6 +2578,11 @@ + Your pet also gains experience from killing monsters, and + can grow over time, gaining hit points and doing more damage. + Initially, your pet may even be better at killing things than + you, which makes pets useful for low-level characters. + Your pet will follow you up and down staircases if it is next to you when you move. Otherwise your pet will be stranded and may become wild. Similarly, when you trigger certain types @@ -2628,13 +2633,8 @@ more will result in it disappearing from your map, similarly if it is the one who moved rather than you. - However, if you encounter a monster which you can't see or - sense--perhaps it is invisible and has just tapped you on the - noggin--a special "remembered, unseen monster" marker will be - displayed at the location where you think it is. That will - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2644,10 +2644,14 @@ - persist until you have proven that there is no monster there, - even if the unseen monster moves to another location or you move - to a spot where the marker's location ordinarily wouldn't be seen - any more. + However, if you encounter a monster which you can't see or + sense--perhaps it is invisible and has just tapped you on the + noggin--a special "remembered, unseen monster" marker will be + displayed at the location where you think it is. That will per- + sist until you have proven that there is no monster there, even + if the unseen monster moves to another location or you move to a + spot where the marker's location ordinarily wouldn't be seen any + more. 7. Objects @@ -2694,13 +2698,9 @@ When you use one of these objects, if its effect is obvious, NetHack will remember what it is for you. If its effect isn't extremely obvious, you will be asked what you want to call this - type of object so you will recognize it later. You can also use - the "#name" command, for the same purpose at any time, to name - all objects of a particular type or just an individual object. - When you use "#name" on an object which has already been named, - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2710,6 +2710,10 @@ + type of object so you will recognize it later. You can also use + the "#name" command, for the same purpose at any time, to name + all objects of a particular type or just an individual object. + When you use "#name" on an object which has already been named, specifying a space as the value will remove the prior name in- stead of assigning a new one. @@ -2757,16 +2761,12 @@ or "BUCX" for Blessed, Uncursed, Cursed, or unknown. (The term beatitude is occasionally used as well.) - 7.2. Weapons (`)') - - Given a chance, most monsters in the Mazes of Menace will - gratuitously try to kill you. You need weapons for self-defense - (killing them first). Without a weapon, you do only 1-2 hit - points of damage (plus bonuses, if any). Monk characters are an - exception; they normally do more damage with bare (or gloved) - NetHack 3.7 December 24, 2022 + + + + NetHack 3.7 December 26, 2022 @@ -2776,6 +2776,13 @@ + 7.2. Weapons (`)') + + Given a chance, most monsters in the Mazes of Menace will + gratuitously try to kill you. You need weapons for self-defense + (killing them first). Without a weapon, you do only 1-2 hit + points of damage (plus bonuses, if any). Monk characters are an + exception; they normally do more damage with bare (or gloved) hands than they do with weapons. There are wielded weapons, like maces and swords, and thrown @@ -2823,16 +2830,9 @@ that each weapon which existed in AD&D does roughly the same dam- age to monsters in NetHack. Some of the more obscure weapons (such as the aklys, lucern hammer, and bec-de-corbin) are defined - in an appendix to Unearthed Arcana, an AD&D supplement. - - The commands to use weapons are `w' (wield), `t' (throw), - `f' (fire), `Q' (quiver), `x' (exchange), `X' (twoweapon), and - "#enhance" (see below). - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2842,6 +2842,12 @@ + in an appendix to Unearthed Arcana, an AD&D supplement. + + The commands to use weapons are `w' (wield), `t' (throw), + `f' (fire), `Q' (quiver), `x' (exchange), `X' (twoweapon), and + "#enhance" (see below). + 7.2.1. Throwing and shooting You can throw just about anything via the `t' command. It @@ -2890,15 +2896,9 @@ using a numeric prefix before the `t' or `f' command. For exam- ple, "2f" (or "n2f" if using number_pad mode) would ensure that at most 2 arrows are shot even if you could have fired 3. If you - specify a larger number than would have been shot ("4f" in this - example), you'll just end up shooting the same number (3, here) - as if no limit had been specified. Once the volley is in motion, - all of the items will travel in the same direction; if the first - ones kill a monster, the others can still continue beyond that - spot. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2908,6 +2908,13 @@ + specify a larger number than would have been shot ("4f" in this + example), you'll just end up shooting the same number (3, here) + as if no limit had been specified. Once the volley is in motion, + all of the items will travel in the same direction; if the first + ones kill a monster, the others can still continue beyond that + spot. + 7.2.2. Weapon proficiency You will have varying degrees of skill in the weapons avail- @@ -2954,17 +2961,10 @@ Some characters can use two weapons at once. Setting things up to do so can seem cumbersome but becomes second nature with - use. To wield two weapons, you need to use the "#twoweapon" com- - mand. But first you need to have a weapon in each hand. (Note - that your two weapons are not fully equal; the one in the hand - you normally wield with is considered primary and the other one - is considered secondary. The most noticeable difference is after - you stop--or before you begin, for that matter--wielding two - weapons at once. The primary is your wielded weapon and the sec- - ondary is just an item in your inventory that's been designated + use. To wield two weapons, you need to use the "#twoweapon" - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -2974,7 +2974,14 @@ - as alternate weapon.) + command. But first you need to have a weapon in each hand. + (Note that your two weapons are not fully equal; the one in the + hand you normally wield with is considered primary and the other + one is considered secondary. The most noticeable difference is + after you stop--or before you begin, for that matter--wielding + two weapons at once. The primary is your wielded weapon and the + secondary is just an item in your inventory that's been designat- + ed as alternate weapon.) If your primary weapon is wielded but your off hand is empty or has the wrong weapon, use the sequence `x', `w', `x' to first @@ -3020,17 +3027,10 @@ Ring mail, Studded leather armor, Dragon scales 7 Leather armor, Orcish ring mail 8 - Leather jacket 9 - none 10 - - You can also wear other pieces of armor (cloak over suit, - shirt under suit, helmet, gloves, boots, shield) to lower your - armor class even further. Most of these provide a one or two - point improvement to AC (making the overall value smaller and - eventually negative) but can also be enchanted. Shirts are an - NetHack 3.7 December 24, 2022 + + NetHack 3.7 December 26, 2022 @@ -3040,6 +3040,14 @@ + Leather jacket 9 + none 10 + + You can also wear other pieces of armor (cloak over suit, + shirt under suit, helmet, gloves, boots, shield) to lower your + armor class even further. Most of these provide a one or two + point improvement to AC (making the overall value smaller and + eventually negative) but can also be enchanted. Shirts are an exception; they don't provide any protection unless enchanted. Some cloaks also don't improve AC when unenchanted but all cloaks offer some protection against rust or corrosion to suits worn un- @@ -3085,18 +3093,10 @@ Some character roles and some monsters are vegetarian. Veg- etarian monsters will typically never eat animal corpses, while - vegetarian players can, but with some rather unpleasant side-ef- - fects. - - You can name one food item after something you like to eat - with the fruit option. - - The command to eat food is `e'. + vegetarian players can, but with some rather unpleasant side- - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3106,6 +3106,13 @@ + effects. + + You can name one food item after something you like to eat + with the fruit option. + + The command to eat food is `e'. + 7.5. Scrolls (`?') Scrolls are labeled with various titles, probably chosen by @@ -3153,16 +3160,9 @@ wands require a direction in which to zap them. You can also zap them at yourself (just give a `.' or `s' for the direction). Be warned, however, for this is often unwise. Other types of wands - don't require a direction. The number of charges in a wand is - random and decreases by one whenever you use it. - - When the number of charges left in a wand becomes zero, at- - tempts to use the wand will usually result in nothing happening. - Occasionally, however, it may be possible to squeeze the last few - mana points from an otherwise spent wand, destroying it in the - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3172,6 +3172,13 @@ + don't require a direction. The number of charges in a wand is + random and decreases by one whenever you use it. + + When the number of charges left in a wand becomes zero, at- + tempts to use the wand will usually result in nothing happening. + Occasionally, however, it may be possible to squeeze the last few + mana points from an otherwise spent wand, destroying it in the process. A wand may be recharged by using suitable magic, but doing so runs the risk of causing it to explode. The chance for such an explosion starts out very small and increases each time @@ -3219,16 +3226,9 @@ `r' (read) command, they transfer to the reader the knowledge of a spell (and therefore eventually become unreadable)--unless the attempt backfires. Reading a cursed spellbook or one with mystic - runes beyond your ken can be harmful to your health! - - A spell (even when learned) can also backfire when you cast - it. If you attempt to cast a spell well above your experience - level, or if you have little skill with the appropriate spell - type, or cast it at a time when your luck is particularly bad, - you can end up wasting both the energy and the time required in - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3238,6 +3238,13 @@ + runes beyond your ken can be harmful to your health! + + A spell (even when learned) can also backfire when you cast + it. If you attempt to cast a spell well above your experience + level, or if you have little skill with the appropriate spell + type, or cast it at a time when your luck is particularly bad, + you can end up wasting both the energy and the time required in casting. Casting a spell calls forth magical energies and focuses @@ -3284,17 +3291,10 @@ Some tools (such as a blindfold) can be worn and can be put on and removed like other accessories (rings, amulets); see - Amulets. Other tools (such as pick-axe) can be wielded as weap- - ons in addition to being applied for their usual purpose, and in - some cases (again, pick-axe) become wielded as a weapon even when - applied. - - The blind option can be set (prior to game start) to attempt - to play the entire game without being able to see (a self-imposed - challenge which is very difficult to accomplish). + Amulets. Other tools (such as pick-axe) can be wielded as - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3304,6 +3304,14 @@ + weapons in addition to being applied for their usual purpose, and + in some cases (again, pick-axe) become wielded as a weapon even + when applied. + + The blind option can be set (prior to game start) to attempt + to play the entire game without being able to see (a self-imposed + challenge which is very difficult to accomplish). + The command to use a tool is `a' (apply). 7.10.1. Containers @@ -3350,17 +3358,9 @@ Other small rocks are also categorized as gems, but they are much less valuable. All rocks, however, can be used as projec- tile weapons (if you have a sling). In the most desperate of - cases, you can still throw them by hand. - - 7.13. Large rocks (``') - - Statues and boulders are not particularly useful, and are - generally heavy. It is rumored that some statues are not what - they seem. - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3370,6 +3370,14 @@ + cases, you can still throw them by hand. + + 7.13. Large rocks (``') + + Statues and boulders are not particularly useful, and are + generally heavy. It is rumored that some statues are not what + they seem. + Boulders occasionally block your path. You can push one forward (by attempting to walk onto its spot) when nothing blocks its path, or you can smash it into a pile of small rocks with @@ -3416,17 +3424,9 @@ more--perhaps a monster has picked it up or it has rotted away-- until you can see or feel that location again. One notable ex- ception is that if the object gets covered by the "remembered, - unseen monster" marker. When that marker is later removed after - you've verified that no monster is there, you will have forgotten - that there was any object there regardless of whether the unseen - monster actually took the object. If the object is still there, - then once you see or feel that location again you will re-discov- - er the object and resume remembering it. - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3436,6 +3436,13 @@ + unseen monster" marker. When that marker is later removed after + you've verified that no monster is there, you will have forgotten + that there was any object there regardless of whether the unseen + monster actually took the object. If the object is still there, + then once you see or feel that location again you will re-discov- + er the object and resume remembering it. + The situation is the same for a pile of objects, except that only the top item of the pile is displayed. The hilite_pile op- tion can be enabled in order to show an item differently when it @@ -3482,17 +3489,10 @@ and candy bars), and lumps of royal jelly. Monks are expected to observe a vegetarian diet. - Eating any kind of meat violates the vegetarian, vegan, and - foodless conducts. This includes tripe rations, the corpses or - tins of any monsters not mentioned above, and the various other - chunks of meat found in the dungeon. Swallowing and digesting a - monster while polymorphed is treated as if you ate the creature's - corpse. Eating leather, dragon hide, or bone items while poly- - morphed into a creature that can digest it, or eating monster - brains while polymorphed into a mind flayer, is considered eating - NetHack 3.7 December 24, 2022 + + NetHack 3.7 December 26, 2022 @@ -3502,6 +3502,14 @@ + Eating any kind of meat violates the vegetarian, vegan, and + foodless conducts. This includes tripe rations, the corpses or + tins of any monsters not mentioned above, and the various other + chunks of meat found in the dungeon. Swallowing and digesting a + monster while polymorphed is treated as if you ate the creature's + corpse. Eating leather, dragon hide, or bone items while poly- + morphed into a creature that can digest it, or eating monster + brains while polymorphed into a mind flayer, is considered eating an animal, although wax is only an animal byproduct. Regardless of conduct, there will be some items which are @@ -3549,16 +3557,8 @@ in your starting inventory is assumed to be learned from your teachers prior to the start of the game and isn't counted. - There is a side-branch to the main dungeon called "Sokoban," - briefly described in the earlier section about Traps. As men- - tioned there, the goal is to push boulders into pits and/or holes - to plug those in order to both get the boulders out of the way - and be able to go past the traps. There are some special "rules" - that are active when in that branch of the dungeon. Some rules - can't be bypassed, such as being unable to push a boulder - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3568,63 +3568,63 @@ - diagonally. Other rules can, such as not smashing boulders with - magic or tools, but doing so causes you to receive a luck penal- - ty. No message about that is given at the time, but it is - tracked as a conduct. The #conduct command and end of game dis- - closure will report whether you have abided by the special rules - of Sokoban, and if not, how many times you violated them, provid- - ing you with a way to discover which actions incur bad luck so - that you can be better informed about whether or not to avoid re- - peating those actions in the future. (Note: the Sokoban conduct - will only be displayed if you have entered the Sokoban branch of - the dungeon during the current game. Once that has happened, it - becomes part of disclosed conduct even if you haven't done any- - thing interesting there. Ending the game with "never broke the - Sokoban rules" conduct is most meaningful if you also manage to - perform the "obtained the Sokoban prize" achievement (see - Achievements below).) + There is a side-branch to the main dungeon called "Sokoban," + briefly described in the earlier section about Traps. As men- + tioned there, the goal is to push boulders into pits and/or holes + to plug those in order to both get the boulders out of the way + and be able to go past the traps. There are some special "rules" + that are active when in that branch of the dungeon. Some rules + can't be bypassed, such as being unable to push a boulder diago- + nally. Other rules can, such as not smashing boulders with magic + or tools, but doing so causes you to receive a luck penalty. No + message about that is given at the time, but it is tracked as a + conduct. The #conduct command and end of game disclosure will + report whether you have abided by the special rules of Sokoban, + and if not, how many times you violated them, providing you with + a way to discover which actions incur bad luck so that you can be + better informed about whether or not to avoid repeating those ac- + tions in the future. (Note: the Sokoban conduct will only be + displayed if you have entered the Sokoban branch of the dungeon + during the current game. Once that has happened, it becomes part + of disclosed conduct even if you haven't done anything interest- + ing there. Ending the game with "never broke the Sokoban rules" + conduct is most meaningful if you also manage to perform the "ob- + tained the Sokoban prize" achievement (see Achievements below).) - There are several other challenges tracked by the game. It + There are several other challenges tracked by the game. It is possible to eliminate one or more species of monsters by geno- - cide; playing without this feature is considered a challenge. + cide; playing without this feature is considered a challenge. When the game offers you an opportunity to genocide monsters, you - may respond with the monster type "none" if you want to decline. - You can change the form of an item into another item of the same - type ("polypiling") or the form of your own body into another - creature ("polyself") by wand, spell, or potion of polymorph; - avoiding these effects are each considered challenges. Polymor- - phing monsters, including pets, does not break either of these - challenges. Finally, you may sometimes receive wishes; a game - without an attempt to wish for any items is a challenge, as is a - game without wishing for an artifact (even if the artifact imme- - diately disappears). When the game offers you an opportunity to - make a wish for an item, you may choose "nothing" if you want to + may respond with the monster type "none" if you want to decline. + You can change the form of an item into another item of the same + type ("polypiling") or the form of your own body into another + creature ("polyself") by wand, spell, or potion of polymorph; + avoiding these effects are each considered challenges. Polymor- + phing monsters, including pets, does not break either of these + challenges. Finally, you may sometimes receive wishes; a game + without an attempt to wish for any items is a challenge, as is a + game without wishing for an artifact (even if the artifact imme- + diately disappears). When the game offers you an opportunity to + make a wish for an item, you may choose "nothing" if you want to decline. 8.1. Achievements - End of game disclosure will also display various achieve- - ments representing progress toward ultimate ascension, if any - have been attained. They aren't directly related to conduct but - are grouped with it because they fall into the same category of - "bragging rights" and to limit the number of questions during - disclosure. Listed here roughly in order of difficulty and not + End of game disclosure will also display various achieve- + ments representing progress toward ultimate ascension, if any + have been attained. They aren't directly related to conduct but + are grouped with it because they fall into the same category of + "bragging rights" and to limit the number of questions during + disclosure. Listed here roughly in order of difficulty and not necessarily in the order in which you might accomplish them. - Attained rank title . Shop - Entered a shop. Temple - Entered a temple. Mines - Entered the Gnomish Mines. - Town - Entered Mine Town. - Oracle - Consulted the Oracle of Delphi. - Novel - Read a passage from a Discworld Novel. - Sokoban - Entered Sokoban. - Big Room - Entered the Big Room. - Soko-Prize - Explored to the top of Sokoban - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3634,11 +3634,17 @@ + Town - Entered Mine Town. + Oracle - Consulted the Oracle of Delphi. + Novel - Read a passage from a Discworld Novel. + Sokoban - Entered Sokoban. + Big Room - Entered the Big Room. + Soko-Prize - Explored to the top of Sokoban and found a special item there. Mines' End - Explored to the bottom of the Gnomish Mines and found a special item there. Medusa - Defeated Medusa. - Tune - Discovered the tune that can be used to open and + Tune - Discovered the tune that can be used to open and close the drawbridge on the Castle level. Bell - Acquired the Bell of Opening. Gehennom - Entered Gehennom. @@ -3654,43 +3660,37 @@ Notes: - Achievements are recorded and subsequently reported in the - order in which they happen during your current game rather than + Achievements are recorded and subsequently reported in the + order in which they happen during your current game rather than the order listed here. - There are nine titles for each role, bestowed at ex- + There are nine titles for each role, bestowed at ex- perience levels 1, 3, 6, 10, 14, 18, 22, 26, and 30. The one for - experience level 1 is not recorded as an achievement. Losing - enough levels to revert to lower rank(s) does not discard the + experience level 1 is not recorded as an achievement. Losing + enough levels to revert to lower rank(s) does not discard the corresponding achievement(s). - There's no guaranteed Novel so the achievement to read one + There's no guaranteed Novel so the achievement to read one might not always be attainable (except perhaps by wishing). Sim- - ilarly, the Big Room level is not always present. Unlike with + ilarly, the Big Room level is not always present. Unlike with the Novel, there's no way to wish for this opportunity. The "special items" hidden in Mines' End and Sokoban are not - unique but are considered to be prizes or rewards for exploring - those levels since doing so is not necessary to complete the + unique but are considered to be prizes or rewards for exploring + those levels since doing so is not necessary to complete the game. Finding other instances of the same objects doesn't record the corresponding achievement. - The Medusa achievement is recorded if she dies for any rea- - son, even if you are not directly responsible, and only if she + The Medusa achievement is recorded if she dies for any rea- + son, even if you are not directly responsible, and only if she dies. - The 5-note tune can be learned via trial and error with a - musical instrument played closely enough--but not too close!--to - the Castle level's drawbridge or can be given to you via prayer - boon. - - Blind and Nudist are also conducts, and they can only be en- - abled by setting the correspondingly named option in NETHACKOP- - TIONS or run-time configuration file prior to game start. In the - case of Blind, the option also enforces the conduct. They aren't + The 5-note tune can be learned via trial and error with a + musical instrument played closely enough--but not too close!--to + the Castle level's drawbridge or can be given to you via prayer - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3700,23 +3700,29 @@ + boon. + + Blind and Nudist are also conducts, and they can only be en- + abled by setting the correspondingly named option in NETHACKOP- + TIONS or run-time configuration file prior to game start. In the + case of Blind, the option also enforces the conduct. They aren't really significant accomplishments unless/until you make substan- tial progress into the dungeon. 9. Options - Due to variations in personal tastes and conceptions of how + Due to variations in personal tastes and conceptions of how NetHack should do things, there are options you can set to change how NetHack behaves. 9.1. Setting the options - Options may be set in a number of ways. Within the game, + Options may be set in a number of ways. Within the game, the `O' command allows you to view all options and change most of - them. You can also set options automatically by placing them in - a configuration file, or in the NETHACKOPTIONS environment vari- + them. You can also set options automatically by placing them in + a configuration file, or in the NETHACKOPTIONS environment vari- able. Some versions of NetHack also have front-end programs that - allow you to set options before starting the game or a global + allow you to set options before starting the game or a global configuration for system administrators. 9.2. Using a configuration file @@ -3724,39 +3730,33 @@ The default name of the configuration file varies on differ- ent operating systems. - On UNIX, Linux, and macOS it is ".nethackrc" in the user's + On UNIX, Linux, and macOS it is ".nethackrc" in the user's home directory. The file may not exist, but it is a normal ASCII text file and can be created with any text editor. - On Windows, it is ".nethackrc" in the folder "\%USERPRO- - FILE%\NetHack\3.7". The file may not exist, but it is a normal - ASCII text file can can be created with any text editor. After - running NetHack for the first time, you should find a default - template for the configuration file named ".nethackrc.template" + On Windows, it is ".nethackrc" in the folder "\%USERPRO- + FILE%\NetHack\3.7". The file may not exist, but it is a normal + ASCII text file can can be created with any text editor. After + running NetHack for the first time, you should find a default + template for the configuration file named ".nethackrc.template" in "\%USERPROFILE%\NetHack\3.7". If you had not created the con- - figuration file, NetHack will create the configuration file for + figuration file, NetHack will create the configuration file for you using the default template file. - On MS-DOS, it is "defaults.nh" in the same folder as + On MS-DOS, it is "defaults.nh" in the same folder as nethack.exe. - Any line in the configuration file starting with `#' is + Any line in the configuration file starting with `#' is treated as a comment and ignored. Empty lines are ignored. - Any line beginning with `[' and ending in `]' is a section + Any line beginning with `[' and ending in `]' is a section marker (the closing `]' can be followed by whitespace and then an - arbitrary comment beginning with `#'). The text between the - square brackets is the section name. Section markers are only - valid after a CHOOSE directive and their names are case insensi- - tive. Lines after a section marker belong to that section up un- - til another section starts or a marker without a name is encoun- - tered or the file ends. Lines within sections are ignored unless - a CHOOSE directive has selected that section. + arbitrary comment beginning with `#'). The text between the + square brackets is the section name. Section markers are only + valid after a CHOOSE directive and their names are case - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3766,7 +3766,12 @@ - You can use different configuration directives in the file, + insensitive. Lines after a section marker belong to that section + up until another section starts or a marker without a name is en- + countered or the file ends. Lines within sections are ignored + unless a CHOOSE directive has selected that section. + + You can use different configuration directives in the file, some of which can be used multiple times. In general, the direc- tives are written in capital letters, followed by an equals sign, followed by settings particular to that directive. @@ -3774,14 +3779,14 @@ Here is a list of allowed directives: OPTIONS - There are two types of options, boolean and compound options. - Boolean options toggle a setting on or off, while compound op- - tions take more diverse values. Prefix a boolean option with - "no" or `!' to turn it off. For compound options, the option + There are two types of options, boolean and compound options. + Boolean options toggle a setting on or off, while compound op- + tions take more diverse values. Prefix a boolean option with + "no" or `!' to turn it off. For compound options, the option name and value are separated by a colon. Some options are per- sistent, and apply only to new games. You can specify multiple OPTIONS directives, and multiple options separated by commas in - a single OPTIONS directive. (Comma separated options are pro- + a single OPTIONS directive. (Comma separated options are pro- cessed from right to left.) Example: @@ -3790,21 +3795,21 @@ OPTIONS=!legacy,autopickup,pickup_types:$"=/!?+ HACKDIR - Default location of files NetHack needs. On Windows HACKDIR - defaults to the location of the NetHack.exe or NetHackw.exe - file so setting HACKDIR to override that is not usually neces- + Default location of files NetHack needs. On Windows HACKDIR + defaults to the location of the NetHack.exe or NetHackw.exe + file so setting HACKDIR to override that is not usually neces- sary or recommended. LEVELDIR - The location that in-progress level files are stored. Defaults + The location that in-progress level files are stored. Defaults to HACKDIR, must be writable. SAVEDIR - The location where saved games are kept. Defaults to HACKDIR, + The location where saved games are kept. Defaults to HACKDIR, must be writable. BONESDIR - The location that bones files are kept. Defaults to HACKDIR, + The location that bones files are kept. Defaults to HACKDIR, must be writable. LOCKDIR @@ -3812,17 +3817,12 @@ Defaults to HACKDIR, must be writable. TROUBLEDIR - The location that a record of game aborts and self-diagnosed + The location that a record of game aborts and self-diagnosed game problems is kept. Defaults to HACKDIR, must be writable. - AUTOCOMPLETE - Enable or disable an extended command autocompletion. Autocom- - pletion has no effect for the X11 windowport. You can specify - multiple autocompletions. To enable autocompletion, list the - extended command. Prefix the command with "!" to disable the - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3832,6 +3832,11 @@ + AUTOCOMPLETE + Enable or disable an extended command autocompletion. Autocom- + pletion has no effect for the X11 windowport. You can specify + multiple autocompletions. To enable autocompletion, list the + extended command. Prefix the command with "!" to disable the autocompletion for that command. Example: @@ -3839,12 +3844,12 @@ AUTOCOMPLETE=zap,!annotate AUTOPICKUP_EXCEPTION - Set exceptions to the pickup_types option. See the "Configur- + Set exceptions to the pickup_types option. See the "Configur- ing Autopickup Exceptions" section. BINDINGS - Change the key bindings of some special keys, menu accelera- - tors, extended commands, or mouse buttons. You can specify + Change the key bindings of some special keys, menu accelera- + tors, extended commands, or mouse buttons. You can specify multiple bindings. Format is key followed by the command, sep- arated by a colon. See the "Changing Key Bindings" section for more information. @@ -3854,7 +3859,7 @@ BIND=^X:getpos.autodescribe CHOOSE - Chooses at random one of the comma-separated parameters as an + Chooses at random one of the comma-separated parameters as an active section name. Lines in other sections are ignored. Example: @@ -3868,9 +3873,9 @@ [] #end of CHOOSE OPTIONS=!rest_on_space - If [] is present, the preceding section is closed and no new - section begins; whatever follows will be common to all sec- - tions. Otherwise the last section extends to the end of the + If [] is present, the preceding section is closed and no new + section begins; whatever follows will be common to all sec- + tions. Otherwise the last section extends to the end of the options file. MENUCOLOR @@ -3878,17 +3883,12 @@ ing Menu Colors" section. MSGTYPE - Change the way messages are shown in the top status line. See + Change the way messages are shown in the top status line. See the "Configuring Message Types" section. - ROGUESYMBOLS - Custom symbols for for the rogue level's symbol set. See SYM- - BOLS below. - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3898,17 +3898,21 @@ + ROGUESYMBOLS + Custom symbols for for the rogue level's symbol set. See SYM- + BOLS below. + SOUND Define a sound mapping. See the "Configuring User Sounds" sec- tion. SOUNDDIR - Define the directory that contains the sound files. See the + Define the directory that contains the sound files. See the "Configuring User Sounds" section. SYMBOLS - Override one or more symbols in the symbol set used for all - dungeon levels except for the special rogue level. See the + Override one or more symbols in the symbol set used for all + dungeon levels except for the special rogue level. See the "Modifying NetHack Symbols" section. Example: @@ -3917,9 +3921,9 @@ SYMBOLS=S_boulder:0,S_golem:7 WIZKIT - Debug mode only: extra items to add to initial inventory. - Value is the name of a text file containing a list of item - names, one per line, up to a maximum of 128 lines. Each line + Debug mode only: extra items to add to initial inventory. + Value is the name of a text file containing a list of item + names, one per line, up to a maximum of 128 lines. Each line is processed by the function that handles wishing. Example: @@ -3948,13 +3952,9 @@ - 9.3. Using the NETHACKOPTIONS environment variable - - The NETHACKOPTIONS variable is a comma-separated list of - initial values for the various options. Some can only be turned - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -3964,10 +3964,14 @@ - on or off. You turn one of these on by adding the name of the - option to the list, and turn it off by typing a `!' or "no" be- - fore the name. Others take a character string as a value. You - can set string options by typing the option name, a colon or + 9.3. Using the NETHACKOPTIONS environment variable + + The NETHACKOPTIONS variable is a comma-separated list of + initial values for the various options. Some can only be turned + on or off. You turn one of these on by adding the name of the + option to the list, and turn it off by typing a `!' or "no" be- + fore the name. Others take a character string as a value. You + can set string options by typing the option name, a colon or equals sign, and then the value of the string. The value is ter- minated by the next comma or the end of string. @@ -3977,7 +3981,7 @@ % setenv NETHACKOPTIONS "color,\!leg,name:Blue Meanie,fruit:lime" - in csh (note the need to escape the `!' since it's special to + in csh (note the need to escape the `!' since it's special to that shell), or the pair of commands $ NETHACKOPTIONS="color,!leg,name:Blue Meanie,fruit:lime" @@ -3987,40 +3991,36 @@ The NETHACKOPTIONS value is effectively the same as a single OPTIONS directive in a configuration file. The "OPTIONS=" prefix - is implied and comma separated options are processed from right + is implied and comma separated options are processed from right to left. Other types of configuration directives such as BIND or MSGTYPE are not allowed. Instead of a comma-separated list of options, NETHACKOPTIONS - can be set to the full name of a configuration file you want to - use. If that full name doesn't start with a slash, precede it - with `@' (at-sign) to let NetHack know that the rest is intended - as a file name. If it does start with `/', the at-sign is op- + can be set to the full name of a configuration file you want to + use. If that full name doesn't start with a slash, precede it + with `@' (at-sign) to let NetHack know that the rest is intended + as a file name. If it does start with `/', the at-sign is op- tional. 9.4. Customization options Here are explanations of what the various options do. Char- - acter strings that are too long may be truncated. Some of the + acter strings that are too long may be truncated. Some of the options listed may be inactive in your dungeon. - Some options are persistent, and are saved and reloaded + Some options are persistent, and are saved and reloaded along with the game. Changing a persistent option in the config- uration file applies only to new games. acoustics - Enable messages about what your character hears (default on). + Enable messages about what your character hears (default on). Note that this has nothing to do with your computer's audio ca- pabilities. Persistent. - alignment - Your starting alignment (align:lawful, align:neutral, or - align:chaotic). You may specify just the first letter. Many - roles and the non-human races restrict which alignments are al- - lowed. See role for a description of how to use negation to - NetHack 3.7 December 24, 2022 + + NetHack 3.7 December 26, 2022 @@ -4030,13 +4030,18 @@ + alignment + Your starting alignment (align:lawful, align:neutral, or + align:chaotic). You may specify just the first letter. Many + roles and the non-human races restrict which alignments are al- + lowed. See role for a description of how to use negation to exclude choices. - Default is random. Cannot be set with the `O' command. Per- + Default is random. Cannot be set with the `O' command. Per- sistent. autodescribe - Automatically describe the terrain under cursor when asked to + Automatically describe the terrain under cursor when asked to get a location on the map (default true). The whatis_coord op- tion controls whether the description includes map coordinates. @@ -4045,48 +4050,43 @@ into a place that can be dug (default false). Persistent. autoopen - Walking into a closed door attempts to open it (default true). + Walking into a closed door attempts to open it (default true). Persistent. autopickup Automatically pick up things onto which you move (default off). Persistent. - See pickup_types and also autopickup_exception for ways to re- + See pickup_types and also autopickup_exception for ways to re- fine the behavior. Note: prior to version 3.7, the default for autopickup was on. autoquiver - This option controls what happens when you attempt the `f' - (fire) command when nothing is quivered or readied (default - false). When true, the computer will fill your quiver or - quiver sack or make ready some suitable weapon. Note that it - will not take into account the blessed/cursed status, enchant- + This option controls what happens when you attempt the `f' + (fire) command when nothing is quivered or readied (default + false). When true, the computer will fill your quiver or + quiver sack or make ready some suitable weapon. Note that it + will not take into account the blessed/cursed status, enchant- ment, damage, or quality of the weapon; you are free to manual- - ly fill your quiver or quiver sack or make ready with the `Q' + ly fill your quiver or quiver sack or make ready with the `Q' command instead. If no weapon is found or the option is false, the `t' (throw) command is executed instead. Persistent. autounlock - Controls what action to take when attempting to walk into a - locked door or to loot a locked container. Takes a plus-sign + Controls what action to take when attempting to walk into a + locked door or to loot a locked container. Takes a plus-sign separated list of values: - Untrap - prompt about whether to attempt to find a trap; it - might fail to find one even when present; if it - does find one, it will ask whether you want to try - to disarm the trap; if you decline, your character + Untrap - prompt about whether to attempt to find a trap; it + might fail to find one even when present; if it + does find one, it will ask whether you want to try + to disarm the trap; if you decline, your character will forget that the door or box is trapped; - Apply-Key - if carrying a key or other unlocking tool, prompt - about using it; - Kick - kick the door (if you omit untrap or decline to at- - tempt untrap and you omit apply-key or you lack a - key or you decline to use the key; has no effect on - containers); + Apply-Key - if carrying a key or other unlocking tool, prompt - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4096,8 +4096,13 @@ - Force - try to force a container's lid with your currently - wielded weapon (if you omit untrap or decline to + about using it; + Kick - kick the door (if you omit untrap or decline to at- + tempt untrap and you omit apply-key or you lack a + key or you decline to use the key; has no effect on + containers); + Force - try to force a container's lid with your currently + wielded weapon (if you omit untrap or decline to attempt untrap and you omit apply-key or you lack a key or you decline to use the key; has no effect on doors); @@ -4105,13 +4110,13 @@ choices. Omitting the value is treated as if autounlock:apply-key. Pre- - ceding autounlock with `!' or "no" is treated as autoun- + ceding autounlock with `!' or "no" is treated as autoun- lock:none. Applying a key might set off a trap if the door or container is trapped. Successfully kicking a door will break it and wake up - nearby monsters. Successfully forcing a container open will - break its lock and might also destroy some of its contents or + nearby monsters. Successfully forcing a container open will + break its lock and might also destroy some of its contents or damage your weapon or both. The default is Apply-Key. Persistent. @@ -4121,38 +4126,33 @@ tent. bones - Allow saving and loading bones files (default true). Persis- + Allow saving and loading bones files (default true). Persis- tent. boulder - Set the character used to display boulders (default is the + Set the character used to display boulders (default is the "large rock" class symbol, ``'). catname - Name your starting cat (for example "catname:Morris"). Cannot + Name your starting cat (for example "catname:Morris"). Cannot be set with the `O' command. character - Synonym for "role" to pick the type of your character (for ex- + Synonym for "role" to pick the type of your character (for ex- ample "character:Monk"). See role for more details. checkpoint - Save game state after each level change, for possible recovery + Save game state after each level change, for possible recovery after program crash (default on). Persistent. cmdassist - Have the game provide some additional command assistance for - new players if it detects some anticipated mistakes (default + Have the game provide some additional command assistance for + new players if it detects some anticipated mistakes (default on). - confirm - Have user confirm attacks on pets, shopkeepers, and other - peaceable creatures (default on). Persistent. - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4162,13 +4162,17 @@ + confirm + Have user confirm attacks on pets, shopkeepers, and other + peaceable creatures (default on). Persistent. + dark_room Show out-of-sight areas of lit rooms (default on). Persistent. disclose - Controls what information the program reveals when the game - ends. Value is a space separated list of prompting/category - pairs (default is "ni na nv ng nc no", prompt with default re- + Controls what information the program reveals when the game + ends. Value is a space separated list of prompting/category + pairs (default is "ni na nv ng nc no", prompt with default re- sponse of `n' for each candidate). Persistent. The possibili- ties are: @@ -4179,8 +4183,8 @@ c - display your conduct; also achievements, if any; o - display dungeon overview. - Each disclosure possibility can optionally be preceded by a - prefix which lets you refine how it behaves. Here are the + Each disclosure possibility can optionally be preceded by a + prefix which lets you refine how it behaves. Here are the valid prefixes: y - prompt you and default to yes on the prompt; @@ -4188,37 +4192,33 @@ + - disclose it without prompting; - - do not disclose it and do not prompt. - The listing of vanquished monsters can be sorted, so there are + The listing of vanquished monsters can be sorted, so there are two additional choices for `v': ? - prompt you and default to ask on the prompt; # - disclose it without prompting, ask for sort order. Asking refers to picking one of the orderings from a menu. The - `+' disclose without prompting choice, or being prompted and + `+' disclose without prompting choice, or being prompted and answering `y' rather than `a', will default to showing monsters in the traditional order, from high level to low level. Omitted categories are implicitly added with `n' prefix. Spec- ified categories with omitted prefix implicitly use `+' prefix. - Order of the disclosure categories does not matter, program + Order of the disclosure categories does not matter, program display for end-of-game disclosure follows a set sequence. - (for example "disclose:yi na +v -g o") The example sets inven- + (for example "disclose:yi na +v -g o") The example sets inven- tory to prompt and default to yes, attributes to prompt and de- fault to no, vanquished to disclose without prompting, genocid- ed to not disclose and not prompt, conduct to implicitly prompt and default to no, and overview to disclose without prompting. - Note that the vanquished monsters list includes all monsters - killed by traps and each other as well as by you. And the dun- - geon overview shows all levels you had visited but does not re- - veal things about them that you hadn't discovered. + Note that the vanquished monsters list includes all monsters + killed by traps and each other as well as by you. And the - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4228,63 +4228,63 @@ + dungeon overview shows all levels you had visited but does not + reveal things about them that you hadn't discovered. + dogname Name your starting dog (for example "dogname:Fang"). Cannot be set with the `O' command. extmenu - Changes the extended commands interface to pop-up a menu of + Changes the extended commands interface to pop-up a menu of available commands. It is keystroke compatible with the tradi- - tional interface except that it does not require that you hit + tional interface except that it does not require that you hit Enter. It is implemented for the tty interface (default off). For the X11 interface, which always uses a menu for choosing an extended command, it controls whether the menu shows all avail- - able commands (on) or just the subset of commands which have + able commands (on) or just the subset of commands which have traditionally been considered extended ones (off). female - An obsolete synonym for "gender:female". Cannot be set with + An obsolete synonym for "gender:female". Cannot be set with the `O' command. fireassist - This option controls what happens when you attempt the `f' + This option controls what happens when you attempt the `f' (fire) and don't have an appropriate launcher, such as a bow or - a sling, wielded. If on, you will automatically wield the + a sling, wielded. If on, you will automatically wield the launcher. Default is on. fixinv - An object's inventory letter sticks to it when it's dropped - (default on). If this is off, dropping an object shifts all + An object's inventory letter sticks to it when it's dropped + (default on). If this is off, dropping an object shifts all the remaining inventory letters. Persistent. force_invmenu - Commands asking for an inventory item show a menu instead of a + Commands asking for an inventory item show a menu instead of a text query with possible menu letters. Default is off. fruit - Name a fruit after something you enjoy eating (for example - "fruit:mango") (default "slime mold"). Basically a nostalgic - whimsy that NetHack uses from time to time. You should set - this to something you find more appetizing than slime mold. - Apples, oranges, pears, bananas, and melons already exist in + Name a fruit after something you enjoy eating (for example + "fruit:mango") (default "slime mold"). Basically a nostalgic + whimsy that NetHack uses from time to time. You should set + this to something you find more appetizing than slime mold. + Apples, oranges, pears, bananas, and melons already exist in NetHack, so don't use those. gender - Your starting gender (gender:male or gender:female). You may - specify just the first letter. Although you can still denote - your gender using either of the deprecated male and female op- + Your starting gender (gender:male or gender:female). You may + specify just the first letter. Although you can still denote + your gender using either of the deprecated male and female op- tions, if the gender option is also present it will take prece- - dence. See role for a description of how to use negation to + dence. See role for a description of how to use negation to exclude choices. - Default is random. Cannot be set with the `O' command. Per- - sistent. - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4294,63 +4294,63 @@ + Default is random. Cannot be set with the `O' command. Per- + sistent. + goldX - When filtering objects based on bless/curse state (BUCX), - whether to treat gold pieces as X (unknown bless/curse state, - when "on") or U (known to be uncursed, when "off", the de- - fault). Gold is never blessed or cursed, but it is not de- + When filtering objects based on bless/curse state (BUCX), + whether to treat gold pieces as X (unknown bless/curse state, + when "on") or U (known to be uncursed, when "off", the de- + fault). Gold is never blessed or cursed, but it is not de- scribed as "uncursed" even when the implicit_uncursed option is "off". help - If more information is available for an object looked at with + If more information is available for an object looked at with the `/' command, ask if you want to see it (default on). Turn- - ing help off makes just looking at things faster, since you - aren't interrupted with the "More info?" prompt, but it also + ing help off makes just looking at things faster, since you + aren't interrupted with the "More info?" prompt, but it also means that you might miss some interesting and/or important in- formation. Persistent. herecmd_menu - When using a windowport that supports mouse and clicking on - yourself or next to you, show a menu of possible actions for - the location. Same as "#herecmdmenu" and "#therecmdmenu" com- + When using a windowport that supports mouse and clicking on + yourself or next to you, show a menu of possible actions for + the location. Same as "#herecmdmenu" and "#therecmdmenu" com- mands. hilite_pet - Visually distinguish pets from similar animals (default off). - The behavior of this option depends on the type of windowing + Visually distinguish pets from similar animals (default off). + The behavior of this option depends on the type of windowing you use. In text windowing, text highlighting or inverse video - is often used; with tiles, generally displays a heart symbol + is often used; with tiles, generally displays a heart symbol near pets. - With the curses interface, the petattr option controls how to - highlight pets and setting it will turn the hilite_pet option + With the curses interface, the petattr option controls how to + highlight pets and setting it will turn the hilite_pet option on or off as warranted. hilite_pile - Visually distinguish piles of objects from individual objects + Visually distinguish piles of objects from individual objects (default off). The behavior of this option depends on the type - of windowing you use. In text windowing, text highlighting or - inverse video is often used; with tiles, generally displays a + of windowing you use. In text windowing, text highlighting or + inverse video is often used; with tiles, generally displays a small plus-symbol beside the object on the top of the pile. hitpointbar - Show a hit point bar graph behind your name and title. Only - available for TTY and Windows GUI, and only when statushilites + Show a hit point bar graph behind your name and title. Only + available for TTY and Windows GUI, and only when statushilites is on. horsename - Name your starting horse (for example "horsename:Trigger"). + Name your starting horse (for example "horsename:Trigger"). Cannot be set with the `O' command. ignintr - Ignore interrupt signals, including breaks (default off). Per- - sistent. + Ignore interrupt signals, including breaks (default off). - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4360,9 +4360,11 @@ + Persistent. + implicit_uncursed Omit "uncursed" from object descriptions when it can be deduced - from other aspects of the description (default on). Persis- + from other aspects of the description (default on). Persis- tent. If you use menu coloring, you may want to turn this off. @@ -4372,51 +4374,49 @@ on). Persistent. lit_corridor - Show corridor squares seen by night vision or a light source + Show corridor squares seen by night vision or a light source held by your character as lit (default off). Persistent. lootabc - When using a menu to interact with a container, use the old - `a', `b', and `c' keyboard shortcuts rather than the mnemonics + When using a menu to interact with a container, use the old + `a', `b', and `c' keyboard shortcuts rather than the mnemonics `o', `i', and `b' (default off). Persistent. mail Enable mail delivery during the game (default on). Persistent. male - An obsolete synonym for "gender:male". Cannot be set with the + An obsolete synonym for "gender:male". Cannot be set with the `O' command. mention_decor - Give feedback when walking onto various dungeon features such - as stairs, fountains, or altars which are ordinarily only de- - scribed when covered by one or more objects (default off). + Give feedback when walking onto various dungeon features such + as stairs, fountains, or altars which are ordinarily only de- + scribed when covered by one or more objects (default off). Cannot be set with the `O' command. Persistent. mention_walls - Give feedback when walking against a wall (default off). Per- + Give feedback when walking against a wall (default off). Per- sistent. menucolors - Enable coloring menu lines (default off). See "Configuring + Enable coloring menu lines (default off). See "Configuring Menu Colors" on how to configure the colors. menustyle Controls the interface used when you need to choose various ob- - jects (in response to the Drop command, for instance). The - value specified should be the first letter of one of the fol- - lowing: traditional, combination, full, or partial. Persis- + jects (in response to the Drop command, for instance). The + value specified should be the first letter of one of the fol- + lowing: traditional, combination, full, or partial. Persis- tent. - Traditional was the only interface available for very early - versions; it consists of a prompt for object class characters, - followed by an object-by-object prompt for all items matching - the selected object class(es). Combination starts with a - prompt for object class(es) of interest, but then displays a - menu of matching objects rather than prompting one-by-one. + Traditional was the only interface available for very early + versions; it consists of a prompt for object class characters, + followed by an object-by-object prompt for all items matching + the selected object class(es). Combination starts with a - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4426,9 +4426,11 @@ - Full displays a menu of object classes rather than a character - prompt, and then a menu of matching objects for selection. - Partial skips the object class filtering and immediately dis- + prompt for object class(es) of interest, but then displays a + menu of matching objects rather than prompting one-by-one. + Full displays a menu of object classes rather than a character + prompt, and then a menu of matching objects for selection. + Partial skips the object class filtering and immediately dis- plays a menu of all objects. menu_deselect_all @@ -4441,8 +4443,8 @@ Key to jump to the first page in a menu. Default `^'. menu_headings - Controls how the headings in a menu are highlighted. Values - are "none", "bold", "dim", "italic", "underline", "blink", or + Controls how the headings in a menu are highlighted. Values + are "none", "bold", "dim", "italic", "underline", "blink", or "inverse". Not all ports can actually display all types. menu_invert_all @@ -4458,19 +4460,19 @@ Key to go to the next menu page. Default `>'. menu_objsyms - Show object symbols in menu headings in menus where the object + Show object symbols in menu headings in menus where the object symbols act as menu accelerators (default off). menu_overlay - Do not clear the screen before drawing menus, and align menus - to the right edge of the screen. Only for the tty port. (de- + Do not clear the screen before drawing menus, and align menus + to the right edge of the screen. Only for the tty port. (de- fault on) menu_previous_page Key to go to the previous menu page. Default `<'. menu_search - Key to search for some text and toggle selection state of + Key to search for some text and toggle selection state of matching menu items. Default `:'. menu_select_all @@ -4480,9 +4482,7 @@ Key to select all items on this page of a menu. Default `,'. - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4493,12 +4493,12 @@ menu_shift_left - Key to scroll a menu--one which has been scrolled right--back - to the left. Implemented for perm_invent only by curses and + Key to scroll a menu--one which has been scrolled right--back + to the left. Implemented for perm_invent only by curses and X11. Default `{'. menu_shift_right - Key to scroll a menu which has text beyond the right edge to + Key to scroll a menu which has text beyond the right edge to the right. Implemented for perm_invent only by curses and X11. Default `}'. @@ -4507,24 +4507,24 @@ off). Debug mode only. mouse_support - Allow use of the mouse for input and travel. Valid settings + Allow use of the mouse for input and travel. Valid settings are: 0 - disabled 1 - enabled and make OS adjustments to support mouse use 2 - like 1 but does not make any OS adjustments - Omitting a value is the same as specifying 1 and negating + Omitting a value is the same as specifying 1 and negating mouse_support is the same as specifying 0. msghistory - The number of top line messages to keep (and be able to recall + The number of top line messages to keep (and be able to recall with `^P') (default 20). Cannot be set with the `O' command. msg_window - Allows you to change the way recalled messages are displayed. - Currently it is only supported for tty (all four choices) and - for curses (`f' and `r' choices, default `r'). The possible + Allows you to change the way recalled messages are displayed. + Currently it is only supported for tty (all four choices) and + for curses (`f' and `r' choices, default `r'). The possible values are: s - single message (default; only choice prior to 3.4.0); @@ -4532,23 +4532,23 @@ f - full window, oldest message first; r - full window reversed, newest message first. - For backward compatibility, no value needs to be specified - (which defaults to "full"), or it can be negated (which + For backward compatibility, no value needs to be specified + (which defaults to "full"), or it can be negated (which defaults to "single"). name - Set your character's name (defaults to your user name). You - can also set your character's role by appending a dash and one + Set your character's name (defaults to your user name). You + can also set your character's role by appending a dash and one or more letters of the role (that is, by suffixing one of -A -B - -C -H -K -M -P -Ra -Ro -S -T -V -W). If -@ is used for the - role, then a random one will be automatically chosen. Cannot + -C -H -K -M -P -Ra -Ro -S -T -V -W). If -@ is used for the + role, then a random one will be automatically chosen. Cannot be set with the `O' command. news Read the NetHack news file, if present (default on). Since the - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4568,7 +4568,7 @@ Send padding nulls to the terminal (default on). Persistent. number_pad - Use digit keys instead of letters to move (default 0 or off). + Use digit keys instead of letters to move (default 0 or off). Valid settings are: 0 - move by letters; "yuhjklbn" @@ -4578,43 +4578,43 @@ 4 - combines 3 with 2; phone layout plus MS-DOS compatibility -1 - by letters but use `z' to go northwest, `y' to zap wands - For backward compatibility, omitting a value is the same as - specifying 1 and negating number_pad is the same as specifying - 0. (Settings 2 and 4 are for compatibility with MS-DOS or old + For backward compatibility, omitting a value is the same as + specifying 1 and negating number_pad is the same as specifying + 0. (Settings 2 and 4 are for compatibility with MS-DOS or old PC Hack; in addition to the different behavior for `5', `Alt-5' acts as `G' and `Alt-0' acts as `I'. Setting -1 is to accommo- - date some QWERTZ keyboards which have the location of the `y' - and `z' keys swapped.) When moving by numbers, to enter a + date some QWERTZ keyboards which have the location of the `y' + and `z' keys swapped.) When moving by numbers, to enter a count prefix for those commands which accept one (such as "12s" - to search twelve times), precede it with the letter `n' + to search twelve times), precede it with the letter `n' ("n12s"). packorder - Specify the order to list object types in (default + Specify the order to list object types in (default "")[%?+!=/(*`0_"). The value of this option should be a string containing the symbols for the various object types. Any omit- ted types are filled in at the end from the previous order. paranoid_confirmation - A space separated list of specific situations where alternate + A space separated list of specific situations where alternate prompting is desired. The default is "paranoid_confirma- tion:pray swim". - Confirm - for any prompts which are set to require "yes" - rather than `y', also require "no" to reject in- + Confirm - for any prompts which are set to require "yes" + rather than `y', also require "no" to reject in- stead of accepting any non-yes response as no quit - require "yes" rather than `y' to confirm quitting - the game or switching into non-scoring explore + the game or switching into non-scoring explore mode; - die - require "yes" rather than `y' to confirm dying - (not useful in normal play; applies to explore + die - require "yes" rather than `y' to confirm dying + (not useful in normal play; applies to explore mode); - bones - require "yes" rather than `y' to confirm saving + bones - require "yes" rather than `y' to confirm saving bones data when dying in debug mode; - attack - require "yes" rather than `y' to confirm + attack - require "yes" rather than `y' to confirm - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4627,33 +4627,33 @@ attacking a peaceful monster; wand-break - require "yes" rather than `y' to confirm breaking a wand; - eating - require "yes" rather than `y' to confirm whether + eating - require "yes" rather than `y' to confirm whether to continue eating; Were-change - require "yes" rather than `y' to confirm changing - form due to lycanthropy when hero has polymorph + form due to lycanthropy when hero has polymorph control; - pray - require `y' to confirm an attempt to pray rather + pray - require `y' to confirm an attempt to pray rather than immediately praying; on by default; - Remove - require selection from inventory for `R' and `T' - commands even when wearing just one applicable + Remove - require selection from inventory for `R' and `T' + commands even when wearing just one applicable item. swim - prevent walking into water or lava. all - turn on all of the above. - By default, the pray choice is enabled, the others disabled. - To disable it without setting any of the other choices, use + By default, the pray choice is enabled, the others disabled. + To disable it without setting any of the other choices, use "paranoid_confirmation:none". To keep it enabled while setting - any of the others, include it in the list, such as "para- + any of the others, include it in the list, such as "para- noid_confirmation:attack pray Remove". perm_invent - If true, always display your current inventory in a window. - This only makes sense for windowing system interfaces that im- + If true, always display your current inventory in a window. + This only makes sense for windowing system interfaces that im- plement this feature. petattr - Specifies one or more text highlighting attributes to use when - showing pets on the map. Effectively a superset of the + Specifies one or more text highlighting attributes to use when + showing pets on the map. Effectively a superset of the hilite_pet boolean option. Curses interface only; value is one or more of the following letters. @@ -4667,20 +4667,20 @@ l - Left line indicator r - Right line indicator - Some of those choices might not work, particularly the final - three, depending upon terminal hardware or terminal emulation + Some of those choices might not work, particularly the final + three, depending upon terminal hardware or terminal emulation software. - Currently multiple highlight-style letters can be combined by - simply stringing them together (for example, "bk"), but in the - future they might require being separated by plus signs (such - as "b+k", which works already). When using the `n' choice, it - should be specified on its own, not in combination with any of + Currently multiple highlight-style letters can be combined by + simply stringing them together (for example, "bk"), but in the + future they might require being separated by plus signs (such + as "b+k", which works already). When using the `n' choice, it + should be specified on its own, not in combination with any of the other letters. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4691,23 +4691,23 @@ pettype - Specify the type of your initial pet, if you are playing a - character class that uses multiple types of pets; or choose to - have no initial pet at all. Possible values are "cat", "dog", + Specify the type of your initial pet, if you are playing a + character class that uses multiple types of pets; or choose to + have no initial pet at all. Possible values are "cat", "dog", "horse", and "none". If the choice is not allowed for the role - you are currently playing, it will be silently ignored. For - example, "horse" will only be honored when playing a knight. + you are currently playing, it will be silently ignored. For + example, "horse" will only be honored when playing a knight. Cannot be set with the `O' command. pickup_burden - When you pick up an item that would exceed this encumbrance - level (Unencumbered, Burdened, streSsed, straiNed, overTaxed, - or overLoaded), you will be asked if you want to continue. + When you pick up an item that would exceed this encumbrance + level (Unencumbered, Burdened, streSsed, straiNed, overTaxed, + or overLoaded), you will be asked if you want to continue. (Default `S'). Persistent. pickup_thrown - If this option is on and autopickup is also on, try to pick up - things that you threw, even if they aren't in pickup_types or + If this option is on and autopickup is also on, try to pick up + things that you threw, even if they aren't in pickup_types or match an autopickup exception. Default is on. Persistent. pickup_types @@ -4715,38 +4715,38 @@ Default is all types. Persistent. The value is a list of object symbols, such as pickup_types:$?! - to pick up gold, scrolls, and potions. You can use autopick- - up_exception configuration file lines to further refine au- + to pick up gold, scrolls, and potions. You can use autopick- + up_exception configuration file lines to further refine au- topickup behavior. - There is no way to set pickup_types to "none". (Setting it to - an empty value reverts to "all".) If you want to avoid auto- + There is no way to set pickup_types to "none". (Setting it to + an empty value reverts to "all".) If you want to avoid auto- matically picking up any types of items but do want to have au- topickup on in order to have autopickup_exception settings con- trol what you do and don't pick up, you can set pickup_types to - `.'. That is the type symbol for venom and you won't come + `.'. That is the type symbol for venom and you won't come across any venom items so won't unintentionally pick such up. pile_limit - When walking across a pile of objects on the floor, threshold - at which the message "there are few/several/many objects here" - is given instead of showing a popup list of those objects. A - value of 0 means "no limit" (always list the objects); a value - of 1 effectively means "never show the objects" since the pile - size will always be at least that big; default value is 5. + When walking across a pile of objects on the floor, threshold + at which the message "there are few/several/many objects here" + is given instead of showing a popup list of those objects. A + value of 0 means "no limit" (always list the objects); a value + of 1 effectively means "never show the objects" since the pile + size will always be at least that big; default value is 5. Persistent. playmode - Values are "normal", "explore", or "debug". Allows selection - of explore mode (also known as discovery mode) or debug mode + Values are "normal", "explore", or "debug". Allows selection + of explore mode (also known as discovery mode) or debug mode (also known as wizard mode) instead of normal play. Debug mode - might only be allowed for someone logged in under a particular - user name (on multi-user systems) or specifying a particular + might only be allowed for someone logged in under a particular + user name (on multi-user systems) or specifying a particular character name (on single-user systems) or it might be disabled - entirely. Requesting it when not allowed or not possible + entirely. Requesting it when not allowed or not possible - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4759,60 +4759,60 @@ results in explore mode instead. Default is normal play. pushweapon - Using the `w' (wield) command when already wielding something - pushes the old item into your alternate weapon slot (default - off). Likewise for the `a' (apply) command if it causes the + Using the `w' (wield) command when already wielding something + pushes the old item into your alternate weapon slot (default + off). Likewise for the `a' (apply) command if it causes the applied item to become wielded. Persistent. quick_farsight - When set, usually prevents the "you sense your surroundings" - message where play pauses to allow you to browse the map when- + When set, usually prevents the "you sense your surroundings" + message where play pauses to allow you to browse the map when- ever clairvoyance randomly activates. Some situations, such as - being underwater or engulfed, ignore this option. It does not + being underwater or engulfed, ignore this option. It does not affect the clairvoyance spell where pausing to examine revealed - objects or monsters is less intrusive. Default is off. Per- + objects or monsters is less intrusive. Default is off. Per- sistent. race - Selects your race (for example, race:human). Choices are hu- - man, dwarf, elf, gnome, and orc but most roles restrict which + Selects your race (for example, race:human). Choices are hu- + man, dwarf, elf, gnome, and orc but most roles restrict which of the non-human races are allowed. See role for a description of how to use negation to exclude choices. - Default is random. Cannot be set with the `O' command. Per- + Default is random. Cannot be set with the `O' command. Per- sistent. rest_on_space - Make the space bar a synonym for the `.' (#wait) command (de- + Make the space bar a synonym for the `.' (#wait) command (de- fault off). Persistent. role - Pick your type of character (for example, role:Samurai); syn- + Pick your type of character (for example, role:Samurai); syn- onym for character. See name for an alternate method of speci- fying your role. - This option can also be used to limit selection when role is - chosen randomly. Use a space-separated list of roles and ei- - ther negate each one or negate the option itself instead. + This option can also be used to limit selection when role is + chosen randomly. Use a space-separated list of roles and ei- + ther negate each one or negate the option itself instead. Negation is accomplished in the same manner as with boolean op- - tions, by prefixing the option or its value(s) with `!' or + tions, by prefixing the option or its value(s) with `!' or "no". Examples: OPTIONS=role:!arc !bar !kni OPTIONS=!role:arc bar kni - There can be multiple instances of the role option if they're + There can be multiple instances of the role option if they're all negations. - Default is random. Cannot be set with the `O' command. Per- + Default is random. Cannot be set with the `O' command. Per- sistent. roguesymset - This option may be used to select one of the named symbol sets + This option may be used to select one of the named symbol sets - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4822,18 +4822,18 @@ - found within "symbols" to alter the symbols displayed on the + found within "symbols" to alter the symbols displayed on the screen on the rogue level. rlecomp When writing out a save file, perform run length compression of - the map. Not all ports support run length compression. It has + the map. Not all ports support run length compression. It has no effect on reading an existing save file. runmode - Controls the amount of screen updating for the map window when - engaged in multi-turn movement (running via shift+direction or - control+direction and so forth, or via the travel command or + Controls the amount of screen updating for the map window when + engaged in multi-turn movement (running via shift+direction or + control+direction and so forth, or via the travel command or mouse click). The possible values are: teleport - update the map after movement has finished; @@ -4842,17 +4842,17 @@ crawl - like walk, but pause briefly after each step. This option only affects the game's screen display, not the ac- - tual results of moving. The default is "run"; versions prior - to 3.4.1 used "teleport" only. Whether or not the effect is + tual results of moving. The default is "run"; versions prior + to 3.4.1 used "teleport" only. Whether or not the effect is noticeable will depend upon the window port used or on the type of terminal. Persistent. safe_pet - Prevent you from (knowingly) attacking your pets (default on). + Prevent you from (knowingly) attacking your pets (default on). Persistent. safe_wait - Prevents you from waiting or searching when next to a hostile + Prevents you from waiting or searching when next to a hostile monster (default on). Persistent. sanity_check @@ -4860,8 +4860,8 @@ off). Debug mode only. scores - Control what parts of the score list you are shown at the end - (for example "scores:5 top scores/4 around my score/own + Control what parts of the score list you are shown at the end + (for example "scores:5 top scores/4 around my score/own scores"). Only the first letter of each category (`t', `a', or `o') is necessary. Persistent. @@ -4870,15 +4870,15 @@ off). Persistent. showrace - Display yourself as the glyph for your race, rather than the - glyph for your role (default off). Note that this setting af- - fects only the appearance of the display, not the way the game + Display yourself as the glyph for your race, rather than the + glyph for your role (default off). Note that this setting af- + fects only the appearance of the display, not the way the game treats you. Persistent. - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -4901,17 +4901,17 @@ The possible values are: - o - list object types by class, in discovery order within each + o - list object types by class, in discovery order within each class; default; - s - list object types by sortloot classification: by class, by - sub-class within class for classes which have substantial - groupings (like helmets, boots, gloves, and so forth for - armor), with object types partly-discovered via assigned + s - list object types by sortloot classification: by class, by + sub-class within class for classes which have substantial + groupings (like helmets, boots, gloves, and so forth for + armor), with object types partly-discovered via assigned name coming before fully identified types; c - list by class, alphabetically within each class; a - list alphabetically across all classes. - Can be interactively set via the `O' command or via using the + Can be interactively set via the `O' command or via using the `m' prefix before the `\' or ``' command. sortloot @@ -4921,14 +4921,47 @@ The possible values are: full - always sort the lists; - loot - only sort the lists that don't use inventory letters, + loot - only sort the lists that don't use inventory letters, like with the #loot and pickup commands; none - show lists the traditional way without sorting; default. sortpack - Sort the pack contents by type when displaying inventory (de- + Sort the pack contents by type when displaying inventory (de- fault on). Persistent. + sortvanquisted + Controls the sorting behavior for the output of the #vanquished + command. Persistent. + + The possible values are: + + t - traditional--order by monster level; ties are broken by in- + ternal monster index; default; + d - order by monster difficulty rating; ties broken by internal + index; + a - order alphabetically, first any unique monsters then all + the others; + c - order by monster class, by low to high level within each + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 76 + + + + class; + n - order by count, high to low; ties are broken by internal + monster index; + z - order by count, low to high; ties broken by internal index. + + Can be interactively set via the `m O' command or via using the + `m' prefix before the #vanquished command. + sparkle Display a sparkly effect when a monster (including yourself) is hit by an attack to which it is resistant (default on). Per- @@ -4942,18 +4975,6 @@ field. If negated or set to zero, disables status hiliting. See "Configuring Status Hilites" for further information. - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 76 - - - status_updates Allow updates to the status lines at the bottom of the screen (default true). @@ -4987,6 +5008,18 @@ toptenwin Put the ending display in a NetHack window instead of on stdout + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 77 + + + (default off). Setting this option makes the score list visi- ble when a windowing version of NetHack is started without a parent window, but it no longer leaves the score list around @@ -5009,17 +5042,6 @@ tion. Also works in other situations where you are asked to pick a location. - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 77 - - - The possible settings are: c - compass ("east" or "3s" or "2n,4w"); @@ -5053,6 +5075,17 @@ through next and previous targets, use a menu instead to pick a target. (default off) + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 78 + + + whatis_moveskip When getting a location on the map, and using shifted movement keys or meta-digit keys to fast-move, instead of moving 8 units @@ -5075,17 +5108,6 @@ Augment object descriptions with their objects' weight (default off). Debug mode only. - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 78 - - - zerocomp When writing out a save file, perform zero-comp compression of the contents. Not all ports support zero-comp compression. It @@ -5117,8 +5139,20 @@ ascii_map If NetHack can, it should display the map using simple charac- ters (letters and punctuation) rather than tiles graphics. In - some cases, characters can be augmented with line-drawing sym- - bols; use the symset option to select a symbol set such as + some cases, characters can be augmented with line-drawing + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 79 + + + + symbols; use the symset option to select a symbol set such as DECgraphics or IBMgraphics if your display supports them. Set- ting ascii_map to True forces tiled_map to be False. @@ -5139,19 +5173,6 @@ If NetHack can, it should use a font by the chosen name for menu windows. - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 79 - - - font_message If NetHack can, it should use a font by the chosen name for the message window. @@ -5186,6 +5207,17 @@ If NetHack can, it should try and display on the entire screen rather than in a window. + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 80 + + + guicolor Use color text and/or highlighting attributes when displaying some non-map data (such as menu selector letters). Curses in- @@ -5205,19 +5237,6 @@ popup_dialog If NetHack can, it should pop up dialog boxes for input. - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 80 - - - preload_tiles If NetHack can, it should preload tiles into memory. For exam- ple, in the protected mode MS-DOS version, control whether @@ -5253,6 +5272,18 @@ When set to 3, the tty interface moves some fields around and mainly shows status conditions on their own line. A display + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 81 + + + capable of showing at least 25 lines is recommended. The value can be toggled back and forth during the game with the `O' com- mand. @@ -5271,19 +5302,6 @@ statuslines can only be set in the run-time configuration file or via NETHACKOPTIONS, not during play with the `O' command.) - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 81 - - - term_cols and term_rows @@ -5320,6 +5338,18 @@ If NetHack can, it should display inverse when the game speci- fies it. + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 82 + + + vary_msgcount If NetHack can, it should display this number of messages at a time in the message window. @@ -5338,18 +5368,6 @@ (The 26x82 size threshold for `2' refers to number of rows and columns of the display. A width of at least 110 columns (80+2+26+2) is needed to show borders if align_status is set to - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 82 - - - left or right.) The persistent inventory window, when enabled, can grow until @@ -5387,6 +5405,17 @@ Here are explanations of options that are used by specific platforms or ports to customize and change the port behavior. + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 83 + + + altkeyhandling Select an alternate way to handle keystrokes (Win32 tty NetHack only). The name of the handling type is one of "default", @@ -5403,21 +5432,9 @@ prior to a command--preceded by n if the number_pad option is set--is also subject to this conversion, so attempting to abort the count by typing ESC will leave NetHack waiting for another - character to complete the two character sequence. Type a - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 83 - - - - second ESC to finish cancelling such a count. At other prompts - a single ESC suffices. + character to complete the two character sequence. Type a sec- + ond ESC to finish cancelling such a count. At other prompts a + single ESC suffices. BIOS Use BIOS calls to update the screen display quickly and to read @@ -5453,6 +5470,18 @@ video Set the video mode used (PC NetHack only). Values are "autode- tect", "default", "vga", or "vesa". Setting "vesa" will cause + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 84 + + + the game to display tiles, using the full capability of the VGA hardware. Setting "vga" will cause the game to display tiles, fixed at 640x480 in 16 colors, a mode that is compatible with @@ -5469,19 +5498,6 @@ Set the VGA mode resolution width (MS-DOS only, with video:vesa) - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 84 - - - videocolors Set the color palette for PC systems using NO_TERMS (default 4-2-6-1-5-3-15-12-10-14-9-13-11, (PC NetHack only). The order @@ -5520,6 +5536,18 @@ Sets an exception to the pickup_types option. The autopick- up_exception option should be followed by a regular expression to be used as a pattern to match against the singular form of + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 85 + + + the description of an object at your location. In addition, some characters are treated specially if they oc- @@ -5537,17 +5565,6 @@ effect if you save and then restore your game. autopickup_ex- ception rules and not saved with the game. - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 85 - - - Here are some examples: autopickup_exception="<*arrow" @@ -5585,6 +5602,18 @@ The menu control or accelerator keys can also be rebound via OPTIONS lines in the configuration file. You cannot bind ob- ject symbols or selection letters into menu accelerators. Some + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 86 + + + interfaces only support some of the menu accelerators. Mouse buttons @@ -5602,18 +5631,6 @@ Prefix key to start a count, to repeat a command this many times. With number_pad only. Default is `n'. - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 86 - - - getdir.help When asked for a direction, the key to show the help. Default is `?'. @@ -5651,6 +5668,18 @@ When asked for a location, the key to go to next closest door or doorway. Default is `d'. + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 87 + + + getpos.door.prev When asked for a location, the key to go to previous closest door or doorway. Default is `D'. @@ -5667,19 +5696,6 @@ When asked for a location, the key to go to previous closest monster. Default is `M'. - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 87 - - - getpos.obj.next When asked for a location, the key to go to next closest ob- ject. Default is `o'. @@ -5718,6 +5734,18 @@ getpos.pick.quick When asked for a location, the key to choose the location, skip + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 88 + + + asking for more info, and exit the location asking loop. De- fault is `;'. @@ -5733,19 +5761,6 @@ When asked for a location, the key to go to next closest unex- plored location. Default is `x'. - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 88 - - - getpos.unexplored.prev When asked for a location, the key to go to previous closest unexplored location. Default is `X'. @@ -5786,6 +5801,17 @@ Here's an example of message types using NetHack's internal pattern matching facility: + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 89 + + + MSGTYPE=stop "You feel hungry." MSGTYPE=hide "You displaced *." @@ -5797,21 +5823,6 @@ matching rule is used. Put the general case first, exceptions below them. - - - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 89 - - - 9.11. Configuring Menu Colors Some platforms allow you to define colors used in menu lines @@ -5855,6 +5866,18 @@ specifies that any menu line with " blessed " contained in it will be shown in green color, lines with " cursed " will be shown in red, and lines with " cursed " followed by "(being + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 90 + + + worn)" on the same line will be shown in red color and under- lined. You can have multiple MENUCOLOR entries in your config- uration file, and the last MENUCOLOR line that matches a menu @@ -5865,19 +5888,6 @@ plicit_uncursed option off so that all items known to be uncursed are actually displayed with the "uncursed" description. - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 90 - - - 9.12. Configuring User Sounds Some platforms allow you to define sound files to be played @@ -5922,6 +5932,18 @@ setting thresholds to change the color or appearance of fields in the status display. + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 91 + + + The format for defining status colors is: OPTION=hilite_status:field-name/behavior/color&attributes @@ -5932,18 +5954,6 @@ OPTION=hilite_status:hitpoints/<=30%/red/normal - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 91 - - - (That example is actually specifying red&normal for <=30% and no- color&normal for >30%.) @@ -5987,6 +5997,19 @@ intelligence power hunger wisdom power-max carrying-capacity charisma armor-class condition + + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 92 + + + alignment score The pseudo-field "characteristics" can be used to set all six @@ -5997,20 +6020,8 @@ Instead of a behavior, "condition" takes the following condi- tion flags: stone, slime, strngl, foodpois, termill, blind, - deaf, stun, conf, hallu, lev, fly, and ride. You can use - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 92 - - - - "major_troubles" as an alias for stone through termill, "mi- + deaf, stun, conf, hallu, lev, fly, and ride. You can use "ma- + jor_troubles" as an alias for stone through termill, "mi- nor_troubles" for blind through hallu, "movement" for lev, fly, and ride, and "all" for every condition. @@ -6052,6 +6063,19 @@ of being exactly 1 experience point short of the next lev- el. + + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 93 + + + * absolute value sets the attribute when the field value matches that number. The number must be 0 or higher, ex- cept for "armor-class' which allows negative values, and @@ -6064,18 +6088,6 @@ the text. Text matches can only be used for "alignment", "carrying-capacity", "hunger", "dungeon-level", and "ti- tle". For title, only the role's rank title is tested; - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 93 - - - the character's name is ignored. The in-game options menu can help you determine the correct @@ -6118,6 +6130,18 @@ prefix to take the following character literally. Thus \ needs to be represented as \\. The special prefix form \m switches on the meta bit in the symbol value, and the ^ prefix causes the + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 94 + + + following character to be treated as a control character. NetHack Symbols @@ -6129,19 +6153,6 @@ A S_angel (angelic being) a S_ant (ant or other insect) ^ S_anti_magic_trap (anti-magic field) - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 94 - - - [ S_armor (suit or piece of armor) [ S_armour (suit or piece of armor) ^ S_arrow_trap (arrow trap) @@ -6184,6 +6195,19 @@ S_expl_mc (explosion middle center) | S_expl_mr (explosion middle right) \ S_expl_bl (explosion bottom left) + + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 95 + + + - S_expl_bc (explosion bottom center) / S_expl_br (explosion bottom right) e S_eye (eye or sphere) @@ -6195,19 +6219,6 @@ { S_fountain (fountain) F S_fungus (fungus or mold) * S_gem (gem or rock) - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 95 - - - S_ghost (ghost) H S_giant (giant humanoid) G S_gnome (gnome) @@ -6250,6 +6261,19 @@ O S_ogre (ogre) o S_orc (orc) p S_piercer (piercer) + + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 96 + + + ^ S_pit (pit) # S_poisoncloud (poison cloud) ^ S_polymorph_trap (polymorph trap) @@ -6261,19 +6285,6 @@ = S_ring (ring) ` S_rock (boulder or statue) r S_rodent (rodent) - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 96 - - - ^ S_rolling_boulder_trap (rolling boulder trap) . S_room (floor of a room) / S_rslant (diagonal beam [zap animation]) @@ -6316,6 +6327,19 @@ - S_tuwall (wall) U S_umber (umber hulk) S_unexplored (unexplored terrain) + + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 97 + + + u S_unicorn (unicorn or horse) < S_upladder (ladder up) < S_upstair (staircase up) @@ -6327,19 +6351,6 @@ ^ S_vibrating_square (vibrating square) . S_vodbridge (vertical lowered drawbridge) - S_vodoor (open door in vertical wall) - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 97 - - - v S_vortex (vortex) | S_vwall (vertical wall) / S_wand (wand) @@ -6383,6 +6394,18 @@ The format for defining a glyph representation is: + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 98 + + + OPTIONS=glyph:glyphidU+nnnn/R-G-B The window port that is active needs to provide support for @@ -6394,18 +6417,6 @@ OPTIONS=glyph:G_pool/U+224B/0-0-160 - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 98 - - - The list of acceptable glyphid's can be produced by nethack --dumpglyphids. Individual NetHack glyphs can be specified using the G_ prefix, or you can use an S_ symbol for a glyphid and @@ -6449,6 +6460,18 @@ The most crucial settings to make the game more accessible are: + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 99 + + + symset:plain Load a symbol set appropriate for use by blind players. @@ -6460,18 +6483,6 @@ number_pad A lot of speech access programs use the number-pad to review - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 99 - - - the screen. If this is the case, disable the number_pad option and use the traditional Rogue-like commands. @@ -6515,6 +6526,18 @@ es a compiled-in default (which may not be appropriate for your system). + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 100 + + + WIZARDS = A space-separated list of user names who are allowed to play in debug mode (commonly referred to as wizard mode). A value of a single asterisk (*) allows anyone to start a game in @@ -6526,18 +6549,6 @@ EXPLORERS = A list of users who are allowed to use the explore mode. The syntax is the same as WIZARDS. - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 100 - - - MAXPLAYERS = Limit the maximum number of games that can be run- ning at the same time. @@ -6581,6 +6592,18 @@ ENTRYMAX = Maximum number of entries in the score file. + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 101 + + + POINTSMIN = Minimum number of points to get an entry in the score file. @@ -6593,17 +6616,6 @@ MAX_STATUENAME_RANK = Maximum number of score file entries to use for random statue names (default is 10). - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 101 - - - ACCESSIBILITY = 0 or 1 to disable or enable, respectively, the ability for players to set S_pet_override and S_hero_override symbols in their configuration file. @@ -6646,6 +6658,18 @@ your machine, depending on how it is set up. In the latter case, each account on the machine can post only one non-winning score on this list. If you score higher than someone else on this + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 102 + + + list, or better your previous score, you will be inserted in the proper place under your current name. How many scores are kept can also be set up when NetHack is compiled. @@ -6658,18 +6682,6 @@ corpse is discovered (adventurers have been known to collect finder's fees). So, consider whether you want to take one last hit at that monster and possibly live, or quit and stop with - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 102 - - - whatever you have. If you quit, you keep all your gold, but if you swing and live, you might find more. @@ -6713,6 +6725,17 @@ allowed or not available will result in falling back to explore mode instead. + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 103 + + + 12. Credits The original hack game was modeled on the Berkeley UNIX @@ -6725,17 +6748,6 @@ Main events in the course of the game development are described below: - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 103 - - - Jay Fenlason wrote the original Hack, with help from Kenny Woodland, Mike Thome, and Jon Payne. @@ -6778,6 +6790,18 @@ of them and Kevin Darcy later joined the main NetHack Development Team to produce subsequent revisions of 3.0. + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 104 + + + Olaf Seibert ported NetHack 2.3 and 3.0 to the Amiga. Norm Meluch, Stephen Spackman and Pierre Martineau designed overlay code for PC NetHack 3.0. Johnny Lee ported NetHack 3.0 to the @@ -6790,18 +6814,6 @@ for the base release and variously as "3.0a" through "3.0j", "3.0 patchlevel 1" through "3.0 patchlevel 10", or "3.0pl1" through "3.0pl10" rather than 3.0.0 and 3.0.1 through 3.0.10; the - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 104 - - - three component numbering scheme began to be used with 3.1.0. Headed by Mike Stephenson and coordinated by Izchak Miller @@ -6844,6 +6856,18 @@ mor and so forth, not separate images for beetles and ants or for cloaks and boots). + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 105 + + + Warwick Allison wrote a graphically displayed version of NetHack for the Atari where the tiny pictures were described as "icons" and were distinct for specific types of monsters and ob- @@ -6856,18 +6880,6 @@ The 3.2 NetHack Development Team, comprised of Michael Alli- son, Ken Arromdee, David Cohrs, Jessie Collet, Steve Creps, Kevin - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 105 - - - Darcy, Timo Hakulinen, Steve Linhart, Dean Luick, Pat Rankin, Er- ic Smith, Mike Stephenson, Janet Walz, and Paul Winner, released version 3.2.0 in April of 1996. @@ -6910,6 +6922,18 @@ released as a source code patch only, without any ready-to-play distribution for systems that usually had such. + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 106 + + + (To anyone considering resurrecting an old version: all versions before 3.2.3 had a Y2K bug. The high scores file and the log file contained dates which were formatted using a two- @@ -6921,19 +6945,6 @@ names to use for random ghost and statue names in the current game.) - - - - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 106 - - - The 3.3 NetHack Development Team, consisting of Michael Al- lison, Ken Arromdee, David Cohrs, Jessie Collet, Steve Creps, Kevin Darcy, Timo Hakulinen, Kevin Hugo, Steve Linhart, Ken Lor- @@ -6978,19 +6989,8 @@ face for the Windows port. Alex Kompel also contributed a Win- dows CE port for 3.4.1. - Ron Van Iwaarden was the sole maintainer of NetHack for OS/2 - the past several releases. Unfortunately Ron's last OS/2 machine - stopped working in early 2006. A great many thanks to Ron for - keeping NetHack alive on OS/2 all these years. - Janne Salmijarvi and Teemu Suikki maintained and enhanced - the Amiga port of 3.4 after Janne Salmijarvi resurrected it for - 3.3.1. - - - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -7000,6 +7000,15 @@ + Ron Van Iwaarden was the sole maintainer of NetHack for OS/2 + the past several releases. Unfortunately Ron's last OS/2 machine + stopped working in early 2006. A great many thanks to Ron for + keeping NetHack alive on OS/2 all these years. + + Janne Salmijarvi and Teemu Suikki maintained and enhanced + the Amiga port of 3.4 after Janne Salmijarvi resurrected it for + 3.3.1. + Christian "Marvin" Bressler maintained 3.4 for the Atari af- ter he resurrected it for 3.3.1. @@ -7045,18 +7054,9 @@ 3.6.0 was released in December 2015, and merged work done by the development team since the release of 3.4.3 with some of the beloved community patches. Many bugs were fixed and some code was - restructured. - - The NetHack Development Team, as well as Steve VanDevender - and Kevin Smolkowski, ensured that NetHack 3.6 continued to oper- - ate on various UNIX flavors and maintained the X11 interface. - - Ken Lorber, Haoyang Wang, Pat Rankin, and Dean Luick main- - tained the port of NetHack 3.6 for Mac OSX. - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -7066,6 +7066,15 @@ + restructured. + + The NetHack Development Team, as well as Steve VanDevender + and Kevin Smolkowski, ensured that NetHack 3.6 continued to oper- + ate on various UNIX flavors and maintained the X11 interface. + + Ken Lorber, Haoyang Wang, Pat Rankin, and Dean Luick main- + tained the port of NetHack 3.6 for Mac OSX. + Michael Allison, David Cohrs, Bart House, Pasi Kallinen, Alex Kompel, Dion Nicolaas, Derek S. Ray and Yitzhak Sapir main- tained the port of NetHack 3.6 for Microsoft Windows. @@ -7111,18 +7120,9 @@ https://www.nethack.org/. - 12.1. Special Thanks - - On behalf of the NetHack community, thank you very much once - again to M. Drew Streib and Pasi Kallinen for providing a public - NetHack server at nethack.alt.org. Thanks to Keith Simpson and - Andy Thomson for hardfought.org. Thanks to all those unnamed dun- - geoneers who invest their time and effort into annual NetHack - tournaments such as Junethack, The November NetHack Tournament, - and in days past, devnull.net (gone for now, but not forgotten). - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022 @@ -7132,6 +7132,15 @@ + 12.1. Special Thanks + + On behalf of the NetHack community, thank you very much once + again to M. Drew Streib and Pasi Kallinen for providing a public + NetHack server at nethack.alt.org. Thanks to Keith Simpson and + Andy Thomson for hardfought.org. Thanks to all those unnamed dun- + geoneers who invest their time and effort into annual NetHack + tournaments such as Junethack, The November NetHack Tournament, + and in days past, devnull.net (gone for now, but not forgotten). @@ -7176,6 +7185,19 @@ Eric S. Raymond Mark Modrall Steve Linhart Erik Andersen Marvin Bressler Steve VanDevender Fredrik Ljungdahl Matthew Day Teemu Suikki + + + + NetHack 3.7 December 26, 2022 + + + + + + NetHack Guidebook 110 + + + Frederick Roeber Merlyn LeRoy Tim Lennan Gil Neiger Michael Allison Timo Hakulinen Greg Laskin Michael Feir Tom Almy @@ -7188,16 +7210,6 @@ - NetHack 3.7 December 24, 2022 - - - - - - NetHack Guidebook 110 - - - Brand and product names are trademarks or registered trade- marks of their respective holders. @@ -7242,19 +7254,7 @@ - - - - - - - - - - - - - NetHack 3.7 December 24, 2022 + NetHack 3.7 December 26, 2022