Contact damage limiter

A BepInEx plugin for Hollow Knight: Silk Song that sets enemy contact damage to a specified value or even removes it completely. Configurable to differentiate between simple contact and actual attacks, mostly set on a per-enemy basis.

Clamp Contact Damage

🎮 **A smart contact injury management system**

✨ Core Functions

• 🔧 **Configurable Damage**: Set enemy contact damage to any value, or even disable it completely
• 🎯 **Accurate Discrimination**: Able to distinguish between simple contact damage and actual attack actions
• ⚙️ **Customized by Enemy**: Supports individually configuring damage settings based on each enemy
• 🔄 **Live Adjustments**: Install BepInEx Configuration Manager to apply changes in real time in the game

📋 Update log

1.4.Version

• 🐛 Fixed the issue where the character became unresponsive after being attacked by Snitchfly
• 📝 Added a lot of ignorable states to the configuration file
• ⚡ Configuration changes can now be applied in-game (requires BepInEx Configuration Manager)

1.3.Version

• 🐛 Fixed the issue of character becoming unresponsive after being attacked by Silk Snipper or Wraith
• 📋 Added a new configuration field to specify the source of all damage being counted as contact damage

1.2.Version

• 🐛 Fixed the issue where when DamageAmount is set to 0, enemies that deal 1 mask damage still have contact damage enabled.
• 📊 Now records all contact damage, not just damage over 1 mask

1.1.Version

• 🐛 Fixed some console bugs and unusual behavior (like Bell Beast battle)
• ⚔️Phantom's Dragoon Down attack now deals full damage

🛠️ Installation Guide

• **Download BepInEx 5** (latest stable version for your version of the game)
• **Extract BepInEx** to the Silk Song installation directory
• **(Optional) Download BepInEx Configuration Manager** to apply configuration changes in the game
• **Run the game once** and create the plugins folder in the BepInEx folder
• **Download the module compressed package**
• **Extract the DLL file** to the BepInEx/plugins folder

🔄 Update to new version

• **Replace DLL files**: Replace the files in the BepInEx/plugins folder with the new version
• **Delete configuration file**: Delete clampcontactdamage.cfg in the BepInEx/config folder so that it can be regenerated the next time the game is started.

⚙️ Configuration instructions

After first startup, the module will create a configuration file:

`BepInEx/config/clampcontactdamage.cfg`

**Configurable options:**

• **DamageAmount**: Adjust the damage value caused by contact, set to 0 to disable contact damage
• **StatesToIgnore**: Add or remove enemy states that are considered attacks
• **SourcesToInclude**: Add or remove sources whose damage should count as contact damage
• **ApplyChanges**: Set shortcut keys for applying configuration changes in the game (requires BepInEx Configuration Manager)

🎮 Usage tips

**Get status and source name:**

Check the BepInEx console log that opens when the game starts. Each time contact damage is determined, the console will display relevant information:

```

[Info:ClampContactDamage] Leaving damage from 'Bone Goomba Large (1)' as is (2). Enemy state: Charge

```

**Example configuration: Make Skull Brute's charge attack count as an actual attack**

• Let Skull Brute hit you with a charge attack and pause the game
• Check the last 'Capping damage' entry in the console
• Copy the state name (such as 'Charge')
• Add it to the StatesToIgnore value in the configuration file
• Restart the game or apply changes

⚠️ Frequently Asked Questions Solved

**"Unable to move after being attacked by an enemy"**

The way some attacks work is: the enemy grabs and pins you, and in order to be able to move again, you have to take an instance of damage. If contact damage is set to 0, this may not happen.

**Solution:**

Just add the states obtained from the console to StatesToIgnore in the configuration file. This is how to fix Silk Snippers an …