DCS Mission Authoring Gateway

dcs-me-gateway は、AI ミッションデザイナーと DCS-SMS Mission Editor ブリッジの間で動作するローカル MCP サーバーです。多くの壊れやすいエディタコマンドを、小さくバージョン付きのオーサリングプロトコルに変換します。

ゲートウェイは UI をクリックせず、DCS にフォーカスすることもありません。リクエストは既存の DCS-SMS メールボックスに書き込まれます。DCS のフォーカスが外れていて Mission Editor の更新ループが抑制されている場合、リクエストは更新ティックが再開するか、呼び出し側が選択した期限が切れるまでキューに残ります。

0.9 で実装済み

• 三十五個の MCP ツール: アップデート検出、ミッションオーサリング/検証、永続的なセマンティックマップと水文の前処理、オフラインクエリ、ライブマップ検査、ライブ航空基地/空母パッケージ割り当て、ネイティブ輸送ルーティング、ライブ AI タスク発見、フライトプロファイル/タイミング計画、パッケージテンプレート、図面、決定論的ミッションドキュメント、オプションの Skynet-IADS セットアップ、および境界付きオフライン外部コンテンツ管理。

• ミッション環境、グループ、ユニット、ペイロード、ルート、型付きウェイポイントオプション/動作、名前付きグループ Triggered Actions、トリガー、円形ゾーン、グループ周波数、ユニットコデサインのための四十一の宣言的パッチ操作。

• 既存の名前付きミッションエンティティと DCS によって割り当てられたユニット名を採用することを含む、安定した論言参照。

• ミッションデザインのガイダンスは、MCP サーバーの初期化命令として提供され、単なるオプションのリソース/プロンプトとしてではありません。これにより、互換性のあるクライアントは、計画、タイミング、ロードアウト、AI ポリシーのデフォルトを自動的に設定できます。

• コンパクトなセマンティック・スナップショット、決定的なリビジョン、楽観的並行、操作ごとの事後条件チェック。

• アトミック書き込みとプロセス間ロックによって保護されたミッションごとのバインディングとべき等性レコード。

• リクエストの絶対有効期限と明示的な OUTCOME_UNKNOWN 処理により、応答喪失後の遅延実行や不検査な再生が防止されます。

• 検証済みパッチは Mission Editor の 1 回のコールバックで送信され、後続の動詞が失敗した場合には、コミット済みの部分 prefix が記録されます。

• プレハブ形狀のミッションフラグメントは、専用の DCS-SMS トランザクションエンドポイントを使用し、ネイティブな ID/名前割り当て、相互参照のマッピング、ロールバック、カルティド再生プロテクションを備えています。

• 保存/再オープン検証は、安定したセマンティックリビジョンを待機し、Save As による ID 変更を超えてバインディングを移行します。

• DCS-SMS が作成した車両ルートと、古い Mission Editor ルートパネル所有権に対する互換性ガードを修正。

• 任意の Lua を実行する MCP ツールはありません。

• リビジョン追跡された F10 マップ注釈は、円、ライン、ポリゴン、テキストラベル、削除の検証済みバッチをサポートし、図形ごとにツールを作成することはありません。

• データ駆動のミッションテンプレートカタログは、調整可能な S-300PS/Buk サイトレイアウトと、段階的な AWACS/カンカーのレーストラックを返します。2 つの SAM パッケージは、インストールされた DCS ユニットデータベースと照合されます。これらは実用的で代表的な出発点であり、実際の戦闘序列ではなく、現実の戦闘序列ではありません。

• 空母パッケージのオーサリングは、DCS 自身の滑走路カテゴリメタデータから、ライブな Supercarrier の利用資格、利用可能な無料/有料のはく体、空母運用可能な航空機を実現します。1 つのトランザクションで、空母を単独または代表的な青/赤の護衛隊で配置し、デッキ上風を計算し、対応する TACAN/ICLS/Link 4/ACLS アクションを設定し、航空機の起点とオプションの回収ウェイポイントを甲板にバインドし、名前付き積載と戦闘用消耗品を適用できます。

• 基本的な通信オーサールはグループ周波数と正規化されたユニットコールサインを記述します。オフライン検証は、AWACS/タンカー グループが同一周波数を共有するとき警告します。

• キャッシュされた地形は、明示的なクリアと障害物地点を持つ座標/高度プロファイルと直線 LOS を提供できます。建物や植生はそのモデルの対象外です。

• 混合モードのオーサリングは、決定的な 1024×1440 のミリタリー・ライトなプレイヤー資料と、コピーオンライトという ファイルファイル 外部コンテンツオーバーレイを提供します。資料コアは、固定保存されたミッションから、呼び出し番号、航空機、ルート、タイミング、無線、収庫による補助装置、搭載物、燃料、砲、対抗手段を読み取ります。最小限の戦術機情報は明示的なエージェント入力のままです。ルートページは、セマンティックラベルと F10 オーバーレイを無効にしたクリーンなキャッシュ済み DCS 地形を使用します。オーバーレイは航空機/一般のニーボード、ブリーフィングテキストと画像、および制限された画像/音声/Lua リソースを元のミッションを編集することなく管理します。

• 再開可能なタイルキャッシュは、権威あるDCS の標高と標層タイプを抽出し、傾斜、アスペクト、粗さ、候補となる尾根/谷/峠を推定し、完成地 PNG と注釈付きコンテキスト PNG を描画します。後続のクエリに DCS は必要ありません。

• 独立して再開可能な水文レイヤーは、デフォルトランプルで 50 m ごとに DCS の地表タイプを標高・傾斜・意味領域変更なしで効率的にサンプリングします。各サンプルを2ビットでパックし、高確信で一様な陸地と外洋のベースタイルをスキップし、境界付き 8 接続の河川/湖成分を生成し、別々に報告されるコンカバティブな短いギャップの継ぎ合わせを誘します。検証された断片から、安定したタイル ID を持つ完全なデータセットカバレッジへ拡張も可能です。

• 各キャッシュには、DCS が作成した名所と固定空軍詳細が含まれ、配置空港の限界/長さ、駐機格納庫、シェルターフラグ、監督エプロンクラスタなどが含まれます。場所のラベルは、DCS の町のソースが操作と座標ではなく重要度を提供しないため、順位付けは明示的にされません。

• 近似のアンカーグラフは、近隣の空軍基地と名所の間の DCS ネイティブな道路・地峡/鉄道回廊をキャッシュします。これには、迂回、標高/勾配、端点のスナップ、川の交差情報が含まれます。正確な端点のライブルーティングを利用可能にするのは、キャッシュが完全な道路ネットワークの出力ではないからです。

• 粗い集落領域は、周辺のバッファリングされた名所クラスタで、乱意性と推奨画像ビュー境界が明示されています。これらは建築物のフットプリントではありません。個々の構造物は、視覚的なマップ検査タスクとして残ります。

• セマンティックキャッシュはまた、クエリ可能な空軍基地、集落、名所のエンティティと、サーフ フェイス、標高、接続、標高、粗さ、低質翔の証拠に基づいて分類された連続した地形領域を格納します。領域は、ラスターセルを実世界の行政境界であるかのように扱うのではなく、コンパクトな行行と隣接性を記録します。

• 再開可能なマクロ輸送グラフは、航空基地と集落のハブを使用します。その端点は DCS ネイティブの道路/鉄道パス、スナップした方向のゲートウェイとして、オフラインのクエリで複数の領域のルートを選択できますが、ライブ DCS ルートには、正確な走行しているコマンド列の通行の第一関区域の幾何形状について、権限が維持されます。

• オンデマンドのマップ検視機能は、ライブ ME マップを要求に応じて範囲に一致させ、マップウィジェットのみをキャプチャし、地理参照PNGを書き込み、以前のカメラを選択します。カメラの動きのフレームチェックは、非表示エディタの捕捉（たとえば、実行中のミッションの F10 ビューが実際に画面に表示されているとき）を拒否します。

• プリプロセスは自動的に、キャッシュの形状、正確な共通タイルのエッジ、16 個の決定論的なポイントをライブ DCS と照合します。同じレポートは、唐本的に validate_map_dataset または、オフラインの QA のためにライブ比較を無効にして再実行できます。

• 控えめなローディテール検出は、その証拠を記録し、ほぼ均一な地形がすべての敷居を超えた場合にのみ粗いタイルを格納します。通常の平らな地形を Simmetric の初期境界に黙って等しいとはみなしません。

• DCS に保存された臨床、オフラインアーカイブ / Lua / リファレンステスト、およびクローンを編集して元を復し、ファイルのハッシュを検証する隔離されたライブオーサリングハーネス。

• ライブ空軍基地の計画は、DCS の航空機の包絡線 / データカテゴリフィルタと、オープンミッションの予約済み スタンド、ミッションの風れ、滑走路ラベル、スタンドから最も可能な閾値へのタクシー プロキシを使用します。確認済みの作成では、1 機から 4 機向けのコールド、ホット、ランウェイスタートが可能で、て構成ステップが失敗した場合、グループの一部構築は全体が削除されます。アクティブランウェイ戦略は、ネイティブのコンパクトな駐車選択肢を検証済みの優先スタンド設定に変更できます。

• プリセットファーストのロードアウトオーサーでは、インストール済みの DCS ビルドから、名前付き航空機プリセット、宣言済みのタスク互換性、格納スペース、重量を問い合わせます。パッチは 1 つのプリセットを適用するか、制限されたピロン事調整を行うことができます。ゲートウェイはモデルに CLSID または合計ペイロードを発明させることはありません。戦闘オーサルでは、砲弾も明示的にチェックされます。ゼロ砲弾の戦闘機は、その例外なしを意図していない限り警告します。

• ライブ検出タスクには、DCS が実際のグループに公開するウェイポイント・および経路アクションだけが含まれています。タスクの説明は、パッチの作成前に、デフォルト値、許可値、欠落したターゲット・セレクターガナイダンスを提供します。

• ミッションの日時と有用な天候フィールドはすべてのセマンティック・スカッシュにすべて含まれており、1 回のリビジョン確認付き環境操作として書き込めます。型付きウェイポイント オプションには、Robespon to threat、ROE、レーダ/ECM 使用、當點 (BINGO) RTB、静扉、投下 / アフターアンバーナー禁止が含まれます。

• ロールベースの固定翼プロフィールと、透明な運転、タキシー、高度、音量を見積もるのに使用して、パッケージの到着を同期させます。AI のスクリーンブル / インターセットがトランジットを低くまたは遅く始める場合、オフライン lint が警告します。

• オフラインの動作 lint は、非武装の AI 戦闘機、兵力を持つ戦闘群、ターゲット ID のない兵器タスク、対応するベハイビアのないセマンティックウェイポイント名、そして端末の着陸 / 食料 / ループのない空のルートを指摘します。オプジェクト即興もまた、両方が起動できる相互場の結果、単独未封のグループメンバーで満たせる条件を満たすキャプチャ条件、すべての識別された結果条件から省略されたブリーフィングで名前付きされたグループ、および非航空群に割り当てられた迎撃ウェイポイントを警告します。これらはヒューリスティックなオーサリング警告であり、DCS ランタイム AI の正確さに関する説明ではありません。

ゲートウェイは、宣言的なパッチに対するロールバックをするしません。DCS-SMS のパッチ動詞は 1 つの ME コールバック内で順に実行されます。動詞 N が失敗した場合、動詞 1 から N-1 のコミットは複数形です。結果はコミットされたプレフィックスと冪等終点をレコードに記録し、無条件な重複再試行を防止します。別の apply_mission_fragment エンドポイントは、DCS-SMS ネイティブのロールバック機能を持ち、不完全なロールバックを明示的に報告します。その確認された結果か、適用後のスナップショットによって要求された成果を証明できない場合、ゲートウェイは OUTCOME_UNKNOWN を返し、復旧前にミッションの監視を要求します。失敗した検証がロールバックをしたとは決して思われていません。将来のトランザクション動詞については、docs/dcs-sms-extension.md で説明しています。ライブのミッションリビジョンに場所の内容が含まれていないため、ゲートウェイは、倉庫効果を含むフラグメントのキャッシュの再生を保守的にブロックします。新しいキーを選択する前にミッションを監視してください。図面は、セマンティックリビジョン、保存 / 再検証に含まれています。

リビジョンと保存/再開検証は、プロトタル 0.1 のオーサリングサーフェスを対象としています。意味的な環境、グループ、ユニット、ルート、トリガ、ゾーン、図面、ミッションパス/タブ。ブリーフィング、倉庫、全体的なミッションオプションは現在のリビジョン境界外です。

DCS は車両の車頭方向をグループレベルで保持します。そのため、セマンティックスナップショットは、その車両グループ内のすべてのユニットに対して、前期の車両の方向を使用します。非主導構成に定則的な異なる車両方向のみを設定しようとすると、再察後に事後条件検証に失敗するたため、音声による再発の影響を防ぎます。

Related MCP server: DCS Lua Runner MCP Server

要件

• Windows リリースには Node.js ランタイムを備わっています。ソースコードでの開発には Node.js 20.17 以上が必要です。

• Windows、DCS World、DCS-SMS ME-mod はライブ エディタツールにのみ必要。

• ミューのために DCS-SMS -> External execution が有効の Mission Editor を開く。

• inspect_map_view は、最小化されていないウィンドウに Mission Editor のマップを含む必要もあります。DCS はフォーカスされていない、または不透明のままでも、ゲートウェイはそのアプリケーションウィンドウを直接キャプチャし、絶対フォカグラウンドにすることもなく、そしてセンサーをし思っず静的モニターキャプチャに堕落ない。

マップ抽出には、付属の DCS-SMS ME-mod 0.32.4 ワークツリー内の型付き terrain info、terrain sample-grid、terrain list-places、terrain nearest-transport、terrain transport-path、airbase plan-start、airbase create-start 動詞が必要です。

Windows リリースのインストール

リリースは 1 つの ZIP です。これには、ゲートウェイ、ロックされた本番依存関係、ポータブル Node ランタイム、および互換性のある DCS-SMS Mission Editor ブリッジソースが含まれます。個別の DCS-SMS インストールは不要で、DCS-SMS ミッションフックやオプションの LuaSec/OpenSSL ファイルもインストールしません。

ZIP を展開し、DCS を閉じて、次を実行します:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Clients codex

サポートされている -Clients の値は、codex、claude-code、claude-desktop、generic です。複数渡すこともできます。generic はポータブルな mcp-config.json を書き込みます。Codex と ChatGPT デスクトップは Codex のローカル MCP 設定を共有します。Claude Code と Claude Desktop は個別に登録されます。他のクライアントは、generic ファイルの同じ stdio コマンドと環境を使用できます。Web 上の ChatGPT はローカル stdio サーバーを直接起動できません。このパッケージは、DCS を実行しているマシン上の ChatGPT デスクトップ/Codex を対象としています。それぞれのネイティブ設定画面については、現在の OpenAI MCP ドキュメント と Claude Code MCP ドキュメント を参照してください。

インストーラは:

• DCS と Saved Games を検出するか、-DcsPath と -SavedGames を受け付けます。

• DCS で Full Screen が無効になっていることを確認しますが、その設定を編集することはありません。

• DCS の実行中は Mission Editor へのパッチ適用を拒否します。

• ユーザーの MissionEditor.lua と以前のブリッジをバックアップします。

• 同梱の GPLv3 ブリッジソースをインストールし、区切りで囲まれた require ブロックのみをユーザー自身のエディタファイルに追加します。

• ユーザーが要求した dcs-me MCP エントリのみを登録し、そのエントリを選択した Saved Games インスタンスに固定します。

MCP 起動時に、ゲートウェイは GitHub の最新安定版リリースエンドポイントをチェックします。タイムアウトは 2.5 秒、ローカルキャッシュは 6 時間です。より新しいセマンティックバージョンが利用可能な場合、ゲートウェイの MCP 指示はエージェントに、更新するかどうかをユーザーに尋ねるよう指示します。このチェックが何かをインストールすることはありません。明示的な承認後、DCS と、ゲートウェイを使用しているすべての MCP クライアントを閉じてから、次を実行します:

powershell -NoProfile -ExecutionPolicy Bypass -File `
  "$env:LOCALAPPDATA\DcsMeGateway\update.ps1"

アップデータは変更を加える前に再度確認を求め、バージョン付きの Windows リリースのみをダウンロードし、別途公開されている SHA-256 を検証して、通常のバックアップ保存インストーラを呼び出します。自動チェックを無効にするには、DCS_ME_GATEWAY_UPDATE_CHECK=0 を設定してください。check_gateway_update はオンデマンドまたは強制チェックを実行します。プレリリースタグはこの更新チャネルから意図的に除外されています。

エージェント主導のインストールでは、展開したフォルダをエージェントに渡し、VIBEINSTALL.md に従うよう依頼してください。インストール後、MCP クライアントを再起動し、DCS Mission Editor でミッションを開いて DCS-SMS -> External execution を有効にします。このトグルはセッション内でのみ有効です。

ゲートウェイは MIT ライセンスです。同梱の DCS-SMS ブリッジは GPLv3 のままであり、完全なソースとライセンスが payload/bridge の下に同梱されています。THIRD_PARTY_NOTICES.md を参照してください。

ソースからインストールして検証する

cd C:\path\to\dcs-me-gateway
npm install
npm test
npm run build
npm run test:golden
npm run test:live

test:golden までのすべては完全にオフラインで動作します。DCS は閉じたままでかまいません。保存済みのミッションを個別に検証するには、次を実行します:

npm run validate:miz -- D:\Missions\mission.miz

バリデータは、ZIP の整合性と展開制限、必須エントリ、リテラルな Lua 構文、ミッション構造、ID/名前、ルート、座標、エンティティ参照、辞書キー、およびパッケージ化されたリソースをチェックします。ミッションコードをロードまたは実行することなく、Lua をデータとして解析します。

宣言的パッチとその直前および直後に保存されたファイルを使用して、焦点を絞った受け入れレポートを生成するには、次を実行します:

npm run report:patch -- patch.json before.miz after.miz [bindings-before.json] [bindings-after.json]
npm run docs:render -- --mission <saved.miz> --dataset <dataset-id> --output <new-directory>

レポートには、直接のパッチターゲット、1 ホップの依存関係コンテキスト、操作の事後条件、導入/解決された検証結果、およびそのスコープ外で変更されたエンティティが含まれます。after ファイルが無効であるか、事後条件が失敗したか、依存関係が予期せず変更されたか、無関係なミッションメタデータ/オプション/ウェアハウスが変更されたか、スコープ外のエンティティが変更された場合、ゼロ以外の終了コードで終了します。以前に作成された論理 ID を参照するパッチは、関連する {"entities": ...} バインディングオブジェクトを提供する必要があります（変更前と、割り当てが変更された場合は変更後の両方）。未解決の ID は明示的に報告され、受け入れは失敗します。

test:live はエディタセッションのみを読み取ります。ライブの読み取り専用ミッションスナップショットには -- --snapshot を追加してください。

npm run test:live-authoring は意図的に変更を加えます。Mission Editor で保存済みのミッションがすでに開いている必要があります。ハーネスはまず Save-As でそのミッションを .artifacts/live の下にクローンし、クローンのみを編集して、冪等性、リビジョン競合、ルート編集、ゾーン、保存/再オープンの安定性をチェックし、その後オリジナルを再度開いて SHA-256 が変更されていないことを検証します。ミッションを起動したり飛行させたりすることはありません。

stdio で MCP サーバーを起動します:

node C:\path\to\dcs-me-gateway\build\index.js

MCP ホストは、そのコマンドとパスを、dcs-me という名前の stdio サーバーとして構成する必要があります。診断情報は stderr に出力され、stdout は MCP フレーム用に予約されています。

設定

オーバーライドがない場合、ゲートウェイは DCS-SMS の saved_games 設定値を読み取り、最も新しい ME ハートビートを持つ DCS、DCS.openbeta、または DCS.server インスタンスを選択します。Windows の Saved Games が移動され、DCS-SMS がそのパスを設定に記録していない場合は、DCS_SMS_SAVED_GAMES を設定してください。

MCP ツール

マップパックライフサイクル

マップ固有のミッション計画の前に、ミッションエージェントはシアターに対して ensure_map_dataset を呼び出すよう指示されます。このツールはまず完全なローカル データセットを再利用し、次にパッケージ化されたレジストリとオプションのGitHubホスト型リモート レジストリを確認します。ダウンロードはストリーミングされ、登録済みバイト数で境界が定められ、 登録済みSHA-256に対して検証され、安全に展開され、データセット／シアターの 同一性と完全性が検証され、原子的に公開されます。パッケージ化されたレジストリ maps/registry.json は正規のリモートレジストリでもあります。 大規模データセットはイミュータブルでSHA-256固定のGitHubリリースアセットです。生キャッシュと 生成されたアーカイブは決してGitにコミットされません。

パックが登録されていない場合、ツールは permission_required を返し、 DCSを起動したり、単独で数時間の抽出を開始したりはしません。ユーザーが 承認した後にのみ、エージェントは allow_local_build=true を指定して呼び出しを繰り返せます。 要求されたシアターはインストール済みで、Mission Editorで外部実行が有効な状態で開かれている必要があります。 ビルドは再開可能で、複数回の呼び出しが必要になる場合があります。

開発者は明示的に未ホストのシアターをビルドおよびパッケージ化できます：

npm run maps:settlements
npm run maps:build -- --theatre Caucasus
npm run maps:package -- --dataset caucasus-full-v01-250m `
  --base-url https://github.com/ALasek/DCS-ME-gateway/releases/download/maps-v0.9.0

maps:settlements は、現在Mission Editorで開かれているシアターに対する高速で独立したレビューパスです。 DCSの権威ある座標変換を通じて一致するキュレーション済みカタログを解決し、DCSネイティブの町名を統合し、 .artifacts/settlements の下にJSONとラベル付きPNGを書き出します。地形、標高、地表被覆、 水文、輸送、空軍基地データのサンプリングや再構築は行いません。 --output <directory> を使用して安定した出力場所を選択します。

パッケージングコマンドは、アーカイブサイズとSHA-256を含む正確なレジストリエントリを出力します。 そのエントリを maps/registry.json に追加し、.tgz を対応するリリースにアップロードします。 ローカルビルドは、プロジェクト作者が所有していないシアターのフォールバックです。 決して暗黙の同意ではありません。

preprocess_map_region は、要求された矩形をDCSの権威あるシアター境界に対して検証します。 DCSの4,096という制限は、データセットタイルではなく、各地形グリッドリクエスト内のサンプルに適用されます。 max_tiles は意図的なデータセットサイズガードに過ぎません（既定値は50,000）。 tile_batch_limit は各MCP呼び出しを既定で200個の欠落タイルに制限します。 結果が complete=false の場合、同一のデータセット形状とサンプリング設定で呼び出しを繰り返してください。 各タイルとマニフェストの更新はすでに永続化されており、不完全なデータセットは通常のクエリを拒否し、 最終検証では読み取り不能、不正、シーム不正のタイルを退避させ、次のバッチで自動修復します。 バッチサイズとセーフティガードの変更は、自動生成されたデータセットIDを変更しません。 その north/east 座標は、ミッションオブジェクトで使用されるものと同じシアターローカルメートルです。 既定の保守的プレパスは、粗い解像度で高信頼度の一様な海またはプレースホルダー的な一様な陸地を保持する場合があります。 そのような決定はすべてマニフェストとクエリ結果に可視化されます。海岸線、混合サーフェス、 およびすべてのしきい値を満たさない平坦な地形は、フル解像度のまま残ります。 空軍基地とDCS作成の場所ラベルは、地形タイルの隣にキャッシュされ、プレビューに注釈付けされます。 場所レコードは都市／町／村として分類されません。DCSソースがその区別を公開しないためです。 意味論的来歴は、DCSビルド、ロケール、シアターの町のソースを記録します。 場所IDは座標から導出されます。DCSが一部のシアターデータセットを読み込む際に重複するLuaキーが上書きされるためです。 DCS地形ビルドが変更された場合は、古いタイルを黙って再利用するのではなく、明示的な force=true による再ビルドが必要です。 query_map_context、query_airbase_context、query_transport_context はキャッシュのみを読み取るため、DCSは 閉じていても構いません。200mのエプロンクラスタリングとコンパクト／標準／ラージエンベロープバンドは ナビゲーションのヒューリスティックであり、DCS互換性の主張ではありません。plan_airbase_start は、ミューテーションの前に、要求された航空機と現在の占有状況を常にDCSを通じて再確認します。

render_mission_documents は、同じ保存済みミッション、地形キャッシュ、スタイルバージョン、選択グループ、および提供された散文に対して決定的です。デフォルトでは Player/Client フライトを選択します。マニフェストとそのまま渡せる kneeboard_images エントリを生成しますが、ミッションは変更しません。DCS のニーボードフォルダは、全航空機または航空機タイプを対象にできますが、同じタイプを使用する2つのフライトを区別することはできません。そのため、それらの指示を組み合わせるか、フライト固有の分離が必要な場合はブリーフィングページを使用してください。ミッションカードは航空機タイプを識別しますが、フライトごとの数量は示しません。通信/搭載ページは、正規の人間が読めるストア名、ポンド単位の燃料、および銃弾薬をパーセンテージで使用します。内部 CLSID は表示されません。保存済みミッションにストアがあるが読み取り可能なプリセット名がない場合は、get_aircraft_loadouts を include_stations=true で呼び出し、その DCS が作成した表示名を flight_notes.loadout_summary に渡します。レンダリングは、それらの名前が提供されるまで明示的な警告を発します。ウェイポイントテーブルは、ルートが実際にスケジュールされている場合、検証済みの保存ルート ETA 値を使用します。状態ゲートまたはプレイヤーペースのイベントでは、flight_notes.waypoint_notes[].time_label を手がかりやタイミングウィンドウに使用でき、固定の時計時刻を発明することはありません。レンダリングは、複数ウェイポイントのプレイヤールートに有用な ETA 値もタイムラベルもない場合に警告します。ルートマップには、まばらな空軍基地と主要集落のラベルのみが追加され、ルートとウェイポイントのラベルは衝突と視覚的な優先順位を保持します。埋め込む前にすべてのページをプレビューしてください。

apply_miz_overlay は、意図的に一般的なミッションテーブルエディタではありません。ライブ ME ミッションを保存し、別のファイルを閉じるか開き、既存の外部コンテンツを検査し、そのソースファイルの報告された SHA-256 を固定し、新しい出力パスに書き込みます。このツールは、実際の画像/サウンド/スクリプト署名を検証し、参照されたリソースの削除を拒否し、ミッション参照が残っていない場合にのみ、置き換えられたブリーフィング画像をガベージコレクトします。オーバーレイが成功した後、ME で出力を開き、save_and_verify を実行します。コアグループ、ルート、トリガー、および目標は ME が作成したままです。これにより、2人のライターが同じ .miz で暗黙的に分岐することを防ぎます。

オプションの Skynet-IADS

意味のあるマルチサイト/EWR ネットワーク、SEAD/DEAD シナリオ、またはレーダー放射戦術にバランスが依存するミッションの場合、エージェントは Skynet を一度推奨し、ユーザーがランタイムスクリプト依存の動作を受け入れるかどうかを尋ねることができます。孤立した SAM 設計のたびにその質問で中断するべきではありません。ネイティブ DCS アラーム状態と決定的な放射トリガーは、孤立した、予測可能な、または訓練用の脅威のデフォルトのままです。

受け入れ後、管理対象 SAM グループ名に共通のプレフィックスを1つ、管理対象 EWR ユニット名に異なるプレフィックスを付け、ミッションを保存し、保存されたファイルの SHA-256 と新しい出力パスを指定して setup_iads を呼び出します。ツールは Skynet-IADS 3.3.0 をその上流テスト済み MIST 4.5.107 とともに検証して埋め込み、その順序で MIST、Skynet、および生成された設定をロードする1つの Mission Start トリガーを追加します。結果の .miz は自己完結型であり、プレイヤーは何もインストールする必要はありません。続行する前に、Mission Editor で出力を開き、save_and_verify を実行してください。

セットアップは、スクリプトハッシュ、ロード順序、連合メンバーシップ、プレフィックス、および名前付きコマンドセンターを検証します。ミッションを実行せずにランタイム IADS 動作を証明することはできません。管理対象 SAM グループごとに1つの SAM システムタイプ、管理対象 EWR グループごとに1つの EWR レーダーを維持し、同じレーダーに対して Skynet と競合するネイティブ放射アクションを追加しないでください。出所、正確なハッシュ、およびライセンスは vendor/skynet-iads/3.3.0 と THIRD_PARTY_NOTICES.md に記録されています。

analyze_terrain_line は、各サンプルをカバーする最も細かいキャッシュされたグリッドを双線形補間し、clear、blocked、または indeterminate を報告します。分類子は明示的な標高解像度エンベロープを使用します。clear と blocked は、エンベロープ全体が視線の片側に留まることを要求します。キャッシュのみのモードは、不確実な回廊と推奨間隔を DCS に連絡せずに報告します。refinement_mode=auto-live は、その境界のある回廊を一致するオープン Mission Editor シアターからサンプリングし、拡張機能の呼び出しごとのサンプル制限に分割し、より細かいタイルをデータセットの下に永続化し、LOS をすぐに再実行します。後続のクエリは、DCS が閉じている状態でそれらのタイルを再利用します。細かい再実行は正当に indeterminate のままになる可能性があります。応答は解像度制限を報告し、可能な場合は clear/blocked の回答を発明するのではなく、より小さい次の間隔を報告します。これはレーダー/SAM 配置とルートスクリーニングに適していますが、建物や木が重要となる最終的な可視性の主張には適していません。

地形タイルが完了した後、セマンティック前処理は 2 km の分類ラスタを導出し、孤立した非水域セルを平滑化し、各4連結コンポーネントを統計、隣接性、および行ランジオメトリを持つコンパクトな地形領域に変換します。空軍基地と集落クラスタはグラフハブになります。道路候補には、80 km 以内の最大4つの隣接と境界のある接続修復が含まれます。鉄道候補には、120 km 以内の最大2つの隣接が含まれます。DCS 鉄道ルーティングは、その地形ネットワークセレクタが無関係な線形フィーチャを返す可能性があるため、候補証拠として扱われます。キャッシュされた鉄道回廊は、両方のアンカーから 1.5 km 以内にスナップし、そのルーティングされた長さは直接分離の少なくとも半分をカバーする必要があります。弱い結果は、エージェントに鉄道として公開されるのではなく、検査のための失敗した候補のままです。transport_batch_limit は、呼び出しごとのライブ DCS パス抽出を制限し、保留中/完了/失敗したエッジ状態は永続的で再開可能です。完了したポリラインは、ハブ ID とスナップされたゲートウェイポイントを保持します。query_transport_context は、完了したキャッシュされたエッジ上の Dijkstra を使用して、オフラインの名前付きハブルートを提供します。route_ground_transport は、ミッション作成に使用される正確な現在の DCS パスに同じ保守的な鉄道チェックを適用します。水上表面の実行は water-crossing-candidate としてラベル付けされ、破壊可能な橋オブジェクトであると断言されません。集落クラスタリングは、意図的に建物ごとのカタログを回避します。これは地形バージョンに敏感で、不必要に大きくなるためです。

ペルシャ湾プロセッサは、DCS 自身の町ラベルを maps/settlements/persian-gulf.json のまばらで編集可能なカタログで補完します。これには、約1980〜1990年のシナリオ語彙用に選択された主要都市、港、および島の集落が含まれます。歴史的な都市フットプリントではありません。前処理中に、DCS は各 WGS84 ポイントをロードされたシアターのローカル座標に変換します。一致する近くの DCS ラベルは、DCS の位置を保持しながら、キュレーションされた名前、エイリアス、タイプ、および重要度を取得します。スタンドアロンのキュレーションポイントは、地域のセマンティック証拠のみのままです。カタログ SHA-256 とソース/時代の出所は semantics.json に保存されるため、カタログを編集すると、標高タイルを再構築せずにキャッシュされた集落と輸送セマンティクスが無効になり再構築されます。意図的に単純なクリーンアップ形式については、maps/settlements/README.md を参照してください。

query_map_context は、境界、semantic_search、またはその両方で呼び出すことができます。セマンティック検索は、地形クラス、最小領域面積、エンティティへの近接性、エンティティの種類/名前、およびおおよその道路アクセスを、地形タイルをロードしたり DCS を必要とせずにフィルタリングできます。inspect_map_view は補完的な詳細パスです。すべての建物や道路標示をキャッシュするのではなく、要求されたスケールで現在の ME レンダリングをアフィン画素からシアターへの変換とともに返します。ME マップカメラを一時的に書き込み、他のゲートウェイミューテーションに対してシリアル化し、キャプチャまたは可視性検証が失敗した場合でも以前のカメラを復元します。正確な DCS ウィンドウハンドルを解決し、DCS が最小化されているか、排他的フルスクリーンの Alt-Tab がキャプチャ可能なサーフェスを削除した場合、ウィンドウジオメトリと回復の詳細で失敗します。ボーダーレス/ウィンドウモードの DCS は、検査中に MCP クライアントの背後に留まることがあります。空軍基地、集落クラスタ、および生の DCS プレースが同じ名前を共有する場合は、返されたエンティティ ID または kind:name セレクタ（settlement:Batumi や airbase:Batumi など）を使用してください。あいまいな裸の名前は、暗黙的に1つを選択する代わりに失敗します。

開発中は npm run viewer でローカルレイヤードキャッシュビューアを実行し、npm run build の後は npm run viewer:start を実行してから http://127.0.0.1:4317 を開きます。クリーンなキャッシュされた地形、連続した地形領域、使用可能および失敗した輸送エッジ、集落ハル、セマンティックエンティティ、およびラベルを DCS に連絡せずに視覚化します。

validate_map_dataset は、タイルの読みやすさと配列チェックをストリーミングし、隣接する共有エッジのみを比較し、マップ全体をメモリに具体化しません。デフォルトの direct_samples=16 は、均等に分散されたキャッシュされたポイントを現在ロードされている DCS シアターと比較します。オフラインのみのチェックには direct_samples=0 を使用してください。レポートはデータセットディレクトリの下に validation.json としても保存されます。完了したデータセットの概要も、境界のある出力ラスタに一度に1タイルずつペイントされます。

境界のあるコーカサス開発ハーネスは、マップの平坦な外側領域ではなく、詳細なバトゥミ-コブレティ海岸から山岳までのストリップを意図的にサンプリングします。

npm run test:live-map

north=-370000..-330000、east=610000..670000 を 250 m でサンプリングし、各タイルの後に進行状況を永続化し、再実行しても安全です。既にキャッシュされたタイルを意図的に更新する場合のみ -- --force を追加してください。マップ全体を処理しません。

水文学の改良

250 m の地形キャッシュは、意図的に権威ある河川ジオメトリとして扱われません。狭い川はグリッドポイントの間に落ち、まばらな青いドットとして表示される可能性があります。preprocess_hydrology_layer は、既存の完了したデータセットに別の hydrology/ キャッシュを添付します。デフォルトの 50 m グリッドは、サンプルごとにコンパクトな2ビットサーフェスコードのみを保存します。標高と地形微分は基本解像度のままです。均一なプレースホルダー陸地または外洋であることが証明されたベースタイルは計画から省略され、詳細で混合した沿岸タイルがサンプリングされます。

代表的な境界から開始し、completeForBounds=true になるまで同一の呼び出しを繰り返します。後で bounds を省略して、同じレイヤーをすべての詳細なベースタイルに拡張します。tile_batch_limit は各呼び出しを制限し、max_tiles は意図的な安全上限にすぎません。変更された間隔、タイルサイズ、シアター、または DCS 地形署名はフェイルクローズします。force=true は意図的に新しい水文学リフレッシュを開始し、その後の再開可能な呼び出しは force=false を使用します。query_map_context は、レイヤーが存在する場合、カバレッジ、正確な境界のあるサーフェスカウント、決定的なステッチメトリクス、およびサンプリングされた8連結の河川/湖コンポーネントを返します。そのプレビューとクリーンなドキュメントマップは、より細かい水マスクを組み込みます。

元のDCSコードとサーフェスカウントは、不変の証拠として残ります。オフラインの方向性ステッチャーは、両端のソースサンプルが同じ線に沿って続く場合にのみ、最大2つの欠落セルを埋めることができます。推論されたセルは別途報告され、コンポーネントの連続性とレンダリングにのみ使用されます。これは、近くの無関係な水路を統合してしまう可能性のある無制限のモルフォロジカルクロージングよりも、意図的に保守的です。コンポーネントのジオメトリは、銀行ポリゴンでもナビゲーションの保証でもありません。選択した間隔よりも狭い河川は依然として断片化される可能性があるため、正確な堤防の配置が重要な場合は、より狭い境界パスまたはライブマップの検査を使用してください。高信頼度の粗いプレースホルダー陸地と一様な海のベースタイルは、設計上、水路学の対象外です。この最適化は、ベースの低詳細キャリブレーションが、マップの非ミッション地形を実際の詳細な平野からすでに分離していることを前提としています。ビューアは、生成されたレイヤーを個別に切り替え可能なRivers / lakesオーバーレイとして公開します。プレゼンテーションは証拠ではなく派生です。湖は平滑化されたサンプル領域ラスターを保持し、河川バンドは決定的に細線化され、保守的にギャップ結合され、簡略化され、固定されたスクリーンスペース幅のアンチエイリアスSVGセンターラインとして描画されます。クエリと検証は、元のパックされたセルと個別に識別されたステッチポイントを引き続き使用します。

完全なパッチスキーマは、MCPリソースdcs-me://schema/mission-patch/0.1としても公開されています。examples/f16-rwr-patch.jsonと、その後のexamples/f16-rwr-route-patch.jsonを参照してください。

ミッション全体のオーサリングは、MCPプロンプトdesign_dcs_missionから開始する必要があります。これは一発指定を要求するのではなく、対話をガイドします。エージェントは、影響の大きい質問をしたり、デフォルトを推奨したり、代替案を提案したり、進行中のプレイヤーロール、成果、フェーズ、グループごとの目的、因果関係の相互作用、能力/搭載、バランスの記録を維持したりできます。正規の人間可読な指示はdocs/design-dcs-mission.mdです。サーバーは、初期化指示、MCPプロンプト、およびガイダンスリソースに同じファイルをロードします。一貫したバックボーンと最初のスライスがミューテーションに先行しますが、承認されたスライスがオーサリングおよびテストされている間、後の詳細は未確定のままで構いません。同じ指示は、読み取り専用リソースdcs-me://guidance/mission-design/0.1としても利用できます。ミッションのコンセプトはユーザーとともに開発され、Mission Editorのバインディング障壁を尊重するために段階的に実装されます。

完全なフラグメントスキーマは、dcs-me://schema/mission-fragment/0.1で公開されています。これは、DCS-SMSプレハブが使用するデータモデル（meta、groups、statics、zones、drawings、triggers）に加えて、明示的な配置ポリシーを受け入れます。エンドポイントはMission Editor内でプリフライトとミューテーションを実行するため、呼び出すにはDCSが必要です。リポジトリのテストスイートの開発と実行にはDCSは不要です。

高レベルのキャリアリクエストスキーマは、dcs-me://schema/carrier-package/0.1で公開されています。最初にget_catalogをkind=carrier_capabilitiesでクエリして、オープンしているDCSインストールの船体、エンタイトルメント、キャリア互換航空機、および護衛タイプを検査してください。dry_run=trueは、ミッションを変更せずにコンパイルされたフラグメントと解決されたウィンドオーバーデッキ計画を返します。自動モジュール選択は、DCSがSupercarrierのインストールと認可を報告した場合はSupercarrierを優先し、それ以外の場合は連合の無料キャリアを選択します。

高レベルの空軍基地リクエストスキーマは、dcs-me://schema/airbase-start/0.1で公開されています。create_airbase_startは、オープンしているMission Editorを必要とし、要求されたセマンティックリビジョンと冪等性キーをチェックし、空いている互換性のあるスタンドをプリフライトし、ネイティブのDCS-SMS構築動詞を呼び出し、新しいスナップショットでグループサイズ、航空機タイプ、ウェイポイントゼロの飛行場リンク、離陸モード、明示的なパーキングIDを検証します。デフォルトのactive_runwayパーキング戦略は、地表風と滑走路指定子を使用して、直線しきい値距離で空いている互換性のあるスタンドをランク付けし、再割り当てを検証します。compactはDCS-SMSの元の近隣グループ選択を保持します。その距離はタクシーのプロキシであり、ルーティングされた時間の保証ではありません。固定陸上飛行場はこのエンドポイントを使用します。キャリアデッキスロットはsetup_carrier_packageを使用します。FARPは別の将来のサーフェスとして残ります。

トリガーフィールド値は、"$ref:<logical_id>"で以前の論理エンティティを参照できます。コンパイラは、その安定したDCS名を代入します。名前付きTriggered Actionへの参照は、トリガーアクションが追加される直前に、DCSの現在の{groupId, taskNumber}タプルに解決されます。スナップショット内のルートポイントindex値とすべてのパッチwaypoint_indexはゼロベースです。トリガールールインデックスとTriggered Actionスロットは1ベースのままです。

サポートされている操作は次のとおりです。

• 既存エンティティ: 正確なグループ、ユニット、トリガー、またはゾーン名に対するadopt_entity。

• グループ: create_group、set_group_task、set_group_late_activation、remove_group。後のパッチがその最初のユニットをアドレス指定する必要がある場合は、create_groupでlead_logical_idを設定します。ゲートウェイはDCSが返す名前をバインドします。

• ユニット: add_unit、set_unit_skill、set_unit_heading、set_unit_loadout、set_unit_payload、clear_unit_payload、remove_unit。ペイロード消耗品: set_unit_fuel、set_unit_chaff、set_unit_flare、set_unit_gun。

• ルート: add_waypoint、insert_waypoint、remove_waypoint、link_waypoint_airbase。

• ウェイポイント動作: add_waypoint_task、add_waypoint_enroute_task、remove_waypoint_task、remove_waypoint_enroute_task、clear_waypoint_tasks、clear_waypoint_enroute_tasks、および型付きのset_waypoint_option操作。タスクfieldsは、targetTypes: ["Air"]などのセレクターを含む、ネストされたJSONライクな配列とレコードを受け入れます。

• グループTriggered Actions: add_triggered_task、replace_triggered_task、remove_triggered_task。これらは、安定した名前を持つタスク/エンルートタスクエントリを作成します。a_ai_taskまたはa_set_ai_taskトリガーアクションフィールドでタスク論理IDを使用します。タスクを削除する前に、それを参照するトリガーアクションを削除してください。

• 環境: 日付/時刻、温度、QNH、視程、乱気流、3レベルの風、雲、ダストに対するset_mission_environment。

• トリガー: create_trigger、add_trigger_condition、add_trigger_action、remove_trigger_condition、remove_trigger_action、remove_trigger。

• ゾーン: create_zone_circle、remove_zone。

同じパッチで作成されたグループのルート編集には、Mission Editorがルート状態の構築を完了できるように、後続のパッチが必要です。add_unitで作成されたユニット、またはcreate_group.lead_logical_idを通じて宣言されたリードの編集または削除も、DCSが操作結果で最終ユニット名を割り当てるため、後続のパッチが必要です。検証は、ミューテーションがディスパッチされる前に、これらを明示的なバリアエラーとして報告します。

プリセット優先の航空機ワークフロー

武装航空機の場合、aircraft_typeとintended_taskを指定してget_aircraft_loadoutsを呼び出します。そのタスクとの互換性を宣言するDCS作成のプリセットを優先します。複数が一致する場合は、ストアがミッションと期待される航続距離に適合する、中程度で明確な名前のプリセットを選択します。チューニングの前に、選択したプリセットに対してinclude_stations=trueを要求します。set_unit_loadoutで適用し、プリセットが満たさない明示的な要件にのみset_unit_payloadまたはclear_unit_payloadを使用します。DCSの名前付きプリセットはパイロンのみを変更します。ユニットの継承された燃料/チャフ/フレア/ガン値を、返された機体の最大値とカウンター測度のデフォルトと比較し、不適切な値を明示的に設定します。ストア固有の信管/プログラム設定は、まだゲートウェイの制約付きパッチスキーマの一部ではありません。

搭載列挙は、DCS Mission Editor me_loadoututils上のゲートウェイ所有の読み取り専用アダプターであり、正式なDCS-SMS動詞ではありません。したがって、バージョンに敏感であり、Mission Editor APIが変更された場合はフェイルクローズし、安定したEagle Dynamicsインターフェースとして主張するのではなく、ローカルにインストールされたDCSビルドに対して検証されています。

AI動作の場合、最初に実際のグループとタスク種類に対してget_ai_task_catalogを呼び出し、次にdescribe_ai_taskを呼び出します。EngageGroup/AttackGroupは数値のgroupIdを必要とします。ユニットバリアントはunitIdを必要とします。EngageTargetsInZoneは劇場ローカルのx（北）とy（東）を必要とします。現在のセマンティックスナップショットのIDを使用してください。タスク名だけでは、有効なターゲット割り当てにはなりません。

安全境界

基盤となるDCS-SMSブリッジは、完全なMission Editor環境でLuaを実行します。このサーバーは、生成されたコードを固定バッチディスパッチャーとJSON/base64シリアル化されたDCS-SMS動詞呼び出しに制限します。ローカルに保ち、そのstdioを認証されていないネットワークサービスに公開せず、不要な場合はExternal実行を無効のままにしてください。

オフライン検証器とパッチレポートはDCS-SMSメールボックスを使用せず、DCSがインストールまたは実行されている必要もありません。これらは構造的および参照整合性のみを確立します。DCSがアーカイブをロードし、保存時に同一に正規化すること、またはランタイムAI、センサー、トリガー、兵器が意図したとおりに動作することを証明することはできません。これらは明示的な後の受け入れレイヤーとして残ります。

ライセンス

MIT。DCS-SMSは別のプロジェクトです。そのtools/ツリーはGPLv3です。

Windowsリリースのビルド

リリースビルダーは、ゲートウェイをコンパイルし、ロックされた本番npm依存関係のみをステージングにインストールし、公式のNode Windowsディストリビューションをダウンロードして公開されたSHA-256を検証し、正確な互換性のあるDCS-SMSブリッジソースとGPLテキストをコピーし、npmライセンスをインベントリし、ファイルごとのマニフェストを書き込み、ZIPとチェックサムを生成します:

npm run release:windows -- -DcsSmsSource C:\path\to\dcs-sms

カスタマイズされたブリッジ0.32.4ソースがコミットおよび公開されるまで、リリースは検証済みのローカルDCS-SMSワークツリーからビルドする必要があります。生成されたpayload/bridge/SOURCE.mdは、そのベースリビジョンとワークツリーがダーティであったかどうかを記録します。対応する完全なブリッジソースは同じパッケージ内にあります。