BeginnerBuilds

GAGBOY的中文新手流派助手：按角色、技能和背包推荐下一件，原版统率S/A/B/C高亮，透明HUD自动避让无人机。公开测试版。

By GAGBOY

https://github.com/GAGBOY-LX/BeginnerBuilds

Last updated	2 days ago
Total downloads	28
Total rating	0
Categories	Mods Tools Tweaks AI Generated
Dependency string	GAGBOY-BeginnerBuilds-0.6.3
Dependants	0 other packages depend on this package

This mod requires the following mods to function

bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.2122

RiskofThunder-RoR2BepInExPack

Simplify the modding ecosystem of Risk of Rain 2, making it easier for modders to create and maintain their mods while preventing harmful bugs.

Preferred version: 1.47.0

README

新手流派助手 · 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不包含其二进制文件，也不要求安装它。游戏图标在运行时由游戏提供，本发布包不附带游戏程序集或游戏资源文件。

Get the Thunderstore App