1 # NetHack 3.6 config.nh $NHDT-Date: 1524689547 2018/04/25 20:52:27 $ $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.1 $
2 # Copyright (c) 2016 by Pasi Kallinen
3 # NetHack may be freely redistributed. See license for details.
4 # Sample config file for NetHack 3.6
6 # A '#' at the beginning of a line means the rest of the line is a comment.
8 # Some options must be set in this file, other options can be toggled while
11 # Copy the contents of this file into
12 # * defaults.nh, same folder as nethack.exe or nethackW.exe (DOS, Windows)
13 # * ~/.nethackrc (Unix, linux, Mac OS X)
14 # * "NetHack Defaults" on pre-OSX Mac and BeOS
15 # * NetHack.cnf on Amiga, Atari, OS/2, and VMS
17 # To change the configuration, comment out the unwanted lines, and
18 # uncomment the configuration you want.
20 # There are two types of options, boolean and compound options.
21 # Boolean options toggle a setting on or off, while compound options
22 # take more diverse values.
23 # Prefix a boolean option with 'no' or '!' to turn it off.
24 # For compound options, the option name and value are separated by a colon.
26 # Some options are persistent, and apply only to new games.
28 # For more information about the options, see the Guidebook.
31 # Set your character's name.
34 # Set your character's role, race, gender, and alignment
35 #OPTIONS=role:Valkyrie, race:Human, gender:female, align:lawful
37 # Set the default dog, cat, and horse names, and your fruit
39 #OPTIONS=catname:Morris
40 #OPTIONS=horsename:Silver
43 # Turn on autopickup, and set object types which are picked up automatically
44 # Both are persistent.
45 #OPTIONS=autopickup,pickup_types:$"=/!?+
46 # Automatically pick up items you threw. Persistent.
47 #OPTIONS=pickup_thrown
48 # When you pick up an item that would exceed this encumbrance
49 # level (Unencumbered, Burdened, streSsed, straiNed, overTaxed,
50 # or overLoaded), you will be asked if you want to continue. Persistent.
51 #OPTIONS=pickup_burden:u
54 # Enable messages about what your character hears
57 # Causes NetHack's top level command loop to treat two character sequence
58 # "ESC c" as M-c, for terminals or emulators which send "ESC c" when Alt+c
62 # NetHack should display an ascii character map if it can.
65 # Automatically describe the terrain under cursor when asked to
66 # get a location on the map.
69 # Automatically dig if walking into a wall and you're wielding a digging
70 # implement or can otherwise dig through the wall.
73 # Automatically try to open doors when walking into them
76 # Let NetHack fill your quiver or make ready some suitable weapon,
77 # when firing with empty quiver or nothing at the ready.
80 # Conduct/Role-playing: blind from birth or "zen"
82 # Conduct/Role-playing: starts with no worn armor.
83 # Wearing any armor will make you lose this conduct
86 # Disable loading and saving of bones files
89 # Save game state after each level change, for possible recovery
93 # Allows looking at things on the screen by navigating the mouse
94 # over them and clicking the right mouse button
97 # Show assistance when you mistype a command
100 # Display color if possible for different monsters, objects,
101 # and dungeon features
104 # Have user confirm attacks on pets, shopkeepers, and other
105 # peaceable creatures (default on).
108 # Highlight out-of-sight room floors with different color or glyph
111 # Controls what information the program reveals when the game ends.
112 #OPTIONS=disclose:+i +a +v +g +c +o
114 # NetHack should pass eight-bit character values straight through
115 # to your terminal (default off).
116 #OPTIONS=eight_bit_tty
118 # Change the extended commands interface to pop-up a menu of
119 # available commands.
122 # Objects will try to keep their inventory letters
125 # Try and display on the entire screen rather than in a window.
128 # If more information is available for an object looked at with
129 # the '/' command, ask if you want to see it (default on).
132 # Hilight pets with a heart symbol (Windows, X11), or inverse attribute (TTY)
135 # Visually distinguish piles of objects from individual objects
138 # Always show the "uncursed" for inventory objects. Useful for MENUCOLORs
139 #OPTIONS=implicit_uncursed
141 # Do not show the legacy intro text at game start
144 # Show lit corridors differently
145 #OPTIONS=lit_corridor
147 # Use the old 'a', 'b', and 'c' keyboard shortcuts when looting,
148 # rather than the mnemonics 'o', 'i', and 'b' (default off).
151 # Don't deliver email in-game
154 # Mention in the message line when walking at a wall. Useful for blind players.
155 #OPTIONS=mention_walls
157 # How menus are shown. Values are 'traditional', 'combination',
158 # 'full', or 'partial'
159 #OPTIONS=menustyle:full
161 # Set menu accelerator keys
162 #OPTIONS=menu_deselect_all:-
163 #OPTIONS=menu_deselect_page:\
164 #OPTIONS=menu_first_page:^
165 #OPTIONS=menu_invert_all:@
166 #OPTIONS=menu_invert_page:~
167 #OPTIONS=menu_last_page:|
168 #OPTIONS=menu_next_page:>
169 #OPTIONS=menu_previous_page:<
170 #OPTIONS=menu_search::
171 #OPTIONS=menu_select_all:.
172 #OPTIONS=menu_select_page:,
174 # Controls how the headings in a menu are highlighted.
175 # Values are 'none', 'bold', 'dim', 'underline', 'blink', or 'inverse'.
176 # Default is 'inverse'
177 #OPTIONS=menu_headings:inverse
179 # Show object symbols in menus in the item class lines where that object symbol
180 # acts as an accelerator key to select items of that class.
181 #OPTIONS=menu_objsyms
183 # Do not clear the screen before drawing menus, and align menus to right
184 #OPTIONS=menu_overlay
186 # Set the number of messages saved into message history (^P -command)
187 #OPTIONS=msghistory:50
189 # Allows you to change the way recalled messages are displayed.
190 # The possible values are:
191 # 's' single message (default; only choice prior to 3.4.0)
192 # 'c' combination, two messages as `single', then as `full'
193 # 'f' full window, oldest message first
194 # 'r' full window reversed, newest message first
195 # Default is 's'. TTY only.
196 #OPTIONS=msg_window:s
198 # Allow use of the mouse for input and travel.
199 #OPTIONS=mouse_support
201 # Read the NetHack news file, if present (default on).
204 # Send padding nulls to the terminal (default on).
207 # Use number pad or vi-keys for movement?
208 # number_pad option can have an optional value of 0 (off), 1 (on),
209 # or 2 (on,legacy-mode) which causes 5='g', alt-5='G', alt-0='I'
210 # -1 (use vi-keys, but swap z and y, for qwertz keyboards)
211 #OPTIONS=number_pad:2
213 # Set the order in which item classes appear in your inventory
214 #OPTIONS=packorder:")[%?+/=!(*0_`
216 # A space separated list of specific situations where alternate
217 # prompting is desired. The default is paranoid_confirmation:pray.
218 #OPTIONS=paranoid_confirmation:confirm quit die bones attack pray remove
220 # Always show the inventory window? X11 and Windows GUI only.
223 # Specify the type of your initial pet, if you are playing a character class
224 # that uses multiple types of pets; or choose to have no initial pet at all.
225 # Possible values are "cat", "dog", "horse", and "none".
228 # Threshold when item pile under you is shown in a popup list. Persistent.
229 #OPTIONS=pile_limit:5
232 # Values are 'normal', 'explore', or 'debug'.
233 #OPTIONS=playmode:normal
235 # Preload tiles into memory. MSDOS only.
236 #OPTIONS=preload_tiles
238 # When wielding a weapon, move your previous weapon to other hand
241 # Space key acts as a wait.
242 #OPTIONS=rest_on_space
244 # Controls the amount of screen updating for the map window when engaged
245 # in multi-turn movement. Possible values are 'teleport', 'run', 'walk',
246 # or 'crawl'. Default is 'run'.
249 # Ask if you really want to hit your pet
252 # Perform extra data checking. Wizard-mode only.
253 #OPTIONS=sanity_check
255 # Display a menu of existing saved games for the player to choose from
256 # at game startup, if it can. Not all ports support this option.
259 # Which parts of the score file to show at end of game
260 #OPTIONS=scores:10 top/2 around/own
262 # Do not show experience points in the status line
265 # Show your own symbol with the symbol of your race
266 # eg. 'G' if you're a gnome, 'h' if dwarf, etc.
269 # Show score on the status line
272 # Suppress terminal beeps. Default on.
275 # Controls the sorting behavior of the pickup lists for inventory.
276 # Possible values are 'full', 'loot', and 'none'.
277 #OPTIONS=sortloot:full
279 # Sort the pack contents by type when displaying inventory (default on).
282 # Disable sparkly magic resistance animation effect
285 # Boldface monsters and --More-- (default off).
288 # NetHack version level to suppress alert notification messages
289 # about feature changes for that and prior versions.
290 #OPTIONS=suppress_alert:3.6.0
292 # Show current turn in the status line
295 # When pausing momentarily for display effect, such as with explosions and
296 # moving objects, use a timer rather than sending extra characters to the
300 # Draw a tombstone graphic upon your death (default on).
303 # Do not show top ten list in a separate window. Windows GUI only.
306 # Enable travel (_) command.
309 # Use the dark gray color
310 #OPTIONS=use_darkgray
312 # Use inverse text attribute in eg. menu titles
315 # Display this number of messages at a time in the message window.
316 # WinCE, Windows GUI, and GEM only.
317 #OPTIONS=vary_msgcount:3
319 # Be less verbose with the messages
322 # Set the color palette for PC systems using NO_TERMS (MS-DOS only).
323 # The order of colors is red, green, brown, blue, magenta, cyan,
324 # bright.white, bright.red, bright.green, yellow, bright.blue,
325 # bright.magenta, and bright.cyan.
326 #OPTIONS=videocolors:4-2-6-1-5-3-15-12-10-14-9-13-11
328 # Gray shades to map to black-gray-white. possible values are 'dark',
329 # 'normal', and 'light'. MS-DOS only.
330 #OPTIONS=videoshades:normal-normal-normal
332 # When using '/' or ';' commands with autodescribe-option on, display
333 # coordinates after the description. Possible values are 'compass',
334 # 'map', 'screen', or 'none'
335 #OPTIONS=whatis_coord:map
337 # Windowing system to use, such as 'tty' or 'x11'.
338 #OPTIONS=windowtype:tty
340 # NetHack port should wrap long lines of text if they don't fit in
341 # the visible area of the window.
347 # How the map window is shown? Windows GUI only.
348 # possible map_mode options include: tiles, ascii4x6,
349 # ascii6x8, ascii8x8, ascii16x8, ascii7x12, ascii8x12, ascii16x12,
350 # ascii12x16, ascii10x18, fit_to_screen, ascii_fit_to_screen,
351 # tiles_fit_to_screen
352 #OPTIONS=map_mode:tiles
354 # Define alternative file for the files, and the tile size
355 #OPTIONS=tile_file:C:\absurd64.bmp
356 #OPTIONS=tile_width:64,tile_height:64
358 # When does the map window scroll? Windows GUI only.
359 #OPTIONS=scroll_margin:5
361 # Message window settings. Windows GUI only.
362 #OPTIONS=font_message:Arial,font_size_message:9,align_message:top
364 # Menu settings. Windows GUI only.
365 #OPTIONS=font_menu:Arial,font_size_menu:9
367 # Text settings. Windows GUI only.
368 #OPTIONS=font_text:Courier New,font_size_text:9
370 # Status window settings. Windows GUI only.
371 #OPTIONS=font_status:Courier New,font_size_status:9
373 # No startup splash screen. Windows GUI only.
374 #OPTIONS=!splash_screen
376 # How does NetHack prompt for character creation. Windows GUI only.
377 #OPTIONS=player_selection:prompts
379 # NetHack should pop up dialog boxes for input.
381 #OPTIONS=popup_dialog
383 # Status/message window colors. Windows GUI only.
384 # Possible color options include:
385 # six digit hexadecimal RGB color value ("#8F8F8F"), black, red, green, brown,
386 # blue, magenta, cyan, gray (or grey), orange, brightgreen, yellow, brightblue,
387 # brightmagenta, brightcyan, white, trueblack, purple, silver, maroon, fuchsia,
388 # lime, olive, navy, teal, aqua, activeborder, activecaption, appworkspace,
389 # background, btnface, btnshadow, btntext, captiontext, graytext, highlight,
390 # highlighttext, inactiveborder, inactivecaption, menu, menutext, scrollbar,
391 # window, windowframe, windowtext.
392 # windowcolors:<window> <text_color>/<background_color>
393 #OPTIONS=windowcolors:status windowtext/window message windowtext/window
395 # HACKDIR is the default location for everything.
396 # Note: On Windows HACKDIR defaults to the location of the NetHack.exe or
397 # NetHackw.exe file so setting HACKDIR below to override that is not usually
398 # necessary or recommended.
399 #HACKDIR=c:\games\nethack
401 # The location that level files in progress are stored
402 # (default=HACKDIR, writable)
403 #LEVELDIR=c:\nethack\levels
405 # The location where saved games are kept (default=HACKDIR, writable)
406 #SAVEDIR=c:\nethack\save
408 # The location that bones files are kept (default=HACKDIR, writable)
409 #BONESDIR=c:\nethack\save
411 # The location that file synchronization locks are stored
412 # (default=HACKDIR, writable)
413 #LOCKDIR=c:\nethack\levels
415 # The location that a record of game aborts and self-diagnosed game problems
416 # is kept (default=HACKDIR, writable)
417 #TROUBLEDIR=c:\nethack\trouble
419 # Finnish keyboards might need these modifications uncommented. Windows GUI.
421 #OPTIONS=subkeyvalue:171/92
422 #OPTIONS=subkeyvalue:178/64
423 #OPTIONS=subkeyvalue:180/36
424 #OPTIONS=subkeyvalue:184/91
425 #OPTIONS=subkeyvalue:188/124
427 # Some versions of Windows allow you to adjust the win32 console port
428 # colors using R-G-B settings.
429 #OPTIONS=palette:black-0-0-0
430 #OPTIONS=palette:red-210-0-0
431 #OPTIONS=palette:green-80-200-0
432 #OPTIONS=palette:brown-180-100-0
433 #OPTIONS=palette:blue-0-0-200
434 #OPTIONS=palette:magenta-128-0-128
435 #OPTIONS=palette:cyan-50-180-180
436 #OPTIONS=palette:gray-192-192-192
437 #OPTIONS=palette:dark gray-100-100-100
438 #OPTIONS=palette:orange-255-128-0
439 #OPTIONS=palette:bright green-0-255-0
440 #OPTIONS=palette:yellow-255-255-0
441 #OPTIONS=palette:bright blue-100-100-240
442 #OPTIONS=palette:bright magenta-255-0-255
443 #OPTIONS=palette:bright cyan-0-255-255
444 #OPTIONS=palette:white-255-255-255
448 # Set exceptions to the pickup_types option. You can use multiple exceptions.
449 # First character must be '<' (autopick) or '>' (don't autopick), followed
450 # by a regular expression.
451 # Always autopickup any type of arrow
452 #AUTOPICKUP_EXCEPTION="<arrow"
453 # Never autopickup any corpse
454 #AUTOPICKUP_EXCEPTION=">corpse"
455 # Never autopickup any known cursed items
456 #AUTOPICKUP_EXCEPTION="> cursed"
459 # Change the way messages are shown in the top status line.
460 # You can use multiple MSGTYPE lines.
461 # Format is MSGTYPE=type "regular expression"
462 # Where type is one of 'show', 'hide', 'stop', or 'norep'
463 # Always prompt for more after becoming hungry.
464 #MSGTYPE=stop "You feel hungry."
465 # Never show any displacing your pet messages.
466 #MSGTYPE=hide "You displaced .*"
467 # Don't repeat message when seeing same items on the floor
468 #MSGTYPE=norep "You see here a *"
469 #MSGTYPE=norep "You see here an *"
472 # Highlight menu lines with different colors. You need to define the colors
473 # with MENUCOLOR lines. Only for TTY and Windows GUI.
474 # Toggle menucolor use on or off
476 # Define color used for a certain menu line. Format is
477 # MENUCOLOR="regular expression"=color
479 # MENUCOLOR="regular expression"=color&attribute
480 # Show all blessed items in green
481 #MENUCOLOR=" blessed " = green
482 # Show all holy water in green
483 #MENUCOLOR=" holy " = green
484 # Show all cursed items in red
485 #MENUCOLOR=" cursed " = red
486 # Show all unholy water in red
487 #MENUCOLOR=" unholy " = red
488 # Show all cursed worn items in orange and underlined
489 #MENUCOLOR=" cursed .* (being worn)" = orange&underline
492 # Use the IBM character set rather than just plain ascii characters
493 # for tty window-port.
494 #OPTIONS=symset:IBMGraphics_2
495 # Use RogueEpyx character set for the rogue level
496 #OPTIONS=roguesymset:RogueEpyx
498 # Override one or more symbols in the symbols files.
499 # See the Guidebook for the symbol names.
500 # Set boulder symbol to '0'
505 # Load DEC text characters display symbols. Deprecated.
507 # Load IBM text characters display symbols. Deprecated.
509 # Set the character symbol used for boulders. Deprecated.
513 # Wizard-mode extra items, in a text file containing item names,
514 # one per line, up to a maximum of 128 lines. Each line is processed
515 # by the function that handles wishing.
520 # Define the directory that contains the sound files
521 #SOUNDDIR=C:\nethack\sounds\
522 # Define a sound mapping
523 # SOUND=MESG "pattern" file volume
524 #SOUND=MESG "KAABLAMM" explosion.wav 100
527 # Turn on all status hilites.
528 #OPTIONS=statushilites
529 # Use highlighting in the status lines when it changes?
530 #OPTIONS=hilite_status:hitpoints/30%/bright-magenta/normal