TA: Kingdomsのマップ — .tnt + .ota + .crt + .kmp

TA: Kingdomsのマップは、1つか2つのメタデータファイルを伴ったTNTの変種（IDVersionのワードが異なる）で、それに加えて、シングルプレイのミッション用にHPI v2のキャンペーンアーカイブ形式があります。これは、以前の「BTM/ハイトマップBMP」という調査メモが示していたよりも、TAのマップモデルにずっと近いものです。実際にGoG版TA:Kのインストールを見ると、.btmもサイドカーのBMPもまったく存在しません。

kbotの既存のHPI v2リーダーは、.kmpアーカイブをそのまま扱えます。kbotのTNTリーダーはTA:Kのバージョンワードを認識し、ヘッダー、DataUnitのハイトマップ、テクスチャマッピングのグリッド（地形名とU/Vオフセットのテーブル）、地形物の配置グリッドと名前テーブル、埋め込みのミニマップを復号します。外部の地形JPGと地形物のGAFスプライトを合成すれば、マップ全体をフル解像度で描画するのに十分です。このページでは、出荷されたインストールから検証できることと、まだ残っている空白部分を説明します。

TA:Kのマップを構成するファイル#

GoG版のインストールのmapsディレクトリで数えた結果です。

典型的なマルチプレイ用のマップは.tnt、.ota、.txtの3つ組で出荷され、.crtのサイドカーが付くこともあります。キャンペーンのミッションは、同じ組み合わせにミッションスクリプトを加えた.kmpアーカイブに詰められています。

# The HPI v2 reader handles .kmp transparently
kbot hpi list /path/to/tak/maps/adamantine\ gate.kmp -v
kbot hpi info /path/to/tak/maps/adamantine\ gate.kmp

.tnt — TA:Kの地形（TNT v2）#

TA:KはTAのTNTの構造を流用していますが、IDVersionのワードを上げています。abnar's terrace.tntの16進ダンプです。

00000000: 00 40 00 00 20 01 00 00 e0 00 00 00 3a 00 00 00   .@.. .......:...
00000010: 34 00 00 00 34 fc 00 00 34 f4 02 00 16 00 00 00   4...4...4.......

最初のuint32は、0x00004000という値です（TAのTNTは0x00002000を使います）。コンテナは今でもヘッダーと、ポインターで位置を示すセクションの並びですが、TA:Kはタイルモザイクの形式ではまったくありません。TAがタイルインデックスのグリッドと32×32のタイル画像の集合を格納するのに対し、TA:Kは地形を、外部のJPGテクスチャを参照するテクスチャマッピングのグリッドとして格納し、それとは別にハイトマップと地形物の配置グリッドを持ちます。以下はすべて、出荷された55のマップで検証済みです。

1. Width/Heightはピクセル数ではなく、16pxのDataUnitの数です。athri cayのような「15 × 15」のマップはWidth = Height = 480のDataUnitを格納しており、一辺は480 × 16 = 7680 pxになります。ハイトマップと地形物グリッドはDataUnitごとにサンプリングされます。地形はそれより粗い32pxのGraphic Unitグリッドでサンプリングされ、これは各軸でDataUnitのグリッドのちょうど半分です（guW = Width/2）。
2. ヘッダーは連続する12個のuint32からなり、オフセットと数が入っています。TAのフィールド名は、もはや中身を表していません。下の表にTA:Kでの意味を示します。
3. セクションのポインターは絶対位置です。そのため、各セクションはそれぞれのポインターと、計算した長さで読みます。

ハイトマップ（0x10）はDataUnitごとに1バイトで、カラーのビットマップではなく、グレースケールの標高データです。地形はテクスチャマッピングによって再構成されます。Graphic Unitごとに、地形名テーブル（0x20）がテクスチャファイル（terrain/<name>.jpg。名前は小文字の8桁の16進数）を与え、U/Vテーブル（0x24/0x28）が、そのJPGの(u×32, v×32)からコピーする32×32のサブタイルを与えます。地形物グリッド（0x14）は配置のレイヤーです。uint16のWidth × Height配列で、各マスは名前テーブルへの地形物インデックスか、「ここに地形物はない」を意味する大きな番兵値（≥0xFF00）のどちらかです。配置先のDataUnitのマス(x, y)は、地形のピクセル(x×16, y×16)に対応します。名前テーブル（0x18）は、TAのTileAnimテーブルと同じ132バイトの項目配置を使います。

ミニマップのブロックは、出荷されたデータ全体で常に126 × 126です。正方形でないマップの外側の余白には、TAと同じ0x64のボイドバイトを使います。

ミニマップのパレット — 王国ごとに1つ#

TA:Kはミニマップを、単一の共通パレットで色付けしてはいません。各マップは126 × 126のプレビューを、そのマップが属する王国のテクスチャパレットに合わせて焼き込んでいます。王国は、隣にある.otaのkingdom=フィールド（aramon / taros / veruna / zhon / creon）で決まります。同じインデックスを間違った王国のパレット（あるいはTAのPALETTE.PAL）で描画すると、斑点だらけのノイズになります。正しいパレットで描画すれば、自然な水、浜辺、地形が現れます。

kbot tnt minimapは、隣にある.otaから王国を自動的に判定します。.otaがない場合（単体の.tntなど）は、--kingdom <name>を明示的に渡してください。

kbot tnt minimap "athri cay.tnt" -t mini.png          # auto: veruna
kbot tnt minimap loose.tnt --kingdom aramon -t mini.png

.ota — マップのメタデータ（TDF。ほぼおなじみの形）#

TA:Kの.otaはTAのものと同じTDFの形をした形式で、TAK固有のフィールドがいくつか加わっています。abnar's terrace.otaの全体です。

[GlobalHeader]
{
    Copyright=Copyright 1998 Cavedog Entertainment. All rights reserved.;
    missionname=Abnar's Terrace;
    missiondescription=9 x 7  4 Player  32MB;
    kingdom=veruna;          // ← TA:K-specific: the side the map "belongs" to
    numplayers=4;
    size=9 x 7;              // ← TA:K-specific: free-text size for the lobby
    memory=32 MB;            // ← TA:K-specific: ~RAM requirement for the lobby
    hasscenario=0;
    [Map Data]
    {
        Type=Network 1;
        aiprofile=DEFAULT;
        [specials]
        {
            [special0] { specialwhat=StartPos1; XPos=37;   ZPos=190; }
            [special1] { specialwhat=StartPos2; XPos=215;  ZPos=38;  }
            …
        }
    }
}

それ以外（StartPos1..N、aiprofile=など）は、TAとまったく同じように働きます。kbot mountのOTAビューアーは、変更なしで両方を扱えます。

.kmp — キャンペーンミッションのHPI v2アーカイブ#

.kmpは、名前を変えたHPI v2アーカイブです。adamantine gate.kmpの先頭の16進ダンプです。

00000000: 48 41 50 49 00 00 02 00 57 32 02 00 77 00 00 00   HAPI....W2..w...
00000010: 15 32 02 00 42 00 00 00 20 00 00 00 00 00 00 00   .2..B... .......
00000020: 53 51 53 48 …                                     SQSH…

v2のヘッダーの形そのものです（HAPIマーカー → 0x00020000のバージョン → 24バイトのv2ヘッダー → SQSHチャンク）。kbot hpi list、info、extractはどれもそのまま使えます。各.kmpには、ふつう次のものが入っています。

• ミッションの.tntと.ota
• ムービーやブリーフィング用のGAFがいくつか
• ミッションスクリプトのCOBファイル。TA:Kは、別のスクリプト言語ではなく、COB形式（VersionSignature == 6）をミッションスクリプトに流用しています。製品版TAKのインストール全体にある3,885か所のMISSION_COMMAND（0x10073000）オペコードは、ここにあります。バイナリ形式と、ミッションコマンドがインデックスで参照するCOBごとのサウンド名の文字列プールについては、cob.mdのTA: Kingdoms — COB v6の差分と付録Cを参照してください。
• ミッションごとのユニットの上書き（ある場合）

.crt — シナリオスクリプト（ユニット、ルール、トリガー）#

.crtは、マップのスクリプト層を担います。プレイ開始前に配置されるユニット、スカーミッシュのAIとキャンペーンの目標を動かすプレイヤーごとのルールエンジン、そしてそれらのルールが参照する名前付きの長方形のトリガー領域です。マルチプレイ用のマップには空のスタブが付いています（ユニットなし、空のプレイヤースロットが9つ、トリガーなしで56バイト）。キャンペーンや特別なマップでは全セクションが埋まっており、大きさは最大で約120 KBになります。

ファイル全体がリトルエンディアンで、エンジンのメモリ上の構造体をそのまま写したものです。そのため、ユニットのレコードには、初期化されていない埋め草のフィールドがいくつか含まれます。

ヘッダー#

abnar's terrace.crt（空のスタブ）の先頭は次のとおりです。

00000000: 00 00 80 3f 00 00 00 00 00 00 00 00 09 00 00 00

1.0f、Unknown1 = 0、UnitCount = 0、続いてプレイヤー数の9です。

ユニットのレコード（各568バイト）#

プレイヤー、ルール、条件、アクション#

ユニットの後にはuint32のプレイヤー数（常に9）があり、その数だけプレイヤーのブロックが続きます。各プレイヤーのブロックは、uint32のルール数と、その数だけのルールからなります。ルールは次のとおりです。

• uint32の条件数。その後の各条件は、uint32のオペコードと64バイトの引数スロット5つからなります。
• uint32のアクション数。その後の各アクションは、uint32のオペコードと64バイトの引数スロット5つからなります。

トリガー#

末尾にあるuint32のトリガー数の後に、その数だけトリガーのレコードが続きます。各レコードは、256バイトのNUL終端の名前と、マップのマス単位で表した4つのuint32の境界（Left、Top、Right、Bottom）からなります。名前は人が読める文字列です（The Hill、Player 1）。

ツール#

kbot crt describe <map.crt>は、ユニットの種類の内訳、ルールの数、トリガー領域を表示します。配置の全一覧を見るには--verboseを付けます。MCPのcrt_describeツールは、同じデータをJSONで返します。

1つのファイル（cairbray coast landing.crt）だけは、手で編集されてずれたヘッダーを持っており、この配置に合いません。パーサーはこれを誤って復号するのではなく、わかりやすいエラーで拒否します。

.txt — 自由記述の説明文#

ロビーで使われる1行のASCII文字列です。たとえばabnar's terrace.txtは9 x 7 4 Player 32MBです（.otaのmissiondescriptionと同じ文字列）。おそらく制作ツールが書き出しの際に両方を書いたのでしょう。ゲームが表示するのは.otaの値のようです。

現時点でのTA:Kマップの扱い方#

手間の少ない順に、実用的な選択肢を挙げます。

1. 自由に調べる — .kmpファイルに対するkbot hpi list/info/extractは、そのまま動きます。.otaと.txtはプレーンテキストです。
2. マップの概要を表示する — kbot tnt describe <map.tnt>は、TA:Kのヘッダー、王国、ハイトマップと地形の寸法、地形物の内訳を報告します。
3. ミニマップを描画する — kbot tnt minimap <map.tnt> -t mini.pngは、埋め込まれた126 × 126のプレビューをトゥルーカラーで書き出します。王国のパレットは隣の.otaから自動で選ばれます（--kingdomで上書きできます。上のパレットについての説明を参照してください）。
4. テクスチャ付きのマップ全体を描画する — kbot tnt preview <map.tnt> --vfs <flattened-tak-root> -t map.pngは、インストールのterrain/*.jpgから地形をテクスチャマッピングし、各地形物のGAFスプライトを合成して、ゲームが描画するとおりのマップを作ります（athri cay → 7680 × 7680）。地形物のスプライトのパレットは、palettes/<kingdom>_features.pcxから読みます。
5. ハイトマップを描画する — kbot tnt image <map.tnt> -t height.pngは外部のアセットを必要とせず、DataUnitのグレースケールのハイトマップを出力します（--featuresを付けると、カテゴリ別に色分けした配置マーカーを重ねます）。
6. キャンペーンアーカイブをまとめ直す — kbot hpi packは今のところv1しか作れないので、まとめ直した.kmpは読み込みに失敗します。kbotがv2の書き込みに対応するまでは、.kmpを展開して単体のファイルを変更し、v2に対応したサードパーティのパッカーを使って、手作業で編集してください。

kbotが現在TA:Kのマップに対してできること、できないこと#

❌の項目へのプルリクエストを歓迎します。ハイトマップ、テクスチャマッピングのグリッド、地形物グリッド、地形物テーブルはすべて復号できているので、地形と地形物はフル解像度で描画されます。残っている空白は、編集したTA:Kマップをラウンドトリップさせるための書き込み経路と、v2の.kmpへまとめる処理です。

関連項目#

• HPI — v2のアーカイブコンテナ（.kmpは拡張子を変えたHPI v2です）。
• TNT — TAのTNT形式。TA:Kはその構造を、0x4000のIDVersionで流用しています。
• TDF — .otaの解析に使う形式。
• GAF — TA:K全体で使われる.tafアニメーションファイル（.kmpアーカイブ内のムービー）。
• TA: KingdomsのGUI — メニューとHUDのウィジェットの形式。
• 用語集 — 陣営、ハイトマップ。