Radiance

English

Overview

Radiance is a Hollow Knight: Silksong mod that adds a new challenge room in the top-left area of BellTown. From this new entrance, you can challenge Radiance.

All in-mod visual/audio/gameplay assets are sourced from Hollow Knight.

Features

• Adds a new BellTown transition point/room entrance for the Radiance challenge.
• Loads the GG_Radiance scene from an embedded AssetBundle.
• Handles return flow back to the original scene after challenge completion/exit.
• Applies runtime compatibility fixes for PlayMaker FSM and scene transition behavior.

Code Summary

• RadiancePlugin.cs
  • Entry point.
  • Registers Harmony patches and creates persistent managers on scene load.
• Source/Managers/AssetManager.cs
  • Preloads and manages the embedded radiance.bundle.
  • Loads the Radiance scene in LoadSceneMode.Single.
• Source/Managers/RadianceSceneManager.cs
  • Core flow controller.
  • Injects the BellTown entrance, tracks enter/exit state, sets up custom-scene behavior, and restores game state on return.
• Source/Patches/*.cs
  • Intercepts scene transition to redirect GG_Radiance loading.
  • Forces custom scene memory behavior where needed.
  • Fixes FSM event handlers and disables incompatible Godfinder icon actions in custom scene.
• Source/Behaviours/Common/RadianceReturnOnDialogueBehavior.cs
  • Hooks Radiance FSM dialogue state and triggers return to the original scene safely.

Dependencies

• BepInEx-BepInExPack_Silksong (5.4.2304)

Credits

• Asset sources: Hollow Knight (HK1).

License

This project is licensed under the MIT License. See LICENSE for details.

中文

模组简介

Radiance 是一个 Hollow Knight: Silksong 模组，在 BellTown（钟心镇）左上角新增了一个挑战入口房间。 通过这个入口可以挑战 Radiance（辐光）。

模组内使用到的视觉、音频与玩法资源均来自 《空洞骑士》一代。

功能说明

• 在 BellTown 新增用于挑战 Radiance 的传送点/房间入口。
• 通过内嵌 AssetBundle 加载 GG_Radiance 场景。
• 挑战结束或退出后，自动返回原场景并恢复状态。
• 在运行时补丁中处理 PlayMaker FSM 与场景切换兼容问题。

代码简述

• RadiancePlugin.cs
  • 插件入口。
  • 注册 Harmony 补丁，并在场景切换时创建常驻管理器。
• Source/Managers/AssetManager.cs
  • 负责预加载与管理内嵌 radiance.bundle。
  • 以 LoadSceneMode.Single 加载 Radiance 场景。
• Source/Managers/RadianceSceneManager.cs
  • 核心流程管理器。
  • 注入 BellTown 入口，维护进出自定义场景状态，处理自定义场景初始化与返回清理。
• Source/Patches/*.cs
  • 拦截场景切换并重定向 GG_Radiance 的加载流程。
  • 必要时强制启用记忆场景行为。
  • 修复 FSM 事件处理，并在自定义场景中禁用不兼容的 Godfinder 图标逻辑。
• Source/Behaviours/Common/RadianceReturnOnDialogueBehavior.cs
  • 挂接 Radiance FSM 对话状态，安全触发返回原场景。

依赖

• BepInEx-BepInExPack_Silksong（5.4.2304）

致谢

• 资源来源：《空洞骑士》一代（HK1）。

开源协议

本项目采用 MIT License 开源，详见 LICENSE。

Radiance 更新日志 / Changelog

0.2.1

修复 / Fixed

• 辐光光球伤害恢复：修复启用原版辐光修复后，光球在对象池复用时可能持续无伤害的问题。
• Radiant Orb damage restore: Fixed an issue where, after enabling the vanilla Radiance fix, pooled orbs could remain harmless when reused.

0.2.0

新增 / Added

• 游戏内配置面板：按 F6（默认，可在配置文件中更改）打开/关闭配置界面，实时调整模组选项。

  • In-game config panel: Press F6 (default, configurable in config file) to toggle the config panel and adjust mod options in real time.

• 永恒之光 (Immortal Light)：引入一代中强力的 mod boss「永恒之光」

  • Immortal Light: Introduces the powerful HK1 mod boss "Immortal Light"

• 原版 Bug 修复：可选修复原版无上辐光 (Absolute Radiance) 的部分 bug：

  • Orb 消散后仍造成伤害
  • Death Ready → Final Impact 过渡期玩家仍可受伤
  • Vanilla bug fixes: Optional fixes for Absolute Radiance bugs:
    • Orbs still dealing damage after dissipating
    • Player taking damage during Death Ready → Final Impact transition

• 丝绸资源限制：进入 Radiance 场景时，将丝绸上限限制为 9 点，超出部分自动移除。

  • Silk cap: When entering the Radiance scene, silk is capped at 9 (matching HK1 challenge), excess silk is removed.

改进 / Improved

• 皮肤 Mod 兼容：为 tk2d 图集添加 (HK1) 后缀命名空间，以兼容 Patchwork 等皮肤 mod。

  • Skin mod compatibility: Added (HK1) suffix namespace to tk2d collections for Patchwork skin mod compatibility.

• Mac 系统适配：运行时 shader 兼容处理，尽可能适配 Mac 平台（作者无 Mac 设备，无法实测，欢迎反馈）。

  • Mac support: Runtime shader compatibility for Mac (author has no Mac to verify; feedback welcome).

• 配置界面增强：为所有配置项添加中英双语描述，支持滚动查看，优化窗口布局。

  • Config UI enhancements: Bilingual descriptions for all options, scroll view, improved layout.