対応エンジン · Electron VN
Electron VN 翻訳ツール — カスタム Electron ベースのビジュアルノベルシェルを翻訳
一部の日本のビジュアルノベルスタジオは、ゲームを TyranoBuilder ではないカスタム Electron アプリとして出荷します — JavaScript レンダラーと同梱の Chromium ランタイムを resources/app.asar にパッケージしたものです。RuneTranslate の Electron VN アダプターはこれらの汎用受け皿です:独自のアーカイブリーダーで app.asar を読み取り・再パックし、既知のコンテンツファイル(files/text.js、html/chat.html)を翻訳し、アーカイブ内の .js、.html、.json、.ks ファイルに対して汎用のソーステキストスキャナー(既定は日本語、任意のソース言語に対応)を実行します。エクスポートは、resources/ に変更済みの app.asar を収めた翻訳済みのゲームのコピーで、Electron ランタイムへのパッチは不要です。
カスタム Electron VN は独自のレイアウトで出荷されます — RuneTranslate の汎用ソーステキストスキャナー(日本語向けに調整されていますが他のソース言語も拾います)は文字列を見つけられますが、どれが話者名でどれが自由形式のセリフかは判別できません。用語集でキャストを固定して、ヒューリスティックに抽出された部分が統一されるようにしましょう:チャットパネルのすべての名前、名前のあるすべてのシステムメッセージ、あらゆる世界観用語。用語集を設定すれば、別のプロバイダーで翻訳を再実行しても固有名詞は前回と一致します。
Electron VN を翻訳する方法
- ステップ 1
Electron VN のゲームフォルダーを開く
Electron の .exe を含むゲームディレクトリを RuneTranslate に指定します。アダプターは resources/app.asar を探し、それが TyranoBuilder レイアウト(専用アダプターがあります)でないことを確認します。RuneTranslate がアーカイブを自分で読み取るので、手動での展開は不要です。
- ステップ 2
原文テキストスキャナーを実行
汎用スキャナーは asar 内のすべての .js、.html、.json、.ks ファイルを走査し、ソース言語の文字列リテラル(既定は日本語;対応する任意のソース言語)を抜き出します。既知形式のファイル(files/text.js、html/chat.html)は構造化抽出され、未知のファイルはヒューリスティックスキャナーで処理されます。バイナリファイルはスキップされます。
- ステップ 3
お好みのプロバイダーで翻訳
プロバイダーを選択 — Anthropic Claude と OpenAI GPT-4o は、これらのシェルが使いがちな会話調の JS 埋め込み文字列に最も強いです。DeepL は手堅い代替です。無料の Google Translate はプロバイダールーティングで短い UI 文字列に使えます。
- ステップ 4
app.asar を再パックしてエクスポート
エクスポート時、RuneTranslate は変更済みの app.asar を持つ翻訳済みのゲームのコピーを書き出し、翻訳済み文字列を焼き込んだ app.asar をその resources/ フォルダーに置きます(ゲームの上にエクスポートする場合は、アーカイブをその場で書き換えます)。翻訳済みビルドは元の Electron ランタイムで動作します。
対応内容
- カスタム Electron ベースのビジュアルノベルシェル(TyranoBuilder 以外)
- resources/app.asar の読み取り + 再パック
- files/text.js と html/chat.html の構造化抽出
- .js / .html / .json / .ks ファイルに対する汎用原文テキストスキャナー
- Electron で包まれた Cocos Creator のゲーム。ゲーム自身のアセットマニフェストでリソース名を保護
制限事項
- ヒューリスティックです — セリフがプレーンな JS 文字列リテラルになっているシェルでもっとも良い結果が出ます
- 強く難読化された JS ソースからは、抽出できる文字列が得られない場合があります
- ネイティブ結合のセリフ(実行時に C++ DLL から読み込まれる)はこの方法では翻訳できません

