Modding Helper 説明書

■ チェック内容について
本ツールの判定は、事前に定義したルールベースのチェックによって行われています。
生成AIなどによる自動推測・自動判定は使用していません。

例：

• Tag のスペルチェック：内部辞書との比較によって行われます
• 東方 Source チェック：事前に定義した作品名一覧との一致判定によって行われます
• snap 判定：BPM line と timing 計算によって行われます

未知の単語・特殊表記・新ジャンルなどについては、正しく判定できない場合があります。

■ 検出内容
Circle（type=1/5）の hitsound を解析し、Clap / Whistle / 両方 の個数を表示します。

「Whistle のタイムスタンプを表示」or 「Clap のタイムスタンプを表示」チェックボックスを有効にすると、それぞれのタイムポイントも表示されます。

■ 検出内容
対象 snap から外れているノーツ・スライダー・スピナーを検出します。
±1 ms のズレは警告、 unsnapped のオブジェクト がある場合（±2 ms 以上のズレ）はエラーとして検出します。

■ 検出内容（osu!stable と osu!lazer の違い）
本ツールでは、再スナップ判定とosu!stable グリッド時刻判定を分離して表示します。
再スナップ時刻、グリッド描画時刻、グリッド時刻は別々の計算処理であり、同じ整数msになるとは限りません。

osu!stable または osu!lazer の片方のグリッド時刻にのみ snap している結果は、警告にはせず白文字で表示します。

各処理の計算式、丸め方、osu!stable / osu!lazer間で1 ms差が生じる理由については、次の技術資料を参照してください。
osu!stable / osu!lazer snap時刻の計算

■ 検出内容
kiai 状態が一致していない区間を表示します。

また、kiai time の終了地点が明示されていない場合も警告を行います（AiModと同一の機能）。

■ 検出内容
kiai の ON/OFF が 1/1 snap 以外 に乗っている場合を検出します。

また、unsnapped な kiai line（1/1 snap + 1 ms など）も検出します（AiModと同一の機能）。

■ 検出内容
指定した間隔（1 ~ 5 ms）以内にある、近すぎる SV line を検出します。

■ 検出内容1：2重小節線
osu!stable と osu!lazer の生成方法をそれぞれ再現し、異なる赤線区間から生成された小節線が同時刻、または 1 ms 以内に複数存在するかを確認します。
この判定では小数時刻そのものが重要なため、lazer の生成時刻を整数化せず double のまま比較します。同時刻に複数生成された小節線も重複除去しません。
結果には [osu!stable, osu!lazer]、[osu!stable のみ]、[osu!lazer のみ] のいずれかを表示します。両クライアントで2重になる場合は赤色の Error、片方だけで2重になる場合は警告なしの白文字として表示します。片方だけの結果では、タブにも Warning / Error を付けません。

例：
[osu!lazer のみ] 02:24:992 | 同時刻に 2 本の小節線が生成されます。

■ 検出内容2：マイナス時刻開始による小節線バグ
最初の赤線がマイナス時刻にある場合、その赤線から最初に生成される小節線位置と、次の赤線位置を比較します。
最初に生成される小節線位置が次の赤線と一致する、または次の赤線を超える場合、osu!stable と osu!lazer で小節線の見え方が異なるため Warning として表示します。

次の赤線の状態	Warning 内容
omit first barline 有効	osu!stable では1本の小節線が表示されますが、osu!lazer では小節線が表示されません。
omit first barline 無効	osu!stable では2重小節線が表示されますが、osu!lazer では1本の小節線が表示されます。

■ 検出内容3：ノーツと小節線の分離
各クライアントで実際に生成される小節線の前後 1 ms 以内に Circle・Slider・Spinner の開始位置がある場合、小節線位置とオブジェクト位置の見た目のスクロール速度を比較します。さらに両者が 2 ms 離れていても、その間に赤線または緑線によるスクロール速度境界があり、境界から両者までがそれぞれ 1 ms 以内なら比較対象にします。値が一致しないものを、ノーツと小節線の分離として黄色の Warning で表示します。
小節線より後のオブジェクトについては、そのオブジェクトと同時刻にSV線がある場合、または両者を上記のスクロール速度境界が橋渡ししている場合に対象にします。
lazer が保持する小数の生成時刻も Math.trunc() で整数 ms に変換してから比較します。整数化後の時刻・対象オブジェクト・判定結果が同じ場合は、stable と lazer の結果を1件へ統合します。
omit first barline は各クライアントの生成処理で先に適用されるため、実際には描画されない小節線を基準にした誤検出は行いません。

見た目のスクロール速度は、スプレッド比較の「スクロール速度」サブタブと同じ考え方で、現在の BPM、現在の SV、SliderMultiplier から計算します。

例：
[osu!stable のみ] 02:45:635 小節線: 934.18 px/s | 02:45:636 ノーツ: 935.08 px/s | 差分: +0.9 px/s

■ 検出内容
ボリューム変更を伴う SV line が、HitObject と近すぎる場合に警告します（この検出は AiMod や Mapset Verifier では行えません）。

検出閾値は、5 ms（丁度は含まない） 1/16 snap（丁度は含まない）から選択できます。

15% 以上の差のみ表示 を有効にすると、volume 差が 15% 以上の際のみ表示します。

■ 検出内容
diff間の赤線・緑線のボリュームを比較し、不一致がある区間を検出します。
（この検出は AiMod や Mapset Verifier では行えません）

5% 以上の差のみ表示 を有効にすると、volume 差が 5% 以上の区間のみを表示します。

50 ms 以上続く区間のみ表示 を有効にすると、50 ms 未満の極端に短い区間を非表示にできます。

各 diff の volume 推移を階段状の線で示すグラフを表示します。

volume 差が条件を満たす区間は背景の帯で強調され、上記2つのチェックボックスの状態にも連動します。

背景オプションでは、volume 差異（赤）・Kiai time（黄）・Break（青）を切り替えられます。
同時に選択できる背景は 1 種類だけです。別の項目を選択すると、それまでの選択は自動的に解除され、選択した背景色がグラフ全体の高さに表示されます。

Kiai time と Break は、表示中の diff のどれか 1 つでも該当する場合に背景を表示します。

グラフ下部のチェックボックスからdiffごとに線の表示・非表示を切り替えられます。 非表示にした diff は、volume 差分・Kiai time・Break の背景を計算する際の対象からも除外されます。

線の色には、Diff の自動整列順を基にした仮想SRカラーを使用します。 Kantan を SR 1、Futsuu を SR 2、Muzukashii を SR 3、Oni を SR 4、Inner Oni を SR 5として扱い、 それ以上の難易度は順番に SR を 1 ずつ加算します。 これは実際の Star Rating を計算したものではありません。

グラフ上でマウスホイールを回すとカーソル位置を中心に拡大・縮小でき、左ドラッグすると表示区間を左右に移動できます。 グラフ上を右クリックすると、そのタイムスタンプを osu!editor で開きます。

■ 検出内容1：ノーツにSVが適用されていない可能性
各 HitObject の時刻を T として、T + 1 ms から T + 5 ms の範囲にSV線があるかを確認します。
該当するSV線がある場合、ノーツにそのSVが適用されていない可能性があるため、黄色の警告として表示します。

出力例：
00:01:000 ノーツSV x1 | 00:01:003 (+3 ms) 直後SV x1.25 | SV差 +0.25

■ 検出内容2：小節線にSVが適用されていない可能性
osu!stable と osu!lazer で実際に生成される小節線位置を別々に計算し、その時刻を T として、T + 1 ms から T + 5 ms の範囲にSV線があるかを確認します。
この判定では、lazer が保持する小数の生成時刻も Math.trunc() で整数 ms に変換します。整数化後の小節線時刻・対象SV線・判定結果が同じ場合は、stable と lazer の結果を1件へ統合します。
該当するSV線がある場合、小節線にそのSVが適用されていない可能性があるため、黄色の警告として表示します。結果には [osu!stable, osu!lazer]、[osu!stable のみ]、[osu!lazer のみ] のいずれかを表示します。

出力例：
[osu!stable, osu!lazer] 02:33:864 小節線SV x1 | 02:33:865 (+1 ms) 直後SV x0.5 | SV差 -0.5

■ 検出内容
ボリューム / kiai のオンオフ / サンプルセット の不一致を検出します。

（この検出は AiMod や Mapset Verifier では行えません）

■ 検出内容
Normal 以外の sampleset やカスタムヒットサウンドを検出します。
（この検出は AiMod や Mapset Verifier では行えません）

赤線・緑線では、以下を検出します：

• sampleset ≠ 1 (normal) → 2: Soft / 3: Drum
• sampleIndex ≠ 0 → カスタムヒットサウンド

ノーツ、スライダー、スピナーでは、以下を検出します：

• normalSet > 1 → 2: Soft / 3: Drum
• additionSet > 1 → 2: Soft / 3: Drum
• sampleIndex ≠ 0 → カスタムヒットサウンド
• filename が指定されている → カスタム音源

スライダーの各エッジに設定されたヒットサウンドも検出します：

• edgeSets.normalSet > 1 → 2: Soft / 3: Drum
• edgeSets.additionSet > 1 → 2: Soft / 3: Drum

■ 検出内容
SliderMultiplier が 1.40 ではない場合に警告します

全ての HitObject の位置から 1/3 snap の割合を計算し、割合が 30% 以上の場合は swingリズムとして扱います（1/3 snap から 1ms ズレしたノーツも考慮しています）。

swingリズムと判定された場合は SliderTickRate = 3、それ以外の場合は SliderTickRate = 1 を推奨値として表示し、実際の値と異なる場合に警告します

（この検出は AiMod や Mapset Verifier では行えません）。

■ 検出内容
最初のノーツが、音源開始時点で画面内のどの位置に表示されているかを推定します。
Circle オブジェクトのみを対象とし、Slider や Spinner は検出対象外です。

BPM と SV から osu!taiko のスクロール速度を推定し、16:9 環境を基準として、ノーツが画面に入ってから判定枠に到達するまでの時間を計算します。

参考： Note Speed Mechanics

結果には、以下の情報を表示します：

• Visible：ノーツが画面に入ってから判定枠に到達するまでの推定時間
• Remain：音源開始時点で、判定枠までどの程度残っているかの推定割合
  （音源開始時点でのノーツ位置）

■ 判定基準

• 警告：Remain ≤ 50%
  
• エラー：Remain ≤ 25%
  

■ 検出内容
以下を検出します。

• 全diffで Artist / ArtistUnicode が一致しているか
• 特殊記号が推奨Romanised表記に変換されているか
• feat.、vs.、CV:、VO: などの marker 表記が正しいか
• カンマの後ろにスペースがあるか
• 連続する半角スペースや全角スペースが含まれていないか

詳細なチェック対象は、 Metadata チェックリスト を参照してください。

■ 検出内容
以下を検出します。

• 全diffで Title / TitleUnicode が一致しているか
• 特殊記号が推奨Romanised表記に変換されているか
• (Short Ver.)、(Game Ver.)、(Movie Ver.) などの title marker 表記が正しいか
• タイトル内の (feat. Artist) 表記が正しいか
• 連続する半角スペースや全角スペースが含まれていないか

詳細なチェック対象は、 Metadata チェックリスト を参照してください。

■ 共通チェック
まず、全diffで Source が一致しているかを確認します（Mapset Verifier と同一の機能）。

■ 検出内容 1：東方
Source を東方作品名のリストと照合します。
チェックリスト

完全一致する場合は OK として表示します。

東方作品と思われる Source で、既知の作品名と表記が微妙に異なる場合は、スペルミスやスペースの全角 / 半角ミスの可能性があるため警告します。
その場合、推奨表記と参照リンクを表示します。

また、東方 や Touhou などの汎用的な表記のみの場合も、具体的な作品名が不足している可能性があるため確認対象として表示します。

■ 検出内容 2：ソースの表記チェック
東方作品名のチェックとは別に、次のSource表記候補を表示します。

• ブルーアーカイブ または Blue Archive：ブルーアーカイブ -Blue Archive-
• プロジェクトセカイ を含む、または大文字小文字を問わず Project Sekai を含む：プロジェクトセカイ カラフルステージ！
• ウマ娘 を含む：ウマ娘 プリティーダービー

正規表記と完全一致している場合は候補を表示しません。

■ 検出内容
まず、全diffで Tags が一致しているかを確認します（Mapset Verifier と同一の機能）。

その後、各diffの Tags に対して、以下の問題を検出します：

• Tag と Tag の間に、2つ以上の半角スペースが含まれている場合
• Tag と Tag の間に、全角スペースが含まれている場合
• 同じ tag が2つ以上含まれている場合
• Title / Artist / Source に含まれる語が Tags にも含まれている場合
• スペルミスの可能性がある tag
• 関連 tag / abbreviation の追加候補

重複タグチェックでは、Tags 内に同じ tag が複数含まれている場合に警告します。
また、Title / TitleUnicode / Artist / ArtistUnicode / Source を半角スペース区切りで tag のように扱い、そこに含まれる語が Tags にも含まれている場合も確認対象として表示します。

スペルチェックでは、主にジャンル名や mapping 関連の tag を対象に、1文字違い・1文字抜け・1文字多い可能性がある tag を検出します。
例：hardcroe → hardcore, vocaliod → vocaloid

関連tag / abbreviation 候補では、特定の tag が含まれている場合に、併記されることが多い tag を追加候補として表示します。
例：jpop → j-pop, pop / tiebreaker → tb

Tagのチェックリスト

この検出は AiMod や Mapset Verifier では行えません。

■ 検出内容
各 difficulty の metadata から、以下の項目を確認します。

• Artist
• ArtistUnicode
• Title
• TitleUnicode
• Source
• Tags

これらの項目に、使用禁止・条件付き許可・利用制限・過去の DMCA 申立てに関連するキーワードが含まれている場合、 warning または error として表示します。

一部のブランド・レーベルでは、代表的な楽曲タイトルも検出対象に含まれています。

■ 検出内容
PreviewTime が snap からずれている場合、warning として表示します
（この検出は AiMod や Mapset Verifier では行えません）。
snap時刻は、osu!stable の「すべてのノーツを再スナップする」と同じ計算方法で判定します。
タイムライングリッドの時刻は別の計算方法で生成されるため、判定結果がタイムライングリッドと一致しない場合があります。

また、以下の内容も検出します：

• diff 間で PreviewTime が一致していない → error
• PreviewTime が設定されていない → error
• .osz 内の mp3 が可変ビットレート（VBR）である → warning

■ 検出内容：mp3の可変ビットレート判定
.osz ファイルを読み込んだ場合、譜面で参照されている mp3 の実ファイルを確認し、 可変ビットレート（VBR）である可能性がある場合は warning として表示します。

判定では、Xing / VBRI などの VBR ヘッダや、 複数の mp3 フレーム間でビットレートが変化しているかを確認します。
単体の .osu ファイルのみを読み込んだ場合は audio file 本体を確認できないため、この判定は行えません。

ogg の可変ビットレートは、このチェックでは warning にしません。
問題になるのは主に mp3 の可変ビットレートであり、 osu-web 上でプレビューポイントがずれてしまう可能性があるため、 warning が出た場合は固定ビットレート（CBR）の mp3 を使用することを検討してください。

[Events]
//Background and Video events
0,0,"BG.jpg",0,40

■ 検出内容1：BGのオフセット差分
mapset 内の各 difficulty について background event を読み取り、同じ背景画像ファイルを使用している difficulty 間で xOffset / yOffset が一致しているかを確認します。

同じ background file を使用しているにもかかわらず、diff 間で offset が異なる場合は warning として表示します。

この検出は AiMod や Mapset Verifier では行えません。

■ 検出内容2：背景画像形式
background event で参照されている背景画像ファイルの拡張子を確認し、 .jpg / .jpeg / .png を識別します。
背景画像に .png が使用されている場合は、容量削減の観点から .jpg 形式が推奨されるため warning として表示します。

.osz ファイルを読み込んだ場合は、画像ファイル本体のシグネチャも確認します。 拡張子が .jpg / .jpeg なのに実体が PNG、または 拡張子が .png なのに実体が JPEG の場合は error として表示します。

複数の background event がある場合は、それぞれの画像ファイル名と形式を一覧で表示します。

■ 検出内容１：Kiai Flash 頻度
Kiai の OFF → ON 切り替え頻度を解析し、 短時間に繰り返される Kiai flash を検出します。

このチェックでは：

• 2 Hz 以上：Caution
• 3 Hz 以上：Warning

として表示します。

例えば：

ON 100ms
OFF 233ms
ON 100ms
OFF 233ms
ON 100ms

のように、短時間で繰り返し Kiai が ON になる場合は、 高頻度 flash として確認対象になります。

■ 検出内容２：高BPM Kiai
Kiai 中の BPM を解析し、 高BPM による高速な kiai flash の可能性を確認します。

osu!taiko の kiai effect は BPM に応じて flash 頻度が増加するため、 高BPM の Kiai は視覚的刺激が強くなる場合があります。

本ツールでは：

• 300 BPM (5 Hz) 以上：Caution
• 360 BPM (6 Hz) 以上：Warning

として表示します。

表示では、以下の情報を出力します：

• BPM：その Kiai 区間の BPM
• Hz：推定 flash frequency（BPM / 60）
• start - end：該当区間

■ 検出内容
Diff順は、difficulty 名から自動推定されます。

自動推定できない difficulty は Unknown として表示されます。
Unknown は必ず手動確認が必要なため、Diff順タブでは赤色で表示されます。

Diff順は、以下の方法で手動調整できます：

• カテゴリのプルダウンから、Kantan / Futsuu / Muzukashii 等を選択する
• ↑ / ↓ ボタンで同カテゴリ内の順番を微調整する

この手動調整後の順番は、OD / HP、ノーツ数、フィニッシャーの各表示にも反映されます。

■ 検出内容
各 difficulty の OverallDifficulty と HPDrainRate を一覧表示します。
また、前の difficulty からの差分として Delta OD と Delta HP も表示します。

OD / HP が osu!taiko Ranking Criteria のルールから外れている場合は Warning として表示します。
（Mapset Verifier と同様の機能）。

また、差分については以下の場合に Warning として表示します：

• Delta OD ≤ 0：上位 difficulty で OD が上がっていない場合
• Delta HP > 0：上位 difficulty で HP が上がっている場合

■ 検出内容
各 difficulty のノーツ数を一覧表示します。Slider と Spinner はノーツ数には含めません。

表示される項目は以下の通りです：

• Notes：Circle の総数
• Δ prev：前の difficulty からのノーツ数差分
• Ratio：前の difficulty に対する倍率（例：x1.80）

difficulty pair ごとの Ratio が適切であるかを 以下の表のに基づき判定します。

■ 警告条件
黄色：警告
赤色：エラー

■ 検出内容
各 difficulty について、1小節ごとの Circle ノーツ数（Slider / Spinner は含めません）を計算し、隣接する difficulty 間で比較します。

同じ小節内で、下位 difficulty のノーツ数が上位 difficulty のノーツ数を上回っている場合、確認対象として表示します。

各 diff の小節ごとのノーツ密度を階段状の線で示すグラフを表示します。

密度逆転の条件を満たす小節は背景の帯で強調され、ノーツ密度の逆転を表示 のチェックボックスに連動します。
また、表示オプションが有効なときは、問題があるdiffのみが自動的に表示されます。問題がないdiffは非表示になります。

■ 検出内容
MapsetVerifier の Taiko Compose / Rest moment を参考に、Kantan / Futsuu / Muzukashii / Oni の continuous mapping が長すぎる区間を検出します。
実装は MapsetVerifier の CheckRestMoments.cs を参考にしています。

gap の計算方法は基本的に MapsetVerifier と同じです。rest moment として扱う gap の判定では、実際の gap に 2 ms の許容幅を足して必要な長さに届くかを確認します。例えば 1/1 の rest が必要な場合、実際の gap が 1/1 ちょうどから最大 2 ms 短い程度であれば、タイミング誤差として rest moment として扱います。

Difficulty	必要な休憩として扱う gap	Warning	Error
Kantan	3/1 以上	36/1 超過	44/1 超過
Futsuu	2/1 以上	36/1 超過	44/1 超過
Muzukashii	3/2 以上、または 1/1 以上の gap が3回連続	36/1 超過	44/1 超過
Oni	1/1 以上	20/1 超過	32/1 超過

■ 検出内容
全 difficulty の Finisher 配置を比較し、Finisher が付いているタイムポイントを一覧表示します（1ms ズレは同一時刻として扱っています）。

表示では、以下の記号を使用します：

• D：Don の Finisher
• K：Kat の Finisher
• -：ノーツがない or 小ノーツ or スライダー or スピナー

Finisher の表は、以下の3種類に分けて表示されます：

• フィニッシャー欠損：一部の difficulty に Finisher が存在しない
• D/K 不一致：全 difficulty で Finisher ではあるが、D / K の種類が一致していない
• 完全一致：全 difficulty で Finisher であり、D / K の種類も一致している

このタブでは警告判定は行わず、比較しやすい形で情報を表示することを目的としています。

■ 検出内容 1：スクロール速度
単純な SV 値だけでは、BPM や SliderMultiplier の影響を考慮できないため、
このチェックでは実際の見た目に近いスクロール速度を比較するために、有効スクロール速度（effective scroll speed, eSV ）を使用します。

effective scroll speed = 175 × SliderMultiplier × SV × BPM / 60

有効スクロール速度は、「ノーツが1秒間に画面上を何ピクセル移動するか」を表す値です。
このチェックの検出対象は、通常ノーツに加えて、スライダーとスピナーの開始位置も含みます。
単位は px/s（pixels per second）です。
また、SM 1.4・SV x1.0 と仮定した場合の 見た目BPM に換算して表示することもできます。

グラフに表示する内容

グラフは2種類あります。どちらのグラフも、Diff順に基づく仮想SRカラーで線や点を色分けします。
この色分けは実際のStar Ratingを計算したものではありません。

1つ目の「スクロール速度グラフ」では、各ノーツ・スライダー・スピナーの開始時点で有効なスクロール速度を階段状の線で表示します。
縦軸は px/s または 見た目BPM に切り替えられます。
カーソルを合わせると、その時点のスクロール速度・BPM・SV・SliderMultiplierを確認できます。

2つ目の「スクロール速度変化量グラフ」では、隣接するノーツ・スライダー・スピナー間で発生した速度変化を点で表示します。
値は 変化後の速度 - 変化前の速度 で、縦軸は Δ px/s または Δ 見た目BPM に切り替えられます。
加速はゼロ線より上、減速は下に表示され、細い線は変化の推移を見るための補助線です。
カーソルを点の近くに合わせると、変化前後の速度・変化量・倍率・隣接オブジェクト間隔を確認できます。

どちらのグラフも、マウスホイールでカーソル位置を中心に拡大・縮小でき、左ドラッグで表示区間を左右に移動できます。右クリックするとそのタイムポイントをosu!editorで開けます。
また、ホバー情報を詳細表示 を有効にすると、簡易表示よりも詳しい情報を確認できます。

グラフには以下の4つの表示オプションがあります。

• 速すぎるスクロール速度の目安値を破線で表示：該当するdiffの目安値を、Diffカラーの破線で表示します。
• 急激な速度変化を表示：既存の警告条件を満たす区間を、速度グラフでは半透明背景、変化量グラフでは強調点で表示します。
• 不自然なスクロール速度Progressionを表示：Diff順に対してスクロール速度の推移が不自然な箇所を強調します。
• スクロール変化の整合性問題を表示：低難易度側の変化が強すぎる箇所や、変化方向が逆になっている箇所を強調します。

これら4つの表示オプションは同時に有効にできません。別の項目を有効にすると、それまでの選択は自動的に解除されます。
また、表示オプションが有効なときは、問題があるdiffのみが自動的に表示されます。問題がないdiffは非表示になります。

表に表示する内容
表では、各diffのスクロール速度の概要と、検出された確認対象をテキストで表示します。
主な表示内容は以下の通りです。

• Min px/s：そのdiff内で最も遅い有効スクロール速度
• Max px/s：そのdiff内で最も速い有効スクロール速度
• Delta：最大速度と最小速度の差
• Ratio：最大速度 / 最小速度
• SV range：そのdiff内で使用されているSVの範囲
• 急激な速度変化：隣接するノーツ・スライダー・スピナー間でスクロール速度が急激に変化している箇所
• スクロール速度Progression：Diff順に対してスクロール速度の推移が不自然な箇所
• スクロール変化の整合性：同じ時間帯の速度変化がdiff間で大きく矛盾している箇所

実際にノーツ・スライダー・スピナーが存在する区間のスクロール速度のみを対象としています。
ノーツ・スライダー・スピナーが存在しない区間のSV変更は、演出用SVなどによる誤検出を防ぐため無視されます。

■ 警告条件 1
下位 difficulty において、急激なスクロール速度変化が発生している箇所を検出します。

• eSV差：eSV after - eSV before
• eSV倍率：eSV after / eSV before
• ノーツ間隔：変化前後のノーツ・スライダー・スピナー間の時間差

上記の3条件をすべて満たした場合のみ Warning として表示します。

この機能のアイデアは、Hivie による MVTaikoChecks の feature request を参考にしています。
参考： Add a drastic SV change warning for lower difficulties

■ 警告条件 2
有効スクロール速度の不自然な Progression を検出します 有効スクロール速度が difficulty 順に一方向へ増加・減少、または同じ値のまま進行している場合は問題なしとします。

例えば、以下のような progression は問題なしとして扱います。

• 520 → 610 → 720 → 800：difficulty が上がるにつれて速度が上がっている
• 800 → 720 → 610 → 520：difficulty が上がるにつれて速度が下がっている
• 640 → 640 → 640 → 640：全 difficulty で同じ速度

一方で、以下のように途中で進行方向が反転する場合は確認対象として表示します。

• 610 → 750 → 680 → 820：増加した後に一度減少している
• 800 → 700 → 760 → 650：減少した後に一度増加している

この機能のアイデアは、Nostril による MVTaikoChecks の feature request を参考にしています。
参考： MVTaikoChecks issue #32

■ 検出内容 2：スクロール変化の整合性
各 difficulty において、隣接するノーツ・スライダー・スピナー間の有効スクロール速度（eSV）の変化量を計算し、difficulty 間で比較します。

この機能は：

• 下位 difficulty の方が上位 difficulty より強い局所スクロール変化を持っていないか
• 同じタイミング付近で、difficulty ごとにスクロール変化の方向が不自然に異なっていないか

を確認するための補助機能です。

表示内容は以下の通りです。

• Δ px/s：隣接するノーツ・スライダー・スピナー間で発生した eSV の変化量（eSV after - eSV before）
• Speed Multiplier：eSV の変化前後の値と倍率。
  例：420 → 735 (x1.75)
• Note Interval：eSV 変化が発生した2つの隣接するノーツ・スライダー・スピナー間の時間差

例えば、下位 difficulty では 420 → 735 のような大きな加速がある一方で、上位 difficulty では同じタイミング付近の変化が小さい場合、確認対象として表示されます。

また、同じタイミング付近で、一方の difficulty は加速、もう一方の difficulty は減速している場合も確認対象になります。

■ 警告条件 3
下位 difficulty の方が、上位 difficulty より強い局所スクロール変化を持っているパターンを検出します。

このチェックでは、隣接するノーツ・スライダー・スピナー間で発生した有効スクロール速度変化（Δ px/s）を difficulty 間で比較します。
下位 difficulty の eSV 変化量が、上位 difficulty より明らかに大きい場合に確認対象として表示します。

■ 警告条件 4
同じタイミング付近において、difficulty ごとにスクロール速度変化の方向が一致していないパターンを検出します。

このチェックでは、隣接するノーツ・スライダー・スピナー間で発生した eSV 変化（Δ px/s）を difficulty 間で比較します。
同じタイミング付近で、一方の difficulty は加速、もう一方の difficulty は減速している場合に確認対象として表示します。

■ 検出内容 3：速すぎるスクロール速度
低難易度でスクロール速度が速すぎる場合、初心者がノーツを十分に認識できない可能性があります。
このチェックでは、各 difficulty のノーツ・スライダー・スピナーの開始位置における有効スクロール速度を計算し、 その上位 90% px/s が difficulty ごとの目安を超えていないかを確認します。

このチェックでは、単純な最大値ではなく 90% px/s を使用しています。
これは、譜面中に一瞬だけ存在する高速ギミックを過剰に警告せず、 ある程度まとまった範囲で高速スクロールが続くケースを検出するためです。

判定基準は、SV = 1.0、SliderMultiplier = 1.4 の状態で、 各 difficulty において以下の BPM 相当の速度を超えるかどうかを目安にしています。

Difficulty	基準	px/s 目安	判定
Kantan / below Kantan	BPM 200, SV 1.0, SM 1.4	約 820 px/s	Warning
Futsuu	BPM 250, SV 1.0, SM 1.4	約 1020 px/s	Warning
Muzukashii	BPM 300, SV 1.0, SM 1.4	約 1225 px/s	Warning
Oni	BPM 300, SV 1.0, SM 1.4	約 1225 px/s	Warning

例えば、Kantan の 90% px/s が 820 を超えている場合、 「Kantan としてはスクロール速度が速すぎる可能性がある」として Warning を表示します。

■ 波形表示の仕様
波形表示は osu!lazer のエディタ内波形表示を参考にしています。主に以下の実装を参照しています。

• WaveformComparisonDisplay.cs
• WorkingBeatmapCache.cs
• Waveform.cs
• WaveformGraph.cs

modding-helper では、音声を 1 ms 単位の点列に変換し、左右チャンネルそれぞれの最大振幅を保持します。
描画時には表示範囲と canvas 幅に合わせて点列を再サンプリングし、ガウシアン重み付きの平均で滑らかに縮約します。
また、osu!lazer の Waveform / WaveformGraph と同じ考え方で、低域・中域・高域の強さを低域通過フィルタから近似しています。
現在の表示では、高域や中域の塗り分けは使わず、ベースの水色波形と内部の濃い水色を中心に表示しています。

■ 小節線とクリック推定
小節線は [TimingPoints] の赤線時刻、beatLength、拍子から生成します。
赤線から次の赤線までの範囲では、その赤線の BPM と拍子を使って小節長を計算し、音声波形上に生成小節線として描画します。

波形上でマウスホイールを回すとカーソル位置を中心に拡大・縮小でき、左ドラッグすると表示区間を左右に移動できます。右クリックした位置を「選択したピーク」として扱い、最も近い生成小節線との差を表示します。
推奨オフセット位置は クリックしたピーク - 28.7 ms として計算し、現在の小節線との差分も表示します。

この -28.7 ms という考え方は、 statementreply 氏による Timing Analyzer v0.32.4 の仕様から着想を得ています。

■ 表示内容
各 HitObject を小節内の snap 位置に配置し、通常ノーツ、フィニッシャー、スライダー、スピナーを記号として表示します。
ノーツは d / k / D / K、スライダーは slider、スピナーは spinner として扱います。

小節は基準 diff の赤線から生成します。赤線の beatLength と拍子を使って小節範囲を作り、各 diff のオブジェクトを同じ小節グリッド上に並べます。
スライダーとスピナーは開始位置から終了位置までを範囲として表示します。スライダー終端は BPM、SV、SliderMultiplier、リピート数、ピクセル長から推定します。

■ snap 幅の決定
各小節ごとに、1/1、1/2、1/3、1/4、1/6、1/8、1/12、1/16、1/24、1/48 の候補から、配置を表現できる最小の snap を選びます。
表示上は最低でも 1/4 相当の解像度を確保し、拍子に応じて小節内のセル数を決めます。
snap 判定には 2 ms の許容幅を設けています。候補 snap のどれにも収まらないオブジェクトがある場合、その小節は未対応として扱います。

■ 検出内容
以下の5種類の情報を比較します。

• ノーツ情報：ノーツの追加、削除、種類変更、スライダー / スピナーの追加・削除、スライダー / スピナーのテール移動を表示します。
• タイムライン： 変更がある小節のみをタイムライン形式で表示します。
  小節内の最小 snap に応じて自動的にグリッド幅を変更します。
  
• Timing情報：BPM / SV の追加・削除・変更、Volume の相違区間、Kiai の相違区間を表示します。
• メタデータ情報： メタデータの変更点を表示します。
• OD / HP：OD /HP の変更を表形式で表示します。

ノーツについては、 d / k / D / K / Slider / S / Spinner / S の差分を表示します。

なお、1 msズレのノーツ移動は表示しない仕様です。
ただし、1 msズレていても d → k のように内容が変更されている場合は、変更として表示されます。