HiveMind

一个为了玩 Hive 棋盘游戏而开发的 AI。

HiveMind AI 由 4 个主要组件构成。 该存储库包含主要的 AI 逻辑。

• 客户端 (Swift)

  • hive-client
  • iOS 应用程序，用于处理状态并显示移动。
  • 轻量级 -- 主要负责编码基本状态和移动。
  • 用于显示移动的 GUI。

• 服务器 (Ruby on Rails)

  • hive-server
  • 轻量级
  • 从客户端接收游戏状态并将其转发到引擎。
  • 将引擎建议的移动传递回客户端。

• 引擎 (Swift)

  • hive-engine
  • 维护游戏状态。
  • 可编码和解码，以便从客户端传递到服务器再传回。
  • 向 AI 提供游戏规则，使其能够确定有效且可进行的移动。

• HiveMind (Swift)

  • 给定游戏状态，探索各种移动以确定最佳策略。
  • 依赖于 alpha-beta 剪枝。

HiveMind 使用 WebSocket 进行通信。 默认情况下，它监听 ws://:8080，但您可以通过命令行参数提供替代端口，如下所述。

要与 HiveMind 交互，您可以通过 WebSocket 提供各种命令，它将依次回复。 可用的命令如下：

• [new, n] <IsFirst> <ExplorationTime>
  • 开始一个新游戏。
  • IsFirst 是一个 Bool 值，指示 HiveMind 是否先手。
  • ExplorationTime 是一个 Double 值，指定 HiveMind 探索状态的最长时间。
• [move, m] <Movement>
  • 解析给定的 HiveEngine.Movement（编码为 JSON）并更新 HiveMind 的内部状态。 这是接收对手移动的方式。
• [play, p]
  • 指示 HiveMind 探索当前状态。 它将在 ExplorationTime 后回复它找到的最佳移动。
• [quit]
  • 指示 HiveMind 结束当前游戏，但保持活动状态以开始另一个游戏。
• [exit]
  • 指示 HiveMind 退出并结束进程。

• --port <Int>, -p <Int>: 指定 HiveMind 应该监听的端口。

1. 首先，您需要获取其他几个存储库来构建整个系统并与 HiveMind 下一盘 Hive 游戏。
   • Hive 客户端
   • Hive 服务器
   • HiveMind
2. 运行以下命令分别构建调试版或发布版
   • swift build -Xswiftc "-target" -Xswiftc "x86_64-apple-macosx10.13"
   • swift build -c release -Xswiftc "-target" -Xswiftc "x86_64-apple-macosx10.13"
3. 使用 .build/debug/HiveMind 或 .build/release/HiveMind 启动实例。

• Swift 5.0+
• macOS 10.13+

1. 安装 SwiftLint 以符合样式规范。
   • brew install swiftlint
   • 从存储库的根目录运行 swiftlint。
   • 不应有任何错误或违规。 如果有，请在打开 PR 之前修复它们。
2. 使用您的更改打开一个 PR 👍

Hive Mind 与 Gen42 Games 没有任何关联。