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："surprisal"（予期しないパターン）を検出して潜在的なマッピングミスをフラグ付けする AI モッディングツール。
高いカスタマイズ性：難易度（星評価）、マッパースタイル（マッパー ID で指定）、アップロード年、特定のスタイル記述子をユーザーが指定可能。
コンテキスト認識生成：既存の timing や kiai セクションをコンテキストとして利用し、精度と速度を向上。
Web と CLI インターフェース：ユーザーフレンドリーな Web GUI とインタラクティブな CLI を搭載。