You are viewing a potentially older version of this package. View all versions.
MengLei-PotentialSystem-1.0.1 icon

PotentialSystem

潜力值系统:可切换官方等级、安小璃和萌泪酱定数,提供角色头像与 PTT 菱形、原生设置、完整成绩浏览、潜力值排序、B50 图片导出与结算动画。

Date uploaded 3 weeks ago
Version 1.0.1
Download link MengLei-PotentialSystem-1.0.1.zip
Downloads 173
Dependency string MengLei-PotentialSystem-1.0.1

This mod requires the following mods to function

BepInEx-BepInExPack_IL2CPP-6.0.755 icon
BepInEx-BepInExPack_IL2CPP

BepInEx pack for IL2CPP x64 Unity games. Preconfigured and ready to use.

Preferred version: 6.0.755

README

PotentialSystem · 潜力值系统

为 In Falsus 添加基于 Arcaea 新版规则的潜力值(PTT)。当前版本 1.0.1,适用于 Windows IL2CPP 版游戏 1.0.7 和 BepInEx 6。

功能

  • 选歌界面顶部中央显示所选角色头像菱形,上角裁至游戏上边缘,右下徽章显示账号 PTT。头像和徽章按 Arcaea 原始布局比例组合,数字使用 Exo-SemiBold 的大整数、小小数样式,并共同适配徽章宽度。
  • 左右歌曲卡片上方显示实际绑定难度的定数与潜力值:未游玩时为 10.0,已游玩时为 #10 11.1 -> 11.123,依次表示完整成绩排名、定数、单曲潜力值;文字按单曲 PTT 档位配色,排名包含超过 B50 的成绩。
  • 选中谱面使用与返回按钮隔开的深色成绩区,显示难度、定数、单曲 PTT、完整排名、对应纪录的打击分数、完成等级、本地时间与定数来源;未知时间明确标注,不拼接其他局的成绩。
  • 点击顶部头像或 PTT 菱形打开全部最佳成绩页面,命中区域按各自菱形轮廓及游戏显示边界限定。横向卡片排成五列,左侧显示曲绘,右侧显示歌名、作者、难度、定数、大号打击分数、通关状态、排名和单曲潜力值;卡片与 B50 导出图共用绘制,圆角、字体与文字位置一致,背景及边框使用曲绘的深色印象色。页头仅显示 PTT、B10、B50。支持滚动与歌名、作者、难度搜索,列表包含全部已游玩谱面,每个歌曲难度保留一项最佳表现。
  • 成绩页提供“导出 B50 到剪贴板”按钮,按成绩和游戏封面独立生成五列分享图片,包含账号 PTT、动态上限及 B50/B10 均值,可直接粘贴到聊天或图片应用。
  • 原版排序按钮的切换序列中依次加入“歌曲定数 升序”“歌曲定数 降序”“歌曲潜力值 升序”“歌曲潜力值 降序”,沿用原按钮的双向切换,保留所有原版排序选项。均按歌曲行实际难度排序:定数使用当前设置的来源,包含未游玩谱面;歌曲潜力值使用该谱面的最佳单曲 PTT,未游玩的歌曲始终排在已游玩歌曲之后。
  • 结算界面顶部中央显示账号 PTT 徽章,右侧显示增加值或 Keep,左侧显示单曲旧最佳、更新后最佳及本次潜力值。入场稍候后,账号数值从旧值滚动到新值。
  • 在原生“游戏和 UI 设置”中增加“潜力值系统”分类与“谱面定数来源”左右箭头选项,依次为官方等级、安小璃、萌泪酱,默认安小璃。官方等级直接作为定数;安小璃在每次启动时后台检查更新,萌泪酱使用 v6 内置表并离线计算新谱面。所有定数始终显示一位小数。
  • 直接读取当前 SongData 的可用谱面与稳定 Id;游戏新增谱面自动纳入,尚未收录或计算失败时暂用原生 Rating。切换来源会重算卡片、排名、账号 PTT、上限、结算、Best 与导出数据,保留原始成绩和时间。
  • 每次载入账号从完整逐局 history 计算最佳 PTT,并在历史变化时同步。独立文件保存对应真实纪录的已知 UTC 时间,关闭模组期间的成绩也可从历史补入。
  • 模组成绩按原版存档目录隔离,不改变原版 .sav 格式。

选歌入口、排名、设置及成绩页控件使用原生 FastText、布局与按钮输入,中文字体由 DLL 内嵌的 NotoSansCJKsc 提供。成绩卡片与导出图共用 Windows 绘图和系统字体,只为可见行保留卡片纹理。成绩页的窗口和滚动列表以游戏显示区域为边界,在 16:10 屏幕上也保持在游戏的 16:9 区域内;可使用滚轮、拖动列表或右侧滚动条浏览。点击搜索框后输入歌名、作者或难度,支持中文输入、方向键、退格及 Ctrl+A/C/X/V;按 Enter 结束输入,点击右上角红叉或按 Escape 返回选歌。页面打开时持有独立输入,关闭后归还选歌输入。排序模式只在当前选歌场景生效,不写入原版排序枚举。

导出图片根据完整成绩快照取前 50 项,独立绘图,不受游戏分辨率、当前选歌或成绩页滚动位置影响。分享图采用五列横向圆角卡片,卡片背景与成绩页共用曲绘印象色,浅色文字保持清晰。已有成绩不足 50 项时按实际数量展示。封面加载或剪贴板被占用时明确提示导出失败;关闭页面取消尚未完成的导出。剪贴板只在玩家点击导出按钮且图片生成完成后更新。

定数来源与设置

路径:游戏和 UI 设置 → 潜力值系统 → 谱面定数来源。使用左右箭头切换官方等级、安小璃、萌泪酱,原生滚轮或右侧滚动条可滚至完整选项行。选项保存在当前 BepInEx profile 的 config/menglei.infalsus.potentialsystem.cfg,键为 PotentialSystem/ChartConstantSource:0 为官方等级、1 为安小璃、2 为萌泪酱。首次使用默认为 1,后续启动保留选择;旧布尔键不再控制此项,升级后尚未保存新选择时使用安小璃。

来源 定数规则
官方等级 定数等于游戏当前 SongChartInfo.Rating。
安小璃(默认) 读取 In Falsus Tools 的 experimental.json,按歌曲 ID 与难度匹配;DLL 内置一份离线副本。
萌泪酱 v6 四难度独立模型,内置当前 320 个谱面结果;新谱面在后台离线读取本机谱面文件计算。

两份定数都嵌入 DLL:安小璃按歌曲 ID 与难度匹配,萌泪酱按原生谱面 ID、难度和官方等级匹配。运行时无需 Python、工作簿或研究工具。B50 分享图标明当前定数来源。

每次启动先使用本地定数,同时在后台读取一次安小璃数据,请求总超时为 15 秒。曲库就绪后,萌泪酱只计算尚未收录或官方等级改变的谱面,不重新训练模型。已有结果从内置表或缓存读取;同一 ID、难度和等级的谱面不会重复读谱。单次后台计算最多两分钟,已完成结果保存,未完成项下次启动重试。缺失 DLC 文件、未知谱面格式或计算失败时暂用官方等级,原因写入 BepInEx 日志。

两边都结束后,在选歌界面空闲时统一应用并最多弹一次窗,分别显示安小璃、萌泪酱的变化数量,不显示具体清单。仅统计当前可用谱面的实际生效定数变化;全为零、仅格式变化或仅未进入当前曲库的条目变化时不弹窗。网络失败保留安小璃本地定数,不阻止萌泪酱结果生效。

缓存位于当前 profile 的 BepInEx/config/PotentialSystem/:anxiaoli-cache.json 和 menglei-v6-cache.json,原子更新时保留上一版 .bak。缓存与内置表配套;萌泪酱还核对模型指纹。模组更换内置数据或模型后,旧缓存不会覆盖新版本。没有可用缓存时使用 DLL 内置副本,因此断网也可运行。

萌泪酱 v6 的结果限制在官方等级 L 到 L+0.9 内:

官方等级 可用小数档位
低于 7 .0、.5
7、8 .0、.5、.8
9 及以上 .0~.9,每 0.1 一档

取最近合法档位,等距取较高档,不进位到下一等级。MIN、EVO 使用各自结构公式;ULT 在 10~12 级、FBD 在 10~14 级使用各自独立的线性与核回归,其他等级使用对应难度的结构公式。缺少同级结构中心时,以 L+0.45 为连续估计再分档。社区定数用于趋势参照;低难度缺少细分社区标签,结果属于结构估计。上述边界与分档只约束萌泪酱,安小璃保留上游原值。

计算方式

每首歌的不同难度作为不同谱面。游戏 PlayerScore 除以 10 后对应 Arcaea 的分数尺度;当前来源的谱面定数为 C,归一化分数为 A,本次成绩完成等级达到 DiveCleared(含 FullLink、PerfectDive)时 bonus=0.2,否则为 0。原生 Lamp 仅按 Pace 判断,可能与未判定音符导致的 DiveFailed 不一致,因此 PTT 的通关状态统一由完成等级决定:

A >= 10,000,000:C + 2 + bonus
9,800,000 <= A < 10,000,000:C + 1 + (A - 9,800,000) / 200,000 + bonus
A < 9,800,000:max(0, C + (A - 9,500,000) / 300,000 + bonus)

保存每谱面分数增量最大的原始成绩,再以当前定数计算单曲潜力值。取最高的 50 项作为 B50,B10 为其中最高的 10 项:

PTT = (B50 单曲潜力值总和 + B10 单曲潜力值总和) / 60

分母始终为 60,成绩不足时缺项贡献零。同一定数表及曲库下,每个谱面的最高值只升不降,因此账号 PTT 只升不降。切换定数来源、后台定数更新,或游戏调整已有谱面等级、可用状态及身份时,模组按当前数据重新计算,PTT 可能上升或下降。

定数固定显示一位小数,例如 10 级显示 10.0;单曲及账号 PTT 截断到三位小数,内部计算保留 decimal 精度。结算增加值按显示前后的差计算;显示未变化时为 Keep。切换定数来源后,已打开的结算页更新当前数值,不把来源变化显示为一次新成绩。

理论上限使用当前所有可用谱面的 C+2.2 套用同一 B50/B10 公式计算,随曲库及定数来源变化。

徽章使用以下固定门槛;达到每档下界时切换。选歌、结算、完整成绩浏览和 B50 导出共用同一规则。

本游戏潜力值范围 徽章外观 对应 Arcaea 原门槛
0.000~3.999 青色,无星 0.000
4.000~7.999 绿色,无星 3.500
8.000~10.999 浅紫色,无星 7.000
11.000~11.999 紫色,外围光效,无星 10.000
12.000~12.999 红色,外围光效,无星 11.000
13.000~13.499 粉红色,一星 12.000
13.500~13.999 粉红色,二星 12.500
14.000 及以上 玫红色,圆形图案,三星 13.000

安装

需要 BepInEx-BepInExPack_IL2CPP-6.0.755。将 PotentialSystem.dll 放入当前启动方式使用的 BepInEx/plugins/MengLei-PotentialSystem 目录,重启游戏后进入选歌界面。

从本仓库编译时,DLL 位于 PotentialSystem/bin/Release/PotentialSystem.dll。安装该 DLL 即可运行,不依赖本仓库其他模组。

成绩文件与异常

独立记录保存在 savestate_V3.sav 相同目录的 savestate_ptt_v1.json,不写入原生存档。正常替换时,上一版保留为 savestate_ptt_v1.json.bak;文件归属于原版账号/存档目录,切换 BepInEx profile 不会混用其他 Steam 账号的成绩。

每次载入账号均遍历 history 的实际 length,逐局使用同一次成绩的分数与完成等级,按歌曲/难度计算最高表现。较低分的通关成绩仍可能比更高分的未通关成绩有更高 PTT。当前有效谱面的数值从历史重建;独立文件只为歌曲、难度、谱面身份、分数和完成等级一致的真实成绩提供已知时间,暂时移除的谱面继续归档。

同步同时检查原生成绩对象、更新号和 history 实际条数。游戏未破最高分或完成等级纪录时,updateId 不增加,但逐局历史仍然追加,因此须以条数识别变化。结算先捕获本局 UTC 时间和更新前数值,再同步历史,保持增加动画。

根字段为 schemaVersion: 1、rule、UTC importedAt 和 bestPlays。官方等级的 rule 为 integer-rating-v1,安小璃为 anxiaoli-v1,萌泪酱为 menglei-v6;同时兼容旧 menglei-v4、community-experimental-v1 和整数记录,读取后按当前来源重算。每条记录包含 songId、difficulty(1/2/4/8)、chartId、score(十进制字符串)、lamp(用于 PTT 的通关状态)、resultClear、constant、未截断 potential、achievedAt 和 source。history 来源为原生真实历史,play 为模组捕获的真实结算及时间;原生时间为零或无效时 achievedAt 为 null。importedAt 仅表示首次创建文件的时间。

新结算由模组捕获 UTC 时间,表现更高时更新记录;相同表现优先已知的较早时间,历史同步不会用 null 覆盖已知时间。关闭模组期间的游玩也会补入,无法还原的完成时间保持 null。定数来源、定数表或游戏等级改变时,文件中的定数与 PTT 同步重算,保留成绩和取得时间。外部读取者须识别当前 rule 及小数 constant,不能把社区定数来源按整数方案解释。

旧 PotentialSystem/integer-v1.json 不再读取或生成。新文件成功写入后,旧文件及其 .bak 会移为同目录的 savestate_ptt_v1.json.legacy.<唯一标识>.bak,移除旧路径并保留可恢复数据。旧格式不作为可靠最佳成绩导入。已有 v1 文件中的 source: "summary" 条目由加载器识别后丢弃,当前谱面随完整历史重建;保存前一版仍由 .bak 保留。新文档只输出真实 history/play 纪录。

读取失败或发现不支持的格式时,模组保留原文件并显示 Data error,不把坏档当作空档覆盖。请查看 BepInEx 日志,备份并修复文件后重启游戏。备份文件由用户判断后恢复,模组不自动用较旧备份替换当前成绩。

写入或旧格式归档失败时,待处理状态保留在内存,并显示 Unsaved。新的场景刷新或结算事件会再尝试保存;成绩可在下次载入时从 history 恢复,但尚未成功保存的模组 UTC 时间无法由原生存档补回。

首次安装或在已经打开的结算界面加载插件时,已有原生成绩作为初始基线,不把它们伪装成本次新增 PTT;之后的结算显示正常增加动画。当前原版历史列表的 1024 是初始容量,写满会扩容,模组读取实际 length。历史缺失或结构无效时停止该账号的计算并报告错误;有效的空历史可生成零成绩文件。

参考

潜力值徽章图片原作来自 Arcaea / lowiro,档位图片对应中文 Wiki 的 Rating_0~Rating_7 和 Rating_off。实际档位素材取自 SkyDynamic/nonebot-plugin-arcaeabot,固定于提交 49ce0c7f4f95107caf6c9aa3443066222eca76b7,保留透明背景并嵌入 DLL。嵌入字体取自用户提供的 Arcaea 7.0.255c APK 内 assets/Fonts/,中文显示使用 NotoSansCJKsc,账号数字使用 Exo-SemiBold。头像白色边框取自同一 APK 内 assets/img/1080/char_icon_border_white-selected.png;深色菱形底为本模组绘制。头像框、头像、徽章的 150:128:85 比例、徽章相对偏移 (56,-37.5) 和 34:24 字号比例来自 UserCell.csb,成绩区参考 HighscoreEntry.csb 的 433×110 横向结构,再适配本游戏的信息量和导航区。角色头像使用当前游戏的角色图标材质,身份取自原生存档 SelectedCharacter;歌曲封面和名称从当前游戏加载。

SAM/ICP1 解码改编自 REDDRAGON-HL/InFalsus-Resource 提交 71cdbfe6e9e4959605a39bdfd53192a61ebb290c 的 spc_to_json.py、extract_infalsus.py。许可证同时嵌入 DLL:

MIT License

Copyright (c) 2026 RedDragon

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

CHANGELOG

更新记录

1.0.1

  • 成绩页顶部仅显示 PTT、B10、B50,移除标题、MAX 和常驻说明,关闭按钮改为右上角红叉。

  • 搜索框与操作按钮按实际字形范围居中;滚轮直接调整列表位置,滚动条底板、轨道与滑块使用独立深度。

  • 成绩卡片与 B50 分享图共用绘制函数,统一圆角、字号、字体和文字位置,并按视口裁切整张卡片。

  • 修复退出选歌时重复注销已销毁头像/PTT 按钮产生的 ArgumentNullException。

  • 头像与 PTT 入口改用独立原生按钮,直接登记最终菱形碰撞体;移除对入口布局矩形的重复鼠标裁切,保留游戏边界和弹窗输入隔离。

  • 按 Arcaea 原始布局调整头像、徽章比例和右下重叠位置;账号数字采用 Exo-SemiBold,整数与小数按 34:24 分层,并共同适配宽度。

  • 选中谱面信息移至独立深色成绩区,与返回按钮分隔;补全难度、定数、单曲 PTT、排名、打击分数、完成等级、纪录时间与定数来源。

  • 侧卡文字按单曲 PTT 档位配色,保留现有定数和排名显示。

  • 萌泪酱定数升级为 v6,内置当前 320 个谱面结果及四难度独立模型。新谱面在后台读取本机文件并离线计算,无需 Python 或联网;已计算结果保存至当前 profile。

  • 萌泪酱结果限制在官方等级范围内:低于 7 级分 .0/.5,7、8 级分 .0/.5/.8,9 级及以上每 0.1 一档。

  • 安小璃更新与萌泪酱计算全部结束后,选歌空闲时统一弹一次变化数量提示;全部无变化时不弹窗。请求或计算失败保留本地定数,互不阻塞另一来源的结果。

  • 萌泪酱缓存按内置表和模型指纹隔离;官方等级改变后重新计算,单次后台计算最多两分钟。

  • 兼容旧 menglei-v4 成绩文件,切换来源或采用新定数后重算潜力值与排名,保留原始成绩和取得时间。

  • 安小璃定数改为从 In Falsus Tools 的 experimental.json 获取,每次启动后台检查一次,15 秒超时;失败时沿用本地定数。

  • 更新 DLL 内置定数副本,并在当前 profile 保存下载缓存;模组更新内置表后,旧缓存不会覆盖新表。

  • 定数更新后同步重算潜力值、排名、排序和分享图数据,保留原始成绩与取得时间。

  • 修复侧卡布局范围为零或尚未就绪时导致整个选歌潜力值界面停用:文字行使用独立定位点,保留原有位置、字宽和卡片缩放。

1.0.0

  • 适配游戏1.0.7的选歌排序回调,保留原版与潜力值扩展排序的切换。
  • 新增潜力值系统,直接读取当前可用谱面;内置安小璃与萌泪酱两份各300条的固定定数表,缺项回退歌曲等级。
  • 在原生“游戏和 UI 设置”增加“潜力值系统”分类及“谱面定数来源”左右箭头选项:官方等级、安小璃、萌泪酱,默认安小璃,选择保存在当前 profile;官方等级直接作为定数,所有来源始终显示一位小数。
  • 按新版 B50/B10 固定分母 60 计算账号 PTT,并保留每谱面最高表现。
  • 从逐局 history 计算每谱面最高 PTT,分数与完成等级来自同一次游玩;完成等级达到 DiveCleared 时增加 0.2。
  • 在原版存档旁保存 savestate_ptt_v1.json,记录真实最佳成绩及已知时间;随历史变化同步,兼容旧整数数据。切换定数来源重新计算全部数值与排名,保留原始成绩和时间。
  • 选歌顶部显示放大的所选角色头像菱形,上角裁至游戏边缘,右下小菱形显示 PTT;白色头像边框采用 Arcaea APK 素材,配合深色菱形底。
  • 歌曲卡片未游玩时显示 10.0,已游玩时显示 #10 11.1 -> 11.123;侧卡信息位于曲绘上方,使用单层文字;选中谱面信息位于场景左下。
  • 徽章按固定潜力值门槛 0/4/8/11/12/13/13.5/14 切换,13、13.5、14 分别对应一星、二星、三星;选歌、结算、完整成绩页和 B50 导出使用同一规则。
  • 点击顶部头像或 PTT 菱形浏览全部已游玩谱面的最佳成绩,支持封面卡片、滚动和搜索;入口复用原生按钮并在选歌取得输入后重新登记,按头像和 PTT 的独立菱形设置碰撞范围,并限制在游戏显示区域内,弹窗期间禁用入口。
  • 原版排序按钮切换序列依次加入“歌曲定数 升序/降序”“歌曲潜力值 升序/降序”:前者使用当前来源定数,后者使用最佳单曲 PTT;沿用原生按钮及双向循环,保留全部原版排序选项。
  • 新增 B50 分享图片生成与剪贴板导出,采用五列横向圆角卡片;成绩页与分享图均使用曲绘的深色印象色,标明当前谱面定数来源,不依赖屏幕截图或当前窗口分辨率。
  • 结算信息位于顶部中央,左侧显示单曲变化,右侧显示账号增加值或 Keep,保留账号数值过渡动画。
  • 独立成绩文件采用原子替换和上一版备份;读取与写入失败均明确提示。
  • 修复选歌和结算文字副本清空原生材质缓存导致的空引用异常,保留原生字体组件的初始化与回收流程。
  • 成绩页改用游戏原生字体、按钮、滚动列表与垂直滑块,统一点击和拖动输入,避免当前 IL2CPP 版本中 GUI 接口恢复不完整的问题。
  • 命中范围按原生布局的累计相机深度换算,统一顶部头像入口及成绩页控件的投影依据。
  • 修复头像容器实际尺寸为零导致点击无响应:固定尺寸容器按父级比例参与原生布局,Best 页直接换算可用范围,按钮和滚动视口同步获得有效命中区域。
  • 修复进入选歌时报“原生 UI 容器的布局范围尚未就绪”:尺寸换算与点击范围直接读取原生布局缓存,避免 IL2CPP 引用返回值导致布局数据读取错误。
  • 成绩页以游戏原生显示区域布局并裁切列表边缘,在 16:10 屏幕上保持在游戏 16:9 区域内;关闭时注销本页控件并归还选歌输入。
  • 修复两侧歌曲卡片误用未同步的难度字段:定数、已游玩成绩、排名和潜力值排序均按原生歌曲行的实际难度查询。
  • 设置页将新增分类高度计入内容边界,同步原生滑块长度、位置和拖动映射,使底部定数来源选项行能够完整滚入游戏区域。
  • 修复搜索聚焦后不接收文字:原生输入接收器在登记及释放时稳定声明文字监听,焦点只控制文本写入。
  • 内嵌 NotoSansCJKsc 字体补全中文显示,设置页显示“萌泪酱”,导出提示使用“粘贴”。
  • Best 页面与导出卡片共用宽高、列数及间距,封面、文字和行高等比缩放;页头信息、操作按钮和状态提示分区显示。
  • 头像与 PTT 使用独立菱形碰撞体,自有命中层置于原生顶部遮挡层之前;鼠标进入可见入口时重放原生悬停判定。