TorchCraftAI 实战教程：3 种方式启动星际争霸游戏（Wine/SC-Docker/OpenBW）完整对比
【免费下载链接】TorchCraftAIA platform that lets you build agents to learn to play StarCraft: Brood War.项目地址: https://gitcode.com/gh_mirrors/to/TorchCraftAI
TorchCraftAI 是一个让你构建 AI 智能体学习玩《星际争霸：母巢之战》的开源平台，其中内置了曾在 SSCAIT 2017-18 夺冠的 CherryPi 机器人。想运行这个星际争霸 AI 框架，第一步就是解决"如何启动星际争霸游戏"的问题。本教程为你梳理 3 种主流启动方式——Wine、SC-Docker 与 OpenBW，并给出完整的安装步骤、优缺点对比与选型建议，帮你快速跑通第一局 AI 对战。
为什么启动星际争霸游戏有 3 种方式？
TorchCraftAI 采用"客户端-服务器"架构：游戏内的 TorchCraft Server（BWEnv）负责注入星际争霸并采集观测数据，而 CherryPi 客户端通过 TCP 连接与之通信。由于星际争霸 1.16.1 是 Windows 程序，在 Linux/macOS 上运行就需要不同的"托管"方案，于是衍生出 Wine、SC-Docker 与 OpenBW 三条路线。这张系统架构图直观展示了各组件如何协作：
从架构图可以看出，无论采用哪种方式，最终目标都是让星际争霸实例中的 BWAPI + TorchCraft Server 与 CherryPi 建立连接。启动方式的差别，只在于"如何把星际争霸跑起来"。
方式一：Wine 启动星际争霸游戏（最接近原生体验）
Wine 是让 Windows 程序在 Linux/macOS 上运行的传统方案，也是官方文档中推荐的方式，完整步骤记录在 docs/play-games.md。
最快配置方法
- 先安装 Wine（各发行版官方源均有对应安装包）；
- 在 Wine 环境中安装星际争霸1.16.1（注意：1.18 及重制版的新 MPQ 暂不支持）；
- 安装 BWAPI 4.2.0，并在星际争霸目录下运行客户端：
cherrypi.exe -hostname 127.0.0.1； - 启动 ChaosLauncher.exe，勾选
BWAPI Injector 4.2.0 [RELEASE]； - 在 Config 中把
ai =指向 BWEnv.dll，保存后点击 Start，即可进入自定义游戏。
启动成功后，你就能看到 AI 控制单位作战的真实游戏画面，例如异龙在战场上的机动操作：
适用人群：想要完整游戏画面、手动观战调试的用户；也是训练 AI 与人对战的默认方案。
方式二：SC-Docker 启动星际争霸游戏（自动化批量对战）
SC-Docker 把星际争霸封装进 Docker 容器，适合需要批量跑对战、做强化学习训练的场景。它只负责运行星际争霸、对手 Bot 与 TorchCraft Server。
一键安装步骤
- 安装 Docker；
- 克隆 SC-Docker 并执行
python setup.py install（注意：pip 版本暂不支持此用法）； - 将官方提供的 TorchCraft 机器人配置解压到
~/.scbw/bots/，其中包含 BWAPI 与 BWEnv.dll； - 运行对战命令，例如
scbw.play --bots "TorchCraft" "Steamhammer"； - 再启动客户端
./cherrypi -hostname 127.0.0.1连接游戏。
适用人群：需要无界面批量训练、与多个 Bot 自动对战的进阶用户。容器隔离让环境可复现，是构建强化学习训练管线的理想底座。
方式三：OpenBW 启动星际争霸游戏（无需 Windows 环境）
OpenBW 是 BWAPI 的开源跨平台重实现，直接在 Linux 上读取星际争霸的 MPQ 数据文件运行，完全不需要 Wine。这也是官方推荐在 Linux 上编译使用的方式，相关安装步骤见 docs/install-linux.md。
最快配置方法
- 编译安装 OpenBW（仓库已内置在 3rdparty/openbw 目录，可用 CMake 构建）；
- 准备星际争霸 1.16.1 的 MPQ 数据文件（可从现有安装拷贝，或用 Wine 安装后执行
find ~/.wine/ -name "*.mpq"定位）； - 通过环境变量
export OPENBW_MPQ_PATH=...指定 MPQ 路径； - 以
BWAPI_CONFIG_AI__AI=/path/to/BWEnv.so方式运行 OpenBW，再启动 CherryPi 客户端。
在 TorchCraftAI 中，OpenBW 进程由 src/gameutils/openbwprocess.cpp 负责拉起与通信，它还支持按名称注入自定义 Bot（如412_T_Ironbot.dll）。启动后地图与单位数据会通过 BWEM 等工具自动解析：
适用人群：希望完全脱离 Windows 环境、进行深度改造的开发者；也是 AI 训练数据生成（如 Defiler 微操场景）的首选。
3 种启动方式完整对比表
| 对比维度 | Wine | SC-Docker | OpenBW |
|---|---|---|---|
| 运行环境 | Windows/Wine | Docker 容器 | 纯 Linux 原生 |
| 游戏画面 | ✅ 完整画面 | ❌ 无界面 | ✅ 可启用 UI |
| 部署难度 | ⭐⭐ 中等 | ⭐⭐⭐ 较高 | ⭐⭐ 中等 |
| 批量训练 | ❌ 不适合 | ✅ 天然支持 | ✅ 支持 |
| 跨平台 | Linux/macOS/Windows | 全平台 | Linux 为主 |
| 推荐场景 | 手动对战、观战 | 强化学习训练 | 开发调试、数据生成 |
选型建议：如何快速选择？
- 想最快看到 AI 打游戏→ 选Wine + ChaosLauncher，按照 docs/play-games.md 操作即可，10 分钟跑通第一局；
- 要做强化学习训练→ 选SC-Docker，容器化让你轻松切换对手 Bot、并行开多局游戏；
- 要写代码调模型→ 选OpenBW，它开源透明、可深度定制，配合 src/gameutils/openbwprocess.cpp 实现全自动化启动。
无论选择哪种方式，都别忘了提前准备好星际争霸 1.16.1（含母巢之战资料片）的数据文件，并确保编译好 CherryPi 客户端。克隆仓库时请使用：
git clone https://gitcode.com/gh_mirrors/to/TorchCraftAI --recursive总结
Wine、SC-Docker 与 OpenBW 三条启动星际争霸游戏的路线各有千秋：Wine 保真体验最佳，SC-Docker 最适合自动化批量训练，OpenBW 则给开发者最大的自由度。结合本教程的对比表和官方文档，相信你已能快速选出适合自己的启动方式。现在就克隆 TorchCraftAI 仓库，让你的 AI 在星际争霸的战场上大展身手吧！
想要深入学习？官方文档 docs/play-games.md 与 docs/install-linux.md 涵盖了全部细节，动手实践才是最快的学习路径。🚀
【免费下载链接】TorchCraftAIA platform that lets you build agents to learn to play StarCraft: Brood War.项目地址: https://gitcode.com/gh_mirrors/to/TorchCraftAI
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
