OliBomby/Mapperatorinator

An AI framework for generating and modding osu! beatmaps for all gamemodes from spectrogram inputs.

What it solves

Mapperatorinator 自动化创建高质量、可排名的 osu! 谱面，覆盖所有游戏模式。它通过音频输入生成击打对象、节拍和图案，省去手动绘谱的繁琐，同时提供工具来识别现有谱面的错误和不一致之处。

How it works

该框架采用多模型方法，核心是修改后的 Whisper 架构（2.19 亿参数），以音频的 Mel 频谱图为输入。它将谱面转换为令牌化的事件表示（量化时间和位置），并顺序生成这些令牌。为处理长歌曲，使用 90% 重叠的滑动窗口方式以确保无缝衔接。为提升精度，使用扩散模型将量化坐标去噪为最终位置，并配合“超级时序生成器”通过多次推理取平均，以应对可变 BPM。

Who it’s for

  • osu! 谱面创作者：想自动化初始绘谱过程或生成客制难度。
  • 谱面模组制作者：想使用 AI 工具（MaiMod）查找节奏错误、时机不准或不一致的放置。
  • 开发者：对音频到事件的生成模型感兴趣。

Highlights

  • 多游戏模式支持：生成 std、taiko、ctb、mania 谱面。
  • MaiMod：AI 模组工具，检测“惊讶度”（意外模式）以标记潜在的谱面错误。
  • 高度可定制：允许用户指定难度（星级）、制谱者风格（通过制谱者 ID）、上传年份和特定风格描述。
  • 上下文感知生成：可使用已有的 timing 或 kiai 区段作为上下文，提高准确性和速度。
  • Web 与 CLI 界面：提供友好的 Web GUI 与交互式 CLI 供配置使用。