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

Моддинг

Набір мап — це один файл .oamap, мод — один файл .oamod, мутатор — один файл .oamut, а мозок — один файл .oabrain: zip-архів із маніфестом у корені. Гра перевіряє маніфест, установлює пакет за його ідентифікатором і грає за оголошеними в ньому правилами. Цей посібник проведе тебе від теки до випуску в каталозі, а кожен розділ посилається на стандарт, який він стисло викладає, у власній документації рушія.

Почати з набору мап Створити мутатор Створити мозок Будова моду Стандартні хаки

Швидкий старт: набір мап

# одна тека, твої мапи всередині, маніфест у корені
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: розібраний приклад

Навчені мережі

Перевірити, запакувати й опублікувати мозок

Стандартні хаки

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

Версії та випуски