        Microsoft Windows specific help file for NetHack 3.4.0
        Copyright (c) NetHack PC Development Team 1993-2002.
        NetHack may be freely distributed.  See license for details.
                   (Last Revision: March 10, 2002)

This file details specifics for NetHack built for Windows 95, 98, NT, 
Me, 2000, and XP. Users of really early 16-bit Windows versions should 
use the MSDOS NetHack. 

Please note that "NetHack for Windows - Graphical Interface" requires 
an installation of Internet Explorer 4 or an installation of 
version 4.71 of the common controls. See the following internet page: 
    http://www.nethack.org/v340/ports/download-win.html#cc
for more information. If the game runs for you, you are not affected.

New players should be sure to read GuideBook.txt which contains 
essential information about playing NetHack. It can be found in the
same directory as your NetHack executable.

The Windows port of NetHack supports some additional or enhanced 
commands as well as some defaults.nh file options specific to 
configuration choices used during the building of NetHack for 
Windows. Listed below are those commands and defaults.nh file 
options. 

Some options are applicable only to the graphical port. 
These are discussed separately in their own section. 

Contents
1. Boolean options
2. Graphical Port Complex options
3. Graphical Port Additional/Enhanced Commands
4. Available ALT Key Combinations
5. Graphical Port Menus

1. Boolean Options
------------------

Listed here are any options not discussed in the main help, options 
which may be slightly different from the main help file, and options 
which may need a slightly more explanatory note: 

    color          Use color when displaying non-tiled maps. Tiled 
                   maps (available in the graphical port) are always 
                   rendered in color. Default: [TRUE]

    IBMgraphics    Use IBM extended characters for the dungeon 
                   Default: [TRUE] 
 
    use_inverse    Use inverse color for detection (similar to hilite_pet). 
                   Default: [FALSE] 

    msg_window     When ^P is pressed, it shows menu in a full window.
                   Default: [FALSE] 


2. Graphical Port Complex Options
---------------------------------

"NetHack for Windows - Graphical Interface" recognizes the following 
additional options, which the non-graphical (tty) version will
silently ignore:

Window Alignment options:

                   |
    align_message  Specifies at which side of the NetHack screen the 
                   message window is aligned. This option can be used 
                   to align the window to "top" or "bottom". "left" 
                   or "right" are possible, but not properly supported 
                   in the Microsoft Windows port. Default: [TOP] 

    align_status   Specifies at which side of the NetHack screen the 
                   status window is aligned. This option can be used 
                   to align the window to "top" or "bottom". "left" 
                   or "right" are possible, but not properly supported 
                   in the Microsoft Windows port. Default: [BOTTOM] 

Other Window options:

These are options that specify attributes of various windows. 
These include the menu windows (such as the inventory list), 
the text windows (such as "It is written in the book of ..." 
screens), the message window (where events of the game are 
displayed), and the status window (where your character name 
and attributes are displayed). 

    font_menu      Specifies the name of the menu font. 
    font_message   Specifies the name of the message font. 
    font_status    Specifies the name of the status font. 
    font_text      Specifies the name of the text font. 

    font_size_menu Specifies the size of the menu font. 
    font_size_message 
                   Specifies the size of the message font.
    font_size_status 
                   Specifies the size of the status font.
    font_size_text 
                   Specifies the size of the text font. 

Map Window options:

    map_mode       Specifies which map mode to use. 
                   The following map modes are available: 
                   tiles (uses tiles to display things on the map), 
                   ascii4x6ascii6x8, ascii8x8, ascii16x8, ascii7x12
                   ascii8x12, ascii16x12, ascii12x16, ascii10x18
                   (which use that size font to display things on 
                   the map), or fit_to_screen (which forces things
                   to fit on a single screen display whether tiled
                   or ascii). Default: [tiles]

    scroll_margin  Specifies the margin of scrolling the map. 
                   Recommended to be set to 1 or greater. If set to 
                   80, this will keep your character centered on the map. 
                   Default: [5] 

    tile_file      An alternative file containing bitmap to use for 
                   tiles. This file should be a .bmp file and should 
                   be organized as 40 rectangular tiles wide. It is 
                   beyond the scope of this document to describe the 
                   exact contents of each tile in the .bmp which may 
                   even be dependent on the options that your version 
                   of NetHack was built with. 

                   If you are interested in creating a tile file of 
                   your own, create a regular build of NetHack using 
                   the graphical version and examine the file tiles.bmp 
                   in the src or build directory. This option may 
                   only be specified in the defaults.nh config file. 
                   Default: [default] 

   tile_height     Used with tile_file to specify the width of each 
                   tile in pixels. This option may only be specified
                   in the defaults.nh config file. 
                   Default: [16] 

   tile_width      Used with tile_file to specify the height of each 
                   tile in pixels. This option may only be specified
                   in the defaults.nh config file. 
                   Default: [16]

Miscellaneous options: 

    vary_msgcount  Number of lines to display in message window. 


3. Graphical Port Additional/Enhanced Commands
----------------------------------------------

The following function keys are active in
the "NetHack for Windows - Graphical Interface": 

    F4             Toggle level overview mode on/off 
                   This key will toggle the map between a view that 
                   is mapped to fit exactly to the window, and the 
                   view that shows the various symbols in their 
                   normal size. This is useful for getting an idea 
                   of where you are in a level. 

    F5             Toggle tiled display on/off. 
                   This key switches between the tiled and the 
                   traditional ASCII display. This is equivalent to 
                   using the "map_mode" option. 

    F10            Activate menu bar. 
                   This key will activate the menu bar, allowing you 
                   to select between the menus: File, Map, 
                   Window Settings, and Help. 

4. Available ALT Key Combinations
---------------------------------

While playing NetHack under Windows you can press the ALT key in 
combination with another key to execute an extended command as an 
alternative method to pressing a # key sequence. (The non-graphical
(tty) version is always running in NetHack mode, but 
"NetHack for Windows - Graphical Interface" can be toggled): 

    Alt-a    adjust         - adjust inventory letters.
    Alt-c    chat           - talk to someone or something.
    Alt-d    dip            - dip an object into something.
    Alt-e    enhance        - enhance your skill with a weapon.
    Alt-f    force          - force a lock. [works in NetHack mode only]
    Alt-i    invoke         - invoke an object's powers.
    Alt-j    jump           - jump to a location.
    Alt-l    loot           - loot a box on the floor.
    Alt-m    monster        - use a monster's special ability. 
                              [works in NetHack mode only]
    Alt-n    name           - name an item or type of object.
    Alt-o    offer          - offer a sacrifice to the gods.
    Alt-p    pray           - pray to the gods for help.
    Alt-q    quit           - quit the game. (Same as #quit)
    Alt-r    rub            - rub a lamp.
    Alt-s    sit            - sit down. [works in NetHack mode only]
    Alt-t    turn           - turn undead.
    Alt-u    untrap         - untrap something.
    Alt-v    version        - list compile time options for this version of
                              NetHack.
    Alt-w    wipe           - wipe off your face.

5. Graphical Port Menus
-----------------------

File
  Save - Allows you to save and exit the game
  Quit - Allows you to quit the game

Map - Provides for selection of map mode. Equivalent to using 
the map_mode option. 

Window Settings - Changes your logged-on user's settings for 
NetHack. In 3.4.0, only one setting is available: NetHack 
mode (or not). NetHack mode allows you to use ALT-f, ALT-m, and ALT-s 
for game key commands [see list above]. You can use F10 to 
access the menu bar while in NetHack mode. You can also 
clear your logged-on user's settings for NetHack. Settings 
in this window are saved in your logged-on user's registry. 

Help - Provides help about various portions of NetHack.

