HAT Continuous Build

Published: 2026-10-09 05:36 UTC

v3.0

Installation

Download the installer for your platform and run it.

Platform	File
Windows	HATinstaller-win-x64.exe
Linux	HATinstaller-linux-x64
macOS	HATinstaller-osx-x64

FEZ will be detected automatically from your Steam or GOG library.
If detection fails, drop the installer into your FEZ game folder
and run it from there, or use --path <dir>.

Changelog

Changes:

• switched to .NET 10 runtime, removing the dependency on Mono (the runtime is included with the installer)
• reworked installation to allow launching modded FEZ directly from Steam/GOG, while keeping the original game in Original directory
• reworked code mod dependency loading to support .NET dependencies and native libraries
• added ModText resources, allowing mods to add custom text and translations without replacing entire game text resources
• updated FEZRepacker to v1.3.3
• updated MonoMod
• updated mod creation documentation for HAT 3 and the new mod template

Tweaks and fixes:

• preserved mods and user files when upgrading older HAT installations
• fixed game detection when placing the installer in FEZ's directory
• restored macOS launcher and original Linux/macOS launcher permissions
• fixed save selection crash when no mods are installed
• fixed HAT dependency validation for code and asset mods
• improved error handling and added console logging from game startup

Note for mod developers: code mods made for previous HAT versions need to be rebuilt for .NET 10 using HAT 3 game assemblies, and declare a HAT dependency with MinimumVersion="3.0" in their metadata.

v2.1.0

Installation

Download the installer for your platform and run it.

Platform	File
Windows	HATinstaller-win-x64.exe
Linux	HATinstaller-linux-x64
macOS	HATinstaller-osx-x64

FEZ will be detected automatically from your Steam or GOG library.
If detection fails, drop the installer into your FEZ game folder
and run it from there, or use --path <dir>.

Changelog

• new World format, allowing modders to create mappacks with save file identification
• new save selection/management menus, allowing more than three save slots, and giving an option to select a mappack upon save file creation
• resolve Mono and other dependency issues for HAT and its installer

v2.0.1

Installation

Download the installer for your platform and run it.

Platform	File
Windows	HATinstaller-win-x64.exe
Linux	HATinstaller-linux-x64
macOS	HATinstaller-osx-x64

FEZ will be detected automatically from your Steam or GOG library.
If detection fails, drop the installer into your FEZ game folder
and run it from there, or use --path <dir>.

Changelog

• Updated Repacker to v1.3.0. This can potentially break loading of older custom assets. If you encounter any issues, please report them.
• Patched in-game issue where camera would not follow the player.
• Patched level hot-reloading to happen only when you're in a modified level.

v2.0.0

Installation

Note: If you had installed HAT previously using older installation methods, it is recommended to reinstall the game first.
Download the installer for your platform and run it.

Platform	File
Windows	HATinstaller-win-x64.exe
Linux	HATinstaller-linux-x64
macOS	HATinstaller-osx-x64

FEZ will be detected automatically from your Steam or GOG library.
If detection fails, drop the installer into your FEZ game folder
and run it from there, or use --path <dir>.

Changelog

• created streamlined cross-platform single-executable installation process (@zrckr)
• resolved issues with installation and functionality on non-Windows platforms, making HAT fully compatible with Linux (MacOS yet to be confirmed) (@zrckr)
• implemented asset dynamic loading and level hot-reloading functionality (@zrckr)
• added support for loading native libraries (@zrckr)
• added option for explicit entry-point component for code mods (@zrckr)
• publicized menu-related game classes for mod access (@zrckr)
• fixed mod dependency and priority handling (@zrckr)
• prevented crash when attempting to load HAT with no mods (@Jenna1337)
• created CI/CD for easier testing and distribution (@Treeways, @Krzyhau, @zrckr)

v1.2.1

Installation

1. Download HAT.zip from Release tab and unpack it in the game's directory (next to FEZ.exe).
2. Run hat_install.bat (for Windows) or hat_install.sh (for Linux, experimental!). This should generate new executable file called MONOMODDED_FEZ.exe.
3. Run MONOMODDED_FEZ.exe and enjoy modding!

Changelog

Changes:

• switched to using stripped game libraries to allow HAT installation in DRM-free versions of the game
• updated FEZRepacker for correct art object/trileset loading
• changed required type of code mod to non-abstract GameComponent (@Jenna1337)

Tweaks and fixes:

• enforced uniform culture (for the same purpose FEZRepacker was updated, probably redundant)
• enhanced custom text injection
• replaced blacklist with ignorelist
• fixed prioritylist functionality
• added more detailed logs to asset loading errors
• enhanced custom logging routine (cleaning up old logs)

v1.2.0

Installation

1. Download HAT.zip from Release tab and unpack it in the game's directory (next to FEZ.exe).
2. Run hat_install.bat (for Windows) or hat_install.sh (for Linux). This should generate new executable file called MONOMODDED_FEZ.exe.
3. Run MONOMODDED_FEZ.exe and enjoy modding!

Note for non-Steam game versions: remove FEZ.Hooks.mm.dll. Any mods using generated hooks won't work, but as of writing this message, there are none either way :)

Changelog

• refactor mod loading process
• add mod identity extensions (helper functions to allow mods easily identify themselves through game components)
• add PAK loading for assets (assets can now be packed into Assets.pak for efficient storage and loading)
• tweak assembly resolving (all HAT's dependencies have been moved to subdirectories. Additionally, mods can contain dependencies by including them in their directories, and HAT will load them automatically when they're requested by the mod's assembly)
• improve logging
• add blacklist.txt (adding directory/zip names to it will prevent the mod from being loaded).
• add prioritylist.txt (adding directory/zip names to it will force it to have priority when loaded over other duplicate mods).

v1.1.1

Installation:

1. Download MonoMod (for .NET 4.5.2) and unpack it in the game's directory.
2. Download HAT.zip and unpack it in the game's directory (next to FEZ.exe).
3. Run command MonoMod.exe FEZ.exe (or drag FEZ.exe onto MonoMod.exe). This should generate new executable file called MONOMODDED_FEZ.exe.
4. Run MONOMODDED_FEZ.exe and enjoy modding!

Changelog:

• refactor the project to use NuGet version of Repacker
• fix incorrect font size for different fonts (@Jenna1337)

v1.1.0

Installation

1. Download MonoMod (for .NET 4.5.2) and unpack it in the game's directory.
2. Download version 1.0.0 of FEZRepacker.Core.dll from FEZRepacker's repository.
3. Download FEZ.HAT.mm.dll and FEZ.Hooks.mm.dll and put them in the game's directory.
4. Run command MonoMod.exe FEZ.exe (or drag FEZ.exe onto MonoMod.exe). This should generate new executable file called MONOMODDED_FEZ.exe.
5. Run MONOMODDED_FEZ.exe and enjoy modding!

Changelog

• included Hooks library which can be used by mods
• included Repacker for asset loading pipeline (which means you can now use converted formats like PNG or fezlvl.json in your mods, without needing to convert assets to XNB format)

Bugfixes

• reworked mod dependency system
• changed asset injection method
• fixed crash when no mods are present

1.0.3 - public beta cont. cont.

Changelog

• fix crash when trying to switch savestates
• change method of mod initialization
• isolate mod component creation