README

English Version

About this mod

Silken Impact is a stylish health bar display mod that elevates combat feedback to a whole new level. Inspired by the art and hit animations of Genshin Impact.

It features:

• ⚔️ Delayed damage animations for health bars, adding weight and clarity to each hit
• 💥 Dynamic damage popups with color-coded text based on attack’s elemental type—including fire, poison, and critical strikes
• 🎨 A sleek visual style and animation system inspired by Genshin Impact, delivering satisfying, high-impact feedback

Whether you're chasing clarity or just craving that extra polish, this mod brings cinematic flair to every encounter.

In-game screenshots

Normal Attacks

Critical Hit

Poisonous Nail

Poisonous Effect

Pyro Damage

Settings

For manually installed mod:

• You can adjust the settings of this mod in-game by installing the "Configuration manager with GUI" mod of BepInEx.

• Or alternatively, you can go to the configs folder in BepInEx folder, and edit the silkenimpact.cfg file

  The name of the .cfg file may vary. But it should be something close related to silkenimpact anyway.

Credit

The mod implements the ability to retrieve boss names partially using code snippets from another open-source project, Silksong_HealthBar(https://github.com/jcx515250418qq/Silksong_HealthBar/tree/master) by Xiaohai, which is shared under the Creative Commons Attribution 4.0 International License (CC BY 4.0). Huge thanks to Xiaohai for his outstanding work and generous contribution to the community.

简体中文版本

简介

Silken Impact 是一款风格化的血条显示 Mod，专为提升战斗反馈而设计，带来更具冲击力的视觉效果。其风格与动画灵感源于《原神》。

主要特色包括：

• ⚔️ 血条延迟伤害动画，让每一次打击更具节奏感与清晰度
• 💥 动态伤害跳字，根据伤害的元素类型（如火焰、毒素）和暴击效果自动变色
• 🎨 视觉风格与动画灵感源自《原神》，呈现出流畅而华丽的战斗反馈

无论你追求清晰度还是视觉冲击力，这款 Mod 都能为每一场战斗增添电影般的张力。

游戏内截图

普通攻击

暴击特效

毒液伤害

中毒效果伤害跳字

刀刀烈火刀刀暴（火元素伤害效果）

设置

对于手动安装的模组：

• 你可以通过安装 BepInEx 的 “带图形界面的配置管理器” 模组，在游戏内调整本模组的相关设置。

• 或者，你也可以进入 BepInEx 文件夹中的 configs 子文件夹，手动编辑其中的 silkenimpact.cfg 配置文件。

  配置文件的名称可能会有所不同，但通常会与 silkenimpact 这个名称密切相关，因此你可以根据文件名进行辨识。

致谢

同时本Mod“获取Boss名字的功能”，一部分源于另一个来自开源项目——来自小海的Silksong_HealthBar（https://github.com/jcx515250418qq/Silksong_HealthBar/tree/master）。小海的项目采用知识共享署名4.0国际许可协议（CC BY 4.0）。 特别感谢小海的精彩创作与无私分享！

Version History

Beta Test

1.0.0

• Regular enemy health bar and boss health bar.
• Damage popups.

1.0.1

• Fix "Enemy death effect not found" error when retrieving localized name of some bosses.
• Improve visibility control. Now it considers the physical pusher of an enemy.

1.0.4

• Switch to debug build with no logging.

1.1.0

• Add heal text popups, so that the health bar reset on certain mobs are less confusing.

• Fix Bell Eater multiple health bar display issue.

  • New Config Option: Infinite HP Threshold

1.1.1

• Implement queue-based Dispatcher middleware to resolve various health bar issues.

  • Fix void creatures health recovery problems.
  • Fix Silk Mother health reset problems.
  • Fix critical hit damage miscalculation problem.
  • Fix SetHP logic to properly show heal text when enemy is not dead.

  [!note]

  TakeDamage() may trigger events (e.g., AddHP, HealToMax...) that also modify the mob's health. These events may modify hp prior or later to the modification of hp in TakeDamage() itself.

  To avoid chaos and conflicts, a Dispatcher middleware is used. It records the entry order of HP-modifying functions and applies health changes to the enemy's health bar in that sequence.

  This approach handles most cases, as events triggered by TakeDamage() typically modify HP after TakeDamage() itself, and the middleware preserves this order. However, in exceptions like Silk Mother, SetHP is called before TakeDamage() modifies the HP. To handle such cases, OnCheckHP(fixMismatch: true) is called after OnSetHP to correct any potential mismatches.

  [!warning]

  OnCheckHP(fixMismatch: true) should be used with caution. Misuse may cause health changes to be applied in the wrong order. While this won't cause the health bar to be noticeably out of sync with the enemy's actual health, it may result in quirky visual effects or other misbehavior.

  Theoretically, OnSetHP is the only place where it should be used.

• Resolve heal and damage text animation issues where text disappeared instantly due to incorrect rect sizing.

  • Set minimum text scale to 0.5 to ensure readability.
  • Decrease spawn spread of damage text and heal text.

• Fix SubtractHP related issues.

• Remove debug logging from release builds using conditional compilation.

1.1.2

[!important]

Major changes in this update include:

Bug Fixes

• Lifeblood State Patch
  • Patched LifebloodState.Update().
  • Now healing of enemies with lifeblood is correctly handled.
• Black Thread State Patch
  • Patched LifebloodState.SetUpThreaded().
  • Fixed the problem where "void enemy" (aka enemy in black-thread state)'s health is set incorrectly.
• Fix the visibility control and health bar tracking problem on enemies without a directly attached Renderer.

New Features

• Add unique healing popup for enemy with lifeblood.
• Allow user to modify the color of health bars.

Refactor

• Extracted BaseHealthBarController from MobHealthBarController and BossHealthBarController.

1.1.3

[!important]

Major changes in this update include:

Bug Fixes

• Bell Eater

  • Merge the two sperate health bars (one for its head and one for its butt) into one.

  [!warning]

  The mod shows the health of bell eater as 850, which is more than its actual health 800.

  This is because the bell eater needs to take additional damage after its hp hits 0. So in reality, the damage it requires for you to kill it may vary between 800 and 833 (based on my testing).

  As a result, additional health is added to its health bar. This also aligns better with the animation, where it's killed by the bell beast, and not the player.

• Damage Number Popups

  • Prevent damage texts from being scaled too small after a single hit damage with extremely large value is dealt.

Refactor

• Extracted BaseHealthBarOwner from MobHealthBarOwner and BossHealthBarOwner.
• Extracted health bar spawning logic into SpawnManager.
• Support linked health bar with LinkBuffer and LinkedVisibilityController.

1.2.0

[!important]

Major changes in this update include:

New Features

• Configuration Options

  • Added separate toggle controls for health bar visibility:
    • Regular enemy health bars (Default: Enabled)
    • Boss health bars (Default: Enabled)
  • Added separate toggle controls for number popups:
    • Damage numbers (Default: Enabled)
    • Healing numbers (Default: Enabled)
  • Added option to display health values on health bars (Default: Disabled)
    • Additionally, the text color is adjustable.
  • Reorganized settings:
    • Moved some configuration options to the "Advanced" tab.
    • Improved settings organization for better clarity.

• Localization

  • Added multi-language support for the configuration menu. The option is available in the "Advanced" tab.
  • Currently supports:
    • English
    • 简体中文 (Chinese Simplified)
    • Deutsch (German)
    • Español (Spanish)
    • Français (French)
    • Italiano (Italian)
    • 日本語 (Japanese)
    • 한국어 (Korean)
    • Português (Portuguese)
    • Русский (Russian)

  [!Warning]

  Currently, Changing into a new language will RESET all the configs to default. Moreover, you need to close the Configuration Manager window and reopen it for its GUI to update.

  Due to these limitations, this option is currently placed in the "Advanced" tab. Please use this feature at your own discretion.

1.3.0

Mod Compatibility

• Added compatibility with Pantheon Of Pharloom

1.3.1

Support Installation via Thunderstore Mod Manager

1.4.0

New Feature

• Health Bar Visuals

  • Added a diamond shaped health bar as the new default. You can switch back to the old health bar in mod's settings.

  • Decrease bar height by 13%.

  • Changed the right-edge outline of the HP bar and the Damage delayed effect from a curve to a vertical line for clearer display.

  • Example of current default visuals:

    

Bug Fix

• Problem adjusting width of Boss health bars

1.4.1

Actually support Installation via Thunderstore Mod Manager

• Now the mod manager should be able to install the mod to the plugins folder automatically, instead of the cores folder.

  I am so sorry for the inconvenience and confusion I caused earlier.

Bell eater

• Removed the 50 over health that had only existed for visual purposes. Now the health bar's max health of the bell eater is set to 800, to avoid confusion when the HP's number is displayed.

1.5.0

Font Customization

As has been requested multiple times, this update introduces the ability to customize fonts for health bars and damage/heal popups.

• Users can now select custom fonts for health bars and damage/heal popups.

• Supported font options: SmileySans, InGameFont, and OSFont.

  [!note]

  SmileySans is the default font used in older version of this mod.

  InGameFont is the default font used in Hollow Knight: Silksong.

  OSFont allows users to use any font installed on their operating system.

• Support font size adjustment for both health bars and damage/heal popups.

Instructions for adding custom fonts with OSFont:

1. Acquire the desired font file (usually with a .ttf or .otf extension) on your system.

   For example, you can find the font used by Genshin Impact in the installation directory under Genshin Impact\Genshin Impact Game\YuanShen_Data\StreamingAssets\MiHoYoSDKRes\HttpServerResources\font\.

2. Install the font on your operating system system-wide.
3. Restart the game if it was running.
4. Set the font option to OSFont in the mod's settings.
5. Input the exact name of the font as it appears in your system's font manager into the provided text box.

   For example, the font used by Genshin Impact is named SDK_SC_Web.

Bug Fixes and Improvements

• Fixed an issue where damage/heal popups could become invisible during certain phases of their animation.
• Adjusted damage/heal popups animation.

1.5.1

Bug Fixes

• Fixed the display issue of health bars.

1.5.2

Bug Fixes

• Fixed the health bar display issue on the Great Conchflies, where the damage taken by 'Driller B' is not properly reflected on the health bar.

1.6.0

Improvements

• Improve performance by introducing object pooling for damage/heal popups and health bars.
• Adjust heal animation of health bars.

Fixes

• Shakra's name shown as "Mapper Spar NPC".
• Health bar not disappearing when some enemies' GameObject is suddenly disabled.