kirikiri · tutorial · engine
Kirikiri / KAG ビジュアルノベルを翻訳する方法
RuneTranslate で Kirikiri / KAG のビジュアルノベルを英語に翻訳します — パックされた .xp3 アーカイブを自動で読み、KAG .ks シナリオと PSB シーンを翻訳し、ゲームが自動読み込みする patch.xp3 をエクスポートします。
Kirikiri(吉里吉里)とその KAG シナリオ層は、日本語ビジュアルノベルの大きな一角を動かしています。難点:Kirikiri はスクリプト、アート、音声を.xp3 アーカイブにパックし、多くのスタジオがその上に独自のアーカイブ形式を使っています。それが Kirikiri が翻訳しにくいという評判を持つ理由です。このガイドは、それを最初から最後まで RuneTranslate で行う手順を説明します:.xp3 を読み、KAG .ks シナリオを翻訳し、ゲームが自動的に読み込むパッチをエクスポートします。
必要なもの
- Windows / Linux 版 RuneTranslate — 無料。すべてのエンジンと、RuneLingua を除くすべてのプロバイダーが解放されています。
- Kirikiri のゲームフォルダ — ゲームの
.exeと 1 つ以上の.xp3アーカイブ(一般的にはdata.xp3、scenario.xp3など)があるディレクトリ。.exe.emb/.xp3.sigファイルを持つ署名付き KirikiriZ ビルドも認識されます。 - ターゲット言語 — 英語、スペイン語、フランス語、ドイツ語、ポルトガル語、ロシア語、中国語、イタリア語、トルコ語、ベトナム語、その他 20 以上。
- 1 つの翻訳プロバイダー。ビジュアルノベルはセリフが多いので、たいてい LLM(OpenAI / Anthropic)または DeepL が最もよく読めます。無料の Google Translate はそのまま使えます。
ステップ 1: ゲームを開いて XP3 を展開する
RuneTranslate を起動し、新規プロジェクト をクリックして、Kirikiri のゲームディレクトリに向けます。エンジン検出は自動的に実行されます。組み込みの XP3 リーダーがアーカイブインデックス — 大きなアーカイブが使う 17 バイトの圧縮インデックスヘッダーを含む — を開き、シナリオファイルを取り出します。元のアーカイブは決して変更されません。
パックされたアーカイブは自動で開きます。RuneTranslate が認識するタイトルでは、最近のリリースの一部が使う新しい形式も含まれます。ごく一部の珍しい形式は、まだ認識されません。
ステップ 2: Kirikiri のセリフがどう抽出されるか
Kirikiri はセリフを KAG .ks シナリオスクリプトに格納します。RuneTranslate はそれらをパースし、翻訳可能なテキストをエディターに一覧します:
- セリフとナレーション — 生のシナリオ行。
- スマート属性抽出 —
[ruby/]、[ch text="..."]、[name text="..."]、[button text="..."]のようなタグ内の読めるテキストが取り出されて翻訳され、タグ構造そのものは保持されます。
KAG のインライン制御タグは、プロバイダーに届く前に数字の [[K#]] プレースホルダーの背後にマスクされるので、機械がエンジンの整形を壊すことはできません。一部の KirikiriZ ゲームは、シナリオをコンパイル済み PSB .scn バイナリ(PSB\0 フォーマット)として出荷します — RuneTranslate は標準の PSB シナリオ(フォーマットバージョン 1 から 4)もパースして再パックするので、それらのゲームもテキストスクリプトと同じように翻訳できます。
ステップ 3: 翻訳とレビュー
プロバイダーを選んで実行します。キャラクターの声や様式化された話し方には、OpenAI や Anthropic のような LLM が最もよく読めます。DeepL はナレーションを高速かつクリーンに、無料の Google Translate はメニューをカバーします。すべてのルートで名前が同一に表示されるよう、キャストと繰り返し出る用語を先に用語集化しましょう — 用語集 101 を参照。無料ティアでは翻訳が控えめにスロットルされます — AI プロバイダーでおおよそ 2 倍遅く、無料プロバイダーではそれ以下 — 出力品質は同一です。有料ティアはフルスピードで実行し、翻訳メモリを追加します。
すべての行がソースの隣のエディターに入ります。インラインで編集し(ブラーまたは Ctrl+Enter で保存)、検索と置換を使い、任意の AI リファイナーで文脈を踏まえた 2 回目の校正を実行します — 長い VN ルートで価値があります。
ステップ 4: パッチをエクスポート
エクスポート をクリックします。RuneTranslate は翻訳済みシナリオを ルーズファイル とスタートアップフック、さらに 役立つ場合はフラットな patch.xp3 として書き出します。単一の方法では普遍的でないので、2 つのオーバーライドパスを使います:
- ルーズファイル + スタートアップフック — フックの
addAutoPath呼び出しがルーズファイルをゲームのアーカイブより上に引き上げます。ビルドごとに異なる初期化エントリポイントを実行するので、RuneTranslate はゲームが使う 3 つの名前すべて —AfterInit2.tjs、xAfterInit2.tjs、xAfterInit.tjs— の下にフックを書き込むので、ゲームが呼ぶどれかが拾います。 - patch.xp3 — Kirikiri は
patch.xp3/patch2.xp3をゲーム自身のアーカイブより高い優先度で自動マウントします(「後のパスが勝つ」)ので、ゲームがスタートアップフックを無効にしていてもオーバーライドします。パッチはゲームが受け付ける形で書き込まれます。ビルドによっては余分なpatch.xp3を拒否するので、それらではルーズファイルのフックが翻訳を運ぶパスになります。
出力は、元のゲームの隣に置かれたあなたの翻訳です。.exe を起動すると、ターゲット言語でプレイできます。
既知の制限
- アプリがまだ認識しない珍しいパック形式のアーカイブは非対応です。ほとんどの市販ゲームは開けますが、すべての例外ではありません。
- 非標準 / MDF 圧縮の PSB
.scnシナリオは飛ばされます。標準の PSB(バージョン 1〜4)のみ対応します。 - コンパイル済みまたはトークン化された KAG
.ksバイトコード(テキストにデコードできないバイナリ /jkマジック)は飛ばされます — 読める KAG スクリプトと標準の PSB シナリオのみがパースされます。 - 画像テキスト(ロゴ、手描き UI、CG のキャプション)はスクリプトの一部ではありません。Image Studio で翻訳してください。XP3 アーカイブの中の画像(TLG を含む)を直接読み取り、翻訳した画像をスクリプトと同じ方法で届けます。
なぜこれが従来より簡単なのか
手動のルートは、アーカイブ形式を特定し、別の展開ツールで XP3 を抽出し、KAG タグ内の読めるテキストを手作業で見つけ、マークアップを壊さずに翻訳し、それから再パックするかオーバーライドパスを正しく配線する、というものでした。RuneTranslate はチェーン全体 — 展開、抽出、タグのマスク、翻訳、ルーズフックと patch.xp3 の両方の構築 — を数クリックに畳み込み、言い回しを管理できるようエディターを開いたままにします。
Kirikiri エンジンページで全機能リストを見るか、別のビジュアルノベルエンジンについて Ren’Py ガイドを読むか、RuneTranslate をダウンロードして実在のゲームで試してみてください。
RuneTranslate を試してみませんか?
無料プランですべてのエンジンとRuneLingua を除くすべての翻訳プロバイダーが使えます。Supporter(月額 $3.99)ならフルスピードで翻訳できます。
Windows / Mac / Linux 版をダウンロード
