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。