👉 GnollHack provides a vast array of configuration options that allow you to customize the user interface, gameplay mechanics, controls, and audio settings to fit your playstyle. This page serves as a comprehensive reference for all available options, whether you are playing on a modern graphical port or a classic terminal interface.
Getting Started
- Accessing Options File — How to access the Options file on various platforms
🖥️ User Interface & Display
| Option Name | Values | Default | Description |
| :— | :— | :— | :— |
| DECgraphics | (varies) | (varies) | Load DECGraphics display symbols (ASCII Only) (Obsolete) |
| IBMgraphics | (varies) | (varies) | Load IBMGraphics display symbols (ASCII Only) (Obsolete) |
| Macgraphics | (varies) | (varies) | Load MACGraphics display symbols (ASCII Only) (Obsolete) |
| align_message | (varies) | top | Message window alignment |
| align_status | (varies) | top | Status window alignment |
| animation_interval | (varies) | 20 | Animation frame interval in milliseconds |
| ascii_map | true / false | false | Show map as text (ASCII Only) |
| autostatuslines | true / false | false | Automatically adjust message lines and status lines in the curses interface (ASCII Only) |
| blinking_cursor_on_tiles | true / false | false | Display a blinking cursor when using tiles |
| classic_colors | true / false | false | Use classic colors for boulders and floor symbols (ASCII Only) |
| classic_statue_symbol | true / false | false | Use classic symbol '' for statues **(ASCII Only)** |
| **color** | true / false | true | Use color in map **(ASCII Only)** |
| **crawl_interval** | *(varies)* | 15 | Crawl movement interval in milliseconds |
| **cursesgraphics** | *(varies)* | *(varies)* | Load curses display symbols **(ASCII Only)** **(Obsolete)** |
| **dark_room** | true / false | true | Show floor outside line of sight differently |
| **detailed_weights** | true / false | false | Show object weights using more accurate units |
| **eight_bit_tty** | true / false | false | Send 8-bit characters directly to terminal **(ASCII Only)** |
| **extmenu** | true / false | true | Use menu for getting extended commands **(ASCII Only)** |
| **fast_map** | true / false | true | Use optimized, less flexible map display |
| **font_map** | *(varies)* | *(varies)* | The font to use in the map window |
| **font_menu** | *(varies)* | *(varies)* | The font to use in menus |
| **font_message** | *(varies)* | *(varies)* | The font to use in the message window |
| **font_size_map** | *(varies)* | *(varies)* | The size of the map font |
| **font_size_menu** | *(varies)* | *(varies)* | The size of the menu font |
| **font_size_message** | *(varies)* | *(varies)* | The size of the message font |
| **font_size_status** | *(varies)* | *(varies)* | The size of the status font |
| **font_size_text** | *(varies)* | *(varies)* | The size of the text font |
| **font_status** | *(varies)* | *(varies)* | The font to use in status window |
| **font_text** | *(varies)* | *(varies)* | The font to use in text windows |
| **fullscreen** | true / false | false | Toggle fullscreen |
| **fullstatuslineorder** | true / false | true | Use full status line order |
| **guicolor** | true / false | true | Use color for UI |
| **here_window_size** | *(varies)* | 20 | Number of rows in the here window |
| **herewindow** | true / false | true | Show here window |
| **hicolor** | *(varies)* | *(varies)* | Same as palette, only order is reversed |
| **hilite_pet** | true / false | false | Use highlight for pets |
| **hilite_pile** | true / false | false | Highlight piles of items |
| **hitpointbar** | true / false | false | Show colored bar for hit points |
| **ibm2utf8** | true / false | false | Convert CP437 symbols to UTF8 format before output **(ASCII Only)** |
| **implicit_uncursed** | true / false | true | Omit "uncursed" from inventory |
| **inventory_weights_last** | true / false | true | Display object weights in parentheses after object name |
| **large_font** | true / false | false | Use large font **(Obsolete)** |
| **last_item_show_duration** | *(varies)* | 10 | Duration for showing last item in context menu |
| **legacy** | true / false | true | Show introductory message |
| **lit_corridor** | true / false | false | Show dark corridors as lit if in sight |
| **long_charge_text** | true / false | false | Long format for charges and rechargings in inventory |
| **map_mode** | *(varies)* | *(varies)* | Map display mode under Windows |
| **menu_deselect_all** | *(varies)* | *(varies)* | Deselect all items in a menu |
| **menu_deselect_page** | *(varies)* | *(varies)* | Deselect all items on this page of a menu |
| **menu_first_page** | *(varies)* | *(varies)* | Jump to the first page in a menu |
| **menu_headings** | *(varies)* | *(varies)* | Text attribute for menu headings |
| **menu_invert_all** | *(varies)* | *(varies)* | Invert all items in a menu |
| **menu_invert_page** | *(varies)* | *(varies)* | Invert all items on this page of a menu |
| **menu_last_page** | *(varies)* | *(varies)* | Jump to the last page in a menu |
| **menu_next_page** | *(varies)* | *(varies)* | Goto the next menu page |
| **menu_objsyms** | true / false | false | Show object symbols in menus |
| **menu_overlay** | true / false | true | Menus overlay and align to right |
| **menu_previous_page** | *(varies)* | *(varies)* | Goto the previous menu page |
| **menu_search** | *(varies)* | *(varies)* | Search for a menu item |
| **menu_select_all** | *(varies)* | *(varies)* | Select all items in a menu |
| **menu_select_page** | *(varies)* | *(varies)* | Select all items on this page of a menu |
| **menu_tab_sep** | true / false | false | Menu formatting |
| **menucolors** | true / false | true | Use colors in menus |
| **menustyle** | *(varies)* | *(varies)* | User interface for object selection |
| **move_interval** | *(varies)* | 15 | Normal movement interval in milliseconds |
| **msg_window** | *(varies)* | *(varies)* | The type of message window required |
| **msghistory** | *(varies)* | 20 | Number of top line messages to save |
| **news** | true / false | true | Show any news at game start |
| **null** | true / false | true | Allow nulls to be sent to terminal |
| **page_wait** | true / false | true | Page wait on Mac |
| **palette** | *(varies)* | *(varies)* | Palette |
| **perm_invent** | true / false | false | Show permanent inventory window |
| **popup_dialog** | true / false | false | Use popup dialog |
| **preferred_screen_scale** | *(varies)* | *(varies)* | Preferred screen scale |
| **preload_tiles** | true / false | true | Preload tiles |
| **roguesymset** | *(varies)* | *(varies)* | Load a set of rogue display symbols from the symbols file |
| **runmode** | *(varies)* | *(varies)* | Display frequency when 'running' or 'travelling' |
| **scroll_amount** | *(varies)* | *(varies)* | Amount to scroll map when scroll_margin is reached |
| **scroll_margin** | *(varies)* | *(varies)* | Scroll map when this far from the edge |
| **show_buff_timer** | true / false | false | Show buff timer on tiles |
| **show_comparison_stats** | true / false | true | Show comparison statistics for items when picking them up |
| **show_damage_formula** | true / false | false | Show damage formula in examine |
| **show_decorations** | true / false | true | Show decorations via colors in ASCII mode **(ASCII Only)** |
| **show_dice_as_ranges** | true / false | true | Show dice as ranges (e.g., 2-12 instead of 2d6) |
| **show_grid** | true / false | false | Show grid between tiles |
| **show_tile_mon_hp_bar** | true / false | false | Show monster hit points on tiles |
| **show_tile_pet_hp_bar** | true / false | false | Show pet hit points on tiles |
| **show_tile_u_hp_bar** | true / false | false | Show player hit points on tiles |
| **show_weapon_style** | true / false | true | Show used weapon type in status line |
| **show_weight_summary** | true / false | true | Show total weight at the end of inventory |
| **showexp** | true / false | true | Show experience points in status line |
| **showmove** | true / false | true | Show current movement speed in status line |
| **showrace** | true / false | false | Show your character by race rather than role |
| **showrealtime** | true / false | true | Show elapsed wall-clock time in status line |
| **showscore** | true / false | true | Show current score in status line |
| **silent** | true / false | true | Don't use terminal bell |
| **skill_table_format** | true / false | false | Show skills in a table format rather than a list |
| **sortloot** | *(varies)* | *(varies)* | Sort object selection lists by description |
| **sparkle** | true / false | true | Display sparkly effect when resisting magic |
| **spell_table_format** | true / false | false | Show spells in a table format rather than a list |
| **splash_screen** | true / false | true | Show splash screen |
| **standout** | true / false | false | Use standout for --more-- **(ASCII Only)** |
| **status_updates** | true / false | true | Allow the status lines to update |
| **statushilites** | *(varies)* | *(varies)* | Highlight control |
| **statuslines** | *(varies)* | *(varies)* | 2 to 8 lines for status display |
| **symset** | *(varies)* | *(varies)* | Load a set of display symbols from the symbols file |
| **term_cols** | *(varies)* | *(varies)* | Number of columns |
| **term_rows** | *(varies)* | *(varies)* | Number of rows |
| **tile_file** | *(varies)* | *(varies)* | Name of tile file |
| **tile_height** | *(varies)* | *(varies)* | Height of tiles |
| **tile_width** | *(varies)* | *(varies)* | Width of tiles |
| **tiled_map** | true / false | true | Tiled map |
| **time** | true / false | false | Display game turns in status line |
| **tombstone** | true / false | true | Show tombstone when your character dies |
| **toptenwin** | true / false | false | Show top scores in window |
| **use_darkgray** | true / false | true | Use bold black color instead of blue **(ASCII Only)** |
| **use_inverse** | true / false | true | Display detected monsters in inverse |
| **vary_msgcount** | *(varies)* | *(varies)* | Show more old messages at a time |
| **video** | *(varies)* | *(varies)* | Method of video updating |
| **videocolors** | *(varies)* | *(varies)* | Color mappings for internal screen routines **(ASCII Only)** |
| **videoshades** | *(varies)* | *(varies)* | Gray shades to map to black/gray/white **(ASCII Only)** |
| **vt_tiledata** | true / false | false | Use VT codes for tiles **(ASCII Only)** |
| **whatis_coord** | *(varies)* | *(varies)* | Show coordinates when auto-describing cursor position |
| **windowborders** | *(varies)* | *(varies)* | 0 (off), 1 (on), 2 (auto) |
| **windowchain** | *(varies)* | *(varies)* | Window processor to use |
| **windowcolors** | *(varies)* | *(varies)* | The foreground/background colors of windows |
| **windowtype** | *(varies)* | *(varies)* | Windowing system to use |
| **wiz_mstatusline** | true / false | false | Enable extended monster status line in wizard mode |
| **wizweight** | true / false | false | Show weights in inventory in wizard mode |
| **worn_shows_equipment** | true / false | true | Worn items shows equipment screen |
| **wraptext** | true / false | false` | Wrap text |
⚙️ Gameplay & Mechanics
| Option Name | Values | Default | Description |
|---|---|---|---|
| asksavedisk |
true / false
|
false |
Prompt for saving to a disk |
| autodescribe |
true / false
|
true |
Describe terrain under cursor |
| autodig |
true / false
|
true |
Dig if moving and wielding a digging tool |
| autokick |
true / false
|
true |
Walking into a door attempts to kick it |
| autoopen |
true / false
|
true |
Walking into a door attempts to open it |
| autopickup |
true / false
|
false |
Automatically pick up objects |
| autoquiver |
true / false
|
false |
Fill empty quiver automatically when firing |
| autoswap_launchers |
true / false
|
true |
Automatically swap launchers on for ranged attacks and off for melee attacks |
| autoswap_polearms |
true / false
|
true |
Automatically swap polearms off for melee attacks |
| autounlock |
true / false
|
true |
Automatically unlock a locked door or chest |
| baseacasbonus |
true / false
|
true |
Display base armor class as a bonus rather than a number starting at 10 |
| bones |
true / false
|
true |
Allow loading bones files |
| boulder | (varies) | (varies) | Deprecated (use S_boulder in sym file instead) (Obsolete) |
| checkpoint |
true / false
|
true |
Save game state after each level change |
| checkspace |
true / false
|
true |
Check disk space on a floppy disk |
| confirm |
true / false
|
true |
Ask before hitting tame or peaceful monsters |
| disclose | (varies) | (varies) | The kinds of information to disclose at end of game |
| displace_peaceful |
true / false
|
true |
Walking into a peaceful monster attempts to displace it |
| dumplog |
true / false
|
false |
Print dumplogs |
| dungeon | (varies) | (varies) | The symbols to use in drawing the dungeon map |
| effects | (varies) | (varies) | The symbols to use in drawing special effects |
| exchange_prompt |
true / false
|
true |
Prompt when exchanging a worn object for another |
| fixinv |
true / false
|
true |
Inventory items keep their letters |
| flush |
true / false
|
false |
Use flush on Amiga |
| force_hint |
true / false
|
false |
Force giving hints regardless of other settings |
| force_invmenu |
true / false
|
true |
Commands asking for inventory item show a menu |
| goldX |
true / false
|
false |
Classify gold as unknown or uncursed |
| ignintr |
true / false
|
false |
Ignore interrupt signals |
| ignore_stopping |
true / false
|
false |
Travelling is not interrupted by items, doors, or engravings |
| knapsack_prompt |
true / false
|
true |
Prompt for an action when inventory is full |
| lootabc |
true / false
|
false |
Use a/b/c rather than o/i/c when looting |
true / false
|
true |
Enable the mail daemon | |
| max_hint_difficulty | (varies) | 10 |
Maximum difficulty level for showing hints |
| mention_walls |
true / false
|
false |
Give feedback when walking into walls |
| metric_system |
true / false
|
false |
Use the metric system for weights |
| monpolycontrol |
true / false
|
false |
Control monster polymorphs |
| monsters | (varies) | (varies) | The symbols to use for monsters |
| multishot_always_fire |
true / false
|
false |
Attack always as many times as possible |
| objects | (varies) | (varies) | The symbols to use for objects |
| packorder | (varies) | (varies) | The inventory order of the items in your pack |
| paranoid_confirmation | (varies) | (varies) | Extra prompting in certain situations |
| pickup_burden | (varies) | (varies) | Maximum burden picked up before prompt |
| pickup_thrown |
true / false
|
true |
Autopickup thrown items |
| pickup_types | (varies) | (varies) | Types of objects to pick up automatically |
| pile_limit | (varies) | (varies) | Threshold for 'there are many objects here' |
| player_selection | (varies) | (varies) | Choose character via dialog or prompts |
| playmode | (varies) | (varies) | Classic or modern play, non-scoring explore or casual mode, or debug mode |
| pushweapon |
true / false
|
false |
Previous weapon goes to secondary slot |
| rawio |
true / false
|
false |
Allow use to raw I/O |
| rlecomp |
true / false
|
true |
Use rlecomp |
| sanity_check |
true / false
|
false |
Perform data sanity checks |
| scores | (varies) | (varies) | The parts of the score list you wish to see |
| search_box_traps |
true / false
|
true |
Search command searches boxes for traps first |
| selectsaved |
true / false
|
true |
Select a saved game at program start |
| sortpack |
true / false
|
true |
Group inventory items by type |
| spellorder | (varies) | (varies) | Default spell sorting |
| stash_on_autopickup |
true / false
|
false |
Stash items into a container on autopickup |
| suppress_alert | (varies) | (varies) | Suppress alerts about version-specific features |
| swap_rhand_only |
true / false
|
false |
Swap right hand weapon only rather than objects in both hands |
| takeoff_uses_all |
true / false
|
true |
Takeoff command uses takeoffall command rather than normal implementation |
| tellexp |
true / false
|
true |
Report experience points gained |
| timed_delay |
true / false
|
true |
Use time delay |
| traps | (varies) | (varies) | The symbols to use in drawing traps |
| verbose |
true / false
|
true |
Enable longer messages |
| wiz_alwaysenc |
true / false
|
false |
Always generate an encounter in wizard mode |
| zerocomp |
true / false
|
true |
Use zerocomp |
🖱️ Controls & Input
| Option Name | Values | Default | Description |
|---|---|---|---|
| BIOS |
true / false
|
false |
Use IBM ROM BIOS calls |
| altkeyhandler | (varies) | (varies) | Alternate key handler |
| altmeta |
true / false
|
true |
Treat 'ESC c' as M-c |
| clickfire |
true / false
|
true |
Enable firing via mouse click |
| clicklook |
true / false
|
true |
Enable looking via mouse click |
| clickpole |
true / false
|
true |
Enable use of polearm via mouse click |
| cmdassist |
true / false
|
true |
Give help for errors on direction input |
| enablettyarrowkeys |
true / false
|
false |
Enable tty arrow keys (ASCII Only) |
| engrave_quickstyle | (varies) | 0 |
Stylus selection style for engrave quick command |
| engrave_quicktext | (varies) | (none) | The preset text for engrave quick command |
| help |
true / false
|
true |
Show all available info when using whatis-command |
| herecmd_menu |
true / false
|
false |
Show commands available in this location |
| inventory_obj_cmd |
true / false
|
true |
Display a command menu upon selecting an object in inventory |
| middle_click_command | (varies) | (none) | Command upon clicking middle mouse button |
| mouse_support | (varies) | (varies) | Game receives click info from mouse |
| number_pad | (varies) | (varies) | Use the number pad for movement |
| prefer_fast_move |
true / false
|
false |
Swap slow move and fast move commands' key bindings |
| rest_on_space |
true / false
|
false |
Space bar is bound to the rest-command |
| right_click_command | (varies) | (none) | Command upon clicking right mouse button |
| run_spot_distance | (varies) | 0 |
Longest distance for spotting a monster to stop running or travelling |
| self_click_action |
true / false
|
false |
Clicking the player character executes an action |
| subkeyvalue | (varies) | (varies) | Override keystroke value |
| travel |
true / false
|
true |
Enable traveling via mouse click |
| travel_debug |
true / false
|
false |
Display debugging graphics for travel algorithm |
| whatis_filter | (varies) | (varies) | Filter coordinate locations when targeting next or previous |
| whatis_moveskip |
true / false
|
false |
Skip same glyph when getting map location |
🐾 Pets & Companions
| Option Name | Values | Default | Description |
|---|---|---|---|
| catbreed | (varies) | (none) | The breed of your (first) cat |
| catgender | (varies) | (none) | The gender of your (first) cat |
| catname | (varies) | (none) | The name of your (first) cat |
| dogbreed | (varies) | (none) | The breed of your (first) dog |
| doggender | (varies) | (none) | The gender of your (first) dog |
| dogname | (varies) | (none) | The name of your (first) dog |
| horsegender | (varies) | (none) | The gender of your (first) horse |
| horsename | (varies) | (none) | The name of your (first) horse |
| partydetails |
true / false
|
false |
Give detailed information for each pet |
| partylinecolor |
true / false
|
true |
Use colors for pet statistics |
| partymultiline |
true / false
|
false |
Print statistics of each pet on a separate status line |
| petattr | (varies) | (varies) | Attributes for highlighting pets |
| pets_not_gifted |
true / false
|
false |
You receive no gifted pets |
| pettype | (varies) | (varies) | Your preferred initial pet type |
| ramgender | (varies) | (none) | The gender of your (first) ram |
| ramname | (varies) | (none) | The name of your (first) ram |
| safe_pet |
true / false
|
true |
Prevent you from hitting pets |
| underline_peaceful |
true / false
|
true |
Underline peaceful monsters |
| wolfgender | (varies) | (none) | The gender of your (first) direwolf |
| wolfname | (varies) | (none) | The name of your (first) direwolf |
🔊 Audio & Sound
| Option Name | Values | Default | Description |
|---|---|---|---|
| acoustics |
true / false
|
true |
Can your character hear anything |
| shield_effect_length | (varies) | 20 |
Shield effect length |
| sound_volume_ambient | (varies) | 20 |
Ambient volume |
| sound_volume_dialogue | (varies) | 20 |
Dialogue volume |
| sound_volume_effects | (varies) | 20 |
Sound effect volume |
| sound_volume_general | (varies) | 20 |
General game volume |
| sound_volume_music | (varies) | 20 |
Music volume |
| sound_volume_ui | (varies) | 20 |
User interface sound volume |
| soundcard | (varies) | (varies) | Type of sound card to use |
| talk_effect_length | (varies) | 20 |
Talk effect length |
🧬 Character & Roleplay
| Option Name | Values | Default | Description |
|---|---|---|---|
| align | (varies) | (varies) | Your starting alignment |
| blind |
true / false
|
false |
Your character is permanently blind |
| female |
true / false
|
false |
Is your character female |
| fruit | (varies) | (varies) | The name of a fruit you enjoy eating |
| gender | (varies) | (varies) | Your starting gender |
| luggagename | (varies) | (varies) | The name of your (first) luggage |
| name | (varies) | (varies) | Your character's name |
| nudist |
true / false
|
false |
Start your character without armor |
| race | (varies) | (varies) | Your starting race |
| role | (varies) | (varies) | Your starting role |