gen1 recomp macOS: Mac向けネイティブセットアップガイド

gen1 recomp macOS は、手書きの Lua エンジンと LÖVE2D フレームワークで構築された、Pokémon 第1世代のネイティブPC向け再現実装です。Game Boy のハードウェアをエミュレートしたり、元のアセンブリコードを直接変換したりせずに、対応している Red、Blue、Yellow の体験を再現します。

アプリケーションはエンジンを提供し、セットアップ中に合法的に所有しているゲーム ROM から抽出されたデータを使用します。Nintendo のゲームファイルは含まれておらず、非公式の再配布サイトからダウンロードすべきではありません。

公式のプロジェクト入口は Gen1 Recomp GitHub リポジトリ です。ダウンロード可能なビルドとリリースノートについては、GitHub Releases ページ を使用してください。プロジェクトでは、gen1recomp.com は認可されたダウンロード元ではないと案内されています。

最も安全な macOS のインストール方法は、ソースコードアーカイブではなく、Mac 向けに用意されたリリースアセットを使用することです。リリースパッケージにはアプリケーションに必要なファイルが含まれる場合があるため、ダウンロード後も元のフォルダ構成またはアプリケーションバンドル構造を保持してください。

初回起動後は、アプリケーションのセットアップフローを通じてゲームデータを取り込んでください。Mac ビルドにしても、合法的に所有する Red、Blue、Yellow の ROM が必要であることは変わりません。Gen1 Recomp フォルダの外に、未改変の ROM バックアップを保管しておきましょう。

初回実行の手順は、管理された順序で進めるべきです。まず対応するクリーンな ROM から始め、ベースゲームを確認し、入力と表示を設定してから、セーブのバックアップを作成してください。

macOS ビルドは、セーブデータを元の ROM とは別に保存します。正確な Application Support の場所は LÖVE のデータパスやリリース構成によって異なる場合があるため、ROM フォルダにセーブが入っていると決めつけず、アプリケーション側のセーブ管理オプションを使うか、ユーザーデータディレクトリを確認してください。

コントローラーを使う場合は、可能であればアプリケーションを開く前にデバイスを接続し、その後で割り当てを確認してください。キーボード入力は信頼できる代替手段ですが、Bluetooth、USB、対応コントローラーの挙動は macOS のバージョンやデバイスによって異なる場合があります。

トラブルシューティング中は、エミュレーターのファイル、改造 ROM ハック、無関係なデータをアプリケーションフォルダ内に置かないでください。クリーンなベースフォルダを維持すると、問題の原因が Mac ビルド、取り込んだゲームデータ、後から追加した MOD のどれなのかを特定しやすくなります。

Gen1 Recomp には、対応するコミュニティパッケージ向けの内蔵 Mod Manager が含まれています。通常の MOD と、別プロジェクトである DramaticShape Voxel Mod は同一の内容として扱うべきではありません。有効化する前に、各パッケージの対象バージョン、対応ゲーム版、依存関係、インストール手順を確認してください。

プロジェクト固有の手順については、Gen1 Recomp Wiki を使用してください。voxel 体験については、DramaticShape Voxel Mod のリポジトリ を参照し、最新の互換性 ノートに従ってください。

信頼性の高い Mac 向け MOD の運用手順は次のとおりです。

• 一度に 1 つのパッケージだけを取り込む。
• Mod Manager がパッケージ化されたアーカイブを想定している場合は、元の ZIP をそのまま保つ。
• MOD が Red、Blue、Yellow のどれに対応しているか、あるいは 1 つだけなのかを確認する。
• 依存関係とロード順の指示に従う。
• ゲーム内容に影響する変更の前に、セーブをバックアップする。
• 問題が起きたら、まず最新の MOD を無効化する。
• クラッシュを報告する前に、ベースゲームをテストする。

内蔵の Save Editor は、手持ちポケモン、PC ボックス、アイテム、ポケデックスのデータ、イベントフラグを管理できます。変更は小さく行い、元のセーブを保持し、バックアップを置き換える前にゲーム内で編集済みファイルをテストしてください。大きすぎる、または一貫性のない編集は、セーブの読み込み失敗やストーリー進行の予期しない変化を引き起こす可能性があります。

macOS の問題の多くは、最小構成に戻すことで絞り込めます。まずアプリケーションバンドルが完全であることを確認し、その後 MOD なしで ROM とベースゲームをテストしてください。

起動失敗を診断するときは、次の順番で試してください。

1. Gen1 Recomp を終了する。
2. アプリケーションバンドルが完全に展開されていることを確認する。
3. 未改造のビルドを起動する。
4. 同じ合法的に所有する ROM が、クリーンな構成で動作するか確認する。
5. MOD を一時的に移動するか無効化する。
6. ウィンドウモードとデフォルト操作を試す。
7. 類似症状がないか、プロジェクトの GitHub Issues を確認する。

Link Play では、両プレイヤーが同じ Gen1 Recomp のリリース、互換性のある Red、Blue、Yellow のゲームデータ、そして一致したゲームプレイ変更 MOD を使用する必要があります。ホスト側では、アプリケーションをファイアウォールで許可し、選択した UDP ポートを設定する必要がある場合があります。インターネットセッションを試す前に、同じローカルネットワークでテストしてください。

編集後にセーブが失敗した場合は、比較用に失敗したファイルを保存し、最新のバックアップを復元してください。より小さく、より狙いを絞った編集を行う前に、バックアップが MOD なしで読み込めることを確認しましょう。