Important
これは非公式の macOS 対応版です。 日本語化MOD 本体の作者様から公開の許諾をいただいていますが、作者様は macOS 環境をお持ちでなく、動作確認も行っていません。 macOS 版に関する不具合報告・使い方の質問は、作者様ではなく本リポジトリの Issues へお願いします。
Steam 版 Guildrun Demo（macOS 版）を日本語で遊べるようにするツールです。Windows 向けに配布されている日本語化MODを、Mac でも適用できるようにしたものです。
これ 1 つで日本語化できます。 Windows 版の日本語化MOD（Guildrun日本語化.exe など）を別途用意する必要はありません。翻訳データとフォントは実行時に自動で取得します。
- Steam 版 Guildrun Demo（macOS 版） がインストールされていること
- インターネット接続（翻訳データの取得に使います。初回は約 42MB）
- macOS（Apple Silicon で確認済み。Intel Mac は未確認）
Python などの準備は不要です。実行に必要な uv というツールが入っていない場合は、実行時に「インストールしますか?」と聞かれるので、y を入力して Enter を押してください。あとは自動で進みます。
- このページ上部の緑色の 「Code」 ボタン → 「Download ZIP」 でダウンロードし、ZIP を展開する
- ゲームフォルダーを開く（Steam ライブラリ → Guildrun Demo を右クリック → 管理 → ローカルファイルを閲覧）
- 展開したフォルダーの中にある
guildrun_jp_patch_mac.pyとGuildrun日本語化_mac.commandの 2 つのファイルを、ゲームフォルダーへコピーする
Guildrun Demo/
├─ Guildrun.app
├─ guildrun_jp_patch_mac.py ← 本リポジトリ
└─ Guildrun日本語化_mac.command ← 本リポジトリ
Guildrun日本語化_mac.commandをダブルクリック（ターミナルが開いて進行状況が表示されます）- 「完了しました」と表示されたらゲームを起動し、設定 → 一般 → 言語 で 「日本語（MOD）」 を選択
ターミナルの表示が終わっても、ウィンドウは Enter を押すまで閉じません。エラーが出た場合はその内容が残るので、Issues に貼っていただければ調べます。
| 症状 | 対処 |
|---|---|
| ダブルクリックしても何も起きない／「開いていません」と警告が出る | 下の「開いていません」の項を参照 |
| 「uv が見つかりません」と出る | 最新版をお使いください。現在の版はインストールを提案します |
| 「Guildrun.app が見つかりません」と出る | 2 つのファイルの置き場所が違います。Guildrun.app と同じフォルダーに置いてください |
| 「翻訳データを取得できませんでした」と出る | ネットワーク接続を確認して、もう一度実行してください |
| 実行は成功したのに、ゲームの言語一覧に「日本語（MOD）」が出ない | ゲームを完全に終了してから起動し直してください。それでも出ない場合は、Steam がゲームを更新してパッチが消えた可能性があるので、もう一度実行してください |
ダウンロードしたスクリプトなので、初回は macOS が実行をブロックします。「Apple は、〜マルウェアが含まれていないことを検証できませんでした」という警告が出た場合は、次の手順で許可してください（「ゴミ箱に入れる」は押さないでください）。
- 警告ダイアログの 「完了」 を押す
- アップルメニュー → システム設定 → プライバシーとセキュリティ
- 下にスクロールし、「"Guildrun日本語化_mac.command" は開けませんでした」の右にある 「このまま開く」 をクリック
- Touch ID またはパスワードで承認し、確認ダイアログで 「開く」
以降はダブルクリックだけで実行できます。
翻訳データは実行時に自動で取得され、ゲームフォルダーの data/ に保存されます。2 回目以降は、変更があったファイルだけを取り直します。
翻訳データとフォントは、日本語化MOD 作者様のリポジトリから取得しています。取得したファイルは、作者様が公開している manifest.json の SHA-256 と照合してから使用します。
手元の data フォルダーを使いたい場合（翻訳を自分で編集した場合や、オフラインで実行したい場合）は、次のいずれかを指定してください。
--no-fetch… 取得を行わず、隣にあるdataフォルダーをそのまま使う--data <パス>… 任意のフォルダーを翻訳データとして使う（この場合も取得は行いません）
適用時に、書き換える 4 ファイルの原本が 日本語化バックアップ/ へ自動退避されます。
./Guildrun日本語化_mac.command --restore
バックアップを消してしまった場合は、Steam のプロパティ →「インストール済みファイル」→「ゲームファイルの整合性を確認」でも元に戻せます。
ゲームが更新されて未適用の状態に戻っている場合、次回の適用時にバックアップも新しい原本で取り直します（更新前のファイルを書き戻してしまわないようにするためです）。
Windows 版と同じ 4 つの処理を行います。
| 対象 | 内容 |
|---|---|
| 中国語（簡体字）の string table | 英語版のテーブルを元に、翻訳 CSV の日本語へ差し替え |
resources.assets |
Noto Sans SC/TC 18 個のフォントデータを Noto Sans JP に置換 |
global-metadata.dat |
言語名「中文（简体）」を「日本語（MOD）」に変更 |
catalog.bin |
再生成したバンドルの CRC に更新 |
生成物はいったん一時フォルダーに作り、4 つすべての検証（CRC 照合・翻訳の再読み込み照合・フォント数の確認）に通ってからゲームフォルダーへ適用します。途中で整合性が取れないと判断した場合はそこで停止し、ゲームファイルは一切変更しません。セーブデータには触れません。
どちらの場合も、もう一度実行するだけです。実行のたびに最新の翻訳データを取得してから適用します。ゲーム側の構成が変わっていて適用できない場合は、スクリプトが停止して何も変更しません。
- 2026-07-29 時点の Steam 版 Guildrun Demo（macOS / Apple Silicon）と翻訳データ 1.0.16
- 翻訳 3,918 件、フォント 18 個の適用と再読み込み照合（警告 0 件）
- 生成バンドルの実 CRC とカタログ内 CRC の一致
- ゲーム起動後、設定画面で「日本語（MOD）」を選択でき、序盤が日本語で表示されること
通しでのプレイ確認は行っていません。表示崩れなどにお気づきの場合は Issues でお知らせください。
- 非公式・無保証です。利用は自己責任でお願いします
- ゲームのデータファイルを直接書き換えます。復旧手段は上記「元に戻す」のとおりです
- 本スクリプトは AI コーディングエージェント（Claude Code）を用いて解析・移植したものです
- 本リポジトリのスクリプトのみ MIT ライセンスです（LICENSE）
- 翻訳データ・フォント・
dataフォルダーの内容は対象外です。これらは日本語化MOD 作者様の著作物であり、本リポジトリには含まれていません。再配布はしないでください - 処理内容は作者様の Windows 版パッチャーに基づいており、macOS 向けの移植と公開について作者様の許諾をいただいています
- 日本語化MOD（翻訳データ・フォント・パッチ処理の設計）: @tomathinn_G — 配布元: https://x.com/tomathinn_G/status/2078683987103690755
- macOS 版パッチャー: 本リポジトリ