Home - AnttiHakkinen/GnollHack GitHub Wiki
GnollHack
![]()
A NetHack variant developed by Sound Mind Games, a non-profit association based in Finland.
Highlights
- Improved Graphical Interface — Large 64x96 tiles with many advanced features. Monsters can be up to 192x192 pixels in size.
- Animations — All characters have attack and kick animations, and spellcasters have also spell casting animations. Spell effects and traps have been animated.
- Advanced Sound System — Over 1100 game sounds that are played using FMOD and an internal sound set system.
- Voice Acting — Voice acting for various game characters and relevant game events. Over 5000 voice over lines.
- Gameplay Improvements — New magic system, new wearable slots, new mythic property system for items (prefixes and suffixes), new weapon quality classes, all item commands accessible from the inventory menu, in-game information for items and monsters, new status lines showing pet information, and a huge number of quality-of-life improvements, such as a pet pathing algorithm.
- Platform Support — Android, iOS, Windows, and Linux.
See Detailed Features for more information. You may also want to read How GnollHack differs from NetHack.
Download
Android
Google Play and the Google Play logo are trademarks of Google LLC.
View Supported Android Devices.
iOS
TestFlight is Apple's app for beta testing iOS apps.
Requires 3 GB RAM but may work with 2 GB RAM. View supported iPhones and iPads.
Please enable Share iPhone/iPad Analytics with App Developers to share crash logs with us.
Windows Binaries (64-bit)
macOS and Linux
You must use Wine or PlayOnMac to run the Windows program. We are investigating possibilities of porting the graphical user interface code to Linux and macOS.
Installation Instructions
Windows 64-bit
- Download the zip file attached to the latest release.
- Unzip it to a folder on your computer.
- Click GnollHackW.exe to play.
macOS and Linux
Install Wine or PlayOnMac to run the Windows program, and then follow Windows instructions.
Choosing the Right Difficulty Level
GnollHack has 7 difficulty levels:
- Standard — You are new to GnollHack
- Experienced — You have some experience with GnollHack
- Adept — You are averagely experienced in GnollHack
- Veteran — You have lots of experience with GnollHack
- Expert – You are expert at GnollHack
- Master — You are a GnollHack professional
- Grand Master — You are a GnollHack professional looking for ultimate challenge
If you are new to GnollHack and NetHack, we recommend starting with the Standard difficulty.
If you are a NetHack veteran but new to GnollHack, we recommend starting with a difficulty between Experienced and Expert. Easier difficulties allow you to learn new mechanics and mitigate some of the additional hardships that come from not being familiar with them. Even though the Expert difficulty has an unadjusted combat difficulty, it can feel more intense than NetHack especially in the end game. Therefore, starting with one of the easier difficulties can be a good choice until you become familiar with the new mechanics in GnollHack.
Gameplay Information
- Difficulty Levels — See more information about difficulty levels.
- Character Classes — Learn about character classes in GnollHack. They are called roles in NetHack.
- Races — Learn about races in GnollHack.
- Alignments — Learn about alignments in GnollHack.
- Attribute Scores — Learn about what strength, dexterity, constitution, intelligence, wisdom, and charisma do.
- Skills — Learn about skills in GnollHack.
- Items — Learn about items in GnollHack.
- Artifacts — GnollHack artifacts.
- Exceptional, Elite, Celestial, Primordial, and Infernal Weapons — Learn about weapon quality modifiers.
- Exceptional, Elite, Celestial, Primordial, and Infernal Armor — Learn about armor quality modifiers.
- Mythic and Legendary Items — Everything about mythic and legendary items.
- Wishing Guide — Wishing rules for new items in GnollHack.
- Resistances and Saving Throws — Learn about how resistances and saving throws work in GnollHack.
- Maximum Mana — Learn about which things contribute to the maximum mana.
- Spell Casting — Learn about how spell casting works in GnollHack.
- Spells — Learn about spells and magic schools in GnollHack.
- Fountains — Learn about new fountain types in GnollHack.
- Scoring — Learn about the scoring system in GnollHack.
- How to Cure Various Conditions — For example, mummy rot and stoning.
- Tips for the Modron Planes — How to complete the Modron planes.
Tutorials (for keyboard-based versions)
These tutorials pertain to the text-based (ASCII) version and the Windows GUI version of GnollHack. Some information in them, though, is relevant to the mobile versions of the game.
- Starting Guide for Beginners — Familiarize yourself with the basics of GnollHack.
- Starting Guide for NetHack Veterans — How to play GnollHack, if you already know NetHack.
- Keyboard Commands — See this guide for the basic keyboard command information as well as to familiarize yourself with what commands are different from NetHack. Good for pros and beginners alike.
- Quick Guide to Text-Based User Interface — A quick look to the basics of the traditional text-based user interface, also called TTY or ASCII graphics.
Public Servers
You can play the text version of GnollHack on public servers over SSH. Two types of servers are available:
- GnollHack Servers — We have proprietary GnollHack servers for a streamlined online play experience.
- Hardfought Servers — GnollHack is also available on Hardfought servers, which host most NetHack variants.
SSH Clients
You need an SSH client to connect to the servers. You can use PuTTY on Windows. On macOS and Linux, you can use the Terminal ssh command.
Development Information
- Build Instructions for ASCII Version on Linux
- Build Instructions for ASCII Version on Windows
- Build Instructions for Windows GUI Version on Windows
- Build Instructions for Android Version on Windows
- Build Instructions for iOS Version on Windows
- Debugging Linux Version in WSL using Visual Studio Code
- Mobile Version Development — The technologies and the history of the mobile version of GnollHack.
Community
- GnollHack Discord Server — Chat about GnollHack
- GnollHack Discussion Forum — Discuss GnollHack in our discussion forum.