面向 osu! stable（mania） 的谱面处理与练习工具：变速、改 OD/HP、LN 变换、难度预览，开箱即用。
单文件 exe，免安装；也可以下载完整文件夹版。
- 按倍速变速：保持音高（SoundTouch）或 变调（重采样，像唱片加速）
- 关闭保持音高（变调）时，倍速不能低于 0.23x；低于该值会明确报错，避免音频与谱面时间轴不同步
- 按 BPM 变速：多 BPM 谱面以覆盖时间最长的主 BPM 为参考，
倍率 = 目标 BPM ÷ 主 BPM - 谱面时间、TimingPoints、音频同步缩放，相对 BPM 结构保持不变
- 修改 OD / HP（未改动时不写入）
- FULL LN：把所有音符变成 LN，尾部留 1/f 拍缝隙（松散 1/2、标准 1/4、密集 1/8，或自定义 1–16）；间隔不足 1/f 拍或每列最后一件保持单点。标准（1/4）与 NOODLES 谱面的规则一致；无缝（seamless） 让 LN 尾与下一件头完全重合（0 ms），供特殊需求使用
- RICE：把 LN 变成单点（Lazer
ManiaModHoldOff） - SHORT LN（短面条）：只把普通音符变成固定长度的短面（默认 1/4 拍，可设 1–16），并保证面尾到下一件的缝隙不小于“最小缝”；原谱已有 LN 保持原样，每列最后一个普通音符也会生成短面
- Release：保留原谱 LN，只随机处理普通音符。
长短比（0–10）是长面概率的十分比（loose=2、standard=5、dense=8，0 全短、10 全长）；尾判难度（0–10）控制面尾对齐程度（0 对齐相邻面头/面尾，10 最参差）；宽松度（0–10）同时约束短面最小长度与长面最大缝隙（0=1/16 拍，5=1/4 拍，10=1 拍）。短面的缝隙不小于长面最大缝隙，放不下时退化为单点；所有长度均按拍长计算，不按小节 - 自动清理视频、故事板与 break（输出更干净）
- 对当前谱面批量生成多个倍速版本；当前谱面视为 1.0x，不解析文件名/Version 里的旧倍速标记
- 倍速模式：填写低值/高值（▲▼ 步长 0.05）与生成步长（默认 0.05），只生成恰好落在步长网格上的值，1.0 跳过
- BPM 模式：填写低值/高值（▲▼ 步长 1）与步长（默认 5）；默认从当前 BPM 到当前 BPM + 5×步长；可开启“BPM 自动对齐 0/5”，只在范围内生成尾数为 0/5 的目标
- 方向只控制生成顺序；单次最多 200 个版本，带进度与逐项失败继续
| 项目 | 来源 |
|---|---|
| 星数 | osu! 官方 SR（rosu-pp） |
| 段位 | Azusa（与 ManiaMapAnalyser 插件一致） |
| MSD | Etterna MinaCalc（仅 4K） |
| LV | 6K 定数（Sunny星 × 200/81 + 7/6） |
| 键型 | ManiaMapAnalyser pattern 引擎（如 Jacky WC Tech，附 RC/LN/HB/Mix） |
- 默认读取 osu! 进程内存自动跟随（选歌界面、游玩中都可）
- 可选 tosu 通道（
ws://127.0.0.1:24050），内存不可用时自动切换 - 内置歌曲列表：搜索谱面集、选择难度、一键载入
- 支持把
.osu文件直接拖进窗口
- 默认写回原谱面所在文件夹，也可指定外部输出目录
- 后缀规则：倍速 + 模式 + HP + OD（未改动的项省略），例如：
[1.2x FULL LN HP8 OD8][180bpm RICE][Release]
- 同名文件自动追加
(2)，不会覆盖原谱面 - 音频按需转码为 192 kbps MP3
- 从 Releases 下载：
OsuMapTools.exe（单文件，推荐）- 或完整文件夹版压缩包（解压后运行
OsuMapTools.exe）
- 先打开 osu!，再打开 OsuMapTools
- 确认右上角出现
内存 SongSelect（或 tosu 已连接）；也可以点「选择谱面…」从歌曲列表选择 - 调整倍速 / OD / HP / 音符处理
- 点「生成」，底部会显示实际输出路径
什么都没改时「生成」按钮是禁用的；这表示输出会和原谱面完全一致，没有生成必要。
- Windows 10 / 11（x64）
- .NET Framework 4.8（系统自带）
- WebView2 Runtime（Win10/11 自带；缺失时从微软官网安装）
- osu! stable（mania 谱面）
OsuMapTools.exe "map.osu" --rate 1.2 --generate
OsuMapTools.exe "map.osu" --bpm 180 --mode invert --strength dense --generate
OsuMapTools.exe "map.osu" --od 8 --hp 7 --out "D:\out" --no-pitch --generate| 参数 | 说明 |
|---|---|
--rate <x> |
倍速（0.01–5） |
--bpm <bpm> |
按目标 BPM 变速 |
--od <v> / --hp <v> |
覆盖 OD / HP |
--mode keep|invert|holdoff|release|shortln |
音符处理 |
--strength loose|std|dense|seamless |
FULL LN 缝隙 |
--gap <1-16> |
自定义 FULL LN 缝隙（1/N 拍） |
--short-length <1-16> |
SHORT LN 面条长度（1/N 拍，默认 4） |
--short-gap <1-16> |
SHORT LN 最小缝（1/N 拍，默认 4） |
--long-ratio <0-10> |
Release 长短比（loose=2、standard=5、dense=8） |
--tail-difficulty <0-10> |
Release 尾判难度（默认 0） |
--leniency <0-10> |
Release 宽松度（默认 5） |
--release-a/b/c |
兼容旧别名 |
--release-style loose|std|dense |
Release 预设（等价于设置 a） |
--release-gap <0-10> |
旧参数，等价于 --release-c |
--no-follow |
不自动跟随 osu! 当前谱面 |
--out <dir> |
外部输出根目录 |
--no-pitch |
关闭保持音高（变调） |
--generate |
生成后退出 |
4K 显示 MSD；6K 显示 LV；其他键数没有公认数值指标，该列会隐藏。 4K 的 LN 段位使用 SunnyWindow 的 LN 专项 star（不再用 Azusa 总 SR 查 LN 表）；没有 LN 分段时不显示 LN 段位。
退出码：0 成功，1 生成失败/无改动，2 参数无效、缺少 --generate 的谱面，或谱面不存在。
- 读内存需要权限对齐：如果 osu! 以管理员身份运行，本工具也需要以管理员身份运行
- 请保留原谱面备份；工具只写新文件，不修改源文件
- Release 模式按设计是随机的，预览与最终生成可能不同
- 输出目录如果选在
Songs根目录，会自动落到原谱面文件夹，不会自我复制