対応エンジン · Kirikiri / KAG
Kirikiri 翻訳ツール — KAG ビジュアルノベルと XP3 アーカイブを翻訳
Kirikiri(およびそのスクリプト層 KAG)は支配的な日本語ビジュアルノベルエンジンです — 過去 15 年の商業 VN リリースの多くがこれに載っています。RuneTranslate は、パックされたアーカイブを自動で開く完全な XP3 リーダーとライター(認識できるタイトルでは、最近のリリースの一部が使う新しい形式も含む)、スクランブルされたシナリオファイルとコンパイル済み PSB(.scn)シナリオへの対応、そしてルビ注記、キャラクター名、ボタンラベル、glink テキスト、編集フィールドのプレースホルダーのためのスマート抽出を搭載しています。翻訳済みビルドはルーズファイルを出力し、加えて AfterInit2.tjs パス優先フックがエンジンに、元の XP3 の内容より優先してそれらを読み込むよう伝え、フックを使わないゲームのためにエンジンが自身のアーカイブの後にマウントするパッチアーカイブも出力します。なので元のアーカイブを再パックする必要は決してありません。Kirikiri の VN が通常出荷する数十のシナリオにわたるキャラクター名の一貫性? それが Supporter ティアの用語集機能のためのものです — ヒロインの名前を一度追加すれば、すべてのシナリオファイルがそれを同じように翻訳します。
Kirikiri の VN は通常、セリフを数十の別々のシナリオファイルに広げ、それぞれが独自のバッチで翻訳されます。用語集がないと、それは同じキャラクター名が章をまたいでぶれるレシピです。すべての名前付き話者(特に機械翻訳が定期的に迷う漢字を名前に使うもの)、地名、特徴的な攻撃 / 呪文の用語を追加しましょう。おまけ:KAG のインラインルビ注記はタグでマスクされるので、[ruby] / [name] インラインタグのある行でも用語集の置換が正しく着地します。
Kirikiri / KAG を翻訳する方法
- ステップ 1
Kirikiri のゲームフォルダを開く
RuneTranslate をエンジンの .exe(krkr.eXe、krkrZ.exe など)を含むディレクトリに向けます。エンジン検出は XP3 アーカイブ + .ks シナリオフォーマットをスキャンします。パックされた XP3 アーカイブは自動で開き、設定は不要です。
- ステップ 2
セリフ、ルビ、名前、ボタンラベルを抽出
RuneTranslate は KAG 対応のトークナイザーで .ks シナリオをパースします。翻訳可能な文字列はセリフの行、[ruby]、[ch]、[name]、[title]、[button]、[checkbox]、[edit text="..."] タグから抽出されます。インラインの KAG タグ([r]、[p]、[改ページ]、[font])は不透明なプレースホルダーとしてマスクされるので、LLM がそれらを保持します。
- ステップ 3
好みのプロバイダーで翻訳
プロバイダーを選びます — DeepL は価格と JA→EN 品質から、長い Kirikiri スクリプトの働き者です。OpenAI と Anthropic は強いキャラクターの声を持つセリフに最も強いです。無料の Google Translate は、Supporter / Pro ティアのプロバイダールーティング経由でメニュー文字列を安く扱います。
- ステップ 4
ルーズファイル + AfterInit2.tjs フックをエクスポート
エクスポート時に、RuneTranslate は翻訳済みスクリプトをルーズファイルとして、加えて AfterInit2.tjs フックをゲームルートに書き込み、エンジンが自身のアーカイブの後にマウントする patch.xp3 も書き込みます。フックはルーズファイルを検索順の先頭に置き、パッチはフックを使わないゲームをカバーするので、翻訳済みスクリプトがパックされた XP3 の内容に勝ちます。元のアーカイブは手を加えられないままです。
対応内容
- XP3 アーカイブの読み取りと書き込み、パックされたアーカイブを自動で開く
- スクランブルされたシナリオファイルの読み取り
- ルビ注記、キャラクター名、ボタンラベル
- [name]、[title]、[button]、[checkbox]、[edit text=...] タグ
- インラインの KAG タグ([r]、[p]、[改ページ]、[font color=...])を保持
- AfterInit2.tjs パス優先フックと patch.xp3(再パック不要)
制限事項
- アプリがまだ認識できないまれなパック形式のアーカイブは読み取れません
- コンパイル済みの KAG バイトコード(テキストとして読めない `jk` マジック付き .ks)は非対応です
- オリジナルエンジンの Kirikiri 1.x(非 Z)は未テストですが、通常は動作します

