ResonatorsOfTheSoul
Resonators of the Soul（魂灵回响者）：整合强化难度、十四种神器、灾荒挑战、回响者、万神殿与多人 PvP。Resonators of the Soul（魂灵回响者）
一个面向《Risk of Rain 2》的大型模块化模组。发布包只有一个插件入口和一个
ResonatorsOfTheSoul.dll，目前整合七个模块：
- 强化难度：气旋、飓风、荒风、灾变、太阳风暴、破灭尘风、步天。
- 神器：顶点、得宝、复苏、命运、凋亡、镜像、折跃、无极、辐辉、荒芜、群峦、巨兽、虚空、缺憾。
- PvP：多人大厅中可直接选择的独立游戏模式，包含分队、伤害、出生、复活、比赛模式和初始配装。
- 统率悬浮说明：为物品与装备自选按钮显示原版风格的本地化完整说明，仅影响本机 UI。
- 灾荒挑战：在日志的原版“挑战”后新增独立栏目，并记录每项挑战已完成的最高难度。
- 回响者：基于 Seeker 骨骼与动画的独立可选角色，拥有蓝色魂体外观与完整的共鸣技能组；装运中可在回响牵魂 / 共感锁定与亡魂领域 / 酝魂光束之间选择。
- 万神殿：交替游戏模式，拥有独立的挑战与角色选择页面，并按角色记录完成情况；当前包含首个完整挑战“黄金万神殿”。六场首领战中玩家等级固定为 5，怪物等级依次为 9 / 9 / 9 / 13 / 13 / 13；前三战使用 14 点配装，后三战使用 18 点配装。
黄金万神殿固定为暴雨难度并禁用全部神器。每战前均可重新分配物品与装备，依次挑战游荡者、甲虫女王、石巨人、黏土沙丘行者、原版 Gilded Halcyonite，以及金色海岸中不带额外精英词缀的奥利雷奥尼特。
当前包含五项灾荒挑战：
- 缚锁之拳：装卸工仅携带命运神器与荒芜神器，在暴雨或更高难度下通关。
- 凋零之舞：女猎人仅携带凋亡神器，在暴雨或更高难度下通关。
- 终极打击：船长仅携带威望神器、群峦神器与巨兽神器，在暴雨或更高难度下通关。
- 军备竞赛：工程师仅携带无极神器与镜像神器，完成至少一次循环后在暴雨或更高难度下通关。
- 辐辉：仅携带辐辉神器通关游戏。
所有灾荒挑战都允许额外启用统率神器；启用其他非指定神器会使挑战失效。
游戏内模块设置
在主菜单的“设置 → Mod Options → Resonators of the Soul”中，可以持久化开启或关闭：
- 强化难度
- 神器
- PvP
- 统率悬浮说明（仅本机）
这些开关由 Risk of Options 提供原版风格的配置界面。强化难度、神器和 PvP 在多人房间中
以房主为权威端并同步给其他玩家；统率悬浮说明完全是客户端本地设置，可由每名玩家独立修改。
开始一局后玩法模块状态会冻结，
避免运行中切换 Hook 或联机目录造成状态分裂。所有联网内容定义始终以固定顺序注册，
所以客户端自己的本地开关不会改变目录，也不会因此制造 Network configuration mismatch。
多人准备大厅中的“Resonators of the Soul 设置”按钮仍用于当前房间的同步设置；选择 PvP 游戏模式且 PvP 模块已启用时，还会显示“模式 / 规则 / 分队 / 配装”栏目。
安装
r2modman
- 在 r2modman 中打开 Risk of Rain 2 的目标 profile。
- 使用
Settings -> Import local mod导入ResonatorsOfTheSoul-0.25.31-r2modman.zip。 - 禁用或卸载旧的
CataclysmResonator、EnhancedDifficulties、PvPMode与独立版CommandTooltips，不要同时加载旧 DLL。 - 确保房主与所有玩家使用完全相同的 Resonators of the Soul 版本和模组列表。
发布到 Thunderstore 后，r2modman 会根据 manifest.json 自动解析并安装前置。
本地导入时能否自动获取前置取决于客户端是否可以连接 Thunderstore；依赖字符串使用的是
Thunderstore 的包 ID，而不是界面搜索显示名。
手动安装
将 ResonatorsOfTheSoul.dll 放入：
BepInEx/plugins/ResonatorsOfTheSoul/
并安装 manifest 中列出的 R2API 子模块与 Rune580-Risk_Of_Options。不要同时保留
CataclysmResonator.dll、EnhancedDifficulties.dll、PvPMode.dll 或 CommandTooltips.dll。
联机约束
该模组会新增 DifficultyDef、ArtifactDef、BuffDef、SurvivorDef、GameMode、GameEnding 和自定义队伍， 因此使用严格的“所有玩家必须安装且版本一致”网络兼容策略。模块开关只控制选择与行为， 不按客户端本地配置增删联网内容。
开发构建
dotnet build ResonatorsOfTheSoul/ResonatorsOfTheSoul.csproj -c Release
输出：
ResonatorsOfTheSoul/bin/Release/netstandard2.1/ResonatorsOfTheSoul.dll
PvPMode/ 目录现作为统一工程链接进来的 PvP 模块源码，不再发布为独立 BepInEx 插件。
统率悬浮说明源码位于统一工程的 Modules/ 中，独立 CommandTooltips.dll 不再发布。