Gimmick Helper 説明書

このツールについて

■ 概要
Gimmick Helper は、osu! の .osu ファイルをブラウザ上で読み込み、特定の gimmick 作成を補助するための変換ツールです。

Modding Helper が「譜面の問題点を検出するチェックツール」であるのに対して、Gimmick Helper は 譜面ファイルを書き換え、変換後の .osu をダウンロードするツールです。
■ 現在対応している入力
現在は .osu 単体ファイルの読み込みに対応しています。
.osz の読み込み・再生成には対応していません。

注意事項 / プライバシー

■ ファイル処理について
読み込まれた .osu ファイルは、ブラウザ内でのみ処理されます。
ファイル内容がサーバーへ送信・保存されることはありません。
■ 元ファイルについて
このツールは、ローカルの元ファイルを直接上書きしません。
変換後の内容は、新しい .osu ファイルとしてダウンロードされます。
■ 注意事項
Gimmick Helper は gimmick 作成を補助するためのツールです。
変換後の譜面が意図通りに動作することを保証するものではありません。

変換後の .osu は、必ず osu!editor 上で確認してください。

基本的な使い方

■ 手順
  1. .osu ファイルを選択、またはドラッグ＆ドロップします。
  2. 使用したい変換タブを選びます。
  3. 必要な設定値を入力します。
  4. プレビュー ボタンを押して、変換内容を確認します。
  5. 問題がなければ ダウンロード ボタンを押して保存します。
■ プレビューが必要な理由
ダウンロードボタンは、直前にプレビューした変換結果を保存します。
そのため、設定を変更した場合は、再度プレビューを行ってからダウンロードしてください。

小節線の分離

■ 背景
osu!taiko の gimmick 作成では、小節線の表示と HitObject の表示を別々に制御したい場合があります。±1 ms ズレは rankable なので、この演出は rankable です。

通常、小節線上に HitObject がある場合、その位置に SV line を置くと、小節線と HitObject の両方に同じ SV が適用されます。
本機能は、HitObject を +1 ms ずらすことで、小節線位置と HitObject 位置に別々の SV line を置けるようにします。
■ 変換内容
入力された小節線時刻に対して、その時刻の -1 ms、0 ms、+1 ms にある HitObject (Circle, Slider, Spinner)を探索します。

対象 HitObject が見つかった場合、HitObject の開始時刻を 小節線 + 1 ms に移動します。
その上で、小節線位置と HitObject 位置にそれぞれ新しい SV line を追加します。

Slider や Spinner の終点時刻に変更は加えません。始点のみを +1 ms へ移動します。

Slider は slider長を元に時間を再計算するため +1 ms 平行移動します。なので終点も unsnapped になります。
Spinner は終点時間を .osu で指定する方式です。なので終点は変更前と同じ snapped 状態のままになります。
■ 移動ルール
元の HitObject 位置 変換後の HitObject 位置 追加される SV line
小節線 - 1 ms 小節線 + 1 ms 小節線位置 / 小節線 + 1 ms
小節線 小節線 + 1 ms 小節線位置 / 小節線 + 1 ms
小節線 + 1 ms 変更なし 小節線位置 / 小節線 + 1 ms
■ SV / volume の設定
ノーツ側・小節線側それぞれに、SV と volume を入力できます。

入力欄が空欄の場合は、その時刻で有効な既存 TimingPoint の値を継承します。
例えば、対象時刻で有効な SV が 0.75、volume が 80 の場合、空欄の項目はその値を引き継ぎます。
■ 注意点
追加予定の時刻に既存の緑線がある場合、その緑線は上書きされます。
上書きが発生した場合は、プレビュー結果の警告欄に表示されます。

kiai 状態は現在の TimingPoint から継承します。
つまり、対象時刻で kiai が ON の場合は追加される SV line も kiai ON、OFF の場合は kiai OFF になります。

本機能は gimmick 作成を補助するための機能です。
変換後は必ず osu!editor で以下を確認してください。
  • HitObject が意図した位置に移動しているか
  • 追加された SV line が意図した値になっているか
  • volume / kiai が意図通りに継承されているか
  • Slider / Spinner の見え方に問題がないか

プレビュー / ダウンロード

■ 概要
Gimmick Helper では、変換後すぐにダウンロードするのではなく、先にプレビュー結果を表示します。
プレビューでは、変換後のファイル名、summary、警告、移動した HitObject の一覧などを確認できます。
■ ダウンロードの仕組み
ダウンロード ボタンは、最後にプレビューした変換結果を保存します。
設定を変更した場合は、再度 プレビュー を押してからダウンロードしてください。

難易度名 suffix

■ 概要
suffix を入力すると、出力ファイル名と [Metadata] セクション内の Version: が書き換えられます。
■ 例
入力ファイル名： 
t+pazolite with siromaru - Chambarising (Vanity8) [chamba].osu
suffix に v2 を入力した場合： 
t+pazolite with siromaru - Chambarising (Vanity8) [chamba v2].osu
.osu 内の難易度名も以下のように変更されます。 
Version:chamba -> Version:chamba v2
■ 注意点
suffix 欄が空欄の場合は、ファイル名と Version: は変更されません。
既に同じ suffix が付いている場合でも、現在は重複チェックを行いません。