Radiance

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。