Development Information - hyvanmielenpelit/GnollHack GitHub Wiki
GnollHack can be built for several platforms using either a Linux or Windows development machine.
- Repository Structure
- Overview of Building GnollHack with .NET MAUI — Please read this first before building anything with .NET MAUI.
- Troubleshooting Building GnollHack with .NET MAUI
- Instructions for Developing GnollHackM Project (.NET MAUI)
- Updating Tileset for GnollHackM (.NET MAUI)
- Known Working Build Setups
| Platform | Technology | CPU Architectures | Executable | Emulator Support1 | Status |
|---|---|---|---|---|---|
| Android | Xamarin.Forms | Arm64 | N/A | Yes, but may have odd behavior or crash | Transitioning Away in 2025 |
| Android | .NET MAUI | Arm64, x642 | N/A | Yes, but may have odd behavior or crash | Transitioning To in 2025 |
| iOS | Xamarin.Forms | Arm64 | N/A | Yes, but may have odd behavior or crash | Transitioning Away in 2025 |
| iOS | .NET MAUI | Arm64 | N/A | Yes, but may have odd behavior or crash | Transitioning To in 2025 |
| Windows | ASCII | x64 | GnollHack.exe | Yes | Legacy |
| Windows | ComCtl32 Controls | x64 | GnollHackW.exe | Yes | Legacy |
| Windows | .NET MAUI | x64, (Arm643) | GnollHackM.exe | No4 | Current |
| Linux | ASCII | x64 | gnollhack | N/A | Current |
- 1 Emulator support refers to the fact that if the port is supported by popular cross-operating-system emulators.
- 2 Android x64 binaries are used by Android emulators running on a Windows machine with an x64 CPU, such as Google Games for PC emulator.
- 3 .NET MAUI supports Arm64 on Windows but we have not built Arm64 binaries, because we do not have a Windows test device with an Arm64 CPU.
- 4 GnollHack's modern Windows port (.NET MAUI) doesn't run on Wine or Proton, because they don't have support for running WinUI 3 apps.
- Support for macOS using .NET MAUI / Mac Catalyst is coming in the future, but it may take a while.
- We don't plan to port our modern GUI to Linux, because .NET MAUI doesn't support Linux.
- We don't plan to support gaming consoles or controllers, such as Steam Deck.
- GnollHackMAUIEasyBuild Repository — Build GnollHack's modern ports (.NET MAUI) with ease
- Build Instructions for ASCII Version on Windows — Win32 Console Application
- Build Instructions for Windows GUI Version on Windows — Win32 Application with ComCtl32 Controls
- Build Instructions for WinUI3 Version on Windows (.NET MAUI)
- Data File Locations (WinUI 3 Version – .NET MAUI)
- Steam Version Publishing Checklist
- Build Instructions for Android Version on Windows
- Android Version Building Checklist
- Build Instructions for iOS Version on Windows
As of March 26, 2025, .NET MAUI mobile ports are fully functional but not yet deployed to the stores.
- Build Instructions for Android Version on Windows (.NET MAUI)
- Build Instructions for iOS Version on Windows (.NET MAUI)
- Debugging Linux Version in WSL using Visual Studio Code
- Release Checklist
- SkiaSharp Build Instructions
- Troubleshooting Gameplay Problems of Modern Windows Port (.NET MAUI/WinUI 3)
- System Requirements for Modern Windows Port (.NET MAUI/WinUI 3)
- CPU and GPU Usage Modes in Modern Windows Port (.NET MAUI/WinUI 3)
- Mobile Version Development — The technologies and the history of the mobile version of GnollHack.