上游说明： 本仓库不是从零开始的独立移植。Apple 平台原生移植的直接基础来自
ammaarreshi/Generals-Mac-iOS-iPad；CNC Generals for iOS/macOS 只代表在该上游基础上，针对维护者个人使用情境所做的增强、修复和打包工作。上游的完整项目介绍与移植历程请直接阅读其 README。
本项目让《命令与征服：将军——零点行动》在 Apple Silicon Mac 上原生运行；直接上游同时提供面向 iPhone 和 iPad 的原生实现。它不是 Windows 模拟器：游戏引擎直接编译为 ARM64，原有 DirectX 8 渲染经过 DXVK、Vulkan 和 MoltenVK 转换到 Metal。本分支保留上游成果，并根据 Apple Silicon Mac、中文游戏资源、外接盘安装和日常游玩中实际遇到的问题，内嵌了一批个人常用功能与体验修复。macOS 是本 fork 当前主要使用和验证的平台；加入这些个人修改后的 iOS / iPadOS 版本尚未测试成功，这一结论不代表直接上游的实现状态。
本仓库及其 GitHub Releases 不包含《将军》或《零点行动》的商业游戏资源。你必须自行拥有并提供合法的 Windows 版游戏文件。个人为自己的 iPhone 或 iPad 构建时，可以把自己合法持有的游戏资源封装进私人 IPA；这种 IPA 仅供个人设备安装，不进入本仓库，也不对外分发。
- 改进 Retina、HiDPI、窗口化、macOS 原生全屏和安全退出行为。
- 将画面渲染帧率与游戏逻辑速度分离；公开默认值为 60 FPS、1.0 倍游戏速度。
- 增加游戏内“画面与速度设置”面板，集中管理分辨率、渲染比例、速度、镜头和本地单机辅助功能。
- 改进中文字体回退、字形选择、字号和界面可读性。
- 修复视频、过场、缩放特效、离屏渲染和远景单位材质等实际游玩问题。
- 改进 SDL 输入、鼠标捕获、菜单稳定性和 macOS 窗口切换体验。
- 提供可移植的资源路径识别和
.app打包流程，适合把游戏放在外接盘。
完整记录见中文版修改日志。
| 平台 | 状态 | 说明 |
|---|---|---|
| Apple Silicon macOS | 主要使用平台 | 支持本地构建、命令行运行和双击 .app |
| iOS / iPadOS | 直接上游已有实现；本 fork 未验证成功 | 加入本 fork 修改后的私人构建可以完成编译、个人签名和真机安装，但当前测试尚未可靠进入游戏；不据此判断直接上游版本 |
| Linux | 共享引擎仍保留 | 本分支的 macOS 修改尚需更完整的跨平台回归测试 |
需要同时准备完整的原版《将军》和《零点行动》目录：
GeneralsX Runtime/
├── Generals/
│ └── INI.big
└── GeneralsZH/
└── INIZH.big
游戏文件可以来自 Steam、EA App、光盘版、The First Decade、The Ultimate Collection 或其他合法拥有的 Windows 安装。购买平台并不重要，完整资源才重要。
如何从 Windows 找到并复制 Steam、EA App、光盘版或典藏版资源，请看 macOS 二次修改版上手指南。
xcode-select --install
brew install cmake ninja meson pkgconf python vcpkg ffmpeg glm
export VCPKG_ROOT="$(brew --prefix vcpkg)"
export VULKAN_SDK="$HOME/VulkanSDK/<version>/macOS"其中 Vulkan SDK 需要从 LunarG 安装，不能只用 Homebrew 的 Vulkan headers 代替。完整依赖说明见 macOS 构建指南。
git clone https://github.com/Log1037/CNC-Generals-for-iOS-macOS.git
cd CNC-Generals-for-iOS-macOS
export GX_RUNTIME_ROOT="$HOME/GeneralsX Runtime"
./scripts/build/macos/build-macos-zh.sh
./scripts/build/macos/deploy-macos-zh.sh./scripts/build/macos/package-macos-zh-app.sh \
--game-dir "$GX_RUNTIME_ROOT/GeneralsZH" \
--generals-dir "$GX_RUNTIME_ROOT/Generals" \
--runtime "$GX_RUNTIME_ROOT/GeneralsZH" \
--output "$HOME/Applications/将军：零点行动.app"启动器支持：
- 自动识别常见位置和上次成功使用的位置；
- 直接选择
INIZH.big、INI.big、游戏目录或共同父目录； - 从 Finder 拖入文件或目录；
- 在原生选择窗口中按
⇧⌘G手动输入路径； - 按住 Option 打开 App，重新选择游戏资源。
| 快捷键 | 功能 |
|---|---|
Ctrl+G |
打开或关闭画面、速度与本地单机设置面板 |
Ctrl+[ / Ctrl+] |
调整渲染帧率 |
Shift+Ctrl+[ / Shift+Ctrl+] |
调整游戏速度 |
Cmd+G |
释放或重新捕获鼠标 |
Ctrl+Cmd+F |
切换 macOS 原生全屏 |
Alt+N |
本地单机模式增加 10,000 资金 |
本地单机辅助功能只面向离线游戏，不用于联机对战。
这首先是一个按自己需要慢慢修改的个人 fork。因为其中一些修复和功能或许也能帮到别人，所以把源码放在这里；它不算成熟发行版，也没有固定的维护计划。
遇到问题、想到什么功能，或者自己改出了一点东西，都可以直接开 Issue 或 Pull Request。能顺手写明系统版本、分辨率和具体现象就更好了，但不用按正式项目提工单。唯一需要注意的是不要上传商业游戏资源、包含资源的 App / IPA 或私人签名资料。
想一起改代码的话，可以再看一眼这份简短的参与说明。
本项目建立在以下工作之上：
- Electronic Arts 发布的 GPLv3 游戏引擎源码
- TheSuperHackers/GeneralsGameCode
- Fighter19/CnC_Generals_Zero_Hour
- fbraz3/GeneralsX
- 直接上游 ammaarreshi/Generals-Mac-iOS-iPad
- DXVK、MoltenVK、SDL3、OpenAL Soft、FFmpeg、Fontconfig、FreeType 等开源组件
详细继承关系和修改边界见 NOTICE.md。
源码按照仓库中的 GPLv3 许可证及 EA 附加条款发布。第三方组件继续适用各自许可证。
本项目不是 Electronic Arts、Westwood、EA Pacific 或任何上游社区项目发布的官方版本。游戏名称、剧情、美术、音频、地图和其他商业资源的权利属于其各自权利人。