Command & Conquer GeneralsがFableを使用してmacOS、iPhone、iPadにネイティブ移植
Command and Conquer Generals natively ported to macOS, iPhone, iPad using Fable (github.com)
要約
この記事は、クラシックRTSゲーム「Command & Conquer Generals: Zero Hour」がFableプロジェクトを使用してmacOS、iPhone、iPadにネイティブ移植されたことを紹介しています。この移植版はApple Silicon上で動作し、DirectX 8をVulkanおよびMoltenVK経由でMetalに変換した2003年のエンジンを使用しており、モバイルデバイス向けにタッチコントロールも備えています。ゲームの所有が必要で、Appleプラットフォームでのビルドと実行方法の詳細な手順が提供されています。
全文翻訳
Command & Conquer Generals: Zero Hour — macOS, iOS & iPadOS
[画像: Zero HourがApple Silicon Mac、iPhone、iPadでネイティブに動作](https://private-user-images.githubusercontent.com/159876365/617135099-aeaf6692-36e6-40c8-b9f8-8066d014ec4b.gif?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3OTI1NjE3MjcsIm5iZiI6MTc5MjU2MTQyNywicGF0aCI6Ii8xNTk4NzYzNjUvNjE3MTM1MDk5LWFlYWY2NjkyLTM2ZTYtNDBjOC1iOWY4LTgwNjZkMDE0ZWM0Yi5naWY_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYxMDIxJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MTAyMVQwNTQzNDdaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT04MzAzYzAxNDQ5YmRmNzkxNWI1Njc0Yjk0NThiZWZkY2RlNDU0ZDNiZDllYTQ3MzM2YzkzYTMyMTQyNjgyYWFmJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZnaWYifQ.58iKv0I7V15DnS7pDPQGVB69-KpGJA0wWJO4_F1_cQM)
Zero HourがApple Silicon Mac、iPhone、iPadでネイティブに動作 — キャンペーン、スカーミッシュ、Generals Challengeに対応。RTS用にタッチ操作(タップで選択、ドラッグボックス、長押しで選択解除、2本指スクロール、ピンチズーム)が組み込まれています。エミュレーションはありません。これは、ARM64用にコンパイルされ、DirectX 8 → DXVK → Vulkan → MoltenVK → Metal でレンダリングされる、本物の2003年のエンジンです。
EAのGPL v3ソースリリースに基づき、コミュニティの作業の連鎖の上に成り立っています — TheSuperHackers、Fighter19のオリジナルのUnixポート、そしてfbraz3/GeneralsX — このフォークはiOS/iPadOSポートと一連のエンジン修正を追加しています。誰が何を作ったかは、Lineage & credits を参照してください。オリジナルのGeneralsX READMEはupstream-mainブランチにあります。
ゲームアセットは含まれておらず、配布もされていません。 ご自身のコピーが必要です(Steam、セール時約5ドル)。
このポートが実際に行ったこと
「移植」という言葉では、この旅の奇妙さを十分に伝えきれません。以下にその正直な形を示します。以下の系譜が基盤を築きました:EAのソースリリース、コミュニティによる近代化、Fighter19のオリジナルのUnixポート、GeneralsXのmacOS/Linux作業。存在しなかったのは、iOS上でのこれらのいずれかです — そしてiOSは、2003年のWindows RTSにとって敵対的な場所です:
- エンジンは、それが存在する場所ならどこでも書き込み可能なファイルシステムを想定しています。 iOSアプリは読み取り専用のコード署名済みバンドル内に存在します。すべての設定書き込み、キャッシュ、保存パスはリダイレクトする必要がありました — そしてワーキングディレクトリはバンドル自体からブートストラップされました。
- レンダラーはDirectX 8を話します。iPadはMetalを話します。 その間には:D3D8→Vulkanへの変換を行うDXVK、Vulkan→Metalへの変換を行うMoltenVK — そしてDXVKはiPhoneOS用にビルドされたことがありませんでした。それにはMesonクロスビルドと、iOSが
dlopenをアプリバンドルに限定しているため、そのVulkanローダーへのパッチが必要でした(Patches/dxvk-ios.patch)。 - iOSはあなたのプロセスを所有します。 アプリスイッチャーを開くと、OSはMetalドローアブルを奪います(あなたをバックグラウンドにすることなく)— もう1フレーム描画すると、再開時にクラッシュします。レンダリング/シミュレーションループ全体が息を止めることを学びました。
- RTSにはマウスが必要です。 SDL3(以下の系譜から)は生のタッチイベントを提供します。その上のRTSセマンティクスは新しいものです。タップは2003年のGUIがホバー(またはメニューボタンがハイライトされない)を処理するまで遅延し、ドラッグは「選択ボックスかカメラパンか」を決定する必要があり、長押しは右クリックになり、キャンセルされたタッチは決してラリーポイントをゴーストクリックしてはなりません。
- そしてバグ探しです — 最も楽しい部分。2003年のテクスチャフォーマットのフォールバックがサイレントにアルファチャンネルをドロップしたために黒くレンダリングされていたミニマップ。ゾンビオーディオストリームが永遠に鳴きながら、「スピーチをオーバーライドしない」というグローバルフラグを保持していたために、EVAの声がランダムにミュートになったこと。それぞれが実機で根本原因を追求し、修正し、アップストリームに提供されました。
→ 戦争の物語: Porting Playbook §8 — バグの考古学 → 完全なエンジニアリングログ: docs/port/PORTING_PLAYBOOK.md → 他のゲームにこれを適用する方法: docs/port/PORTING_PATTERNS.md
はっきりと述べる価値があります:これは人間とAIの協力でした。エンジニアリング — C++、クロスビルド、デバイスデバッグ — はClaude Code(AnthropicのClaude、Fableモデル)によって行われ、人間が「ミニマップが黒い」「鳴き声が聞こえる」といった症状を説明し、すべての決定を下しました。どちらか一方だけではこれをリリースできません:私たちの一方はC++を書けず、もう一方は鳴き声を聞けません。
クイックスタート — macOS
前提条件(一度だけ):
# Toolchain
xcode-select --install
brew install cmake ninja meson pkgconf
brew install --cask steamcmd
# vcpkg (full clone — a shallow clone breaks manifest baselines)
git clone https://github.com/microsoft/vcpkg ~/vcpkg && ~/vcpkg/bootstrap-vcpkg.sh
export VCPKG_ROOT=~/vcpkg # add to your shell profile
# LunarG Vulkan SDK (NOT the Homebrew cask) — https://vulkan.lunarg.com/sdk/home
export VULKAN_SDK=$HOME/VulkanSDK/<version>/macOS # add to your shell profile
クローン、ビルド、アセット取得、プレイ:
git clone https://github.com/ammaarreshi/Generals-Mac-iOS-iPad.git GeneralsX
cd GeneralsX
./scripts/build/macos/build-macos-zh.sh # checks deps, configures, builds
./scripts/build/macos/deploy-macos-zh.sh # creates ~/GeneralsX/GeneralsZH + run.sh
./scripts/get-assets.sh <your_steam_username> # fetches game data you own
cd ~/GeneralsX/GeneralsZH && ./run.sh -win
クイックスタート — iPhone / iPad
macOSの前提条件に加えて:完全なXcode(Apple IDでサインイン済み)、brew install xcodegen、そして(無料または有料の)Apple Developerチーム。
cd GeneralsX
git submodule update --init references/fbraz3-dxvk # iOS DXVK is built from this + Patches/dxvk-ios.patch
./scripts/build/ios/fetch-moltenvk.sh # pinned MoltenVK.framework (checksummed)
./scripts/build/ios/stage-fonts.sh # Liberation fonts, renamed as the game expects
cmake --preset ios-vulkan
cmake --build build/ios-vulkan --target z_generals
GX_TEAM_ID=<your-team-id> GX_BUNDLE_ID=com.you.generalszh \
./scripts/build/ios/package-ios-zh.sh --install # assembles, signs, installs
Xcode → Settings → Accounts でチームIDを見つけてください。アセットはアプリバンドル内に同梱されます(自己完結型インストール)。--devは、高速なコードイテレーションのために約2.7GBのコピーをスキップします。
ファイルの場所
| パス | 内容 |
|---|---|
docs/port/PORTING_PLAYBOOK.md | このポートの完全なエンジニアリングログ:すべての障害モード、根本原因、修正 — まず§8、バグの考古学から始めてください:黒いミニマップ、ミュートされたEVAライン、そして鳴き声 |
docs/port/PORTING_PATTERNS.md | クラシックなWindowsゲームをAppleプラットフォームに移植するための一般的な方法論 |
docs/port/RELEASE_CHECKLIST.md | 公開リリースのゲート |
scripts/get-assets.sh | Steamアセットフェッチャー(ご自身のコピーを使用。アプリ2732960) |
scripts/build/macos/, scripts/build/ios/ | ビルド、デプロイ、パッケージングパイプライン |
ios/ | XcodeGenサイニングスタブプロジェクト + ios/config/(ステージングされたOptions.ini、dxvk.conf) |
Patches/dxvk-ios.patch | iOSのd3d8/d3d9 dylibsがビルドされる際のDXVKの変更点(ローカルフォークビルドで適用) |
既知の問題
- iPadでの長時間のセッションは、メモリ(約3GB以上常駐)のためにiOSによって終了させられることがあります。アプリはダイアログなしでホーム画面に終了します。セッションログ(現在および以前)は、ゲームのフォルダ内のFilesアプリにあります。調査中です。
- ゲーム中のバックグラウンド化は、iOSで時々クラッシュすることがあります — ライフサイクルのポーズは一般的なパスをカバーしていますが、まれな競合状態が残っています。頻繁に保存してください。
次は何:Renegade 👀
Generalsには、巨人たちの肩に乗るための連鎖がありました。Command & Conquer: Renegade — 同じGPLソースリリースからのEAの2002年のFPS — は、はるかに少ないです:W3DエンジンのネイティブmacOSまたはiOSビルドは一度もリリースされていません(今日のMacプレイヤーはWineベースの互換レイヤーを使用しています)。OpenW3Dコミュニティプロジェクトは、真のクロスプラットフォームの基盤を持っています — DXVKラッパーの足場とSDL3ビルド配管 — Mac/Linuxをロードマップに含んでおり、その基盤こそが私たちが構築したものです。
このリポジトリと同じ方法論で、より深い水域へ:OpenW3DのWin32互換足場は約3,000行拡張されました(エンジンはファイル検索、キーボード状態、COMのために生のWindows APIを呼び出します)、20,000ものアセットパスのケースセンシティブ戦略、DXVK/MoltenVKレンダラーの立ち上げ、オーディオ/ビデオスタック、そしてFPSタッチコントロール。これは今日、MacとiPhoneでプレイ可能です — キャンペーン、シネマティクス、ミッションスクリプト。規模で言うと:このGeneralsポートはGeneralsXの上に約2,200行を追加しました。RenegadeはWindows専用ソースの上に約6,700行を必要としました。
リポジトリはすぐにドロップされ、OpenW3Dの系譜はこのリポジトリがその連鎖をクレジットするのと同じ方法でクレジットされます。同じルール:GPL v3、ご自身のコピーを用意、完全なエンジニアリングログ。
系譜とクレジット
このポートは長い連鎖の最新のリンクであり、以前のリンクは、このリポジトリがすべてで継承する基盤的な作業を行いました:
- Westwood / EA Pacific — ゲーム;EA — GPL v3ソースリリース
- TheSuperHackers/GeneralsGameCode — コミュニティメインライン:ビルドの近代化、VC6→モダンツールチェーン、そしてクロスプラットフォームの基盤の多く、OpenSAGEのfeliwirによって作成されたFFmpegビデオバックエンド(このポートのオーディオスタックが構築されているOpenALオーディオデバイス作業も担当)を含む
- Fighter19/CnC_Generals_Zero_Hour — オリジナルのUnix/64ビットポート:SDL3プラットフォーム管理、C++17ファイルシステム/スレッディング、Freetype/Fontconfigテキストレンダリング、そしてこのレンダラーパスが派生するDXVKアプローチ
- fbraz3/GeneralsX — このフォークが直接構築されているmacOS/Linuxポート。上記の統合と拡張
- このフォーク — iOS/iPadOSポート(arm64-iosクロスビルド、iOS上のDXVK、タッチコントロール、アプリライフサイクル、パッケージング)およびエンジン修正。アップストリームに提供
- DXVK, MoltenVK, SDL, OpenAL Soft, FFmpeg, Liberation Fonts — 負荷を支える壁
エンジンコード GPL v3 (EAのソースリリース → 上記の連鎖 → このフォーク)。ゲームアセット:含まれていません。ここではライセンスされていません。