BeginnerBuilds
GAGBOY的中文新手流派助手：按角色、技能和背包推荐下一件，原版统率S/A/B/C高亮，透明HUD自动避让无人机。公开测试版。新手流派助手 · BeginnerBuilds
作者：GAGBOY · 版本：0.6.3 · 公开测试版 · MIT 开源
不知道下一件物品该选什么？让推荐跟着你的角色、技能和当前背包一起成长。
这是一个面向《雨中冒险2》新手的独立 BepInEx Mod，提供中文配装建议、透明推荐HUD，以及原版统率神器选择界面的分级高亮。
能做什么
- 识别当前角色与技能：大厅选择角色和进入对局后读取技能信息；无法确认的机制会保留估计或未知说明。
- 按当前背包推荐下一件：分别比较白、绿、红品质候选，并考虑机动、防护、恢复和输出短板。
- 解释联动与叠层：区分同类叠层与满足条件的独立乘算；暴击封顶、虚空替换、技能条件和未知触发系数分别处理。
- 原版统率分级高亮：S首选、A优先、B可选、C备选；悬停可查看推荐理由。等级表示本次候选中的相对优先级，不是通用强度榜。
- 透明推荐HUD：使用游戏提供的图标，支持缩放、透明度和位置设置；自动避让左侧队友与无人机卡片。
- 按角色保存偏好：选择适合自己的流派，调整目标数量，或忽略本局不想继续拿的物品。
推荐是辅助判断，不保证最优解、完整DPS计算或通关。软参考数量不是必须拿满的目标，也不是硬上限。
第一次使用
- 安装并从 r2modman / Thunderstore Mod Manager 启动 Mod 配置。
- 选择角色并进入对局；默认使用正常模式，只提供推荐。
- 按 F2 打开助手，按 F3 显示或隐藏推荐条。
- 使用统率神器时，仍在原版选择界面操作；推荐标记和理由附加在原版按钮上。
- 先拿对应品质的一件，再看背包变化后的推荐，不需要一次拿满参考数量。
快捷键
| 操作 | 按键／入口 |
|---|---|
| 打开／关闭助手 | F2，快捷键可在配置中修改 |
| 显示／隐藏推荐HUD | F3 |
| 取消确认／关闭助手 | Esc |
| 修改HUD位置、缩放和透明度 | F2 → 显示与操作 |
| 正常／体验／测试模式 | F2 → 配装与体验 |
| 导出界面与掉落诊断 | F2 → 显示与操作 → 导出界面与掉落诊断 |
统率界面打开时，助手让原版处理鼠标和选择，不叠加F2窗口。其他Mod占用相同快捷键时，请调整快捷键。
三种模式
| 模式 | 行为 |
|---|---|
| 正常（默认） | 读取角色、技能与背包并给出建议，不直接发物品；统率选择由玩家操作原版界面。 |
| 体验 | 预览并确认后，只补足自己的目标永久物品数量，保留原有被动物品；是否替换当前主动装备由你选择。 |
| 测试 | 确认后，允许在本局角色生成或换关时自动补齐，可手动停止；重启游戏后不会自动启用。 |
体验与测试会改变配装。直接补齐功能限定单人或本机房主，作用于自己；客户端不支持直接补齐。客户端的推荐与高亮路径仍需更多实际联机验证。助手不会主动暂停联机世界。
安装与依赖
依赖：bbepis-BepInExPack-5.4.2122（基础加载器）和 RiskofThunder-RoR2BepInExPack-1.47.0（游戏适配修复包）。不需要 FirstMod、HUDdleUP 或 R2API。
通过管理器
发布到 Thunderstore 后，在《雨中冒险2》社区搜索 BeginnerBuilds，核对发布者 GAGBOY 并安装。上传前，该包尚不能在在线列表中搜索到。以实际发布团队名为准。
手动安装
- 退出游戏，并确认目标配置已安装所需加载器。
- 将公开发布ZIP内的
plugins/BeginnerBuilds/复制到当前配置的BepInEx/plugins/BeginnerBuilds/，即把ZIP中的plugins合并进BepInEx。 - 最终DLL位置应为
BepInEx/plugins/BeginnerBuilds/BeginnerBuilds.dll。 - 从管理器启动该配置；配置名称可自行命名，无需叫UES 1。
另提供文件名以 -Manual.zip 结尾的手动包：将其中的 BepInEx 文件夹合并到目标配置目录即可。安装后确认只保留一份BeginnerBuilds.dll。
设置、更新与卸载
- 设置文件：
BepInEx/config/local.beginnerbuilds.assistant.cfg，首次运行自动生成。 - 更新前退出游戏并备份原插件；替换DLL，保留配置文件。
- 卸载时退出游戏，移除
BepInEx/plugins/BeginnerBuilds/。配置可单独保留或删除。 - 卸载不会撤回体验／测试模式已经发放的物品。
测试范围与已知问题
这是公开测试版，目前以原版角色和物品为主要目标。不宣称覆盖所有DLC角色、全部技能变体或其他Mod的自定义角色与物品。
- 已通过本机程序集编译、机制回归、HUD几何检查、隔离安装回退检查，以及76次模型对局／7296次成长步骤。
- 模型使用人工技能样例与固定奖励输入，不运行Unity渲染、实际鼠标、网络或原版掉落随机数，不能替代真实游戏验收。
- 不同分辨率、动态队友卡片、中文字体回退、手柄、联机和其他Mod组合仍需玩家实测。
- 极端拥挤、没有可读空位时，推荐条可能暂时隐藏；空位恢复后重新显示，F2仍可查看推荐。
- 曾收到“开启统率后一直没出现白色物品”的反馈，原因尚未确定。没有发现助手修改掉落权重或过滤白色选项的路径；尚未完整排除第三方Mod影响。
如何反馈问题
请在 GitHub Issues 提交反馈，并提供版本、角色和技能、分辨率、当前模式、单人／房主／客户端身份、复现步骤、截图和相关日志。
若白色统率仍未出现，请在仍处于该局时导出诊断：BepInEx/config/BeginnerBuilds-diagnostics.txt。报告包含当前可用池、实际启用的神器、主机观察到的源品质事件和异常信息。
掉落球与统率方块可能是同一物品的不同阶段，计数不可相加；客户端记录不代表主机世界，源品质也不保证最终选择品质。零计数不直接等于掉率故障。请在公开报告前查看日志，按需隐去个人路径或玩家信息。
English quick start
BeginnerBuilds is a Chinese-first, beginner-oriented Risk of Rain 2 build advisor by GAGBOY. Press F2 for the menu and F3 for the compact HUD. Normal mode only recommends items. Experience/test modes explicitly modify your own inventory and require confirmation and host authority. Native Command choices receive relative S/A/B/C highlights.
This is a public testing release. Recommendations are conditional estimates, not a complete DPS model or a guaranteed optimal build. Runtime visuals, controller support and multiplayer combinations require further testing. The unexplained white-drop report remains under investigation.
许可证与致谢
本项目源码及原创图标采用 MIT License，作者 GAGBOY。参考项目及第三方声明见 THIRD_PARTY_NOTICES.md。
HUD集成思路参考了 HUDdleUP 的公开实现。本Mod不包含其二进制文件，也不要求安装它。游戏图标在运行时由游戏提供，本发布包不附带游戏程序集或游戏资源文件。