Development Information - hyvanmielenpelit/GnollHack GitHub Wiki

Overview

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

Easy Build Repository

• GnollHackMAUIEasyBuild Repository — Build GnollHack's modern ports (.NET MAUI) with ease

Windows Development Machine

Windows Build Target

Legacy Windows Ports (from 1990s)

• Build Instructions for ASCII Version on Windows — Win32 Console Application
• Build Instructions for Windows GUI Version on Windows — Win32 Application with ComCtl32 Controls

Modern Windows Port: .NET MAUI with WinUI 3 (from 2024)

Note that .NET 9.0 is still in preview, as of August 2024. Our .NET MAUI ports of the game are also in development and not yet released.

• Build Instructions for WinUI3 Version on Windows (.NET MAUI)

Android and iOS Build Targets

Xamarin.Forms

Note that Xamarin.Forms is out-of-support since May 2024 and has been replaced by .NET MAUI. However, we continue to maintain our Xamarin.Forms ports until .NET 9.0 is officially released in November 2024 and we can officially release our GnollHack ports that use .NET MAUI.

• Build Instructions for Android Version on Windows
• Android Version Building Checklist
• Build Instructions for iOS Version on Windows

.NET MAUI

This is the latest technology since May 2024. Note that .NET 9.0 is still in preview, as of August 2024. Our .NET MAUI ports of the game are also in development and not yet released.

• Build Instructions for Android Version on Windows (.NET MAUI)
• Build Instructions for iOS Version on Windows (.NET MAUI)

Linux Development Machine

Linux Build Target

• Build Instructions for ASCII Version on Linux

Miscellaneous Info

General

• Debugging Linux Version in WSL using Visual Studio Code
• Release Checklist
• SkiaSharp Build Instructions

.NET MAUI

Windows / WinUI 3

• 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)

Articles

• Mobile Version Development — The technologies and the history of the mobile version of GnollHack.