Моддинг · для авторов карт, модов, мутаторов и мозгов

Моддинг

Набор карт — это один файл .oamap, мод — один файл .oamod, мутатор — один файл .oamut, а мозг — один файл .oabrain: zip-архив с манифестом в корне. Игра проверяет манифест, устанавливает пакет под его id и играет по объявленным в нём правилам. Это руководство проведёт вас от папки до выпуска в каталоге, а каждая глава ссылается на стандарт в документации движка, который она кратко пересказывает.

Начать с набора карт Сделать мутатор Сделать мозг Устройство мода Стандартные доработки

Быстрый старт: набор карт

# одна папка, внутри ваши карты, в корне манифест
my-maps/
  oamap.yaml
  Ridge.tnt  Ridge.ota
  Long Lakes.tnt  Long Lakes.ota

# oamap.yaml
oamap: 1
id: my-maps
name: My Maps
version: "1.0"
author: {name: A. Mapper}
packaging: {revision: 1, date: 2026-10-18, packager: A. Mapper}

# проверка и упаковка, индекс пишется автоматически
$ oa-tool pack my-maps/ -o my-maps.oamap

Быстрый старт: мод

# мод, который поднимает лимит юнитов и включает два общих правила
oamod: 1
id: small-mod
name: Small Mod
version: "1.0"
author: {name: A. Modder}
packaging: {revision: 1, date: 2026-10-04, packager: A. Modder}

limits:
  units-per-player: {default: 500, max: 1000}

hacks:
  units.id-reuse-delay: true
  economy.deterministic-wind: true

# всё, что файл не указывает, работает как в 3.1c
$ oa-tool pack small-mod/ -o small-mod.oamod

Быстрый старт: мутатор

# Commander Radar от Drinken: одна папка, манифест в корне
commander-radar/
  oamut.yaml
  mutator.lua

# mutator.lua: одно правило, параметр radar выбирает дальность
function mutate(ctx)
  local distance = ctx.options.radar == "none" and 0 or 2880
  return {
    rules = {
      where { commander = 1, bmcode = 1 }:change {
        radardistance = set(distance),
      },
    },
  }
end

# упакуйте снаружи папки, затем проверьте .oamut
$ oa-tool mutator pack commander-radar
$ oa-tool mutator check commander-radar-1.oamut

Быстрый старт: мозг

# Steady Commander: одна папка, манифест в корне
steady-commander/
  oabrain.yaml
  brain.lua

# oabrain.yaml
oabrain: 1
id: steady-commander
name: Steady Commander
version: "1.0"
author:
  name: Ridge Workshop
description: "Builds a little economy, then a factory, and sends a squad when it is ready."
tags:
  - economy
  - teaching
works-with:
  - "*"

# упакуйте папку, затем проверьте .oabrain с игрой
$ build/oa-tool brain pack brains/examples/steady-commander --out /tmp/brain-scratch/steady-commander.oabrain
$ build/oa-tool brain check /tmp/brain-scratch/steady-commander.oabrain --game-dir "$OA_GAME_DIR"

Моддинг

От папки до игры у игрокаинтерактивная схема

Устройство набора карт

Устройство мода

Сделать мутатор

Примеры на Lua

Перенос старого мутатора

Проверка, упаковка и публикация

Сделать мозг

Lua мозга

Classic: разбор примера

Обученные сети

Проверка, упаковка и публикация мозга

Стандартные доработки

Расширения скриптов

Версии и выпуски