osu!taiko Mapping Helper 使用説明書

起動方法

1. osu! を起動し、エディタで編集したい taiko 譜面を開きます。
2. osu!taiko Mapping Helper.exe を起動します。
3. ツール上部の譜面名や背景表示が更新されることを確認します。
4. メニューから SV Editor、Utility、BG Setter を選びます。
5. 条件を入力して 実行 を押します。
6. 成功メッセージが出たら osu! 側で Ctrl + L を押します。

1. Timing

処理する範囲の始点と終点を指定します。
入力は mm:ss:fff 形式、またはミリ秒の整数に対応しています。たとえば 01:23:456 と 83456 はどちらも受け付けます。

Set Start Timing と Set End Timing は、osu! の現在の再生位置をそれぞれ始点・終点に入れるボタンです。

⇔ ボタンは始点と終点を入れ替えます。始点が終点より後ろにある状態では実行時にエラーになります。

2. SV

SV チェックを有効にすると、追加または更新する緑線の SV を指定できます。
SV は 0 より大きい数値を入力します。小数も使用できます。
SV チェックを外した場合は、処理地点の直前にある緑線の SV を参照して、SV 値を明示的には変更しません。

等差モード は始点から終点まで一定量ずつ変化します。
等比モード は比率で変化します。

p は範囲内の進行率です。始点では 0、終点では 1 になります。

3. Volume

Volume チェックを有効にすると、緑線の音量を指定できます。
Volume は 5 から 100 の整数で入力します。小数は受け付けません。
Volume チェックを外した場合は、処理地点の直前にある赤線 or 緑線 の Volume を参照します。音量を変えずに SV だけを編集したい場合は、Volume を無効にして下さい。

赤線に適用 を有効にすると、指定範囲内にある赤線の Volume も指定した値に変更します。
赤線と緑線が同時刻にある場合に、それぞれの Volume が違う値になってしまうことを避けたいときに使います。

このチェックボックスをオフにすると、範囲内の赤線 Volume は変更されません。
たとえば最初の赤線だけ、赤線と緑線をあえて別の Volume にすることで、その線より前は赤線の Volume、その線より後は緑線の Volume として扱わせたい場合に使えます。

6. 相対速度変化

設定のアドバンスモードを有効にすると表示されます。
通常は入力した SV をそのまま使いますが、相対速度変化では対象のオブジェクトに適用されている SV を基準にして、新しい SV を計算します。

乗算 は (現在の SV - 基準 SV) * 入力 SV + 基準 SV の形で変化します。
加算 は現在の SV に入力 SV を足します。

終点の有効化 を併用すると、相対変化の始点値と終点値を別々に指定できます。

9. オフセット

チェックすると、Objects のみで緑線を置くときに、対象ノーツの少し前へ緑線をずらします。

設定画面のオフセットタイプが
1/16 (1/12) オフセット の場合は、BPM から 1/16 分の時間を計算して前に置きます。
ミリ秒 (ms) オフセット の場合は、指定したミリ秒分前に置きます。

1/12 を含める を有効にすると、1/12 snap の HitObject が含まれる場合に、前の HitObject の方へ SV 線が近づきすぎないように 1/12 分のオフセットを使います。それ以外の配置では 1/16 が使われます。

Volume 変化を伴う SV 線を設置する場合は、プレイヤーが早入りして叩くことにより Volume 変化が適用されなくなる場合を防ぐためにこの機能を使うことを推奨します。

10. 処理対象の選び方

Objects のみの詳細

11. 実行ボタン

実行 を押すと、現在の入力値と処理対象をもとに .osu ファイルを上書きします。
実行前にバックアップが作成され、成功するとメッセージが表示されます。最後に osu! 側で Ctrl + L を押して再読み込みしてください。

再スナップの詳しい挙動

赤線ごとに BPM、拍子、barLength からスナップ間隔を計算します。
各スナップ位置の前後半分の範囲に入っているノーツを、そのスナップ位置へ移動します。範囲内に赤線がある場合、次の赤線以降は新しい BPM と拍子で再計算します。

選べる間隔は 1/24、1/36、1/48、1/60 です。譜面の意図に合う最小単位を選んでください。実行前に確認ダイアログが表示されます。

何を変更するか

Events セクションの背景行にある Y オフセットを書き換えます。画像ファイルそのものを編集する機能ではありません。背景の表示位置だけを変えたいときに使います。

操作

1. osu! エディタで対象譜面を開きます。
2. メニューから BG Setter を開きます。
3. 背景を上下にドラッグして Y 座標を調整します。
4. 実行、または Ctrl + S で保存します。
5. osu! 側で Ctrl + L を押して確認します。

使い方

osu! エディタで曲を再生またはシークすると、Timing Property の値も更新されます。
表示されているそれぞれの値をダブルクリックするとクリップボードにコピーされます。

実行後の確認

成功メッセージは「ファイルへの書き出しが終わった」ことを示します。osu! エディタの表示は自動では更新されません。
必ず Ctrl + L で再読み込みし、Timing、HitObjects、背景座標を確認してください。