Subscribe to download
Henrys Whistle

Henry’s Whistle enhances the atmosphere of your KCD2 adventures by letting Henry whistle blacksmith-inspired tunes while mounted.

Whistles are triggered at random intervals and automatically stop when dismounting. The mod is fully integrated with KCDUtils, using its registration, event handling, UI notifications, and logging systems. Modders can extend the functionality through custom events or adjust the timing to fit their own projects.


- KCDUtils and LuaDB[www.nexusmods.com] are required. They provide mod registration, event handling, logging, and UI integration.


- The mod is now configurable via settings in the menu (look at images for examples)
- Should Henry get into a dialog sequence while on horse, the whistling will no longer trigger

IMPORTANT: Every mod that edits the file `Menu.gfx` will result in `Mod Settings` not showing. Everything else will still work as it should.


- Randomly triggers blacksmith-themed whistling sounds while mounted
- Stops sounds immediately when dismounting to prevent audio glitches
- Custom Console Commands (for more info, scroll down)
- Keybind for toggling whistle ON and OFF
- Settings get stored in a DB. Set up the configs to your liking and keep them for the rest of your playthrough
- hw_toggle can also be bound as a key. For this, download KCD2 Keybinder[www.nexusmods.com] and set the keybind in the game settings


- Fully extendable through KCDUtils events for custom behaviors
- UI tutorial first time on horse
- UI notifications for debugging or development purposes
- Look at the script for an example how KCDUtils can be used in your own project


1. Ensure KCDUtils and LuaDB[www.nexusmods.com] are installed
2. Install Henry’s Whistle by placing it in your Mods folder
3. Mount a horse and wait for Henry’s whistling to activate automatically
4. Modders: Check the Lua scripts and KCDUtils events to extend or add new functionality


- hw_toggle - Toggles Henry's Whistle on or off
- hw_toggle_combat - Toggles combat restriction while mounted
- hw_toggle_gallop - Toggles gallop restriction while mounted
- hw_speed <value> - Sets the speed threshold for gallop detection (default: 11)
- hw_trigger_delay <Short|Medium|Long> - Set initial whistle delay preset
- hw_loop_delay <Short|Medium|Long> - Set loop whistle delay preset
- hw_chance <0–100> - Sets the chance to whistle (default: 100%)
- hw_show_status - Displays current configuration and mod status
- hw_reset - Resets all settings to default values
- hw_help - Shows this help message

Notes:

- Optional parameters are indicated with [brackets]
- All values are in seconds unless specified otherwise
- Chance values are from 0 to 100 in percent


- Henry’s Whistle does not modify gameplay mechanics
- Intended for immersion and modding experimentation
- Timers and sounds are fully controlled and stop on dismounting to prevent conflicts
- If issues occur, check that KCDUtils is installed and up to date


For support, scripting examples, or contributions, visit the KCD2 modding community[discord.com] or the KCDUtils GitHub repository[github.com].

If you’d like to support my work, feel free to buy me a drink, mead, or beer[ko-fi.com] at “The Hole in the Wall”!