GitGud Harmony

A highly customizable mod for Hollow Knight: Silk Song that plays playful sound effects when you take damage or die. The new version brings comprehensive improvements, including independent custom sound effects for damage and death, a beautiful cinematic splash screen, a user-friendly automatic folder system, and in-menu hotkeys for easy testing!

GitGud Harmony

🎮 **A fun sound effect module tailor-made for "Hollow Knight: Silk Song"**

🎵 Core Functions

• **Smart Sound Effect Trigger**: Automatically play custom sound effects when receiving damage or dying
• **Dual-track sound effect system**: independent damage sound effects and death sound effects settings
• **Movie-level experience**: Beautiful splash screen confirms the loading status of sound effects
• **Convenient Test**: Use hotkeys in the main menu to test the sound effects at any time

🚀 Quick Start Guide

Step 1: Install the plug-in

Make sure you have **BepInEx 5 with Config Manager** installed, then place the **GitGudHarmonyPlugin.dll** file into the `BepInEx/plugins` folder of your game directory.

Step 2: Run the game for the first time

After starting the game, the module will automatically create the `BepInEx/GitGudCustom` folder, which contains two subfolders:

• `PlayOnDamage` - stores damage sound effects
• `PlayOnDeath` - stores death sound effects

Step 3: Add custom sound effects

Put your favorite audio files (supports .mp3, .wav, .ogg, etc. formats) into the corresponding folder:

• Injury sound effects → `PlayOnDamage` folder
• Death sound effects → `PlayOnDeath` folder

💡 **Tips**: If the custom folder is empty, the module will automatically use the classic "GitGud" sound effect as a backup, no need to worry about settings!

Step 4: Restart and test

Launch the game again and you will see a new cinematic splash screen to confirm whether the custom sound effects are loaded successfully.

In the main menu, use the hotkeys to test the sound at any time:

• **S+1** - Test injury sound effects
• **S+2** - Test death sound effects

⚙️ Advanced configuration

Module behavior can be fine-tuned through the configuration file `BepInEx/config/com.toohiggh.gitgud.cfg`:

**Main options include:**

• **ShowCinematicIntro**: Switch startup screen
• **PlayOnDamage / PlayOnDeath**: enable/disable injury and death sound effects respectively
• **VolumePercent**: Volume adjustment (0-100)
• **DamageCooldown**: Set the damage cooldown time (seconds) to prevent the sound effect from playing repeatedly when you are continuously injured.

🎯 **Pro Tip**: If you have **BepInEx Configuration Manager** installed, press **F1** in-game to adjust all settings in real time!

---

🌟 **Make every injury fun and make every death worth looking forward to! **