Сделать мозг

Что такое мозг

Собственный компьютерный игрок движка остаётся игроком по умолчанию и остаётся в движке. Мозг играет за одно место компьютера, и только за то, на которое его поставил игрок. Пустой id мозга — это и есть встроенный игрок. Место без мозга, мозг, который не подходит, и мозг, который остановился, — во всех этих случаях играет тот же встроенный игрок. Classic написан на Lua и играет так же, как этот игрок. Это документация встроенного игрока, а не замена ему.

Скрипт выполняет только машина, которая размещает компьютерного игрока, поэтому другим игрокам ничего устанавливать не нужно. Их машины отражают юниты этого места. При воспроизведении записи скрипт не выполняется. Мозг — это исходный код Lua и данные. У него нет нативного кода, файлов, сети и часов. Полный обзор — флаг в манифесте. Мозг может его установить и играть с ним в сетевой игре, а место показывает этот флаг.

Пакет

Мозг — это один файл .oabrain или папка, в которую он распаковывается. Манифест — тот же строгий YAML, что и профиль мода: один документ, одно отображение верхнего уровня, без якорей и блочных скаляров. В корне пакета лежит oabrain.yaml. Каждый файл рядом с ним должен быть одним из перечисленных ниже. Файл вне этого списка отклоняется.

При сравнении регистр букв ASCII не учитывается, кроме случаев, когда стандарт требует совпадения байтов. brain.lua не входит в список, если entry называет другой файл. Один файл Lua — не больше 1 МиБ. Значок — квадратный PNG, каждая сторона не больше 256 пикселей, размер не больше 256 КиБ. OA устанавливает мозг в Brains/, в папку с id из манифеста.

Манифест

Парсер собирает все нарушенные правила и при любом нарушении оставляет манифест без изменений. Ключ, которого нет в стандарте, отклоняется. Ключу профиля место в моде. Ключ мутатора отклоняется как ключ мутатора. Версию берите в кавычки, потому что 1.0 без кавычек — это число, а звёздочку — потому что звёздочка без кавычек — это псевдоним YAML.

Девять тегов

Тег — один из этих девяти, сравнение побайтовое. Больше четырёх тегов, когда общее правило тегов уже пройдено, — отдельная ошибка. Тег не из этих девяти отклоняется.

Уровни и сложность

levels — это список из 1–6 отображений. Каждое — ровно id, name и difficulty, все обязательны. id — kebab-case строчными буквами длиной от 1 до 32 байт, без повторов. name — от 1 до 64 байт без управляющих символов. difficulty — easy, medium или hard, побайтово.

Эти три имени соответствуют значениям 0, 1 и 2. Место, на котором выбран уровень, использует это значение для правил дохода — ту же сложность, что игра уже использует.

Полный обзор

fullAwareness — true или false. Если нет, то false. Мозг с этим флагом видит юниты, которые место в тумане войны не увидело бы, как и встроенный компьютерный игрок, и его проверкам площадок не нужен размещающий игрок. Флаг разрешён в сетевой игре. Библиотека показывает Видит все юниты на карте, как и компьютер самой Total Annihilation. Флаг принадлежит самому манифесту. Он не выдаётся по id пакета и не входит в то, что дано только Classic.

Где выполняется мозг

Пакет нужен только машине, которая размещает компьютерного игрока, и только эта машина выполняет скрипт. Место — это компьютерный игрок этой машины. Место человека отклоняется. game.mode — skirmish, campaign или network.

Мозг, который играет за место, не входит в хеш симуляции. Два матча, которые отличаются только тем, какой мозг сидит на месте, дают один и тот же хеш состояния матча. Значения доработок ai.* мода входят в профиль мода, который покрывает этот хеш, поэтому они всё равно доходят до каждой машины.

Бюджеты среды выполнения

Мозг выполняется как Lua в одной песочнице. Два мозга не делят модулей, глобальных переменных и бюджетов. У скрипта нет файлов, часов, окружения, процессов и сети. Каждый чанк загружается как текст. pcall и xpcall не могут продлить исчерпанную фазу. Ход — это один вызов за счёт банка инструкций в точке контроллера места, после обхода юнитов. Приказы, отданные хуком, вступают в силу на следующем тике.

Когда мозг даёт сбой

Мозг останавливается из-за ошибки в хуке или таймере, исчерпанного лимита инструкций, предохранителя реального времени, предела памяти Lua, строки длиннее 65 536 байт или загрузки, которую отклоняет место. Неудачный ход закрывает песочницу и очищает хуки до того, как этот ход вернёт управление. Неудачный ход всё равно считается сыгранным. На следующем тике приказов хуков нет, поэтому его берёт встроенный компьютерный игрок. У мозга, который отклонён, не смог запуститься или не подходит, хуков нет вовсе, поэтому этот игрок играет с самого начала. Уведомление использует название из манифеста и причину, обрезанную до 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. Побеждённого игрока просто перестают вызывать. Песочница закрывается вместе с матчем.