FrozenRA

In Falsus 的独立 PTT、B30 与游玩记录模组。正式版本 1.0.3，作者 SkyFrozen。

适用于 Windows x64 / In Falsus（IL2CPP），需要 BepInEx-BepInExPack_IL2CPP-6.0.755。本项目为非官方工具。

安装与独立开关

在 Thunderstore Mod Manager 选择 In Falsus 和要使用的配置，安装 FrozenRA，通过 Start modded / 启动模组版 进入游戏。在 Installed / 已安装 列表可单独启用、禁用或卸载；切换开关后需要重新启动游戏。

本地导入时，在 Settings / 设置 → Import local mod / 导入本地模组 中选择完整的 SkyFrozen-FrozenRA-1.0.3.zip，作者填写 SkyFrozen。无需解压，也不要将它作为整个配置文件导入。若本地导入未自动安装依赖，请先在管理器安装上述 BepInEx 组件。

FrozenRA 不依赖原评级模组或练习模组。练习模组可独立安装；默认 F5～F7 与练习模组默认 F8～F10 分开。

旧版本迁移

已有管理器版本，请在同一发布团队及包名下更新，保留当前配置。管理器会将本模组放入 BepInEx/plugins/<发布团队名>-FrozenRA/。

曾手动安装 FrozenRA 或原评级 DLL 的用户，请先将旧 DLL 备份到 BepInEx/plugins 目录之外。只修改文件夹名称仍可能被递归加载；多份 DLL 会造成重复显示或管理器禁用后仍运行。

用户数据保存在当前管理器配置的 BepInEx/config/FrozenRA/：

• appearance/theme.json：外观、昵称、界面语言、快捷键及导出目录。
• appearance/assets/：导入的图片、原图与字体。
• const.json：当前定数表。
• scores-data.json：用于恢复显示的本地成绩快照。

首次启动补齐缺失资源；升级保留已有设置、导入素材和成绩，只替换仍与旧默认值一致的资源。禁用模组保留上述数据。1.0.3 继续清理未调用的旧补丁、旧统计字段与冗余面板代码，保留 1.0.1 的谱面难度筛选，评分与定数不变，旧版默认五列 B30 可自动衔接到 INF 三列布局，自定义布局继续保留。

快捷键

默认按键	功能
F5	打开外观与游玩记录面板
F6	显示／隐藏游戏内 PTT
F7	按已保存选项导出一张 B30

面板顶部可修改绑定，支持 Ctrl／Alt／Shift 加主键；Esc 取消，提供恢复默认。重复绑定或系统保留组合会被拒绝，原绑定继续有效。快捷键仅在游戏窗口位于前台时响应。

F6 控制 PTT 的显示；管理器中的开关控制整个 FrozenRA。完整停用需要关闭管理器开关后重启游戏。

游戏内 PTT 与外观

• INF 科技风顶栏，昵称与 PTT 可分别调整位置、字号、字体和颜色。
• 背景与人物插图可自行导入，支持裁剪、预览、位置、大小、透明度及镜像；也可导入 TTF／OTF 字体。
• 游戏内 PTT 与 B30 分别保存布局。点击预览元素可定位对应属性，红色选中框跟随调整；选中框只用于编辑。
• 结算加分按画面上三位小数 PTT 的实际变化显示，持续呼吸到 Restart、继续或离开结算，最暗时可完全消失。
• 可选择游戏内截图是否包含 PTT：开启时在游戏画面内绘制，关闭时使用桌面浮层。不同桌面录制方式的捕捉结果可能不同。

打歌期间暂停 PTT 绘制、成绩扫描、配置轮询和纹理上传，只保留低频状态观察与快捷键检测。原生预览及图片导出等待歌曲结束再执行，结算／选曲时恢复；面板设置仍可保存。

B30 导出

B30 默认使用 INF 三列成绩卡 + OVER FLOW（第 31～39 名），也保留旧版式及已有布局。

在 B30 页选择 有曲绘／无曲绘，面板预览、导出按钮和 F7 使用同一保存选项，每次只导出一张。无曲绘仅隐藏歌曲曲绘，人物与背景沿用外观设置。

• 曲绘保持完整比例；边框对应 EVO 青蓝、ULT 紫、FBD 红。
• EX、EX+ 等为评级；FL 与 PD 是附加状态，分别使用紫色／粉色标识和光效。
• 支持游戏原有日／英文歌曲资料，显示曲名、作曲、定数、成绩、Dive 与单谱面评级。
• 图片可显示生成日期、时间及所在时区。

默认输出到桌面新建的 InFalsusB30 文件夹，可在面板输入路径或浏览选择文件夹。有曲绘以 b30.png 命名，无曲绘以 b30_nojacket.png 命名；重名追加 _2、_3 等编号。文件名不加日期时间，已有图片保留。

游玩记录与完成表

曲包、谱面难度与等级／定数可同时筛选，支持七个原生曲包、全部曲包及全部等级；当前曲包没有的定数自动隐藏。

• 谱面难度：全部难度／MIN／EVO／ULT／FBD，默认全部难度。统计、徽章、预览和导出均使用三项筛选的交集；难度切换时隐藏没有谱面的定数，当前定数不可用时切回全部等级。
• 1～9：整数等级。
• 10、11、12、13、14：整级汇总，例如 10 包含 10.0～10.9。
• 10.0～15.0：间隔 0.1 的精确定数，10 与 10.0 是不同选项。

预览包含所选全部谱面和成绩，未游玩也计入分母。统计按累计达成计算：Clear 包含历史通关，EX 包含 EX+，FL 包含 PD，PD 单独统计；评级与通关状态独立。

所选全部谱面的达成条件	标题右侧徽章
全 EX+（最高分均至少 99,000,000）	淡紫色 将
全 FL（含 PD）	紫色 極
全 PD	粉色 神

徽章采用日文书法字形、冷白渐变与科技感细线，只显示最高一档；部分达成或空集合不授牌。面板、原生预览和导出同步，依据当前曲包与等级的交集判断。

完成表沿用 B30 的导出目录，例如 10.8完成表.png、10完成表.png；曲包筛选会加入曲包名，难度筛选会加入 MIN／EVO／ULT／FBD，例如 ULT_10.8完成表.png；重复导出自动编号。面板支持 中文／日本語，曲包名称、完成表文字和文件名跟随界面语言。

PTT 与 B30 Avg

PTT 使用评级最高的 30 张谱面，第 1 名权重 4、第 2～6 名权重 2，其余权重 1。B30 Avg 是同一组谱面的普通平均，因此两者不同是正常行为；不足 30 张时使用实际谱面数及对应权重。

单谱面评分沿用当前规则：定数加分数项（95,000,000 为基准，每 2,500,000 分对应 1，限制在 -2～+2），非负 Dive 加 Dive / 100，负 Dive 按现行阶梯扣减。分数、Dive 与通关状态保存各自历史最佳值，可能来自不同游玩。

隐私与资源

外观、导入素材与成绩快照保存在当前管理器配置内。编辑器只监听本机 127.0.0.1 随机端口，使用每次启动生成的令牌；模组不向外发送这些数据。

公开包包含默认曲绘、INF 背景、歌曲／曲包资料、定数及字体，供新配置独立使用；不包含个人设置、成绩、导入素材、本机绝对路径、日志、调试符号或开发测试文件。游戏曲绘和背景占据主要包体积，安装文件大小不等于运行时内存占用。

致谢与许可证

感谢 Atres 的原评级模组 v0.4.0 提供的早期思路。当前成绩读取、评级、场景状态、持久化与运行核心已独立实现；历史 MIT 版权和许可继续保留于 LICENSE。

感谢 BepInEx 与 Il2CppInterop 提供加载及互操作能力。曲绘、背景、曲包与歌曲资料来自 In Falsus，其权利属于相应权利人。

Oxanium、Orbitron、Rajdhani 及 Yuji Mai 的字体来源与 OFL 许可随资源保留。「将・極・神」使用重命名为 FrozenRA Completion Seal 的三个字形精简子集，沿用 SIL OFL 1.1。

包结构参考 Thunderstore 包格式与 BepInEx 目录规则。