制作大脑

大脑是什么

引擎自己的电脑玩家仍然是默认，并且仍然留在引擎里。大脑打一个电脑席位，而且只打玩家把它设置上去的席位。空的大脑标识就是那个内置电脑玩家。没有大脑的席位、不适配的大脑，以及停下来的大脑，都由同一个玩家来打。Classic 用 Lua 写成，打法与那个玩家相同。它是那个玩家的文档，不是替代。

只有把电脑玩家入座的那台机器运行脚本，所以其他玩家什么都不用安装。他们的机器镜像该席位的单位。录像回放不运行脚本。大脑是 Lua 源码和数据。它没有原生代码，没有文件，没有网络，也没有时钟。全图视野是清单上的一个标志。大脑可以设置它，可以带着它打网络游戏，席位会显示这个标志。

包

大脑是一个 .oabrain 文件，或该文件解压成的文件夹。清单是模组配置所用的严格 YAML：一份文档、一个顶层映射、没有锚点、没有块标量。包的顶层放着 oabrain.yaml。它旁边的文件是下面这些之一。这份列表以外的文件会被拒绝。

比较时忽略 ASCII 字母的大小写，标准要求字节必须一致的地方除外。entry 点了别的文件时，brain.lua 就在范围外。一个 Lua 文件至多 1 MiB。图标是正方形 PNG，每边至多 256 像素，至多 256 KiB。OA 把大脑安装到 Brains/ 和清单中的标识。

清单

读取器收集每一条被打破的规则，只要有任何一条被打破，清单就保持不变。标准没有列出的键会被拒绝。配置文件的键属于模组。变异器的键会因为它是变异器的键而被拒绝。版本要加引号，因为裸的 1.0 是数字；星号也要加引号，因为裸的星号是 YAML 别名。

九个标签

标签是这九个之一，按字节逐个比较。超过四个，在共享的标签规则已经通过之后，是它自己的问题。不是这九个之一的标签会被拒绝。

级别与难度

levels 是一列 1 到 6 个映射。每个恰好是 id、name 和 difficulty，全部必填。id 是 1 到 32 字节的小写 kebab-case，标识不重复。name 是 1 到 64 字节，不能有控制字符。difficulty 是 easy、medium 或 hard，按字节逐个比较。

这三个名字就是值 0、1 和 2。选定该级别的席位把这个值用作它的收入规则，也就是游戏已经在用的同一难度。

全图视野

fullAwareness 是 true 或 false。不写则为 false。带这个标志的大脑能看见迷雾里的席位看不见的单位，做法与内置电脑玩家相同，而且它的选址检查不需要一个放置玩家。这个标志允许用于网络游戏。资料库显示 能看到地图上的每个单位，与Total Annihilation自带的电脑玩家相同。这个标志是清单自己的。它不由包的标识授予，也不是只给 Classic 的那些东西之一。

大脑在哪里运行

只有把电脑玩家入座的那台机器需要这个包，也只有那台机器运行脚本。席位是这台机器的电脑玩家。人类席位会被拒绝。game.mode 是 skirmish、campaign 或 network。

席位所打的大脑不是模拟哈希的输入。两场对局若只有入座的大脑不同，对局状态哈希保持相同。模组的 ai.* 规则值是该哈希所覆盖的模组配置的一部分，因此它们仍然到达每一台机器。

运行时的额度

大脑作为 Lua 在一个沙箱里运行。两个大脑不共享模块、不共享全局变量、也不共享额度。脚本没有文件、没有时钟、没有环境、没有进程、也没有网络。每一块都按文本加载。pcall 和 xpcall 不能让一个已经用尽的阶段继续活着。一个回合是一次计入额度的调用，在席位的控制器点上，单位清扫之后。钩子给出的命令在下一个 tick 生效。

大脑失败时

大脑会因钩子或计时器中的错误、用尽的指令额度、实时兜底、Lua 内存上限、超过 65,536 字节的字符串，或席位拒绝的一次加载而停下。失败的回合在返回之前关闭沙箱并清掉钩子。这个失败的回合仍算已经打过。下一个命令 tick 没有钩子，因此由内置电脑玩家接手。被拒绝、启动失败或不适配的大脑从来没有钩子，所以那个玩家从一开始就打。提示使用清单名字和理由，截到 160 字节：

- `{brain} stopped ({reason}); the engine plays this seat on`
- `{brain} could not start ({reason}); the engine plays this seat`
- `{brain} does not fit this game ({reason}); the engine plays this seat`

席位自己没有理由时，理由是 the brain could not be seated。被击败的玩家只是不再被调用。沙箱随对局关闭。