RTS Terrain Studio

マップの構造

クラシック RTS ゲームのマップエディターを使ったことがあれば、ここで紹介する考え方の多くはなじみがあるはずです。マップは正方形のセル（デフォルトでは幅 2 m）が並んだグリッドです。セルの角は頂点と呼ばれ、ほとんどのデータは頂点ごとに、またはマップ全体を覆う高解像度テクスチャに保存されます。

シーン内では、マップは RTSTerrain コンポーネントを持つゲームオブジェクト上に存在します。メニュー GameObject ▸ RTS Terrain Studio ▸ RTS Terrain を使うと、サブシステムのコンポーネント（RTSVegetationRenderer、RTSWaterRenderer、RTSDecorManager）も追加されます。地形は、プロジェクト内の .rtsmap ファイル（RTSMapAsset）からマップを読み込みます。表示されるチャンクメッシュ、草、水は、そのファイルから生成されます。これらがシーンに保存されることはないため、シーンのサイズは小さいままです。

最初の 5 分間

すべての機能が動作する様子を最も手早く確認できる方法です。パッケージをインポートする以外に、セットアップは必要ありません。

1. Tools ▸ RTS Terrain Studio ▸ Validate Project を開き、Fix All をクリックします。これにより、URP、戦場の霧のレンダラー機能、水が使用するカメラテクスチャ、カラースペースが設定されます。実際に変更が行われる前に、確認ダイアログで変更内容が説明されます。
2. Tools ▸ RTS Terrain Studio ▸ Create Demo Content を実行します。テクスチャ、モデル、タイルセット、マップ、シーンの生成中は進行状況バーが表示されます。完了すると、プロジェクトウィンドウで RTS Terrain Studio - Gameplay Demo シーンが選択された状態になります。
3. そのシーンをダブルクリックして開き、Play をクリックします。
4. マウスの左ボタンでユニットを選択し（クリック、またはボックスをドラッグ）、地面を右クリックして移動させます。WASD キーまたは矢印キーでパンし、マウスホイールでズームします。F1 キーを押すと、すべての操作方法が表示されます。
5. 再生モードを停止し、RTS Terrain Studio - Editor Playground シーンを開きます。Tools ▸ RTS Terrain Studio ▸ Editor Window を開いてツールを選択し、シーンビューでペイントします。Shift キーを押したままにすると、逆の操作になります（たとえば、上げる代わりに下げます）。Ctrl+Z キーで元に戻せます。
6. RTS Terrain Studio - In-Game Editor Demo シーンを開き、Play をクリックします。これが、ゲームのプレイヤーが使用するエディターです。F5 キーを押すとユニットを使ってマップをテストプレイでき、F2 キーを押すとエディターの表示と非表示を切り替えられます。

どこから始めるか

主な機能

以下の編集ツールはすべて、Unity エディターとゲーム内エディターの両方に用意されています。どちらも同じツールクラス（RTSTool のサブクラス）を使用しているためです。この一覧に記載している名前は、ユーザーインターフェースに表示される名前と同じです。

設計方針の概要

RTS 向けの地形ツールについて特によく寄せられる質問と、それぞれに対する RTS Terrain Studio の答えをまとめました。

API の概要

API がどのようなものかをつかめるよう、プログラマー向けに完全なスクリプトを 1 つ紹介します。このスクリプトは、クリックした地点について地形に問い合わせ、組み込みの経路探索エンジンでその地点までの経路を計画します。コライダーや追加のコンポーネントは不要です。RTSTerrain があるシーン内の任意のゲームオブジェクトに追加するだけで動作します。

using System.Collections.Generic;
using RTSTerrainStudio;
using UnityEngine;

/// <summary>Click on the ground: logs what the terrain knows about that point and plans a path to it.</summary>
public class ClickInfoExample : MonoBehaviour
{
    // Reused for every click, so no new list is allocated each time.
    readonly List<Vector3> path = new List<Vector3>();

    void Update()
    {
        // RTSInput works with the Input System package and with the old Input Manager.
        if (!RTSInput.GetMouseButtonDown(0) || Camera.main == null) return;

        Ray ray = Camera.main.ScreenPointToRay(RTSInput.PointerPosition);

        // Analytic ray cast against every RTSTerrain in the scene. Colliders are not needed.
        if (!RTSTerrain.RaycastAll(ray, out RTSTerrainHit hit)) return;
        RTSTerrain terrain = hit.terrain;

        // Gameplay questions, answered from the map data and the pathing map.
        int level = terrain.GetCliffLevel(hit.point);
        bool buildable = terrain.IsBuildable(hit.point);
        bool water = terrain.IsWater(hit.point, out float depth);
        Debug.Log($"Cell {hit.cell}: cliff level {level}, buildable {buildable}, water {water} ({depth:0.00} m)");

        // Built-in Burst A* on the pathing map, for a unit with a radius of 0.6 m.
        PathStatus status = RTSPathfinder.FindPath(terrain, transform.position, hit.point,
                                                   PathRequestOptions.ForUnit(0.6f), path);
        Debug.Log($"Path from {name}: {status}, {path.Count} waypoints");
    }
}

PathStatus は Success、Partial（到達可能な最も近い地点までの経路）、NoPath、InvalidStart のいずれかです。API 全体については、スクリプティングガイドの章で説明しています。

動作要件

フォルダー構成

パッケージは 1 つのフォルダーにまとまっており、デフォルトでは Assets/RTSTerrainStudio です。このフォルダーは移動や名前の変更が可能です。エディターは RTSTerrainStudio.Runtime.asmdef の場所からパッケージのルートを特定し、デモコンテンツとドキュメントはそこからの相対位置で検出されます。

RTSTerrainStudio/
├── Runtime/                 Core, rendering, tools and runtime systems (RTSTerrainStudio.Runtime)
├── Editor/                  Editor window, Scene View, inspectors, setup, demo content (RTSTerrainStudio.Editor)
├── Shaders/                 URP shaders and HLSL includes
│   ├── Hidden/              Internal shaders (fog blur, minimap fog, gizmos, texture array blit)
│   └── Include/             Shared HLSL (fog of war, brush cursor, wind, terrain, vegetation, water)
├── Samples/
│   ├── Scripts/             Sample gameplay: camera, units, selection, orders, minimap, HUD (RTSTerrainStudio.Samples)
│   └── Scenes/              Demo scenes (created by Create Demo Content)
├── Integrations/
│   ├── Mirror/              Multiplayer (compiled only with Mirror)
│   ├── AStarPathfinding/    A* Pathfinding Project (compiled only with A* Pro 5.4.4+)
│   └── UnityNavMesh/        Unity AI Navigation (compiled only with com.unity.ai.navigation 2.0+)
├── Content/                 Generated demo content (empty until you run Create Demo Content)
├── Resources/
│   └── RTSTerrainStudio/    Runtime UI style sheets and theme, shader references, panel settings
├── Documentation/           This manual (index.html) and its images
└── Tests/
    └── Editor/              EditMode unit tests (RTSTerrainStudio.Tests.Editor)

同梱内容

このパッケージは、ソースコード、シェーダー、このマニュアルで構成されています。テクスチャ、モデル、タイルセット、マップ、シーンといった視覚的なコンテンツはすべて、スクリプトによって手元のマシン上で生成されます。これによりダウンロードサイズを小さく抑えられ、コンテンツにもコードとまったく同じライセンスが適用されます。

デモマップ

3 つのマップはすべて、セルサイズ 2 m、崖レベルの高さ 2 m で、Summer タイルセットを使用しています。

マップ	サイズ	対称	説明
Two Rivers (1v1).rtsmap	128 × 128 セル	Rotate 2	プレイヤー 2 人、川 2 本のマップ。川のいたるところに浅瀬があって渡ることができ、中央の湖は深くなっています。スロープを上ると、遺跡や放棄された野営地のある、森に覆われた台地に出ます。
Four Kingdoms (4p).rtsmap	192 × 192 セル	Rotate 4	4 つの王国が、それぞれ独自の高地に位置しています。スロープを下ると共有の低地に出ます。中央は、古い神殿の遺跡がある汚染された大地です。
Sandbox.rtsmap	96 × 96 セル	None	ツールを試すための、ほぼ平坦な小さいマップ。

アイコン

エディターウィンドウ、インスペクター、ゲーム内エディターのアイコンはすべて RTSIcons によってプロシージャルに描画されます。そのため、どのサイズでも鮮明に表示され、テクスチャアセットがなくてもビルドで動作します。

インストールとセットアップ

デモシーンを開く

デモシーンは RTSTerrainStudio/Samples/Scenes にあります。プロジェクトウィンドウでダブルクリックして開くか、Welcome ウィンドウの手順 3 で選択して Open をクリックします。

はじめてのマップ

マップはシーン内の RTS Terrain ゲームオブジェクト上に存在し、プロジェクト内の .rtsmap ファイルに保存されます。シーンはこのファイルを参照するだけで、編集内容はファイルに保存されます。自由に試せるように、新しいシーンから始めます。

1. File ▸ New Scene を選択し、URP のシーンテンプレート（たとえば Basic (URP)）を選びます。
2. Ctrl+S キーで、すぐにシーンを保存します（たとえば Assets/MyMaps/FirstMap.unity として）。新しいマップファイルは保存したシーンと同じ場所に作成されるため、マップとシーンをまとめて管理できます。

エディターウィンドウを開く

Tools ▸ RTS Terrain Studio ▸ Editor Window を開きます（ウィザードや Welcome ウィンドウから開くこともでき、RTS Terrain のインスペクターにも Open RTS Terrain Studio ボタンがあります）。シーンビューを同時に見られるように、インスペクターの隣にドッキングします。

領域	表示内容
ヘッダー	地形ピッカー、マップ名（ドットは未保存の変更があることを示します）、Save、Save As…、Open…、Reload、ステップ名を表示する Undo / Redo、ヘルプボタン、Editing On / Editing Off の切り替えボタン。
タブバー	8 つのツールカテゴリ（Height、Cliffs、Paint、Vegetation、Decor、Water、Pathing、Markers）と、それに続く Map と Settings。アクティブなツールのカテゴリにはドットが付きます。
ツールページ	大きなツールボタン、アクティブなツールの説明とリアルタイムの状態を表示するカード、Brush カードと Symmetry カード、ツール固有の設定とパレット（レイヤー、崖レベル、プレイヤー、木、装飾オブジェクト）。
ステータスバー	マウスカーソル下のセル、崖レベル、高さ、通行判定と、アンドゥに使用しているメモリ量。

8 つのカテゴリと、それぞれに含まれるツールは以下のとおりです。

キー	カテゴリ	ツール
1	Height	Raise / Lower、Smooth、Flatten、Set Height、Noise、Terrace、Erode
2	Cliffs	Raise / Lower Level、Set Level、Ramp、Cliff Type、Clean Cliffs
3	Paint	Paint Layer、Tile Paint、Fill / Replace、Smooth Paint、Auto Paint
4	Vegetation	Paint Details、Erase Details、Place Trees、Erase Trees
5	Decor	Place Decor、Erase Decor、Select Decor
6	Water	Paint Water、Erase Water、Flood Fill
7	Pathing	Paint Pathing、Clear Pathing
8	Markers	Start Locations、Regions、Markers

各ツールの詳細は、それぞれの章で説明しています（たとえば Height ツールや Cliffs ツール）。ウィンドウ自体については RTS Terrain Studio ウィンドウで説明しています。

はじめてのテストプレイ

マップをプレイする方法は 2 つあります。再生モードで Demo Game を使う方法と、実行中のゲーム内でゲーム内エディターとその Play Test ボタンを使う方法です。

using RTSTerrainStudio;
using UnityEngine;

// Add this component to any GameObject in a scene with an RTS Terrain and an in-game editor.
public class PlaytestStartLogger : MonoBehaviour
{
    void OnEnable()
    {
        // Raised by the in-game editor when a play test starts (true) or stops (false).
        RTSRuntimeEditorEvents.PlaytestChanged += OnPlaytestChanged;
    }

    void OnDisable()
    {
        RTSRuntimeEditorEvents.PlaytestChanged -= OnPlaytestChanged;
    }

    void OnPlaytestChanged(bool playing)
    {
        if (!playing) return;

        // The first enabled terrain of the scene.
        RTSTerrain terrain = RTSTerrain.Main;
        if (terrain == null || terrain.Map == null) return;

        foreach (StartLocation start in terrain.Map.StartLocations)
        {
            // Start locations are stored in map-local coordinates: convert to world space
            // and move the point onto the ground.
            var local = new Vector3(start.position.x, start.position.y, start.position.z);
            Vector3 world = terrain.SnapToGround(terrain.LocalToWorld(local));
            Debug.Log($"Player {start.player + 1} starts at {world}, facing {start.yaw:0} degrees");
        }
    }
}

10 分間チュートリアル：はじめての 1v1 マップ

このチュートリアルでは、2 人用の小さく公平なマップを作成します。各プレイヤーにはスロープ付きの台地の上に拠点があり、川がマップを 2 つに分け、森がマップの周囲を囲みます。対称ペイントによって両側がまったく同じになるため、作るのは半分だけで済みます。

次のステップ

• エディターウィンドウ：Map タブ（サイズ変更、ジェネレーター、ハイトマップのインポートとエクスポート、ミニマップ、環境）を含む、すべてのタブ、カード、設定の詳しい解説。
• ツールの各章（カテゴリごとに 1 章）：Height、Cliffs、Paint、Vegetation、Decor、Water、Pathing、Markers。
• ゲーム内エディター：エディターをゲームに同梱し、プレイヤーがマップを作れるようにする方法。
• スクリプティング：コードから高さ、崖レベル、通行判定を取得したり、ランタイムでマップを読み込んだり、編集に反応したりする方法。
• 連携：Mirror によるマルチプレイヤー、A* Pathfinding Project または Unity NavMesh による経路探索。
• トラブルシューティング：ピンク色のマテリアル、平坦に見える水、ペイント位置のずれなど、よくある問題への対処法。

Project Validator

Tools ▸ RTS Terrain Studio ▸ Validate Project を開くか、Welcome ウィンドウで Validate をクリックします。ウィンドウを開くとすぐにチェックが実行されます。チェック項目は次の 5 つのカテゴリに分かれています。

各結果には、次の 4 つのステータスのいずれかが付きます。

Fix All は、利用できるすべての修正を適用します。最初にダイアログですべての変更内容が一覧表示され、Apply Fixes をクリックするまでは何も変更されません。URP を必要とする修正（カメラテクスチャと戦場の霧のレンダラー機能）はパイプラインの割り当て後に自動的に実行されるため、新規プロジェクトもワンクリックでセットアップできます。Run Again はチェックを再実行します。すべてのチェックとその修正ボタンの一覧は、プロジェクトの検証に記載されています。

コードからのチェックの実行

RTSProjectValidator.RunChecks() は何も変更せずに結果を返し、RTSProjectValidator.FixAll() は修正を適用します。これらはビルドスクリプトや継続的インテグレーション（CI）のジョブで使用できます。次の例のスクリプトは Editor フォルダーに配置する必要があります。

using UnityEditor;
using UnityEngine;
using RTSTerrainStudio.Editor;

// Command line: Unity -batchmode -projectPath <path> -executeMethod ProjectSetupCheck.Run -quit
public static class ProjectSetupCheck
{
    public static void Run()
    {
        // Runs every check. Nothing is modified.
        var results = RTSProjectValidator.RunChecks();

        // Applies every available fix without dialogs, then checks again.
        int applied = RTSProjectValidator.FixAll(results, interactive: false);
        if (applied > 0) results = RTSProjectValidator.RunChecks();

        // Logs warnings and errors ("[Status] Title: Message").
        foreach (var result in results)
            if (result.IsProblem) Debug.LogWarning(result.ToString());

        // Fails the job when a required setting is still missing.
        if (RTSProjectValidator.WorstStatus(results) == RTSValidationStatus.Error)
            EditorApplication.Exit(1);
    }
}

Universal Render Pipeline

このパッケージのシェーダーはすべて URP 用に書かれています。URP がないと、地形、水、植生はピンク色で表示されるか、まったく表示されません。Use URP 修正は、プロジェクト内の URP アセットを使用し（ない場合はレンダラー付きの Assets/Settings/RTS URP.asset を作成し）、それをデフォルトのレンダーパイプラインとして割り当てるとともに、ほかのパイプラインを使用しているすべての品質レベルにも割り当てます。同じことを手動で行うには、次の手順に従います。

1. プロジェクトにまだ URP アセットがない場合は、プロジェクトウィンドウで Create ▸ Rendering ▸ URP Asset (with Universal Renderer) を選択して作成します。
2. Edit ▸ Project Settings ▸ Graphics で、その URP アセットを Default Render Pipeline に割り当てます。
3. Edit ▸ Project Settings ▸ Quality を開きます。Render Pipeline Asset のオーバーライドが設定されているすべての品質レベルについて、そのアセットも URP アセットであることを確認します。

Depth Texture と Opaque Texture

水は、カメラの深度テクスチャを使用して、水深に応じた色、泡、岸辺の柔らかな境界を、水中に立つオブジェクトにも合わせて表示します。屈折には不透明テクスチャを使用します。これらがないと、水の見た目が簡素になります。品質レベルで使用しているすべての URP アセットを選択し、それぞれの Rendering セクションで Depth Texture と Opaque Texture をオンにするか、Project Validator で Enable Both をクリックします。

戦場の霧のレンダラー機能

RTS Fog Of War レンダラー機能（RTSFogOfWarRendererFeature）は、独自のマテリアルを使ったユニットやプロップも含め、画面上のすべてのものの上に霧を描画します。この機能がない場合、霧を表示できるのはパッケージ独自のシェーダーだけです。Add Feature は、使用中のすべての URP アセットのデフォルトレンダラーにこの機能を追加します。手動で追加するには、Universal Renderer Data アセットを選択し、Add Renderer Feature をクリックして RTS Fog Of War を選択します。詳しくはレンダリング：レンダラー機能とシェーダーのフォールバックを参照してください。

カラースペース

このパッケージは、URP のデフォルトである Linear カラースペースを前提に設計されています。Gamma カラースペースでは、スクリーンショットと比べて色、ライティング、水が色あせて見えます。Edit ▸ Project Settings ▸ Player ▸ Other Settings ▸ Color Space を Linear に設定するか、Project Validator で Switch to Linear をクリックします。

必須パッケージ

ランタイムアセンブリは、ジョブとデータモデルに Burst（com.unity.burst）、Collections（com.unity.collections）、Mathematics（com.unity.mathematics）を使用します。これらのいずれか 1 つでも不足していると、パッケージのスクリプトはコンパイルされません。Window ▸ Package Manager ▸ Unity Registry からインストールするか、Project Validator で Install をクリックします。後者の場合、不足しているすべてのパッケージが 1 回のパッケージマネージャーリクエストで追加されます。動作確認済みのバージョンは必須パッケージに記載されています。

入力処理

ランタイムのすべての入力（ゲーム内エディター、サンプルのカメラとユニット）は、静的クラス RTSInput を経由します。Input System パッケージ（com.unity.inputsystem）がインストールされている場合、ランタイムアセンブリは定義シンボル RTS_INPUT_SYSTEM 付きでコンパイルされ、Input System を使用します。それ以外の場合、またはプロジェクトが旧 Input Manager のみを使用している場合、RTSInput は旧来の UnityEngine.Input API にフォールバックします。

この設定は Edit ▸ Project Settings ▸ Player ▸ Other Settings ▸ Active Input Handling にあります。設定を変更すると、Unity からエディターの再起動を求められます。適切な設定はゲームによって異なるため、Input handling チェックがこの設定を自動で変更することはありません。動作要件の入力処理も参照してください。

シェーダーとコンテンツ

• Package shaders compile：パッケージのシェーダーにコンパイルエラーがある場合（該当するオブジェクトはピンク色で表示されます）、Reimport でそのシェーダーを再インポートします。URP の読み込みが完了する前にシェーダーがインポートされた場合は、これで解決します。必要なシェーダーそのものが見つからない場合は、Asset Store からパッケージを再インポートしてください。詳しくはトラブルシューティングを参照してください。
• Shaders included in builds：ゲームのビルドを参照してください。
• Tileset texture arrays built：最新のビルド済み配列がないタイルセットも動作しますが、配列が再ビルドされるまでは、マップの読み込み時にエディターが非圧縮の配列をビルドするため、余分なメモリと読み込み時間がかかります。Build Arrays は、古くなったすべてのタイルセットの配列をビルドします。プレイヤービルドでは、古くなった配列が自動的に再ビルドされます。一度もビルドされていないタイルセットは、ビルドしたゲームでも非圧縮の配列を使用します。詳しくはテクスチャ配列とプレイヤービルドでのテクスチャ配列を参照してください。
• GPU instancing on instanced prototypes：インスタンス描画される木、Mesh モードのディテール、インスタンス描画される装飾オブジェクトのマテリアルでは、Enable GPU Instancing をオンにしてください。オフのままだと、マテリアルの一時的なコピーを介して描画され、インスタンシング用のバリアントがプレイヤービルドから除外される可能性があります。Enable Instancing は、一覧に表示されている編集可能なすべてのマテリアルでこの設定をオンにします。モデルやパッケージ内のマテリアルは読み取り専用のため、先に抽出してください。詳しくは GPU インスタンシングを参照してください。
• Terrains have a tileset：タイルセットのない地形は、ニュートラルなプレースホルダーの外観で表示されます。この修正は、タイルセットのないすべての地形にプロジェクト内のタイルセットを割り当てます（元に戻せます）。詳しくはタイルセットを参照してください。

シーン内の地形のマップファイル

RTS Terrain は、マップを .rtsmap アセット（Map Asset フィールドで指定）に保存します。このアセットがない地形はマップをメモリ上にしか持たないため、シーンを閉じると編集内容が失われます。Terrains save to a map file チェックには、こうした地形が一覧表示されます。Create Map Files は、一覧に表示された各地形の現在のマップを、そのシーンのフォルダー（シーンがまだ保存されていない場合は Assets/Maps）に新しい .rtsmap ファイルとして保存し、その地形に割り当てます。

New Map Wizard やデモコンテンツで作成した地形には、すでにマップファイルがあります。マップアセットや Save、Save As の仕組みについては、マップアセットとマップファイルを参照してください。

ゲームのビルド

Unity は、ビルドに含まれるマテリアルが使用しているシェーダーだけをプレイヤービルドに含めます。RTS Terrain Studio は地形、水、戦場の霧のマテリアルをランタイムでコードから作成するため、これらのシェーダーはパッケージフォルダー内のアセット Resources/RTSTerrainStudio/RTSShaderReferences.asset から参照されています。このアセットは DecorPlaceholder マテリアルも参照しており、これによって URP Lit のインスタンシング用バリアントがビルドに残ります。このアセットは、スクリプトのリロード後、シェーダーのインポート時、プレイヤービルドの前に毎回自動でチェックされ、更新されます。Shaders included in builds チェックが赤の場合は、Update をクリックします。

ビルドする前に、次の項目を順に確認してください。

1. Tools ▸ RTS Terrain Studio ▸ Validate Project を実行し、すべてのエラーと警告を修正します。
2. ターゲットプラットフォームのすべての品質レベルで、Depth Texture と Opaque Texture を有効にした URP アセットが使用されていることを確認します。戦場の霧を使用する場合は、そのレンダラーに RTS Fog Of War 機能が追加されていることも確認します。
3. 地形が読み込み時に配列を非圧縮でビルドしなくて済むように、タイルセットのテクスチャ配列をあらかじめ一度ビルドしておきます（Project Validator の Build Arrays、またはタイルセットのインスペクターの Build Texture Arrays）。古くなった配列は、プレイヤービルドの前に毎回自動で再ビルドされます（以下を参照）。
4. マップでフォグを使用する場合は、Fog kept in player builds チェックが OK であることを確認します（プレイヤービルドでのフォグを参照）。
5. Map タブでマップを検証します（マップの検証を参照）。
6. ビルドプロファイルのシーンリストにシーンを追加します。シーン内の RTS Terrain に割り当てられたマップは、ほかの参照アセットと同様にビルドに含まれます。
7. ゲーム内エディターを同梱してリリースする場合は、ゲーム内エディターのリリースを参照してください。プレイヤーがランタイムで保存したマップは、RTSMapSerializer.StorageRoot（Application.persistentDataPath。Web ビルドではブラウザーのストレージ）内の Maps フォルダーに保存されます。詳しくはランタイムでのマップファイルを参照してください。
8. Managed Stripping Level を Minimal より高く設定していて、独自の編集ツールを作成している場合は、コードストリッピングとカスタムツールを参照してください。
9. Web ビルドの場合は、Web（WebGL）ビルドも参照してください。

プレイヤービルドでのテクスチャ配列

ビルド済みのテクスチャ配列をソーステクスチャと比較できるのはエディターだけなので、ビルドしたゲームはタイルセットのビルド済み配列をそのまま使用します。古い地面テクスチャがビルドに含まれたままリリースされることがないように、以前に配列をビルドしたすべてのタイルセットは、プレイヤービルドの開始直前に次のようにチェックされます。

• テクスチャ、解像度、圧縮設定と一致しなくなった配列や、別のプラットフォームまたは別のテクスチャ圧縮形式向けにビルドされた配列は、通常の圧縮品質で再ビルドされます。処理の進み具合は進行状況バーに表示されます。
• 一度もビルドされていないタイルセットは対象外です。こうしたタイルセットについては、ビルドしたゲームがマップの読み込み時に非圧縮の配列をビルドします。
• 再ビルドがキャンセルされたか失敗し、テクスチャまたは設定が変更されていた場合は、Try Again、Cancel Build、Build Anyway を選べるダイアログが表示されます。形式が異なるだけの配列でも正しいテクスチャが表示されるため、この場合は警告がログに出力されるだけです。
• バッチモードのビルドは、このような場合には停止します。それでもビルドするには、コマンドラインに -rtsAllowOutdatedTextureArrays を追加します。その場合は、タイルセットごとに警告が出力されます。
• グラフィックスデバイスのないエディター（ビルドサーバーでよく使われる -nographics）では、配列をビルドできません。この場合、古くなったタイルセットごとに警告を出力したうえでビルドが続行され、ビルドしたゲームでは最後にビルドされた状態の配列が使用されます。このようなビルドの前に、エディターで配列をビルドしておいてください。
• 配列が再ビルドされるのは、アクティブなビルドプラットフォーム向けの場合だけです。別のプラットフォーム向けにビルドすると、代わりに警告がログに出力されます。先にそのプラットフォームに切り替えてください。
• アセットバンドルや Addressables のコンテンツを単独でビルドする場合、このチェックは実行されません。先に配列をビルドしてください。

ビルド済みの配列は、読み取り可能な状態でタイルセットアセットに保存されます。ビルドしたゲームは、配列を初めて使用するときにこの CPU 側のコピーを解放します。これにより、タイルセット 1 つあたり、512 px で約 14 MB、1024 px で約 56 MB のメモリを節約できます。

プレイヤービルドでのフォグ

RTSEnvironment は、ゲームの実行中にマップに保存されたフォグを有効にします。Unity は、使われていないと判断したフォグモードのシェーダーバリアントを除外します。Project Settings ▸ Graphics ▸ Shader Stripping ▸ Fog Modes が Automatic に設定されている場合、フォグを有効にした状態で保存されたビルドシーンのフォグしか保持されません。RTS Environment は保存の前に毎回シーン本来のフォグ設定を復元するため、RTS Environment が適用したフォグはこの判定に含まれません。その結果、フォグを使うマップでも、ビルドではフォグが表示されなくなってしまいます。

Fog kept in player builds チェックは、アクティブなビルドプロファイルのビルドシーンと開いているシーンを読み取り、そこで RTS Environment が使用しているフォグモードを一覧表示します。Keep Fog Modes（Fix All にも含まれます）は、Fog Modes を Custom に設定し、これらのモードと、すでに保持されていたモードだけを保持します。保持するモードごとにシェーダーバリアントがビルドに追加されるため、使われていないモードは追加されません。アクティブなビルドプロファイルがグラフィックス設定をオーバーライドしている場合は、そのプロファイルの Fog Modes も確認してください。

Web（WebGL）ビルド

RTS Terrain Studio は Web ブラウザーで動作します。地形、植生、水、装飾オブジェクト、戦場の霧、ゲーム内エディター、サンプルのすべてが対象です。ただし、ブラウザーはデスクトップとは動作が異なります。プレイヤーが開けるフォルダーはなく、一部のキーはブラウザーが使用し、すべてのコードは 1 つのスレッドで実行され、ゲーム全体がサイズに上限のある 1 つのメモリヒープを共有します。このセクションでは、こうした違いにこのパッケージがどう対処しているか、そして Web ビルドの作成、テスト、公開の方法を説明します。

手短にまとめると、次のとおりです。

1. File ▸ Build Profiles を開き、Web を選択して Switch Platform をクリックします（または、Web のビルドプロファイルをアクティブにします）。
2. Tools ▸ RTS Terrain Studio ▸ Validate Project を実行し、Fix All をクリックします。Web がアクティブな場合、Project Validator はウィンドウ全体に表示するテンプレートもインストールし、Web ビルドの品質レベルもチェックします。
3. マップでフォグを使用する場合は、Fog kept in player builds が OK になっていることを確認します。
4. Build And Run をクリックします。Unity がゲームをビルドし、ブラウザーで開きます。

using RTSTerrainStudio;
using UnityEngine.Scripting;

// [Preserve] keeps the tool in builds with a high Managed Stripping Level.
[Preserve]
public sealed class CraterTool : RTSTool
{
    // ...
}

using System.IO;
using RTSTerrainStudio;

public static class MyGameFiles
{
    // Kept between sessions on every platform; in Web builds in the storage of the browser.
    static string SettingsPath => Path.Combine(RTSMapSerializer.StorageRoot, "settings.json");

    public static void SaveSettings(string json)
    {
        Directory.CreateDirectory(RTSMapSerializer.StorageRoot);
        File.WriteAllText(SettingsPath, json);

        // Web builds: write the change to the browser storage, so it survives a reload.
        // Does nothing on other platforms.
        RTSWebFileSystem.Flush();
    }

    /// <summary>Lets the player keep a copy of the current map on the computer (Web builds only).</summary>
    public static bool DownloadMap(RTSTerrain terrain)
    {
        if (!RTSWebFileSystem.IsSupported || terrain.Map == null) return false;
        byte[] bytes = RTSMapSerializer.Serialize(terrain.Map);
        return RTSWebFileSystem.DownloadFile("My Map" + RTSMapSerializer.FileExtension, bytes);
    }
}

マップモデル

マップのデータはすべて、MapData クラス（名前空間 RTSTerrainStudio）の 1 つのオブジェクトに格納されます。RTSTerrain コンポーネントは 1 つの MapData（terrain.Map）を所有し、それをチャンクメッシュとしてレンダリングします。また、そこから派生する通行マップを常に最新の状態に保ち、「この地点の地面の高さは？」といったクエリに応答します。

セルと頂点

マップは Width × Height 個のセルから成るグリッドです。各セルには 4 つの角の頂点があり、隣り合うセルは角の頂点を共有します。そのため、4 × 2 セルのマップには 5 × 3 個の頂点があります：

 z
 2   v10 ---- v11 ---- v12 ---- v13 ---- v14
      |  cell  |  cell  |  cell  |  cell  |
      | (0,1)  | (1,1)  | (2,1)  | (3,1)  |
 1   v5 ----- v6 ----- v7 ----- v8 ----- v9
      |  cell  |  cell  |  cell  |  cell  |
      | (0,0)  | (1,0)  | (2,0)  | (3,0)  |
 0   v0 ----- v1 ----- v2 ----- v3 ----- v4
     x=0      1        2        3        4

 vertex index = z * VertexCountX + x      (VertexCountX = Width + 1)

• 頂点レイヤー（微細高さ、崖レベル、フラグ、崖タイプ、水面の高さ）は (Width + 1) × (Height + 1) 個のエントリを持ち、1 行ずつ順に格納されます。インデックスの計算には map.VertexIndex(x, z) を使用してください。
• セルサイズ（map.CellSize、デフォルト 2 m）は、1 セルのワールドサイズです。2 m のセルから成る 128 × 128 のマップは、256 × 256 m（map.WorldSize）の範囲をカバーします。
• ある位置は floor(localXZ / CellSize) のセルに属します。map.LocalToCell(localXZ) はこの計算を行い、結果をマップの範囲内にクランプします。
• レンダリングのために、セルはチャンク単位にまとめられます（1 辺あたり 16、32、または 64 セル。RTSTerrain コンポーネントの Chunk Size 設定で指定し、デフォルトは 32）。再構築されるのは、編集の影響を受けたチャンクだけです。チャンクサイズはマップデータには影響しません。

マップの寸法

寸法はマップの作成時に選択します（New Map Wizard、ゲーム内の New Map ダイアログ、またはコード内の MapCreationSettings）。有効範囲外の値は MapCreationSettings.Validate() によって補正されます。

マップの内容

すべてのデータには、MapLayers 列挙型に対応するフラグがあります。これらのフラグは、変更通知、アンドゥの記録、シリアライズに使用されます。

便利な組み合わせフラグが 2 つあります。MapLayers.Geometry（高さ、レベル、頂点フラグ、崖タイプ）と MapLayers.PathingInputs（通行マップに影響するすべてのデータ）です。MapLayers.All はすべてを対象にします。

通行マップ（terrain.Pathing、PathingMap クラス）は派生データです。上記のレイヤーから計算され、保存されることはありません。詳しくは通行マップを参照してください。

崖レベル、微細高さ、崖タイプ

クラシック RTS の地形には 2 種類の高さがあります。大きく不連続な段差（崖）と、小さく滑らかな起伏（丘）です。RTS Terrain Studio は、この 2 つを頂点ごとに別々に格納します。

崖レベル

• 各頂点には 0～15 の崖レベルがあります（MapData.MaxCliffLevel = 15）。
• 1 レベルの高さは CliffLevelHeight メートルです（デフォルト 2 m）。
• 新しいマップはレベル 2 から始まります。そのため、地面より下には湖、川、峡谷用に 2 レベル、上には台地用に 13 レベルの余地があります。
• レベルは Cliffs ツール（Raise / Lower Level、Set Level、Ramp、Cliff Type、Clean Cliffs）で編集します。
• 戦場の霧（Fog of War）は、視線判定に崖レベルを使用します。ユニットは自分と同じレベルとそれより低い場所を見ることができ、それより高い地形は視界を遮ります。

微細高さ

各頂点には、レベルに加えて、メートル単位の微細高さ（Heights）があり、正の値も負の値も取れます。Height ツール（Raise / Lower、Smooth、Flatten、Set Height、Noise、Terrace、Erode）が変更するのは微細高さだけです。そのため、台地の上に丘を作っても、それが崖に変わることはありません。頂点の地面の高さは次のとおりです：

vertex height = CliffLevels[i] × CliffLevelHeight + Heights[i]      (map-local Y, metres)

例：レベルの高さが 2 m のとき、レベル 3 で微細高さが 0.4 m の頂点は、マップの原点から 6.4 m の高さにあります。map.GetVertexHeight(x, z) と map.GetVertexPosition(x, z) を使えば、この値を自動で計算できます。

崖タイプ

タイルセットには、最大 4 つの崖レイヤー（たとえば「Rock」と「Grassy Cliff」）を用意できます。各頂点には、どの崖レイヤーを使うかが格納されます（CliffTypes、0～3、Cliff Type ツールでペイントします）。崖の壁面には、そのセルの最も高い角の崖タイプが使用されます。崖タイプのインデックスに対応するレイヤーがタイルセットにない場合、壁面には代わりに崖レイヤー 0 が使用されます。

地表の構築方法（基準面）

MapGeometryView 構造体は、地形の唯一の正しい地表を定義します。チャンクメッシュ、ゲームプレイ用のクエリ（GetHeight、Raycast、…）、通行マップ、戦場の霧はすべて同じルールに従うため、見た目どおりの場所をユニットが歩きます。各セルは 4 つの角によって分類されます：

丸みのある輪郭線。崖セル内では、各レベルのしきい値 t について、「角のレベル ≥ t」という指標（1 または 0）がセル全体でバイリニア補間されます。ある点は、補間された指標が 0.5 以上になる最も高いレベルに属します（MapGeometryView.LevelAt）。これはマーチングスクエア方式のルールです。1 つの角だけが高い場合は対角線ではなく 4 分の 1 円になり、長い崖のラインはまっすぐに保たれます。壁面自体は輪郭線の位置で垂直に立ちます。微細高さは常にバイリニア補間されて上乗せされます。これは崖セル内でも同じです。

描画される壁面の見た目は、RTSTerrain コンポーネント（Settings）で調整します：

ビューは map.GetGeometryView() で取得します。ネイティブ配列から成る構造体なので、Burst ジョブに渡すこともできます。すべてのメンバーはマップローカルの位置を受け取ります：

スロープ

スロープを使うと、ユニットはある崖レベルから次の崖レベルへ歩いて移動できます。ルールは単純です：

• フラグは各頂点の VertexFlags.Ramp です。Ramp ツール（ID cliff.ramp）でペイントします。Shift キーを押したままペイントすると、フラグを削除できます。
• スロープセルは、角の高さ（レベル + 微細高さ）の間を結ぶ滑らかなバイリニアの傾斜です。
• スロープはちょうど 1 レベルをまたぐ場合に最もうまく機能します。それより急なスロープも作成できますが、2 レベル以上にまたがるスロープセルがあると、ステータスバーに警告が表示されます。
• 通行判定：有効な 1 レベルのスロープでは、歩行可能かどうかは微細高さによる傾斜だけで評価されます（スロープが橋渡しするレベル間の勾配によって「急すぎる」と判定されることはありません）。スロープは常に建設不可です。
• スロープ上で GetCliffLevel を呼び出すと、補間されたレベルを丸めた値が返されます。下半分では低いほうのレベル、上半分では高いほうのレベルになります。

1. Raise / Lower Level ツールで台地を 1 レベル上げます。
2. Ramp ツールを選択し、スロープを作りたい場所の崖の縁をまたぐようにペイントします。間にあるセルのすべての角にフラグが付くように、ブラシで少なくとも壁面の両側の頂点を覆ってください。
3. 壁面が消えて傾斜が現れます。縁に沿ってさらに頂点をペイントすると、スロープの幅を広げられます。

地面レイヤーとスプラットマップ

地面テクスチャはスプラットマップにペイントされます。スプラットマップは、SplatWidth × SplatHeight テクセルの 4 枚の RGBA テクスチャ（MapData.SplatMapCount = 4）です。16 個のチャンネルはそれぞれ、タイルセットの 1 つの地面レイヤーのウェイトを保持します：

• レイヤー i は、マップ i / 4 のチャンネル i % 4 に格納されます。タイルセットの地面レイヤーがちょうど 16 個なのはこのためです（4 マップ × 4 チャンネル）。
• 16 チャンネル全体で、1 テクセルのウェイトの合計は常に 255 になります。すべての Paint ツールはこの不変条件を維持します。スプラットデータを書き込むコードも、この条件を守る必要があります。
• スプラット解像度は、セルの 1 辺あたりのテクセル数です（デフォルト 4）。2 m のセルでは、0.5 m ごとに 1 テクセルになります。
• テクセル (x, z) の中心は、マップローカルの XZ で ((x + 0.5), (z + 0.5)) × CellSize / SplatResolution の位置にあります。ディテールや通行判定のテクセルにも、それぞれの解像度で同じ式が適用されます。
• ヘルパー：map.SplatIndex(x, z)、map.GetSplatWeight(texelIndex, layer)、map.GetDominantLayer(texelIndex)、MapData.GetChannel / SetChannel、map.FillSplat(layer)。

using RTSTerrainStudio;
using Unity.Mathematics;
using UnityEngine;

public static class SplatExample
{
    /// <summary>Paints one map cell 100 % with a ground layer (like the Tile Paint tool, without undo).</summary>
    public static void PaintCell(RTSTerrain terrain, int2 cell, int layer)
    {
        MapData map = terrain.Map;
        if (map == null || !map.IsValidCell(cell.x, cell.y)) return;
        layer = math.clamp(layer, 0, MapData.MaxGroundLayers - 1);

        int res = map.SplatResolution;
        for (int tz = cell.y * res; tz < (cell.y + 1) * res; tz++)
        {
            for (int tx = cell.x * res; tx < (cell.x + 1) * res; tx++)
            {
                int texel = map.SplatIndex(tx, tz);
                for (int m = 0; m < MapData.SplatMapCount; m++)
                {
                    // All channels 0, except the one of our layer: the sum stays exactly 255.
                    var c = new Color32(0, 0, 0, 0);
                    if (layer / 4 == m) MapData.SetChannel(ref c, layer % 4, 255);
                    map.SplatMaps[m][texel] = c;
                }
            }
        }

        // Tell the terrain which data changed and where (in cells). Textures and pathing update in LateUpdate.
        terrain.NotifyChanged(MapLayers.Splat, new RectInt(cell.x, cell.y, 1, 1));
    }
}

水

• 頂点に VertexFlags.Water フラグがある場合、その頂点は水中にあります。その水面の高さ（マップローカルの Y、メートル単位）は WaterHeights に格納されます。この値は、フラグが設定されている場所でのみ意味を持ちます。
• ある点は、その点が属するセルの 4 つの角のフラグからバイリニアに求めた被覆率が 0.5 以上のとき、水に覆われていると見なされます。水に覆われたセル内にある水のない角には、そのセルで最も高い水面の高さが使用されるため、岸辺でも水面が水平に保たれます。
• 水深 = 水面 − 地面の高さ。通行判定は水深によって決まります。タイルセットの Shallow Depth Limit（デフォルト 0.9 m）より深い水は深水域（歩行不可）、それより浅い水は浅水域（歩行可能、デフォルトでは建設不可）になります。
• Water ツールは Paint Water、Erase Water、Flood Fill です。水の編集では MapLayers.Water だけが通知されるため、水をペイントしている間に地形のチャンクが再構築されることはありません。
• クエリ：terrain.IsWater(world, out depth) と terrain.TryGetWaterHeight(world, out waterWorldY)。

水の見た目（色、波、泡）は、タイルセットの水プロファイルで決まります。詳しくは水プロファイルを参照してください。

ディテール密度（草と小さな植物）

• ディテールは個別のオブジェクトではありません。マップで使用される各ディテールプロトタイプは、map.DetailLayers 内に 1 つの DetailLayer を持ちます。これはディテールテクセルごとに 1 バイトのデータです（DetailWidth × DetailHeight、デフォルトではセルの 1 辺あたり 2 テクセル）。
• 密度 0 は空を意味し、255 はテクセルあたり Max Density 個のインスタンス（ディテールプロトタイプのフィールド、デフォルト 6）を意味します。各テクセルは density / 255 × maxDensity 個のインスタンスを生成します。レンダラーはそれらを決定論的に散布するため、同じマップは常に同じ見た目になります。
• レイヤーは prototypeId によって植生ライブラリと照合されます。map.GetOrAddDetailLayer(id) は必要に応じてレイヤーを作成します。map.FindDetailLayer(id) は、そのプロトタイプが使用されていない場合に null を返します。
• Paint Details ツールでペイントし、Erase Details ツールで消去します。

木と装飾インスタンス

木（TreeInstanceData）と装飾オブジェクト（DecorInstanceData）は、単純なリストとして保存されます。各インスタンスは、プロトタイプ名の代わりに、マップに保存されたライブラリ ID のリストを指す小さなパレットインデックスを保存します：

map.TreePrototypeIds = [ "a3f0…", "77c1…" ]        <- ids of TreePrototype entries in the vegetation library
map.Trees[n].prototype = 1                          <- this tree uses "77c1…"

• ライブラリ ID のパレットインデックスを取得するには、map.GetOrAddTreePrototype(id) / map.GetOrAddDecorPrototype(id) を使用します（ID がリストにない場合は追加されます）。
• マップはプロトタイプを ID で参照するため、ライブラリの名前変更、並べ替え、拡張を安全に行えます。ライブラリに存在しないプロトタイプは、植生レンダラーではスキップされ、装飾マネージャーではマゼンタの立方体のプレースホルダーとして表示されます。同じ ID のプロトタイプを追加すると元に戻ります。通行判定：プロトタイプが見つからない木は描画されませんが、半径 PathingMapBuilder.DefaultTreeFootprintRadius（0.8 m）× スケールの円形の範囲は引き続きブロックします。装飾オブジェクトのプレースホルダーは、プロトタイプが戻るまで通行フットプリントを書き込みません。
• 各インスタンスは、マップ内で一意かつ不変の id を持ちます。新しい ID は map.AllocateInstanceId() で取得します。
• 位置はマップローカル座標です。回転はどこでも同じ規則に従います。単位は度で、上から見て時計回り、0 = +Z、90 = +X です（Unity の Y 軸回転と同じ）。

position.y の規則

プロトタイプの yOffset を position.y に決してコピーしないでください。この値は描画時に加算されます。DecorMath.ComputeLocalPosition と DecorMath.ToStoredHeight は、保存されている位置と描画される位置を相互に変換します。

using RTSTerrainStudio;
using Unity.Mathematics;
using UnityEngine;

public static class InstanceExample
{
    /// <summary>Adds a tree of the first tree prototype of the terrain's vegetation library at a world position.</summary>
    public static uint AddTree(RTSTerrain terrain, Vector3 worldPosition, float yawDegrees)
    {
        MapData map = terrain.Map;
        RTSVegetationLibrary library = terrain.VegetationLibrary;
        if (map == null || library == null || library.trees.Count == 0) return 0;

        Vector3 local = terrain.WorldToLocal(worldPosition);
        var tree = new TreeInstanceData
        {
            id = map.AllocateInstanceId(),
            prototype = map.GetOrAddTreePrototype(library.trees[0].id), // palette index of the library id
            position = new float3(local.x, 0f, local.z),                 // y = offset above the ground, normally 0
            yaw = yawDegrees,                                             // clockwise from above, 0 = +Z
            scale = 1f,
            tint = new Color32(255, 255, 255, 255)
        };
        map.Trees.Add(tree);

        // Notify the cell that changed: vegetation, pathing (tree footprint) and fog blockers update.
        int2 cell = map.LocalToCell(new float2(local.x, local.z));
        terrain.NotifyChanged(MapLayers.Trees, new RectInt(cell.x, cell.y, 1, 1));
        return tree.id;
    }

    /// <summary>Adds a decor object (by library id) standing upright on the ground.</summary>
    public static uint AddDecor(RTSTerrain terrain, string decorPrototypeId, Vector3 worldPosition, float yawDegrees)
    {
        MapData map = terrain.Map;
        if (map == null) return 0;

        Vector3 local = terrain.WorldToLocal(worldPosition);
        var decor = new DecorInstanceData
        {
            id = map.AllocateInstanceId(),
            prototype = map.GetOrAddDecorPrototype(decorPrototypeId),
            variant = 0,                                  // main prefab
            flags = DecorFlags.None,
            position = new float3(local.x, 0f, local.z),  // the prototype's yOffset is added at render time
            rotation = DecorMath.Yaw(yawDegrees),
            scale = new float3(1f, 1f, 1f),
            tint = new Color32(255, 255, 255, 255)
        };
        map.Decor.Add(decor);

        int2 cell = map.LocalToCell(new float2(local.x, local.z));
        terrain.NotifyChanged(MapLayers.Decor, new RectInt(cell.x, cell.y, 1, 1));
        return decor.id;
    }
}

通行マップ

通行マップは、「ここをユニットが歩けるか、ここに建物を建てられるか」という問いに答えます。通行マップは通行セルのグリッドで、各セルが 1 バイトの PathingFlags を持ちます。通行セルの数はマップセルの 1 辺あたり PathingResolution 個（デフォルトは 2）なので、セルサイズ 2 m のマップでは通行セルの大きさは 1 m になります。通行マップは自動的に生成され、入力（ジオメトリ、水、地面レイヤー、木、装飾オブジェクト、オーバーライド）が変わるたびに逐次再構築されます。通行マップ自体は保存されず、保存されるのは手動のオーバーライドだけです。

フラグの算出方法

1. 地形：崖の壁面（と Cliff Margin の範囲）には Cliff が設定されます。Max Walkable Slope（デフォルト 42°）を超える傾斜には Steep が設定されます。水には水深に応じて ShallowWater または DeepWater が設定されます。Flyable はすべての場所に設定されます。Buildable は、歩行可能で、傾斜が Max Buildable Slope（デフォルト 18°）以下で、水がない場所（Shallow Water Buildable がオンの場合は浅水域も含む）に設定されます。続いて、優勢な地面レイヤーの Pathing Effect が適用されます（たとえば、ごつごつした岩には「Unbuildable」）。
2. フットプリント：木は円形の範囲（Footprint Radius × 木のスケール × Tree Footprint Scale）をブロックします。装飾オブジェクトは、インスタンスに DecorFlags.IgnorePathing が付いていない限り、円または回転したボックスの範囲内に Footprint Effect を適用します。
3. Paint Pathing / Clear Pathing ツールでペイントした手動オーバーライドが最後に適用されます。

これらのルール設定は RTSTerrain コンポーネントにあります（RTSPathingSettings、プロパティ terrain.PathingSettings）。

地面レイヤーの通行効果、装飾オブジェクトのフットプリント効果、ペイントしたオーバーライドには、すべて同じ PathingOverride フラグが使われます。結果は terrain.GetPathing(world)、terrain.IsWalkable(world)、terrain.IsBuildable(world) でクエリするか、terrain.Pathing.Flags を直接読み取ります。

リージョン、開始地点、マーカー

これらはゲームロジック用の軽量なオブジェクトです。ゲーム内では描画されず、エディターではギズモとして表示されます。

ツールは開始地点とマーカーに position.y = 0 を保存し、木と同様に地面からのオフセットとして扱います。

using RTSTerrainStudio;
using Unity.Mathematics;
using UnityEngine;

public static class RegionExample
{
    /// <summary>Returns the "gold" property of the first region that contains the world position, or 0.</summary>
    public static int GetGoldAt(RTSTerrain terrain, Vector3 worldPosition)
    {
        if (terrain.Map == null) return 0;
        Vector3 local = terrain.WorldToLocal(worldPosition);
        foreach (MapRegion region in terrain.Map.Regions)
        {
            // Regions are rectangles in map-local XZ.
            if (region.Contains(new float2(local.x, local.z)) &&
                int.TryParse(region.GetProperty("gold", "0"), out int gold))
                return gold;
        }
        return 0;
    }
}

マップ情報と環境

EnvironmentSettings はマップのライティングを保存します。この設定は RTSEnvironment コンポーネント（GameObject ▸ RTS Terrain Studio ▸ Environment）によってシーンに適用されます。このコンポーネントがない場合、値は保存されますが使用されません。

変更通知

コードから MapData を変更した場合は、何がどこで変更されたかをセル単位で地形に通知してください：

• terrain.NotifyChanged(MapLayers layers, RectInt cellRect) は、ただちに MapChanged を発生させ、再構築をキューに追加します。
• terrain.NotifyChangedAll(layers) は、マップ全体を変更済みとしてマークします（ジェネレーターやインポートの後に使用します）。
• 保留中の変更は LateUpdate（再生モード外ではエディターのティックごと）で処理されるか、terrain.ProcessPendingChanges() でただちに処理されます。その後 ChangesProcessed が発生し、この時点でメッシュ、テクスチャ、通行判定は最新の状態になっています。
• 1 つの頂点は最大 4 つのセルに接しています。頂点の矩形は BrushUtility.VertexRectToCellRect(map, vertexRect) で、テクセルの矩形は BrushUtility.TexelRectToCellRect(map, texelRect, resolutionPerCell) でセルの矩形に変換します。

using RTSTerrainStudio;
using UnityEngine;

public static class CliffExample
{
    /// <summary>Raises a square plateau by one cliff level around a world position.</summary>
    public static void RaisePlateau(RTSTerrain terrain, Vector3 worldCenter, int radiusInVertices)
    {
        MapData map = terrain.Map;
        if (map == null) return;

        // Nearest vertex to the centre (vertices sit on multiples of the cell size).
        Vector3 local = terrain.WorldToLocal(worldCenter);
        int cx = Mathf.RoundToInt(local.x / map.CellSize);
        int cz = Mathf.RoundToInt(local.z / map.CellSize);

        int x0 = Mathf.Max(0, cx - radiusInVertices), x1 = Mathf.Min(map.Width, cx + radiusInVertices);
        int z0 = Mathf.Max(0, cz - radiusInVertices), z1 = Mathf.Min(map.Height, cz + radiusInVertices);
        for (int z = z0; z <= z1; z++)
        {
            for (int x = x0; x <= x1; x++)
            {
                int i = map.VertexIndex(x, z);
                // Levels are bytes from 0 to 15: always clamp.
                map.CliffLevels[i] = (byte)Mathf.Min(map.CliffLevels[i] + 1, MapData.MaxCliffLevel);
            }
        }

        // Convert the changed vertices to the cells around them and notify the terrain.
        var vertexRect = new RectInt(x0, z0, x1 - x0 + 1, z1 - z0 + 1);
        RectInt cells = BrushUtility.VertexRectToCellRect(map, vertexRect);
        terrain.NotifyChanged(MapLayers.CliffLevels, cells);
    }
}

座標と複数の地形

マップデータはすべてマップローカル空間に保存されます。RTSTerrain ゲームオブジェクトのトランスフォームが、この空間をワールド内に配置します。

マップローカル空間

• 原点は頂点 (0, 0)、つまりセル (0, 0) の角です。X と Z はメートル単位で 0 から map.WorldSize までの範囲をとり、Y が上方向です。
• 頂点 (x, z) はローカル座標 (x × CellSize, height, z × CellSize) にあります。セル (x, z) の中心は ((x + 0.5) × CellSize, …, (z + 0.5) × CellSize) です。
• ローカル Y = 0 は、レベル 0 かつ微細高さ 0 の位置です。ベースレベル 2、レベルの高さ 2 m の新しいマップでは、地面はローカル Y = 4 m にあります。
• チャンクのゲームオブジェクトは、地形の非表示の子オブジェクト RTS Chunks（RTSTerrain.ChunkRoot）の下に配置されます。このルートはローカルのオフセットや回転を持たず、地形のスケールを打ち消します。さらに各チャンクのローカルトランスフォームは恒等変換なので、チャンクメッシュのオブジェクト空間はマップローカル空間と一致します。これは地形用のシェーダーを書くときに重要になります。

ワールド空間とマップ空間の変換

using RTSTerrainStudio;
using Unity.Mathematics;
using UnityEngine;

/// <summary>Add to any GameObject and use the context menu to see the map data under it.</summary>
public class TerrainProbe : MonoBehaviour
{
    [ContextMenu("Probe Terrain")]
    void Probe()
    {
        // Several terrains can exist: find the one below this object.
        RTSTerrain terrain = RTSTerrain.FindAt(transform.position);
        if (terrain == null || terrain.Map == null) { Debug.Log("Not above an RTS Terrain."); return; }
        MapData map = terrain.Map;

        // World -> map-local (origin at vertex 0,0; position and Y rotation only).
        Vector3 local = terrain.WorldToLocal(transform.position);
        int2 cell = terrain.WorldToCell(transform.position);

        // Nearest vertex.
        int vx = Mathf.Clamp(Mathf.RoundToInt(local.x / map.CellSize), 0, map.Width);
        int vz = Mathf.Clamp(Mathf.RoundToInt(local.z / map.CellSize), 0, map.Height);
        int v = map.VertexIndex(vx, vz);

        // Splat texel below the object (SplatResolution texels per cell side).
        int tx = Mathf.Clamp((int)(local.x / map.CellSize * map.SplatResolution), 0, map.SplatWidth - 1);
        int tz = Mathf.Clamp((int)(local.z / map.CellSize * map.SplatResolution), 0, map.SplatHeight - 1);
        int dominantLayer = map.GetDominantLayer(map.SplatIndex(tx, tz));

        Debug.Log($"Cell {cell}, vertex ({vx},{vz}): level {map.CliffLevels[v]}, fine height {map.Heights[v]:0.00} m, " +
                  $"vertex height {map.GetVertexHeight(vx, vz):0.00} m. Ground at world Y {terrain.GetHeight(transform.position):0.00}, " +
                  $"cliff level {terrain.GetCliffLevel(transform.position)}, dominant ground layer {dominantLayer}, " +
                  $"pathing {terrain.GetPathing(transform.position)}.");
    }
}

位置、回転、スケールのルール

複数の地形

1 つのシーンには、RTSTerrain コンポーネントをいくつでも配置できます。それぞれが独自のマップ、タイルセット、ライブラリ、チャンク、通行マップを持ちます。

• RTSTerrain.All は有効なすべての地形を列挙します。RTSTerrain.Main は最初の地形を返します（マップが 1 つのゲームで便利です。一時的なプレビュー用の地形はスキップされます）。
• RTSTerrain.FindAt(worldPosition) は、指定した位置を XZ 範囲内に含む地形を返します。
• RTSTerrain.RaycastAll(ray, out hit) は、すべての地形に対してレイキャストを行い、最も近いヒットを返します（どの地形かは hit.terrain でわかります）。
• RTSTerrain.TerrainEnabled / TerrainDisabled は、地形を追跡するシステム向けの静的イベントです。
• 地形は互いに独立しています。マップは境界でつなぎ合わされず、経路探索（RTSPathfinder.FindPath(terrain, …)）も一度に 1 つの地形に対してのみ動作します。2 つのマップを継ぎ目なくつなげるには、境界の頂点に同じ高さを設定します。

using RTSTerrainStudio;
using UnityEngine;

public static class TerrainLayout
{
    /// <summary>Places "east" directly next to "west" (along west's local +X), with the same rotation.</summary>
    public static void PlaceNextTo(RTSTerrain west, RTSTerrain east)
    {
        if (west.Map == null) return;
        float widthMetres = west.Map.WorldSize.x;   // map-local X extent in metres
        east.transform.SetPositionAndRotation(
            west.transform.position + west.transform.rotation * new Vector3(widthMetres, 0f, 0f),
            west.transform.rotation);
    }
}

マップアセットとマップファイル

マップは .rtsmap ファイルとして保存されます。Unity エディター（プロジェクト内のアセットとして）とゲーム内エディター（ディスク上のファイルとして）は同じバイナリ形式を使用するため、プレイヤーが作成したマップを Unity で開くことも、その逆も可能です。

プロジェクト内の .rtsmap ファイル

Unity が Assets フォルダー内で .rtsmap ファイルを検出すると、インポーター RTSMapImporter がそれを RTSMapAsset に変換します。このアセットには、圧縮されたファイルのバイト列、小さなヘッダー（名前、作成者、サイズ、プレイヤー数、タイルセット ID）、そしてプロジェクトウィンドウのサムネイルとしても使われるミニマッププレビューが格納されます。

マップアセットの作成

• Tools ▸ RTS Terrain Studio ▸ New Map Wizard...：ガイド付きのセットアップ（基本情報、サイズ、外観、地形）です。ファイルを書き出し、そのファイル用の地形を作成するか、選択中の地形にファイルを割り当てます。
• Assets ▸ Create ▸ RTS Terrain Studio ▸ Map (.rtsmap)：選択中のフォルダーに、デフォルト設定で 128 × 128 の平坦なマップを作成します。
• RTS Terrain Studio ウィンドウの Save As…：地形の現在のマップを新しいファイルに書き出します。
• ゲーム内エディターで作成した .rtsmap ファイルを Assets フォルダーにコピーします。ほかのファイルと同じようにインポートされます。

マップアセットのインスペクター

マップアセットを選択すると、プレビュー、名前、作成者、説明、サイズ、プレイヤー数、タイルセット、フォーマットバージョンに加えて、統計情報（セル数、ワールドサイズ、セルサイズ、レベルの高さ、開始地点、木、装飾オブジェクト、リージョン、マーカー、ディテールレイヤー、ファイルサイズ、メモリ、最終更新日時）が表示されます。

マップの ID に対応するタイルセットが追加・削除されたとき、またはそのタイルセットのミニマップの色が変更されたときは、プレビューが自動的に再ベイクされます。テクスチャ配列を再構築しても、マップは再インポートされません。破損したファイルは、エラーアイコン付きの空のアセットとしてインポートされ、コンソールにインポートエラーが表示されます。

編集、Save、Save As

マップアセットを RTSTerrain の Map Asset フィールドに割り当てます。地形が有効になるとマップがメモリに読み込まれ、すべての編集はそのメモリ上のコピーに対して行われます。シーンファイルに保存されるのはアセットへの参照だけで、マップデータそのものが保存されることはありません。

• Save（RTS Terrain Studio ウィンドウのヘッダー、またはシーンビューの RTS Terrain Studio オーバーレイのオプションメニューにある Save Map）は、マップを元の .rtsmap ファイルに書き戻して再インポートします。未保存の変更がある間は、Save がハイライト表示されます。
• Save As… は新しいファイルを書き出し、再読み込みせずに地形に割り当てます。そのため、アンドゥ履歴は保持されます。
• Open… は別のマップアセットを読み込みます。Reload はアセットからマップを再読み込みし、未保存の変更を破棄します。
• マップアセットが割り当てられていない地形は、その Default Map Settings からマップを作成します。このマップは、Save As を使用するまでメモリ上にしか存在しません。
• シーンを保存（Ctrl+S キー）すると、そのシーン内の地形の編集済みマップも保存され、ファイルがまだない新規マップについては Save As を促します。どちらの動作も、シーンビューのオーバーレイのオプションメニュー（Save Maps When Saving the Scene、Offer Save As for New Maps）でオフにできます。
• マップに未保存の編集がある状態で再生モードに入る、シーンを閉じる、または Unity を終了しようとすると、保存するかどうかを確認されます。再生モード中の編集（シーンビューのツールまたはゲーム内エディターによるもの）についても、再生モードを終了するときに保存するかどうかを確認されます。

ランタイムでのマップファイル

ビルドしたゲームでは、マップはディスク上の通常のファイルです。

• RTSMapSerializer.DefaultMapsFolder は、RTSMapSerializer.StorageRoot（Application.persistentDataPath）内の Maps フォルダーです。そのため、Windows では通常 %USERPROFILE%\AppData\LocalLow\<Company>\<Product>\Maps になります。Web ビルドでは、StorageRoot はブラウザーのストレージ内のフォルダーです（ブラウザー内のマップを参照）。
• ゲーム内エディター（RTSRuntimeEditor）は、Maps Folder にマップを保存し、そこからマップを開きます（空 = 上記のデフォルトフォルダー。相対パスは RTSMapSerializer.StorageRoot からの相対パスです）。Write Preview Images がオンの場合は、マップブラウザー用に、保存した各マップの隣に小さなミニマップ画像 Name.preview.png を書き出します。
• マップを共有するには、.rtsmap ファイルをほかのプレイヤーのマップフォルダー、または Unity プロジェクトにコピーします。Web ブラウザーでは、代わりにゲーム内エディターの Download Map と Import Map を使用します。
• ゲームと一緒にリリースするマップは、地形やスクリプトから参照されるマップアセットにするだけで構いません。ほかのアセットと同じようにビルドに含まれます。

using System.IO;
using RTSTerrainStudio;
using UnityEngine;

public class SimpleMapList : MonoBehaviour
{
    [SerializeField] RTSTerrain terrain;

    /// <summary>Logs all maps in the default folder without loading them, then opens the first one.</summary>
    [ContextMenu("List And Open Maps")]
    void ListAndOpen()
    {
        string folder = RTSMapSerializer.DefaultMapsFolder;
        if (!Directory.Exists(folder)) { Debug.Log("No maps folder yet: " + folder); return; }

        string[] files = Directory.GetFiles(folder, "*" + RTSMapSerializer.FileExtension);
        foreach (string path in files)
        {
            // The header is stored uncompressed, so this is fast even for big maps.
            if (RTSMapSerializer.TryReadHeaderFromFile(path, out RTSMapHeader h))
                Debug.Log($"{h.name} by {h.author}: {h.width} x {h.height} cells, {h.maxPlayers} players, saved {h.Modified}");
        }

        if (files.Length > 0 && terrain != null)
        {
            try
            {
                terrain.LoadFromFile(files[0]);   // the terrain owns and disposes the loaded map
            }
            catch (InvalidDataException e)
            {
                Debug.LogError("The map file is damaged: " + e.Message);
            }
        }
    }
}

タイルセット

タイルセット（RTSTileset）は、マップの外観を定義します。最大 16 個の地面レイヤー、最大 4 つの崖レイヤー、そして水のスタイルで構成され、クラシック RTS のマップエディターにある夏、冬、砂漠のタイルセットに相当します。タイルセットはいくつでも作成でき、地形のタイルセットはいつでも切り替えられます。ペイントされたマップはレイヤーのインデックスしか保存しないため、同じマップを夏の外観でも冬の外観でも表示できます。

1. Assets ▸ Create ▸ RTS Terrain Studio ▸ Tileset でタイルセットを作成します。
2. 地面テクスチャをインスペクターの Ground Layers セクションにドラッグします。アルベドテクスチャ 1 枚につき 1 つのレイヤーが作成されます。対応する法線マップと高さテクスチャは、ファイル名のサフィックス（たとえば _n、_normal、_nrm、_normalgl、_h、_height、_disp）によって自動的に検出されます。ラフネス、AO、メタリックのマップは無視されるため、ダウンロードしたテクスチャフォルダーを丸ごとドロップできます。
3. 同じ方法で、Cliff Layers に崖レイヤーを追加します。
4. タイルセットを RTSTerrain の Tileset フィールドに割り当てます。
5. Texture Arrays セクションで Build Texture Arrays を 1 回クリックします（テクスチャ配列を参照）。

タイルセットのフィールド

地面レイヤーのフィールド

崖レイヤーのフィールド

崖の壁面はマップローカル空間でトライプラナーマッピングによってテクスチャリングされるため、崖テクスチャに特別な UV レイアウトは必要ありません。

水プロファイル

水プロファイルはタイルセットの一部で、水レンダラー、通行マップ、ミニマップで使用されます。

コードからのタイルセットの編集

タイルセットは ScriptableObject です。コードからフィールドを変更したら、tileset.NotifyChanged() を呼び出して、地形にマテリアルを更新させます。tileset.GetGroundLayer(index) と GetCliffLayer(index) は、未使用のスロットに対して null を返します。

テクスチャ配列

地形シェーダーは 20 個のレイヤーすべてを単一のパスで描画するため、すべてのレイヤーテクスチャは 2 つの GPU テクスチャ配列にパックされます。これらの配列を自分で作成する必要はありません。任意のサイズと形式の通常の Unity テクスチャを入力すれば、配列が出力されます。

レイアウト

• 最初の崖スライスは RTSTileset.CliffSliceOffset（16）、スライスの総数は RTSTileset.TotalSlices（20）です。
• 高さ（アルファ）は、レイヤーの Height Map（R チャンネル）から取得されます。Height Map がない場合は、Height From Albedo Alpha がオンであればアルベドのアルファから取得され、それ以外の場合は定数 0.5 になります。
• 法線はビルド時にアンパックされるため、法線マップには通常どおり Unity の法線マップインポート（DXT5nm / BC5）を使用できます。法線マップのないレイヤーには平坦な法線が使用されます。
• アルベドのないレイヤーには、控えめなパターンの入ったニュートラルグレーのスライスが使用されます。その場合でも、Tint の色はシェーダーによって適用されます。
• すべてのスライスは完全なミップチェーンを持ち、トライリニアフィルタリングを使用します。どのサイズのソースも、選択した Resolution にリサイズされます。

ビルド済み配列とランタイムフォールバック

配列が作成される方法は 2 つあります。

Texture Arrays セクションには、ステータスバッジが表示されます。

• Not built：地形はランタイム配列を使用しています。Build Texture Arrays を 1 回クリックします。
• Up to date：形式、サイズ、ミップ数、メモリが表示されます。
• Outdated：テクスチャ、解像度、圧縮設定のいずれかが変更されたか、配列が別のプラットフォームまたは別のテクスチャ圧縮形式用にビルドされています。再ビルドするか、次回のプレイヤービルドに任せてください。
• Building：ビルドが実行中か、予約されています。

このセクションには、アクティブなビルドプラットフォーム向けのターゲット形式、推定サイズ、推定ビルド時間も表示されます。256 MB を超えるビルドの前には確認を求めます。Clear はビルド済みの配列を削除します。

プレイヤービルド

ビルド済み配列をソーステクスチャと比較できるのはエディターだけなので、プレイヤー（ビルドしたゲーム）はビルド済み配列をそのまま使用します。そのため、古くなった配列は毎回のプレイヤービルドの直前に自動的に再ビルドされ、一度もビルドされていないタイルセットは引き続きランタイム配列を使用します。バッチモードや -rtsAllowOutdatedTextureArrays を含む詳細は、プレイヤービルドでのテクスチャ配列を参照してください。また、プレイヤーはビルド済み配列を初めて使用するときに、その CPU 側のコピーを解放します。これにより、配列が GPU 上で使用するのとほぼ同じ量のメモリを節約できます。

コードから：tileset.HasValidBuiltArrays は、圧縮済みの配列が使用されるかどうかを示します。エディターでは、配列が存在し、ComputeContentHash() と一致する必要があります。プレイヤーは、ランタイムでコードからレイヤーのテクスチャ、解像度、圧縮設定のいずれかが変更されるまではビルド済み配列を有効とみなし、変更されるとランタイム配列にフォールバックします。エディターはテクスチャのインポート状態をハッシュ化するため、ComputeContentHash() の値を比較できるのは、エディター内で計算した値どうし、または同じプレイヤーセッション内で計算した値どうしに限られます。HasValidBuiltArrays が false の場合、RTSTerrain は非圧縮のランタイム配列をビルドします（RTSTextureArrayBuilder.Acquire）。tileset.BuiltAlbedoArray / BuiltNormalArray でビルド済みの配列にアクセスできます。独自のランタイムコードでは、Shader.Find の代わりに RTSShaderReferences.FindShader(name)（および FindMaterial(name)）を使用してください。こうすることで、プレイヤービルドでも検索が機能します。

Auto Build

Auto Build がオンの場合（デフォルト。すべてのタイルセットに適用されるエディターの環境設定です）、以前にビルドされた配列は、テクスチャ、解像度、圧縮設定が変更されてから 1 秒後に、高速圧縮で再ビルドされます。最初のビルドは必ず手動で開始します。キャンセルされた自動ビルドや失敗した自動ビルドは、内容またはターゲット形式が変わるまで再試行されません。Build Texture Arrays ボタンで明示的にビルドした場合は通常の圧縮品質が使用され、見た目がわずかに良くなります。そのため、リリース前にはこのボタンを押してください。

植生ライブラリ

植生ライブラリ（RTSVegetationLibrary）は、ペイントに使用できる草、植物、木の一覧です。Assets ▸ Create ▸ RTS Terrain Studio ▸ Vegetation Library で作成し、RTSTerrain の Vegetation Library フィールドに割り当てます。植生を表示するには、地形に RTSVegetationRenderer コンポーネントも必要です（RTSTerrain のインスペクターが追加を提案します）。

インスペクターには Details と Trees の 2 つのタブがあり、サムネイルがグリッド状に並んでいます。プレハブ（木）、テクスチャ（草のカード）、メッシュ（ディテールメッシュ）をそこにドロップすると、エントリが追加されます。各エントリには、マップが参照する不変の id が割り当てられます。複製したエントリには、自動的に新しい ID が割り当てられます。

ディテールのプロトタイプ

ディテールとは、密度を指定してペイントする、小さくて数の多い植物のことです（ディテール密度を参照）。ディテールは 16 × 16 セルのパッチ単位で生成され、内部のプロシージャルシェーダー Hidden/RTS Terrain Studio/Detail で描画されます。このシェーダーは、風、戦場の霧、色のバリエーションを処理します。

木のプロトタイプ

木は、Place Trees で配置される個別のインスタンスです（木と装飾インスタンスを参照）。

GPU インスタンシング

Instanced モードの木は GPU インスタンシングで描画されるため、そのマテリアルでは Enable GPU Instancing をオンにしてください。マテリアルでこの設定がオフになっている場合、レンダラーはインスタンシングを有効にした非表示のコピーを自動的に使用します（編集中も元のマテリアルと同期されます）。また、ライブラリのインスペクターには、マテリアル自体を修正する Enable ボタン付きの情報メッセージが表示されます。ディテールは常にプロシージャルなディテールシェーダーで描画されるため、そのマテリアルでインスタンシングを有効にする必要はありません。

コードからは、RTSVegetationRenderer.RemoveTree(id) で木のインスタンスを削除でき（たとえば、ワーカーが木を伐採したとき）、TryFindNearestTree で検索できます。また、GetTreeObject(id) は木のゲームオブジェクトまたはコライダープロキシを返します。

コードからのライブラリの編集

マップはプロトタイプ ID のパレットを保存しているため、パレットのインデックスはライブラリを介して解決します。

• 木：vegetationLibrary.FindTree(map.TreePrototypeIds[tree.prototype])。
• ディテールレイヤー：vegetationLibrary.FindDetail(layer.prototypeId)。
• 装飾オブジェクト：decorLibrary.Find(map.DecorPrototypeIds[d.prototype])。バリアントのプレハブは prototype.GetPrefab(d.variant) で取得します。0 はメインのプレハブで、無効なバリアントや空のバリアントはメインのプレハブにフォールバックします。VariantCount にはメインのプレハブも含まれます。
• decorLibrary.GetCategories() は、カテゴリを表示順に列挙します（カテゴリのないプロトタイプは Misc として列挙されます）。
• vegetationLibrary.EnsureUniqueIds() は、重複したエントリに新しい ID を割り当てます。

コードからライブラリを変更したら、library.NotifyChanged() を呼び出してください（ライブラリの Changed イベントが発生します）。これにより、RTSTerrain が LibrariesChanged を発生させ、レンダラーが更新されます。これはタイルセットの場合と同じルールです。

装飾ライブラリ

装飾ライブラリ（RTSDecorLibrary）は、配置できるプロップ（ドゥーダッド）の一覧です。岩、遺跡、柵、木箱、建物など、任意のプレハブを登録できます。Assets ▸ Create ▸ RTS Terrain Studio ▸ Decor Library で作成し、RTSTerrain の Decor Library フィールドに割り当てます。地形に付いている RTSDecorManager コンポーネントが、配置されたインスタンスとシーンの内容を同期させます。

インスペクターでは、プロトタイプが自動生成のサムネイル付きでグリッド表示され、カテゴリごとに 1 つずつタブ（ほかに All タブ）が並びます。プレハブをここにドロップすると、現在のカテゴリに追加されます。カテゴリタブを右クリックすると名前を変更できます。カテゴリのないプロトタイプは Misc に表示されます。

装飾プロトタイプのフィールド

フットプリント

• 円形のフットプリントは、Footprint Size の X を半径として使い、インスタンスの水平方向のスケールのうち最大の値を掛けます。
• ボックス型のフットプリントは、インスタンスの回転（地面に投影した X 軸と Z 軸）と X/Z スケールに従います。そのため、回転させた壁でも、壁自身が占める範囲だけを正確にブロックします。
• 形状が None の場合、効果が None の場合、またはインスタンスに DecorFlags.IgnorePathing フラグが付いている場合は、フットプリントは書き込まれません。
• ユニットが上を歩ける平らな装飾（花、がれき）には Unbuildable だけを使い、実体のある物体には Unwalkable を使います。

スポーンモード

Instanced モードの装飾オブジェクトは、インスタンス描画される木と同じように GPU インスタンシングを扱います。Enable GPU Instancing がオフのマテリアルは、非表示のインスタンシング用コピーを使って描画されます。生成されたオブジェクトはプールされます。RTSDecorManager.GetInstanceObject(id) はインスタンスに対応する生成済みのオブジェクトを返し、RTSDecorInstance.FromCollider(collider) は物理演算のヒットから対応するインスタンスを求めます。

.rtsmap ファイル形式

このセクションは、ほかのツールでマップを読み込みたい、コンバーターを作りたい、または独自のデータを追加したいプログラマー向けです。このパッケージを使うだけなら、この内容は必要ありません。すべて RTSMapSerializer が処理します。

バイナリレイアウト

数値はすべてリトルエンディアンです。文字列は .NET の BinaryWriter 形式で、7 ビットエンコードされた長さの後に UTF-8 のバイト列が続きます。

ヘッダーは圧縮されていないため、マップブラウザーはマップを展開しなくても名前、作成者、サイズ、プレイヤー数を表示できます（RTSMapSerializer.TryReadHeader、TryReadHeaderFromFile、構造体 RTSMapHeader）。読み込み側はヘッダー長を使ってヘッダーの末尾までジャンプするため、将来のバージョンでヘッダーの末尾にフィールドを追加できます。

セクション

各セクションは [int32 tag][int32 length][payload] の形式です。タグはリトルエンディアンで格納された FourCC コードで、最初の文字が最下位バイトに入ります（DIMS = 0x534D4944）。ラスターデータの配列は、int32 の要素数の後に生の要素が続く形で書き込まれます。

「プロパティ」は、int32 の個数の後に、キーと値の文字列ペアが続く形で書き込まれます。派生データである通行マップは保存されません。保存されるのは手動のオーバーライドだけです。

未知のセクション、破損ファイル、バージョン管理

• 未知のセクションはスキップされます。セクションの長さを使って読み飛ばします。そのため、古いバージョンのパッケージでも、セクションが追加された新しいファイルを読み込むことができ、独自に追加したカスタムセクションがほかの読み込み処理を妨げることもありません。
• 読み込み側より新しいフォーマットバージョンのファイルを読み込むと、警告がログに出力されますが、読み込み自体は行われます。未知のデータはスキップされます。
• 要素数がマップサイズと一致しないラスターレイヤーがあると、警告がログに出力されます。収まる部分は読み込まれ、残りはスキップされます。
• 途中で切れたファイルや破損したファイルでは、どちらの場合も同じ 1 種類の例外 System.IO.InvalidDataException がスローされます。マジックナンバーが正しくないファイルは「Not an RTS Terrain Studio map file」として報告されます。
• RTSMapSerializer.SaveToFile は、まず <path>.tmp に書き込んでからファイルを置き換えます。そのため、保存中にクラッシュしても、書きかけのマップが残ることはありません。
• フォーマットの互換性ルール：新しいデータは、新しいセクションまたはヘッダー末尾へのフィールド追加として加え、既存のセクションを変更することはありません。独自のセクションでも同じようにし、ペイロード内にバージョン番号を持たせてください。

カスタムセクション

マップファイルには、ゲームルール、トリガー、クエストデータなどの独自データを保存できます。RTSMapSerializer にある次の 2 つの静的フックで、これを実現できます。

• 組み込みのタグと衝突しないタグを選んでください。先頭は X にします（たとえば XGLD）。0 はセクションの終わりを示すため、決して使わないでください。
• どちらのフックも通常のデリゲートです。+= でハンドラーを追加し、-= で削除できるため、複数のシステムがそれぞれセクションを追加できます。
• 読み込み処理ではタグを確認し、自分のものではないセクションは無視してください。
• MapData には独自データを格納する場所がありません。データはマップと対応付けて別に保持します（例では ConditionalWeakTable を使用）。この方法で保持したデータは MapData.Clone() や ResizeMap ではコピーされず、元に戻す操作の対象にもなりません。
• フックは、マップを読み込んだり保存したりする前に登録してください。Unity エディターでは、マップはインポーターでも読み込まれ、Save でも書き込まれるため、エディター用にも登録してください（例では InitializeOnLoadMethod を使用）。

using System;
using System.IO;
using System.Runtime.CompilerServices;
using RTSTerrainStudio;
using UnityEngine;

/// <summary>Stores a "starting gold" value in every map file, in a custom section "XGLD".</summary>
public static class StartingGoldSection
{
    // FourCC, little-endian like the built-in tags: the first character is in the lowest byte.
    const int Tag = 'X' | ('G' << 8) | ('L' << 16) | ('D' << 24);
    const int PayloadVersion = 1;

    /// <summary>Our data for one map.</summary>
    public sealed class Data
    {
        public int startingGold = 500;
    }

    // One Data object per MapData. Entries disappear automatically together with their map.
    static readonly ConditionalWeakTable<MapData, Data> s_Data = new ConditionalWeakTable<MapData, Data>();

    /// <summary>Returns the data of a map (created with defaults when the map has none).</summary>
    public static Data Get(MapData map) => s_Data.GetOrCreateValue(map);

#if UNITY_EDITOR
    [UnityEditor.InitializeOnLoadMethod]          // editor: importer and Save
#endif
    [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]   // player and Play Mode
    static void Register()
    {
        // Remove first so a second registration does not add the handlers twice.
        RTSMapSerializer.CustomSectionWriter -= Write;
        RTSMapSerializer.CustomSectionWriter += Write;
        RTSMapSerializer.CustomSectionReader -= Read;
        RTSMapSerializer.CustomSectionReader += Read;
    }

    static void Write(MapData map, Action<int, byte[]> writeSection)
    {
        if (!s_Data.TryGetValue(map, out Data data)) return;   // nothing to save for this map
        using (var stream = new MemoryStream())
        {
            using (var writer = new BinaryWriter(stream))
            {
                writer.Write(PayloadVersion);   // our own version, so the payload can grow later
                writer.Write(data.startingGold);
            }
            writeSection(Tag, stream.ToArray());
        }
    }

    static void Read(MapData map, int tag, byte[] payload)
    {
        if (tag != Tag) return;   // another system's section: ignore it
        using (var reader = new BinaryReader(new MemoryStream(payload)))
        {
            int version = reader.ReadInt32();
            if (version >= 1) Get(map).startingGold = reader.ReadInt32();
        }
    }
}

ゲームコードでは StartingGoldSection.Get(terrain.Map).startingGold のようにして値を使います。エディターで値を変更したら、保存されるようにマップを変更済みとしてマークしてください（たとえば terrain.NotifyChanged(MapLayers.Info, terrain.Map.CellBounds) を呼び出すか、terrain.HasUnsavedChanges = true を設定します）。

RTS Terrain Studio ウィンドウ

このウィンドウは、エディターの操作の中心です。ウィンドウ自体は編集状態を持たず、シーンビュー、シーンビューのオーバーレイ、RTS Terrain のインスペクターも使用している共有の編集セッションを表示・変更します。どこかで変更した内容は、ほかの場所にもすぐに反映されます。

次のいずれかの方法で開くことができます。

• Tools ▸ RTS Terrain Studio ▸ Editor Window
• RTS Terrain のインスペクターにある Open RTS Terrain Studio ボタン
• シーンビューの RTS Terrain Studio オーバーレイにあるウィンドウボタン

ウィンドウは 4 つの領域で構成されています。上部のヘッダー、タブバー、スクロール可能なページ、下部のステータスバーです。

ツールページ

各カテゴリタブには、カードが縦に並んで表示されます。各カードは、ヘッダーをクリックすると折りたためます。

カード	内容
Category Tools	ツールのグリッドです。ツールをクリックすると、そのツールでシーンビューにペイントできます。アクティブなツールをもう一度クリックすると、編集を終了します。ツールにマウスカーソルを合わせると、説明と修飾キーが表示されます。自作のカスタムツールも自動的にここに表示されます。
ツールカード	選択中のツールの名前、説明、ヒント、このマニュアルの該当セクションを開く ? ボタン、そしてリアルタイムのステータス行です。ステータス行は、マウスを地形の上に移動すると表示されます。たとえば、Height ツールでは Ground 4.25 m | Fine +0.25 m | Level 2、Cliffs ツールでは Level 2 → 3 のように表示されます。
Getting Started	このカテゴリのツールが選択されていないときに表示されます。別のカテゴリのツールでペイント中の場合は Active tool: X と表示され、Go to Tool ボタンでそのツールに移動できます。
Brush	形状、半径、強さ、硬さ、減衰カーブ、回転、ランダム回転、間隔、ジッター。これらの設定はすべてのブラシツールで共有されます。ブラシを使わないツールでは非表示になります。詳しくはブラシを参照してください。
Symmetry	対称モードと対称の中心（ドラッグツールでは表示されません）。詳しくは対称を参照してください。
Tool Settings	選択中のツールの設定です。ツールのコードから自動的に構築されます。設定はエディターのセッションをまたいで記憶されます。すべての設定はツールリファレンスの表に記載されています。
カテゴリ別のアクション	一部のカテゴリにある追加カード：Auto Paint Whole Map（Paint）、Selection（Decor、Select Decor がアクティブなとき）、Water at Cursor（Water）、Pathing Overlay（Pathing）。

編集が一時停止している間は、Editing is paused – the Scene View uses Unity's tools というバナーが表示されます。バナーの Resume ボタンを押すと、編集が再びオンになります。

Map タブ

Map タブには、マップ全体に関わる設定と操作がまとめられています。ダイアログで特に記載がない限り、どの変更も元に戻せます。上部の ? ボタンでこのセクションを開けます。

Settings タブ

シーンビューでのペイント

編集はすべてシーンビューで行います。地形編集がオンでツールが選択されているときは、マウスの左ボタンでオブジェクトを選択する代わりに、そのツールでペイントします。編集をオンにするには、ウィンドウの Editing ボタン、オーバーレイの Start Editing ボタン、インスペクターの Edit Terrain ボタンを使うか、ツールをクリックします。オフにするには Esc キーを押します。

using RTSTerrainStudio.Editor;
using UnityEditor;

static class MyBuildSteps
{
    [MenuItem("Tools/My Project/Run Map Batch")]
    static void RunMapBatch()
    {
        // No save prompts while this scope is open. Scopes can be nested.
        using (RTSMapSaveGuard.Suppress())
        {
            // ... open scenes, edit or generate maps, enter and leave Play Mode ...
        }
    }
}

キーボードショートカット

シーンビューのショートカットは、Unity のショートカットマネージャーの RTS Terrain Studio カテゴリに登録されています。これらのショートカットが有効になるのは、地形編集がオンで、シーンビューまたは RTS Terrain Studio のエディターウィンドウのいずれかにキーボードフォーカスがあり（またはマウスがシーンビュー上にあり）、テキストフィールドや数値フィールドに入力中でない場合だけです。編集時以外は、R キーや数字キーなどは Unity での通常の機能のままです。

以下のキーとマウス操作はパッケージ自体が処理するため、割り当てを変更できません：

以下のキーは Unity 標準のショートカットとコマンドです。RTS Terrain Studio はこれらに反応しますが、キー割り当ては Edit ▸ Shortcuts... の Unity のカテゴリ（Main Menu/Edit、Tools）での設定に従います：

Select Decor 使用時の R キーは、このパッケージ独自の RTS Terrain Studio/Toggle Random Rotation エントリです。Select Decor が有効な間は、ランダム回転を切り替える代わりに Unity の Scale ツールに切り替えます。

ブラシ

すべてのブラシツールは 1 つのブラシを共有します。ブラシは、各ツールページの Brush カード、オーバーレイ（Size と Strength）、またはショートカットで設定します。ブラシの設定はエディターセッション間で保持されます。

対称

対称機能は、すべてのダブ、クリック、配置したオブジェクトを、ミラーリングまたは回転した位置で繰り返します。これを使うと公平な対戦マップを作れます。すべてのプレイヤーに同じ丘、崖、スロープ、木、金鉱が与えられます。モードは Symmetry カードまたはオーバーレイで選択します。シーンビューのマゼンタのガイドが軸と中心を示します。

Centre は、正規化されたマップ座標で表した対称の中心です。(0.5, 0.5) がマップの中心で、デフォルト値です。Reset で中心を元に戻します。中心を移動すると、一部のコピーがマップの外に出てスキップされることがあり、その場合はカードに警告が表示されます。

元に戻す・やり直し

地形の編集はすべてマップ独自のアンドゥ履歴に記録され、この履歴は Unity のアンドゥシステムと連動しています。Ctrl+Z、Ctrl+Y キーや Edit ▸ Undo メニューは、ほかの変更とまったく同じように地形の編集にも使えます。Edit メニューには Undo Raise / Lower のようにステップ名が表示されます。ウィンドウのヘッダーにある Undo ボタンと Redo ボタンも同じ動作をし、Unity の履歴との同期を保ちます。途中でほかのオブジェクトへの変更を元に戻しても、地形の履歴は乱れません。

using RTSTerrainStudio;
using RTSTerrainStudio.Editor;
using UnityEditor;

static class MyTerrainCommands
{
    [MenuItem("Tools/My Project/Raise Whole Map 1 m")]
    static void RaiseWholeMap()
    {
        // The terrain edited by the RTS Terrain Studio window and the Scene View tools.
        RTSTerrain terrain = RTSEditorContext.Terrain;
        if (terrain == null || terrain.Map == null) return;

        RTSEditSession session = RTSEditorContext.Session;

        // Records the Heights layer, runs the code and pushes one undo step named "Raise Whole Map".
        session.RunOperation("Raise Whole Map", MapLayers.Heights, ctx =>
        {
            var heights = ctx.Map.Heights; // fine height per vertex, on top of the cliff level
            for (int i = 0; i < heights.Length; i++)
                heights[i] = TerrainToolUtility.ClampFineHeight(ctx.Map, heights[i] + 1f);

            // Tell the terrain which layers changed so meshes, water and pathing are rebuilt.
            ctx.Terrain.NotifyChangedAll(MapLayers.Heights);
        });
    }
}

ツールリファレンス

以下のセクションでは、8 つのカテゴリに含まれるすべてのツールについて説明します。どのツールも、Unity エディターとゲーム内エディターで同じように動作します。すべてのツールに共通する決まりは次のとおりです：

• ID は、ツール固有の ID です。たとえば RTSEditorContext.ActivateTool("height.raise") のように、コードで使用します。
• 入力：ブラシツールはドラッグ中にペイントします。クリックツールはクリックごとに 1 回動作します。ドラッグツールは、ボタンを押す・ドラッグする・離すという一連の操作で動作します（矩形、ボックス選択）。
• 繰り返し：マウスを動かさずにボタンを押し続けているときの、1 秒あたりのダブ数です。
• 表に記載がある場合、Shift キーで効果が反転し、Ctrl+クリックすると値をスポイトで取得します。
• 各設定には、範囲とデフォルト値を記載しています。設定はエディターのセッション間で保持されます。Settings タブの Reset All Tool Settings で、デフォルトに戻せます。

using RTSTerrainStudio;

// Appears on the Height tab after the built-in tools (Order 100).
public sealed class StepTool : HeightTool
{
    public override string Id => "mygame.step";
    public override string DisplayName => "Step";
    public override string Description => "Raises the ground under the brush by a fixed step per click.";
    public override string Hint => "Shift: step down";
    public override int Order => 100;

    // One dab per click; keep the brush panel visible for the radius and falloff.
    public override ToolInputMode InputMode => ToolInputMode.Click;
    public override bool UsesBrush => true;

    [ToolSetting("Step", Min = 0.05f, Max = 4f, Order = 0, Tooltip = "Height change per click in metres at full strength.")]
    public float step = 0.5f;

    // Called once per click and once for every symmetry copy.
    public override void ApplyDab(RTSToolContext ctx, in BrushDab dab)
    {
        var map = ctx.Map;
        // Computes the vertex weights and records the Heights layer for undo.
        bool any = BeginVertexEdit(ctx, dab, out var w, out var cells);
        using (w) // the weights must always be disposed
        {
            if (!any) return;
            float sign = dab.invert ? -1f : 1f; // Shift inverts
            var heights = map.Heights;
            for (int z = w.rect.yMin; z < w.rect.yMax; z++)
            for (int x = w.rect.xMin; x < w.rect.xMax; x++)
            {
                float weight = w[x, z];
                if (weight <= 0f) continue;
                int i = map.VertexIndex(x, z);
                heights[i] = TerrainToolUtility.ClampFineHeight(map, heights[i] + sign * step * dab.strength * weight);
            }
        }
        // Rebuilds the chunks, water and pathing of the changed cells.
        EndVertexEdit(ctx, cells);
    }
}

Height ツール

Height ツールは微細高さを造形し、崖レベルの上に丘、谷、道路、自然な細部を作り込みます。崖レベルは決して変更しないため、崖の壁面はくっきりしたままです。ステータス行には、カーソル位置の地面の高さ、微細高さ、崖レベルが表示されます。

Raise / Lower の設定

Smooth の設定

Flatten の設定

Set Height の設定

Noise の設定

Terrace の設定

Erode の設定

Cliffs ツール

Cliffs ツールは、頂点の崖レベル（0～15）と、レベル間にある崖の壁面の外観を変更します。ブラシは頂点にスナップしてハードセレクションとして動作するため、常に頂点単位でペイントされ、中途半端なレベルになることはありません。ステータス行には、カーソル下のレベルと、これからペイントするレベルが表示されます（例：Level 2 → 3）。

Raise / Lower Level の設定

目標レベルは、ストローク開始時にカーソル下にある頂点から決まり、その 1 レベル上（Shift キーを押している場合は 1 レベル下）になります。ドラッグ中は同じレベルをペイントし続けるため、レベルを積み重ねることなく台地を広げられます。このツールは頂点を上げるだけ（または下げるだけ）です。

Set Level の設定

Ramp

Ramp には設定がありません。セルの 4 つの角の頂点すべてにスロープフラグが付いていて、かつそのセルのレベル差がちょうど 1 の場合に、そのセルはスロープになります。ステータス行も参考になります。ブラシの下にある有効なスロープセルの数を表示し、フラグは付いているもののレベル差のないセルについて知らせ、スロープが 1 レベルを超えてまたがる場合（引き伸ばされてしまいます）は警告を表示します。

Cliff Type の設定

Clean Cliffs の設定

崖の縁の自動ペイント

クラシック RTS のマップエディターでは、崖を上げると、その隣の地面も変化します。Cliffs ツールも同じように動作します。ストロークが終わると、新しくできたすべての崖の縁に沿って、崖タイプの Edge Ground Layer（縁の地面レイヤー）で地面がペイントされます（たとえば、石の多い「Rocky Dirt」の縁取り）。この縁取りは丸みのある崖の輪郭に沿い、Edge Width の範囲でフェードアウトし、輪郭がわずかに不規則になっているため、セルの形が目立たず自然に見えます。

1. タイルセットを選択し、Cliff Layers を開きます。各崖カードで Edge Layer を選択します（デモのタイルセットでは Rocky Dirt を使用しています）。
2. Raise / Lower Level、Set Level、Ramp、Clean Cliffs のいずれかを選び、Paint Cliff Edges をオンのままにします。
3. 通常どおり崖をペイントします。マウスボタンを離すと、縁取りが表示されます。

• 1 アンドゥステップ：レベルの変更と縁のペイントは、まとめて元に戻されます。
• 対称：すべての対称コピーにも、同じ処理で縁が付きます。
• スロープ：スロープセルに縁取りが付くことはありません。Clean Up Old Edges がオンの場合、縁をまたいでスロープをペイントすると、その部分の縁取りが取り除かれます。
• 移動した崖：Clean Up Old Edges がオンの場合、なくなった縁（下げた台地、広げた台地）の縁取りは再び取り除かれます。その場所に縁レイヤーを手作業でペイントしていた場合も、それごと取り除かれます。
• 任意：ツールごとに Paint Cliff Edges をオフにするか、崖タイプの Edge Layer を None に設定してタイルセット全体で使わないようにできます。このオプションがオンなのに縁レイヤーが設定されていない場合は、ステータス行にその旨が表示されます。

Paint ツール

Paint ツールは、タイルセットの地面レイヤー（最大 16 個）をペイントします。スプラットの各テクセルはすべてのレイヤーのウェイトを保持しており、その合計は常に 100% になります。選択したレイヤーがタイルセットに存在しない場合やテクスチャがない場合は、代替のレイヤーで黙ってペイントするのではなく、ステータス行にその旨が表示されます。

Paint Layer の設定

Tile Paint の設定

Fill / Replace の設定

1 回のクリックが 1 アンドゥステップになり、実際に変更された領域だけが記録されます。

Smooth Paint の設定

Auto Paint の設定

Paint タブには Auto Paint Whole Map カードも表示されます。このカードでは、プロファイルに基づいてマップ全体を 1 ステップで再ペイントできます。

Vegetation ツール

Vegetation ツールは、地形の Vegetation Library を使って、草や小さな植物（ディテール）をペイントし、木を配置します。地形に植生ライブラリがない場合は、ツールページに Create Vegetation Library が表示されます。プロトタイプはグリッドで選択します。何も選択していない場合は、ライブラリの最初のプロトタイプが使用されます。

Paint Details の設定

Erase Details の設定

Place Trees の設定

Erase Trees の設定

Decor ツール

Decor ツールは、地形の Decor Library にある岩、遺跡、柵などのプロップを配置、消去、編集します。地形に装飾ライブラリがない場合は、ツールページに Create Decor Library が表示されます。プロトタイプグリッドには、検索フィールドとカテゴリフィルターがあります。

Place Decor の設定

Erase Decor の設定

Select Decor の設定

Selection カード

Select Decor ツールがアクティブな間は、Decor タブに Selection カードが表示され、選択中のオブジェクトの数を確認できます。編集ボタン（Delete、Duplicate、Snap to Ground、Rotate 90°、Lock、Unlock）は、どれも 1 回の操作が 1 アンドゥステップになります。Select All と Clear は選択を変更するだけです。

ハンドルによる移動、回転、拡大縮小については、装飾オブジェクトの選択ハンドルを参照してください。

Water ツール

水は頂点ごとに保存されます。各頂点は、水面の高さを持つ「水あり」か、「水なし」のどちらかの状態です。Water ツールは、Cliffs ツールと同様にハードセレクションを使用します。Water at Cursor カードには、マウスカーソル位置の水位と水深が表示されます。また、タイルセットの浅水域の上限に基づいて、その地点が浅水域（歩行可能）と深水域のどちらと見なされるかも表示されます。

水の高さの設定（Paint Water と Flood Fill）

Paint Water の設定

Flood Fill の設定

Pathing ツール

通行マップ（歩行可能、建設可能、飛行可能、水）は、傾斜、崖、水、地面レイヤー、木、装飾オブジェクトから自動的に生成されます。Pathing ツールでは、通行セル単位のハードセレクションを使って、その上に手動のオーバーライドをペイントします。結果を確認するには、Pathing Overlay カードまたは P キーでオーバーレイをオンにします。

Paint Pathing の設定

通行オーバーレイの色

自動生成部分に使われるルール（最大傾斜角、崖マージンなど）は、RTS Terrain コンポーネントで設定します。詳しくは Pathing Rules を参照してください。

Markers ツール

Markers ツールは、プレイヤーの開始地点、トリガー用の名前付きリージョン、カメラ位置などの名前付きポイントといったゲームプレイ情報をマップに追加します。マーカーは、Markers ツールがアクティブなとき、または Show Markers がオンのときにシーンビューに描画されます。

Start Locations の設定

Regions の設定

新しいリージョンには、一意の名前が自動的に付けられます。

Markers の設定

Auto Paint

Auto Paint は、地形の形状に基づいて地面レイヤーをペイントします。平らな地面には草、急斜面や崖沿いには岩、岸辺には砂を塗り、ノイズで不規則に散らした土のパッチを加えます。スカルプトしたばかりのマップや生成したばかりのマップを完成した見た目にする、最も手早い方法です。その後、手作業で調整できます。

使い方は次の 3 通りです。

• Paint タブの Auto Paint ブラシツールは、ブラシの範囲内にルールを適用してペイントし、ブラシのウェイトと強さに応じて既存のペイントとブレンドします。Shift キーを押すと代わりにベースレイヤーがペイントされ、ルールによるペイントが取り除かれます。
• Paint タブの Auto Paint Whole Map カードは、マップ上のすべての地面テクセルを 1 アンドゥステップで塗り直します。このカードには Profile フィールドと Create Profile ボタンがあります。
• プロファイルのインスペクターにある Apply To Map ボタンと、マップジェネレーターの Paint ステージ。