These settings relate to GnollHack's modern ports only.
General Settings
General
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| GPU Acceleration | On / Off | On | Enables and disables the GPU acceleration of the game. If disabled, the game uses CPU for rendering graphics. Note that GPU acceleration can cause crashes on some systems. |
| Graphics Style | Tiles / ASCII | Tiles | Shows the game in 2D tile graphics or in ASCII text. |
| Map FPS | 20 to 144 | 60 | Determines the max refresh rate of the game. This can be used to save battery or to make the game smoother. |
| Screen Resolution | Multiple resolutions | Native | Determines the rendering resolution of the game map. |
| Screen Scale | Percentage | 100% | Custom scale to make UI components larger or smaller than normal. |
| Windowed Mode | On / Off | Off | (Desktop only) Determines if the game runs in windowed or fullscreen mode. |
| Cursor Style | Green Block / Blinking Underline | Green Block | (ASCII graphics only) Determines the way how the player character is identified in the game. |
| Hide Navigation | On / Off | On | (Android only) Determines whether to hide the operating system navigation buttons in the bottom of the screen. |
| Hide Status Bar | On / Off | On | (iOS only) Determines if the top status bar of the operating system is hidden. |
| Show Battery | On / Off | Off | Displays a battery icon in the status bar indicating the current battery level. |
| Show FPS | On / Off | Off | Displays a frames-per-second icon in the status bar indicating the current refresh rate of the game. |
| Show Zoom | On / Off | Off | Displays a zoom icon in the status bar indicating the current zoom level of the map. |
| Silent Mode | On / Off | Off | Game sounds and music are not played if turned on. |
| Dark Mode | On / Off | Off |
Off (Light mode): Menu and text window backgrounds are light and texts are black. On (Dark mode): Menu and text window backgrounds are dark and texts are white. |
| Tournament Mode | On / Off | Off | Toggles several other settings to values required by tournaments like Junethack. Also forces on Classic Mode. More info about tournament mode. |
| Show Keyboard Shortcuts | On / Off | On (Desktop) / Off (Mobile) | Determines if keyboard shortcuts are shown in menus. |
Format
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Metric System | On / Off | Off | Uses the metric system (kg, cm, etc.) instead of the imperial system for weights and measures in descriptions. |
| Show Dice As Ranges | On / Off | On |
Off: XdY format (e.g., 2d6). On: Range format A-B (e.g., 2-12). |
| Show Damage Formula | On / Off | Off | Shows the damage formula (dice) for weapons and attacks in menus. |
Menu Appearance
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Menu Fade Effects | On / Off | On | Determines whether the texts in the menu and text pages fade in and out when opening and closing the page. |
| Improved Menu Images | On / Off | On |
Off: Nearest neighbour (faster but worse quality). On: Bilinear interpolation (slower but better quality). |
| Highlighted Menu Keys | On / Off | On (Desktop) / Off (Mobile) |
Off: Hotkeys are grayed. On: Hotkeys are colored black/white based on light/dark mode. |
| Show Equipment Icons | On / Off | On | Displays equipment slot icons in the inventory menu. |
| Equipment Flip Animation | On / Off | On | Enables a 3D flip animation when equipping or taking off items. |
| Worn Shows Equipment | On / Off | Off | Determines whether the worn item menu shows an equipment screen with all body slots or just a list of currently worn items. |
Adventuring Settings
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Starting and Gifted Pets | On / Off | On | Determines whether the player starts with a pet and gets new pets in certain special situations. Turn off if you are attempting a petless conduct. |
| Allow Ghost Levels | On / Off | On | Determines if the game uses so-called bones files of dead characters. |
Layout & Interface Settings
Layout
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Simple Command Layout | On / Off | On |
Off: Shows two rows of commands in the bottom of the screen, and extra commands in more commands. On: Shows one row of commands and only the most important extra commands in more commands. |
| Alternative Zoom Button | On / Off | Off | Displays the alternative zoom toggle button in the top-right corner of the map. |
| Travel Mode Button | On / Off | Off | Displays the travel mode toggle button in the top-right corner of the map. |
| Auto-Dig Button | On / Off | Off | Displays the auto-dig toggle button in the top-right corner of the map. |
| Ignore Stopping Button | On / Off | Off | Displays the ignore stopping toggle button in the top-right corner of the map. |
| Desktop Buttons | On / Off | On (Desktop) / Off (Mobile) | Determines whether Stats and Equipment buttons are shown on the left and right side of command buttons. |
| Skill Context Button | On / Off | On | Determines whether to show the skill context button near the player. |
| Polearm Context Button | On / Off | Off | Determines whether to show the polearm context button near the player. |
| Single Commands Page | On / Off | On (Desktop) / Off (Mobile) | Uses a single large commands page instead of categorized tabs. |
Status Bar
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Classic Status Bar | On / Off | Off |
Off: Shows the modern graphical game status bar. On: Shows the game status bar in text in the NetHack style. |
| Desktop Status Bar | On / Off | On (Desktop) / Off (Mobile) | Displays ability scores and other extra information on the status bar. |
| Show Score | On / Off | Off | Displays the game score on the status bar. |
| Show XP | On / Off | Off | Displays experience points on the status bar. |
| Right-aligned on 2nd row | On / Off | Off | Moves the display location of score, experience points and gold to the 2nd status bar row. |
| Show Status Screen | On / Off | Off | Toggle for showing the status screen. The same as tapping the middle area of the status bar. |
Interface
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Grid | On / Off | Off | Determines if the game shows grid lines in the game for easier tile position discernment. |
| Grid Opacity | 5% to 100% | 100% | Adjusts the opacity of the grid lines if they are shown. |
| Hit Point Bars | On / Off | Off | Determines if the game shows hit point bars under the player character, NPCs, pets, and monsters. |
| Player Mark | On / Off | Off | Determines if a green targeting icon is displayed above the player character. |
| Targeting | On / Off | Off | Determines if a red targeting icon is displayed above hostile monsters. |
| Show Pets | On / Off | On | Determines if the game shows pet icons in the top of the game screen (under the game status bar). |
| Pet Rows | 1 to 4 | 2 | Determines how many rows of pet icons are allowed in the top of the screen. |
| Orbs | On / Off | On | Determines if health and mana orbs are shown in the top left corner of the screen. |
| Show Max Hit Points | On / Off | Off | Determines if maximum hit points are shown under the current hit points in the health orb. |
| Show Max Mana | On / Off | Off | Determines if maximum mana is shown under the current mana in the mana orb. |
| Messages | 1 to 50 | 5 | Determines the number of messages shown in the bottom left corner of the screen. |
| Show All | On / Off | Off | Toggle for showing all messages. The same as tapping the message area in the game screen. |
| Walk Arrows | On / Off | On | Determines if there are walk arrows when Travel Mode is disabled. |
| Default Auto-Center | On / Off | On | Determines if the Auto-Center button in the game screen is enabled by default. |
Drawing
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Lighter Unlit Areas | On / Off | On |
Off: Unlit areas are darker. On: Unlit areas are lighter. |
| Draw Wall Ends | On / Off | On | Determines if the game draws wall end graphics. Can be disabled to save processor time. |
| Breathing Animations | On / Off | On | Determines if the game shows the breathing animations of various creatures. |
Behavior Settings
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Empty Wish is Nothing | On / Off | On |
Off: A random item is received if the wish is left blank. On: Nothing is received. Keep on to preserve wishless conduct. |
| Character Click Action | On / Off | Off | Clicking or tapping on the player character executes an action appropriate to the location (e.g., descending the stairs). |
| OK on Double Click | On / Off | Off | Double-clicking a menu item also presses OK button automatically in menus. |
| Traditional Get Position | On / Off | Off | When asked to select a location, the location is selected by moving around a tile-based game cursor using arrow icons or keyboard, rather than clicking a location on the map. |
| Auto-Dig | On / Off | On | Automatically dig a clicked or tapped wall when wielding a digging tool. Mirrors the autodig option in the game. |
| Ignore Stopping | On / Off | Off | Travelling does not stop at items, doors, or engravings. Mirrors the ignore_stopping option in the game. |
| Right Mouse Button | Action | None | Configures a specific action or command for a right mouse click. |
| Middle Mouse Button | Action | None | Configures a specific action or command for a middle mouse click. |
| Quick Engrave Text | Text String | None | Text that is engraved automatically when using the quick engrave command. |
| Quick Engrave Style | Engrave Method | Write in Dust | Specifies the method to use for quick engraving (e.g., finger, wand). |
Bar Commands Settings
This section enables you to specify which commands are displayed in the command bar.
Volume Settings
| Setting Name | Description |
|---|---|
| Master Volume | Changes the volume of all sounds and music. |
| Music Volume | Changes the volume of music. |
| Ambient Volume | Changes the volume of ambient sounds. |
| Dialogue Volume | Changes the volume of voice overs. |
| Effects Volume | Changes the volume of sound effects. |
| Interface Volume | Changes the volume of interface sounds, such as button clicks. |
Forum Posting Settings
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Post Game Progress | On / Off | Off | Posts updates of new events of your journey to a selected channel on a Discord Server. |
| Webhook Link | URL | player-log channel on the GnollHack Discord server | Specifies the webhook link to the channel on a Discord server where your game progress is posted. |
Server Posting Settings
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Account | URL | account.gnollhack.com | Enables you to access and specify the GnollHack Server web address. |
| User Name | Text | None | Your user name on the GnollHack server. |
| Password | Text | None | Your password on the GnollHack server. |
| Post Top Scores | On / Off | Off | Posts your score to the GnollHack Server when your game has ended. |
| Share Bones Files | On / Off | Off | Posts bones files to the server, and allows you to encounter other players' dead characters' ghosts (if Allow Ghost Levels is on). |
| Use Blacklist | On / Off | Off | Determines whether to use blacklist or whitelist in blocking unwanted users' bones files. |
| Whitelist/Blacklist | Comma-separated names | None | List of allowed or blocked user names on the GnollHack server for bones files. |
Replays Settings
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Record Game | On / Off | Off | Determines whether the game records a replay of your game. |
| Show Recording | On / Off | On | Determines whether a red dot appears on the status bar to indicate that game recording is on. |
| Auto-Upload to Cloud | On / Off | Off | Determines whether the saved replay is automatically uploaded to an Azure cloud storage. |
| GZip Replay Compression | On / Off | On |
Off: Zip format is used. On: GZip format is used. |
System Settings
| Setting Name | Options / Values | Default | Description |
|---|---|---|---|
| Developer Mode | On / Off | Off | Activates Developer Mode, which enables Wizard Mode and editing the options file. |
| Debug Logging | On / Off | Off | Debug information is written in the app log. |
| Low-Level Logging | On / Off | Off | Extensive logging of various low-level events. Can clog the app log quickly. |
| Debug Post Channel | On / Off | Off | Use an alternative post channel instead of the one specified under Post Game Progress. |
| Show Memory | On / Off | Off | Shows the current managed memory usage on the game screen. |
| Load Sound Banks | On / Off | On | Determines if FMOD sound banks are loaded. Can be disabled to save memory, but the game will have no sounds. |
| Streaming Banks to Memory | On / Off | Off |
Off: Streamed from inside the AAB file (uses less memory). On: Read to memory and streamed from there (uses more memory). |
| Streaming Banks to Disk | On / Off | Off |
Off: Streamed from inside the AAB file (uses less storage space). On: Copied to the storage and streamed from there (uses more storage space). |
| Longer Message History | On / Off | Off | Shows 16,384 last messages instead of 250, and adds a search bar. Switches off automatically for performance reasons upon adding new messages or restarting. |
| Hide Message History | On / Off | Off | The game will not show latest messages at all. Useful for taking cleaner screenshots. |
| Use Single Dumplog | On / Off | On |
Off: The game asks whether to open plain text or HTML dumplog. On: Opens the dumplog based on the Use HTML Dumplog setting. |
| Use HTML Dumplog | On / Off | On | If Use Single Dumplog is On, determines if the dumplog is plain text (Off) or HTML (On). |
| Platform Render Loop | On / Off | On |
Off: .NET MAUI animation system is used. On: Platform-specific render loop linking to display refresh rate is used. |
| GL Only on Map | On / Off | Off |
Off: Skia GL rendering is used on map, menus, and more commands page. On: Skia GL rendering is used only on map. Other pages use CPU-based rendering. |
| Mipmapping On Map | On / Off | Off | Toggles whether mipmapping is used in map rendering. Mostly obsolete. |
| Adjust Rectangles | On / Off | On | Toggles whether the game adjusts tile rectangles to prevent Skia from drawing non-existing lines between tiles. |
| Default Vi-Keys | On / Off | Off |
Off: The default setting for the number_pad option is 2 (numbers for movement).On: The default setting is 0 (vi-keys for movement). |
| On Switching Apps | Save Game / Checkpoint | Save Game |
Save Game: The game is automatically saved and restored when the player returns. Menus close. Checkpoint: The game creates a checkpoint and doesn't close menus, but recovers to checkpoint if terminated. |
| Map GPU Cache | Number | Varies | Determines the cache size for Skia GPU rendering for the map. Large numbers can lead to out of memory. |
| Menu GPU Cache | Number | Varies | Determines the cache size for Skia GPU rendering for the menu and more commands pages. |