CommandCenter：适用于《星际争霸：母巢之战》和《星际争霸II》的AI机器人

CommandCenter是一款星际争霸AI机器人，能够同时游玩《星际争霸：母巢之战》和《星际争霸II》。

CommandCenter使用C++编写，基于BWAPI以及暴雪提供的StarCraft II AI API。它为这两个API封装了大量功能，使得同一份源代码可以在两款游戏中实现相同的功能。该项目由纪念大学计算机科学系助理教授、AIIDE星际争霸AI竞赛的组织者David Churchill开发。

CommandCenter以UAlbertaBot的架构为基础，旨在提供一个易于使用的框架，方便玩家快速修改、调试并构建自己的机器人。该机器人本身并未内置过多硬编码的策略或战术，但它为玩家实现针对任意种族的自定义策略提供了一个良好的起点。

目前，CommandCenter具备以下功能：

• 使用同一份源代码同时支持《星际争霸》两款游戏；
• 支持所有三个种族，并为作战单位提供了通用的微观操控逻辑；
• 能够在线分析地图，提取基地位置和扩张点等信息；
• 记录所有已知敌方单位及其在地图上的最新位置；
• 内置WorkerManager模块，负责资源采集、工人分配与建筑生产；
• 可根据配置文件中预设的建造顺序执行任务；
• 允许玩家轻松创建自定义建造顺序，并在游戏中实时调整；
• 包含建筑放置算法，可为指定建筑找到距离目标位置最近的可建造点；
• 利用工兵单位侦查地图，定位敌方基地位置；
• 当达到特定条件（默认为拥有12个作战单位）时，会发起进攻，分波次向敌方基地推进；
• 支持组建小队，让多个单位按照既定顺序执行攻击或防守等任务。

CommandCenter最终将具备UAlbertaBot的所有功能，但目前仍有部分功能尚未完成。以下是CommandCenter当前缺失、即将实现的功能列表：

• ProductionManager目前仅能建造单位和基础建筑，暂不支持附加设施、科研和技术升级；
• 尚未实现自动化的建造顺序规划系统；
• 缺乏用于预测战斗结果的模拟模块；
• 机器人目前仅支持1v1对战模式，若面对多敌或团队战时可能会出现未定义行为甚至崩溃。

下载与运行CommandCenter

《星际争霸：母巢之战》：
您需要安装《星际争霸：母巢之战》1.16.1版本，并确保已正确安装BWAPI。

《星际争霸II》：
要运行本机器人，您必须安装最新版本的零售版《星际争霸II》。此外，还需下载并安装一些地图文件，这些文件可在此处获取。请注意，页面上提供了用于解压地图压缩包的密码。

机器人附带一个名为BotConfig.txt的配置文件，您可以通过该文件修改建造顺序、输出调试信息以及设置机器人参数。在文件的“Strategies”部分，您可以定义多个建造方案，并选择在特定种族对局中启用哪一种策略。建造顺序中的单位名称区分大小写，必须与游戏中显示的完全一致，且不能包含空格。目前，配置文件中的一些选项尚未实现，例如KiteWithRangedUnits选项。

需要注意的是，此配置文件采用JSON格式，只有格式正确的JSON文件才能使机器人正常运行。此外，配置文件必须与CommandCenter.exe位于同一目录下，否则机器人将无法启动。如果您不确定JSON语法是否正确，可以使用在线JSON验证工具进行检查。

默认情况下，运行CommandCenter.exe时，机器人将以随机种族对阵内置的SC2简易AI。您可以通过配置文件中的“BotRace”和“EnemyRace”选项来更改对战双方的种族，也可以通过“MapFile”选项指定要游玩的地图。请注意，“MapFile”选项的路径是相对于您的《星际争霸II》地图目录而言的，默认路径为StarCraft_Install_Directory/maps/。如果未指定有效的地图文件，机器人将无法运行。

如果机器人出现崩溃或其他异常情况，请耐心等待，我会继续优化其稳定性！

开发者安装/编译说明（Windows）

• 下载并安装 Visual Studio 2017
• 要游玩《星际争霸：老版本》，您必须下载并安装 StarCraft BW v1.16.1 以及 BWAPI。
• 要游玩《星际争霸II》，您必须下载并安装 StarCraft II AI API。最简单的方法是下载页面底部的 预编译库，然后将其解压到您电脑上的一个文件夹中。如果您通过克隆 Blizzard 的 GitHub 仓库并从头开始编译 SC2API，可能需要将 VS 的包含目录和库目录指向与下方描述不同的路径。
• 将此 Git 仓库克隆到您电脑上的一个文件夹中。
• 在 VS2017 中打开“CommandCenter/vs/CommandCenter.sln”。
• 如果您使用 x64 平台编译 CommandCenter 项目，它将编译 SC2 模块。
• 如果您使用 x86 或 Win32 平台编译 CommandCenter 项目，它将编译 BW 模块。
• 设置 VS 项目的包含和库目录以指向相应目录：
  • 在 VS2017 中右键单击 CommandCenter 项目。
  • 选择“属性”。
  • 在左上角选择您想要构建的正确配置（“Release”或“Debug”）。
  • 选择您想要构建的目标平台（x64 = SC2，Win32 = BW）。
  • 在左侧选择“VC++ 目录”。
  • 在右侧表格中选择“包含目录”选项。
  • 点击右侧的下拉箭头，然后点击“编辑...”。
  • 修改现有的目录条目，使其指向您的 (SC2API|BWAPI)/include 目录。
  • 在右侧表格中选择“库目录”选项。
  • 点击右侧的下拉箭头，然后点击“编辑...”。
  • 修改现有的目录条目，使其指向您的 (SC2API|BWAPI)/lib 目录。
• 从“生成”菜单中，点击“生成解决方案”。
• 二进制文件“CommandCenter_API.exe”应出现在 CommandCenter/bin/ 目录中。
• 运行 CommandCenter 机器人的方式有：
  • 双击 CommandCenter/bin/ 目录中的可执行文件。
  • 从控制台运行程序。
  • 在 VS 中点击“本地 Windows 调试器”以在 VS 内部启动程序。为此，您需要将“调试”下的“工作目录”选项设置为“$(ProjectDir)/../bin/”（我不知道为什么这个选项无法保存）。
• 如果您运行的是 BW 版本的机器人，则必须通过 Chaoslauncher 启动 BW，并注入 BWAPI。
• CommandCenter/bin/BotConfig.txt 文件必须与 .exe 文件位于同一目录中，才能正常运行。

开发者安装/编译说明（Linux 和 OS X）

按照这些步骤，您应该能够构建并安装 SC2 API，并将其集成到 CommandCenter 中。该方法已在 aba2d3813571c344090f3de5b58a5c912cd5acb3 版本上成功测试过。因此，如果下面的安装说明不起作用，请切换到该版本的 SC2 API：

$ git checkout aba2d3813571c344090f3de5b58a5c912cd5acb3 .

然后重复上述步骤。

• 构建 SC2 API 项目

$ git clone --recursive https://github.com/Blizzard/s2client-api && cd s2client-api
$ mkdir build && cd build
$ cmake ../
$ make

• 将 SC2 API 的库和头文件安装到您的系统中

# 假设您已完成上一步，当前位于 'build' 目录
$ cd ../

# 安装 SC2 API 头文件
$ sudo mkdir -p /opt/local/include
$ sudo cp -R include/{sc2api,sc2renderer,sc2utils} /opt/local/include
$ sudo cp -R build/generated/s2clientprotocol /opt/local/include

# 安装 protobuf 头文件
$ sudo cp -R contrib/protobuf/src/google /opt/local/include/sc2api

# 安装 SC2 API 库
$ sudo mkdir -p /opt/local/lib/sc2api
$ sudo cp build/bin/{libcivetweb,libprotobuf,libsc2api,libsc2lib,libsc2protocol,libsc2utils}.a /opt/local/lib/sc2api

• 构建机器人

$ git clone https://github.com/davechurchill/commandcenter.git && cd commandcenter
$ cmake .
$ make

机器人开发

如果您熟悉 UAlbertaBot 的架构，那么 CommandCenter 的逻辑与之非常相似。最大的区别在于，与地图、基地位置等相关的信息不再全局可用。这些数据现在存储在主 CCBot 类中，必须通过该类的实例引用才能访问。因此，CommandCenter 中的大多数类都携带对机器人主 CCBot 对象的引用，所有与游戏相关的信息、观察和查询都可以通过该引用进行。

详细的开发指南即将发布，但目前您可以参考 UAlbertaBot 维基，因为两者的架构非常相似（除了建造顺序规划器和战斗模拟器之外）。

CommandCenter 快速上手指南

CommandCenter 是一个支持《星际争霸：母巢之战》（Broodwar）和《星际争霸 II》（StarCraft II）的双平台 AI 机器人框架。它基于 C++ 开发，旨在提供一个易于修改和扩展的架构，帮助开发者快速构建自己的星际争霸 AI 策略。

环境准备

系统要求

• 操作系统：Windows (推荐 VS2017), Linux, 或 macOS
• 编译器：Visual Studio 2017 (Windows) 或 CMake + Make (Linux/macOS)
• 游戏版本：
  • Broodwar: 必须安装 StarCraft: Broodwar v1.16.1
  • StarCraft II: 必须安装最新零售版 StarCraft II

前置依赖

根据目标游戏选择安装对应的 API：

1. 针对 Broodwar:
   • 下载并安装 BWAPI。
2. 针对 StarCraft II:
   • 下载并安装 StarCraft II AI API (s2client-api)。
   • 地图文件: 需从 官方仓库 下载比赛用地图并解压（注意页面提供的解压密码）。
   • 提示: Windows 用户可直接下载 "Precompiled Libraries" 预编译库以简化安装。

安装步骤

方案 A：Windows (Visual Studio)

1. 获取源码:

   git clone https://github.com/davechurchill/commandcenter.git
   

2. 打开项目: 使用 Visual Studio 2017 打开 CommandCenter/vs/CommandCenter.sln。
3. 配置路径:
   • 右键点击 CommandCenter 项目 -> 属性 (Properties)。
   • 选择对应的配置（Release/Debug）和平台：
     • x64: 编译 SC2 版本
     • Win32/x86: 编译 BW 版本
   • 进入 VC++ 目录 (VC++ Directories):
     • 包含目录 (Include Directories): 指向 (SC2API|BWAPI)/include 文件夹。
     • 库目录 (Library Directories): 指向 (SC2API|BWAPI)/lib 文件夹。
4. 编译: 点击菜单栏 生成 (Build) -> 生成解决方案 (Build Solution)。 编译成功后，CommandCenter_API.exe 将出现在 CommandCenter/bin/ 目录中。

方案 B：Linux / macOS

1. 编译并安装 SC2 API:

   # 克隆特定稳定版本的 s2client-api
   git clone --recursive https://github.com/Blizzard/s2client-api
   cd s2client-api
   git checkout aba2d3813571c344090f3de5b58a5c912cd5acb3
   
   mkdir build && cd build
   cmake ../
   make
   
   # 安装头文件和库到系统目录
   cd ../
   sudo mkdir -p /opt/local/include
   sudo cp -R include/{sc2api,sc2renderer,sc2utils} /opt/local/include
   sudo cp -R build/generated/s2clientprotocol /opt/local/include
   sudo cp -R contrib/protobuf/src/google /opt/local/include/sc2api
   
   sudo mkdir -p /opt/local/lib/sc2api
   sudo cp build/bin/{libcivetweb,libprotobuf,libsc2api,libsc2lib,libsc2protocol,libsc2utils}.a /opt/local/lib/sc2api
   

2. 编译 CommandCenter:

   cd .. # 返回上级目录
   git clone https://github.com/davechurchill/commandcenter.git
   cd commandcenter
   cmake .
   make
   

基本使用

1. 配置文件设置

在运行前，确保 BotConfig.txt 文件位于可执行文件 (CommandCenter_API.exe) 的同级目录下（即 bin/ 文件夹）。

• 编辑 BotConfig.txt (JSON 格式) 可调整种族、地图和建造顺序。
• 关键参数:
  • BotRace: 设置机器人种族 (如 "Terran", "Zerg", "Protoss", "Random")。
  • EnemyRace: 设置对手种族。
  • MapFile: 设置地图路径（相对于 SC2 安装目录下的 maps/ 文件夹）。
  • Strategies: 定义具体的建造顺序（单位名区分大小写且不能有空格）。

注意：请确保 JSON 格式正确，否则机器人无法启动。可使用在线工具验证。

2. 运行机器人

对于 StarCraft II

直接运行编译好的程序：

# Windows
cd bin
CommandCenter_API.exe

# Linux/macOS
./CommandCenter_API

默认情况下，机器人将以随机种族对抗内置的简单 AI (Easy AI)。

对于 Broodwar

1. 启动 Chaoslauncher。
2. 勾选 BWAPI Inject 插件。
3. 启动 StarCraft: Broodwar。
4. 在游戏创建房间后，CommandCenter 会自动接入并控制对应玩家。

3. 开发提示

• CommandCenter 的架构与 UAlbertaBot 相似，但地图信息等数据不再全局访问，而是封装在 CCBot 类中。
• 大多数功能类都需要持有 CCBot 实例的引用以获取游戏状态。
• 目前仅支持 1v1 模式，多敌人或团队模式可能导致崩溃。