MOD制作情報 · マップ制作者、MOD作者、ミューテータ制作者、ブレイン作者向け

MOD制作情報

マップパックは1つの.oamapファイル、MODは1つの.oamodファイル、ミューテータは1つの.oamutファイル、ブレインは1つの.oabrainファイルで、いずれも最上位にマニフェストを置いたzipです。ゲームはマニフェストを検証し、パッケージをIDごとにインストールして、宣言されたルールどおりにプレイします。このガイドはフォルダーからカタログのリリースまでを順に案内し、各章からはエンジン自身のドキュメントにある元の規格へリンクしています。

マップパックから始めるミューテータを作るブレインを作る MODの構造標準ハック

クイックスタート：マップパック

# フォルダー1つ、中にマップ、最上位にマニフェスト
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

クイックスタート：MOD

# ユニット上限を引き上げ、共通ルールを2つ有効にするMOD
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

クイックスタート：ミューテータ

# DrinkenのCommander Radar：フォルダー1つ、最上位にマニフェスト
commander-radar/
  oamut.yaml
  mutator.lua

# mutator.lua：ルール1つ。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：フォルダー1つ、最上位にマニフェスト
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"

MOD制作情報

フォルダーからプレイヤーのゲームまでインタラクティブなフロー図

マップパックの構造

MODの構造

ミューテータを作る

Luaの例

旧式ミューテータの移植

確認、パック、公開

ブレインを作る

ブレインのLua

実例：Classic

学習済みネットワーク

ブレインの確認、パック、公開

標準ハック

スクリプト拡張