Wiki · TJA とシミュレーター

OpenTaiko で自作譜面を追加する方法：TJA フォルダ設定ガイド

OpenTaiko と TJAPlayer3 に自作 TJA チャートを追加する方法：フォルダ構成、.tja と音声ファイルを同じ場所に置く方法、box.def と genre.ini の用途、そして曲が表示されない場合や音声がずれる場合の対処法。

このガイドでは、.tja チャートを OpenTaiko または TJAPlayer3 に追加する方法を説明します。フォルダの配置、カテゴリの設定、そして曲が表示されない場合や音声がずれる場合の確認事項について説明します。

1. フォルダ構成

各曲を専用フォルダに入れ、そのフォルダをシミュレーターの曲ディレクトリに配置します。OpenTaiko と TJAPlayer3 の曲ディレクトリは通常、ゲームフォルダ内の Songs というフォルダです。実際の場所や変更可否はバージョンと設定によって異なります。お使いのバージョンのドキュメントを参照してください。

Songs/
  MyCharts/
    box.def
    MySong/
      MySong.tja
      MySong.ogg

ここで MyCharts はオプションのカテゴリフォルダ（第 3 節参照）、MySong はこの曲専用のフォルダです。同じ曲の異なる難易度は COURSE で区切られた 1 つの .tja ファイルに書かれており、複数のファイルは必要ありません。

COURSE およびその他のヘッダーフィールドの意味については、TJA フォーマット解説を参照してください。

TaikoForge からダウンロードした zip を解凍すると、.tja と音声ファイルが同じ階層に展開されます。解凍先に直接散らばっている場合は、フォルダを作成してそこに移動し、そのフォルダを曲ディレクトリに配置してください。

2. .tja と音声ファイルを同じフォルダに置く

.tja の WAVE フィールドは音声ファイル名を指定します。シミュレーターは .tja と同じフォルダでそのファイルを検索します。両者は同じフォルダに置く必要があり、拡張子も含めてファイル名が完全に一致していなければなりません。

MySong/
  MySong.tja    ← WAVE:MySong.ogg
  MySong.ogg

WAVE フィールドは .tja の先頭にあり、テキストエディタで確認・編集できます。音声ファイルを別フォーマットに変更する際は、WAVE のファイル名も忘れず更新してください。再生できるフォーマットはシミュレーターのバージョンによって異なり、OGG が最も一般的な選択肢です。

3. カテゴリフォルダ：box.def と genre.ini

Songs ディレクトリの下にサブフォルダを作成して曲を整理できます。選曲画面ではそれらがカテゴリとして扱われます。

box.def はカテゴリフォルダに置く plain-text 設定ファイルです。# で始まるコマンドでカテゴリを設定します。例えばカテゴリ名：

#TITLE:My Charts

使用できるコマンドはバージョンによって異なります。genre.ini もカテゴリ関連の設定ファイルですが、用途や書き方はシミュレーターとバージョンによって異なり、すべてのバージョンが読み込むわけではありません。

どちらのファイルも必須ではありません。なくても曲は読み込まれますが、カスタムのカテゴリ設定は適用されません。詳細は、お使いのシミュレーターに付属のドキュメントを参照してください。

4. 曲リストを再読み込みする

フォルダーを配置したあと、新しい曲を認識させるにはシミュレーターに曲を再スキャンさせる必要があります。ゲーム内の曲選択画面から曲リストを再読み込みするか（メニュー名はバージョンによって異なります）、ゲームを再起動してください。

5. 曲が選曲画面に表示されない

配置場所が違う：フォルダーがシミュレーターの実際の曲フォルダーの中に入っているか確認してください。ゲームフォルダー内の別の場所では読み込まれません。
ファイルが圧縮ファイルの中にある：zip を先に解凍してください。シミュレーターは zip 内の .tja を読み込みません。
拡張子が違う：Windows はデフォルトで拡張子を非表示にするため、MySong.tja.txt という名前のファイルが MySong.tja のように見えます。エクスプローラーの「表示」設定で拡張子を表示し、ファイルが本当に .tja で終わっているか確認してください。
曲リストを再読み込みしていない：前の節を参照してください。
曲名が文字化けする、または読み込まれない：ファイルのエンコードがシミュレーターの想定と異なる可能性があります。TJA フォーマット解説の文字コードの節を参照してください。
譜面の内容に問題がある：#START・#END や BPM フィールドがないと、シミュレーターがファイル全体を読み飛ばすことがあります。まず TJA 譜面をブラウザでプレイで読み込めるか確認してください。

6. 音声がずれる、または音が出ない

音が全く鳴らない：WAVE フィールドのファイル名が実際の音源ファイルと一致していないか、そのバージョンでそのフォーマットがサポートされていません。ファイル名は拡張子も含めて完全に一致させてください。Linux では大文字・小文字の違いも関係します。
音符と音楽が最初から最後まで同じ量だけずれている：OFFSET の問題です。OFFSET と BPM を調整するを参照してください。
最初は合っているが、後ろになるほどずれていく：BPM の問題です。OFFSET と BPM を調整するを参照してください。
別バージョンの音源に差し替えた：同じ曲でも音源の入手元によって前奏の長さや頭・尾の編集が異なることが多くあります。音源を差し替えたあとは、譜面を合わせるために OFFSET を調整し直す必要が通常あります。