đ The tools for testing and debugging GnollHack: developer mode and wizard mode in the game, debuggers, device testing, and where each version keeps its files.
đšī¸ In the Game
- Developer Mode â A setting of the modern clients that shows the reset menu, the options file and the Wizard Mode switch, and allows debug logging
- Wizard Mode â The debug mode for testing: the character cannot die, and the wizard-mode commands are available
đ Debugging
- Avalonia port on Windows: start the game from its output folder, and attach Visual Studio's debugger to it, as in Run the Game. This is the quickest way to debug a change to the Avalonia port.
- Linux version in WSL: build the packages and run the game in WSL, as in Run the Game in WSL.
đą Testing on Devices
- Testing Avalonia Linux Version on Steam Deck â The Steam Deck as a test device for the Linux version, with one-command deployment and a live log
- Testing on the Mac â Running a test build of the macOS version on the Mac
- Test Crash Reporting â Checking that test messages and native crash reports reach Sentry
đ Files and Installs
- Data File Locations (WinUI 3 Version â .NET MAUI) â Where the Windows version keeps its settings and saved games
- Installing MSIX Packages on Windows 10 and 11 â Installing a signed MSIX package of the Windows version
The Avalonia clients' data folders are listed under Files and Folders.