Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

osumania_map_analyser

English | 中文


本仓库是一个纯AI打造的VSRG游戏内叠加界面,实时在 osu!mania(4/6/7K/Lazer/Stable)、Etterna、Malody V(及其编辑器)、Malody 4.3.7下,提供估算难度、RC/LN键型分析、MSD计算、难度分布、区间分析和分轨准确度等多种实用功能。

本项目同时支持在tosu中作为ppcounter使用。

Features

功能展示 LaneAcc LivePP CombineModeAndSectionMode
CompareRAM

主要特性

  • 基础功能:在多种游戏选图过程中实时分析当前谱面的各项数据,包含多版本Etterna MinaCalc、难度估计、难度图表等丰富内容。
  • 多游戏支持:同时支持Osu!Stable/Lazer、Etterna、Malody V及其编辑器、Malody 4.3.7。
  • 多mod支持:兼容上述游戏的多个mod,支持自定义倍速与判定修改。
  • 区间分析:双击难度分布图,拖动选中一段时间,单独计算某段的数据。
  • 分轨准确度:游玩过程中计算每个轨道的独立准确度,并实时进行真ScoreV1/V2互转。
  • 暂停计数:统计实时游玩中和Lazer回放中的暂停次数并显示在难度分布图上。
  • ReworkPP:在游玩过程中实时计算 Sunny Rework PP,并展示其内部参数。
  • 预设系统:提供系统与自定义预设,一键应用/保存整套配置,支持自动跟随手动修改。
  • 高度自定义:提供丰富的自定义选项,满足不同玩家的需求。
  • 轻量化:使用桌面壳读取内存,无须额外启动 tosu,占用仅 ~10MB RAM,且不影响游戏性能。

快速开始

作为独立程序使用(推荐)

  1. 前往Release下载带shell的最新版本。
  2. 将下载的文件解压到任意位置。
  3. 如果你需要在 Etterna 或 Malody V 中使用,请一并在 Release 中下载bridges.zip,并解压到与shell同目录下,注意不要嵌套文件夹,确保正确放置。打开bridges目录,运行install-bridge-zh.bat。对于Linux用户,请参照本文档的“安装桥”章节手动安装 Etterna 与 Malody V 的桥文件。
  4. 按下Ctrl+Shift+S打开设置页,在Shell Configuration中检查自动探测游戏目录结果是否正确,否则请填写需要使用的游戏目录,用于寻找谱面进行分析。
  5. 完成后,按需重启应用,随后即可正常使用。其中 Malody V 编辑器需要手动点击MMA Analyze按钮进行分析。窗口的操作说明见下方。
  6. 阅读设置说明、预设系统教程和桌面壳完整教程(含注意事项和常见问题),开始使用。
  • 在OBS中捕获窗口时,如果捕获到黑屏,请在设置中使用 Windows 11 捕获方式。
操作方法
拖动整个窗口按住窗口顶部拖动条(发光细条,中间有 ⋮⋮ 标志)拖动。鼠标移上去会显示一圈描边,标出即将移动的整扇窗口范围
改变窗口大小拖动窗口边缘(无边框,四周可拖)。看不到边界时把鼠标移向窗口边缘,贴近的边会发光
页面缩放按住 Ctrl 滚动鼠标滚轮;或 Ctrl + / Ctrl -;Ctrl 0 复位
开关置顶(默认开)默认按 Ctrl+Shift+T(全局快捷键)
开关点击穿透(默认关)默认按 Ctrl+Shift+C(全局快捷键)
打开设置窗口默认按 Ctrl+Shift+S(全局快捷键)
关闭窗口默认按 Ctrl+Q(全局快捷键)
刷新卡片选中窗口后按下 F5
  • 标注全局快捷键的操作在窗口失焦或点击穿透时同样有效。
  • 卡片右上小圆点为当前激活的数据来源,包含:粉色-osu!(Stable/Lazer)、紫色-Etterna、亮青色-Malody 4.3.7、蓝色-Malody V、灰色空心-当前没有数据源。

在tosu中使用

  1. 前往Release下载不带shell的最新版本。
  2. 将下载的文件解压到任意位置。
  3. 将整个文件夹放置在 tosu 的 static 目录下,如果你没有修改 Counters Directory 设置项的话。注意不要嵌套文件夹,确保正确放置。
  4. 启动 tosu,进入 dashborad,即可找到 "ManiaMapAnalyser" 插件,可以点击右侧Settings按钮进行相关设置。
  5. 阅读设置说明和预设系统教程,开始使用。游戏内界面以及OBS的使用方法见 tosu 相关文档。

注意事项

  1. 本插件依赖于谱面数据的正确解析,某些特殊或非标准的谱面可能会导致分析结果不准确。
  2. 本程序主要设计作为独立程序在 osu 中运行。在非 osu 来源或未使用桌面壳的前提下,部分功能可能会不可用或降级。
  3. 从 Etterna 转换得到的谱面默认取 OD 9;Malody 4.3.7 与 Malody V 的转换 OD 由游戏内判定档(A~E或Pro)与谱面倍速(模组或Turbo Mode)共同决定。详见此处。
  4. 当Lazer更新,内存无法正常读取时,请尝试在设置中点击壳设置 -> 内存偏移表管理 -> 偏移表操作 -> 检查 GitHub 远程更新。若开发者尚未发布shell/偏移表更新时,点击旁边的实时生成可快速根据当前运行的Lazer进程尝试生成偏移表。使用时需要保持Lazer正在运行。你也可以通过offsets/gen.exe来生成。
  5. 读取回放中的暂停次数和位置功能,仅限 2025.816.0 版本之后的原生 Lazer 成绩。
  6. 当无法启动桌面壳,日志中提示端口被占用时,请先用 Get-NetTCPConnection -LocalPort 24061(或 netstat -ano | findstr :24061)查占用进程 PID ,随后在任务管理器中关闭占用程序。所有的端口占用情况为:24061(壳页面)、24062(osu! 原生读取兼容端点)、17653(Malody V 选曲桥);tosu 使用 24050。若 24061 被占用,壳无法启动。24062/17653 被占用时对应原生传输/桥功能会被降级。若修改了 tosu 端口,请在插件设置 wsEndpoint 中填写相同的 host:port。
  7. 如果你无法使用 Ctrl + Shift + S 打开设置页,请检查是否有其他程序占用了该快捷键,或尝试打开 mma-shell-config.json 文件,手动修改 hotkeys 中的 settings 键值为其他组合键(如 "settings": "Ctrl+Alt+S")。
  8. 如果存在问题欢迎提交issue。我们也欢迎任何人在遵守CONTRIBUTING.md的前提下提交PR!

设置说明

注意:推荐直接使用默认设置开始体验,或选择一个合适的预设,之后再根据个人喜好进行调整。
详细设置说明见 docs/settings.md 。
预设系统教程见 docs/presets-guide.md。
桌面壳教程见 docs/shell-guide.md。

难度估计算法说明

  • 难度估计算法虽然经过调整,但仍然可能存在不准确的情况,请仅将其作为参考。对于4K,一般情况下在 Reform Beta 开始比较准确,整体误差不超过半个段位,低难相对没那么准确;在Minijack、Stamina和Anchor等键型中,估计结果可能会有较大的偏差。对于6K和7K,整体表现相对一般。建议玩家结合自己的实际游玩体验进行判断,不要过于依赖估计结果,将算法视为一个真正的玩家给出的参考结果。

基准测试

  • 基准测试已迁移至独立仓库 VSRG-DanEstimation-Benchmark,测试结果可以在此处查看。测试涵盖了多个算法在不同类型谱面上的表现,帮助玩家选择适合自己的算法。
  • 需要注意的是,虽然基准测试提供了算法表现的参考,但实际使用中可能会受到谱面特征、mod组合等多种因素的影响,建议玩家结合自己的游玩体验进行判断。
  • 受限于人工标注误差以及玩家个人差异,目前在1300+样本量下的难度估计准确度已经接近极限。我们添加了对算法的反馈功能,欢迎广大玩家在游玩时对其进行反馈,这有助于我们寻找偏离较大的谱面并针对优化,谢谢!
  • 你可以在此处下载用于基准测试的谱面数据,但是请注意阅读免责声明,合理使用这些数据。

特色算法

  • Sunny 是一个星数直接映射到难度的表。请注意与 SunnyRework 进行区分,后者只是星数与PP计算。本表格通过计算对应段位的星数,直接划分出多个映射区间,详细的表格请查阅 js/estimator/intervals。
  • Roxy 是一个 4K RC 元结构估算器,聚焦高难区间(Alpha 至 Emik Zeta high)。其核心分为两层:第一层对谱面进行 7 个方面结构分析,产出结构化数值难度;第二层通过 Ridge 线性元模型融合 Azusa/Daniel 的参考预测,并在最终输出上与 Azusa 预测按 0.4/0.6 加权平均,输出最终难度。元模型按段位 0.5 序数刻度校准,使结果更贴近段位判定。如有需要,请前往此处(英文)查看算法文档。
  • Azusa 算法在谱面本身的基础上,融合了Daniel和Sunny Rework的结果,并针对4K RC谱面进行了特定的调整。如有需要,请前往此处(英文)查看算法文档。
  • Polaris 是一个表修正估算器。以 Sunny 为基线,修正“星数 → 段位”映射的系统性偏差。覆盖 7K 的 RC 与 LN 两侧;如有需要,请前往此处(英文)查看算法文档。
  • Mixed 是一个路由器。通过智能识别谱面信息来自动路由到内置最佳算法,在必要情况下会进行修正和融合。拥有全局最优准确度。

第三方算法

  • Daniel: SunnyRework 的改进版本。仅支持 4K RC。
  • Companella: 基于 Etterna MinaCalc 的 4K 段位 onnx 估算模型。
  • XDC1: 构建 4K 单手模型,综合手指、手腕与抖动三种维度并计入LN代价与体力消耗估计难度。支持 4K RC/LN(Alpha 至 Theta)。
  • Proj7k: proj7k 7K 难度引擎的移植。按手指建模负荷,用阈值求解得到整首难度,再按 JinJin Dan 给出标签;仅支持 7K,其他键数回退 Sunny。

隐私

  • 本插件默认开启匿名使用统计,用于统计活跃用户数、在线分布与使用行为。上报内容不含用户名、玩家 id、分数、谱面标识(标题/md5)、IP 地址等任何个人信息,数据仅用于生成聚合统计。如不希望上报,可在设置 → Network 分组中关闭 "Anonymous Usage Statistics"。
  • 本插件默认开启估计算法反馈,在玩家游玩结束后会在卡片下方提示玩家对本次估计算法进行反馈,用于收集准确度信息、偏差较大谱面以及整体估计情况。上报内容只包含本轮游玩的谱面bid、模组和算法输出等必要信息,不包含个人信息。数据仅用于改进估计算法。如不希望上报,可在设置 → Network 分组中关闭 "Difficulty Feedback"。
  • 两者的数据透明公开,看板见:https://mma-stats.leoblack.top/

贡献指南

详见 CONTRIBUTING.md。

参考内容

  • tosu: 本插件的运行环境和基础框架。
  • Etterna: 使用了Etterna的MinaCalc进行难度估计和MSD计算。
  • Sunny Rework: 使用了Sunny Rework的算法计算星数,是大部分算法的基础。
  • Interlude: 使用了Interlude的RC键型分析算法并在基础上新增LN检测算法。
  • Daniel: 使用了Daniel的算法进行难度估计。
  • Companella: 使用了Companella的算法进行难度估计。
  • XDC1: 使用了 XDC1 的算法进行 4K 难度估计。
  • DanielEtterna:参考了其获取Etterna数据的方法。

贡献者/致谢

  • inuiyumegan: 提供了大量谱面数据用于算法调试和Benchmark。
  • greycsont: 提供了部分功能。
  • ZHAO20060708: 提供了精美的Lazer主题和Full模式(现已更新为Combined模式)。
  • SST-03 & AkutaZehy: 提供了改进的 Sunny LN 算法。
  • 未来lk: 赞助了300M Token。
  • Entitley于Malody V小卡片视频下方发表的评论:提供了 MalodyV 支持的灵感来源和 BepInEx 插件部分源码。
  • aleju03:通过其项目 mania-hub 提供了大规模真实游玩行为数据集(约484万次4K/7K游玩),用于难度判定与玩家实际成绩的对照分析,是 Polaris 的数据基础。

本页自2026/6/21起累计访问量,感谢大家的支持!

:maniamapanalyser

关于 About

Real-time VSRG overlay with difficulty estimation, RC/LN pattern analysis, multi-version MSD calculation, difficulty distribution and more, for 4K, 6K and 7K maps.
difficultyestimatoretternamalodymalodyvosuosu-maniatosu

语言 Languages

Rust44.8%
JavaScript40.4%
Go4.2%
CSS3.3%
PowerShell3.1%
C#2.0%
HTML1.1%
Python0.6%
Lua0.3%
Shell0.1%
Dockerfile0.0%
Batchfile0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
762
Total Commits
峰值: 94次/周
Less
More

核心贡献者 Contributors