WTmissionEditor - warthunder

*目次 [#p3e98e67]
#contents
*WTmissionEditorとは [#aa22cbff]
WTmissionEditor（以下ミッションエディタ）は公式が配布しているツールセットの1つ。非常に自由度の高いツールであり、シングル用ミッションはもちろん、カスタムバトルを用いてのマルチ用ミッションも作成する事が出来る。本Wikiには既に[[ミッションエディッタ]]が存在しているが、本ページはより初心者へと向けたページとなる。
このページではミッションエディタの最低限の使用方法やインストール方法を解説する。

*公式解説動画[#fsdada56]
公式がアップロードしている解説動画。非常に参考になるので一度は目を通しておこう。
#youtube(GCb0sd3pfKk,460,360)
#youtube(G9Zp32d3Gjw,460,360)

**環境構築 [#yaju4545]
***ダウンロード[#h0m01919]
Warthunder公式WikiにてCDKは配布されている。[[Download War Thunder CDK>https://wiki.warthunder.com/index.php?title=Download_War_Thunder_CDK]]に進み、一番上（Current Version）のファイルをダウンロードしよう。((2024/10/6現在の最新版はJuly 26 2024))
なお&color(red){大前提};として本ツールはWindows&color(red){限定};であり、Mac、Linux系のOSには非対応である。
余談だがこのツールセットにはミッションエディタの他に[[アセットヴューアー]]、[[ロケーションエディタ>ロケーションED]]の2つのツールも同封されている。本Wikiにはそれぞれ専門ページがあるので興味があればこれらのツールも使ってみよう。
***インストール[#fse4s46]
先程ダウンロードした「WarThunderCDK_（日付）.exe」を開くと最初に言語設定の項目が表示されるので、英語を選択しよう。なお、本ツールは日本語に対応していない点は要注意。
続いてインストール先の設定に入るが、インストーラー側が勝手にWarthunderのファイルを見つけてセッティングしてくれているので&color(red){絶対};に弄らない事。((例外としてはDev鯖でCDKを使用する時))下手に弄ると正常に動作しなくなる可能性があるためである。
その次の項目はデスクトップにショートカットを作成するか否かの設定。あると便利なので項目にチェックを入れておこう。
そうするとインストール先、オプションの確認が表示されるので「install」をクリック。「Completing the War thunder CDK Setup Wizard」と表示されれば、CDKのインストールは成功。((Lanuch Misson Editorの項目はミッションエディタを起動するか否かの項目。筆者はどっちでもいいと思います…))

*ミッションエディタ入門 [#h4856e12]
***起動[#bdsb4453]
先程作成したショートカットからWTmisionEditorを起動しよう。もし見つからない場合は、Windowsの検索バーに「Mission」と入力すればWTMissionEditorのソフトが表示されるのでそちらでも可。

**操作方法・ツールバー[#sfsa6494]
***操作方法[#hnki3rd00]

全てのキー配置を網羅はしていないが、基本的にこれらの操作が出来れば大丈夫。本ツールは後述するツールバーに機能の大半が集約されているためである。
|>|SIZE(11):CENTER:|c
|デフォルトのキー(PC)|機能|h
|>|~視点操作|
|マウスホイール|細かい拡大/縮小|
|ホイールドラッグ|細かい視点の移動|
|ホイールドラッグ+Ctrl+Alt|視点の拡大/縮小((筆者はこっちを常用する事を推奨))|
|ホイールドラッグ+Alt|視点の回転|
|ホイールドラッグ+Ctrl|視点の移動|
|Space|フライモードON/OFF。WASD操作で視点を移動する事が出来る。|
|>|~その他|
|Ctrl+Z|元に戻す|
|Ctrl+Y((この手のソフトにありがちな''Shift+Ctrl+Zではない''ので&color(red){要注意};&#8252;))|やり直す|
|(&attachref(SandBox/WTmissionEditor/MissionEditor_MoveIcon_Wiki.jpg,nolink,70%);モード時にユニットを選択した状態で)ドラッグ+Shift|ユニットをコピー((メチャクチャ使う))|
|Ctrl+M((''Ctrl+Sではない''ので&color(red){要注意};&#8252;これは本当に罠))|&attachref(SandBox/WTmissionEditor/MissionEditor_SaveMissionIcon_Wiki.jpg,nolink);ミッションを保存|
|>|~各モード選択|
|Q|&attachref(SandBox/WTmissionEditor/MissionEditor_SelectIcon_Wiki.jpg,nolink);オブジェクトの選択|
|W|&attachref(SandBox/WTmissionEditor/MissionEditor_MoveIcon_Wiki.jpg,nolink);オブジェクトの移動|
|P|&attachref(SandBox/WTmissionEditor/MissionEditor_ShowHideObjectIcon_Wiki.jpg,nolink);オブジェクトのプロパティを開く|
|Shift+P|&attachref(SandBox/WTmissionEditor/MissionEditor_TriggersSettingIcon_Wiki.jpg,nolink);トリガー/ミッションオブジェクトの設定|

***ツールバー[#hnkistrl00]
基本的に使用するのは赤（移動/設定）、青（可視化）、緑（配置）、橙（保存）の4色のエリアだけである。
#attachref(SandBox/WTmissionEditor/bar.jpg,nolink)

//~&attachref(./,nolink);

#accordion(赤（移動/設定系）,***,close){{
|CENTER:BGCOLOR(#fadbda):SIZE(12):||c
|~&attachref(SandBox/WTmissionEditor/MissionEditor_SelectIcon_Wiki.jpg,nolink);|オブジェクトの選択|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_MoveIcon_Wiki.jpg,nolink);|オブジェクトの移動|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_MoveOverSurfaceIcon_Wiki.jpg,nolink);|マップの地面に沿ってオブジェクトを移動する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_RotateIcon_Wiki.jpg,nolink);|オブジェクトを回転する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_ScaleIcon_Wiki.jpg,nolink);|オブジェクトのサイズを変更する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_DropObjectIcon_Wiki.jpg,nolink);|選択したオブジェクトをマップの地面に合わせる|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_SelectObjectNameIcon_Wiki.jpg,nolink);|オブジェクトのリストを表示する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_ShowHideObjectIcon_Wiki.jpg,nolink);|オブジェクトのプロパティを開く|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_TriggersSettingIcon_Wiki.jpg,nolink);|トリガー/ミッションオブジェクトの設定|
}}

#accordion(青（可視化系）,***,close){{
|CENTER:BGCOLOR(#a9ceec):SIZE(12):||c
|~&attachref(SandBox/WTmissionEditor/MissionEditor_ShowNamesIcon_Wiki.jpg,nolink);|マップにオブジェクト/エリアの名前を表示/非表示|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_ShowWaypointsIcon_Wiki.jpg,nolink);|マップにウェイポイントを表示/非表示|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_ShowUnitsIcon_Wiki.jpg,nolink);|マップにオブジェクトを表示/非表示((非表示にする理由が一切ないので必ず表示しよう))|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_UnitsAssetsIcon_Wiki.jpg,nolink);|マップにオブジェクトのモデルを表示/非表示|
}}

#accordion(緑（配置系）,***,close){{
|CENTER:BGCOLOR(#69b076):SIZE(12):||c
|~&attachref(SandBox/WTmissionEditor/MissionEditor_OnlyZonesIcon_Wiki.jpg,nolink);|選択機能でエリアのみを選択する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_OnlyEffectsIcon_Wiki.jpg,nolink);|選択機能でエフェクトのみを選択する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_OnlyUnitsIcon_Wiki.jpg,nolink);|選択機能でオブジェクトのみを選択する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_OnlyWaypointsIcon_Wiki.jpg,nolink);|選択機能でウェイポイントのみを選択する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_PointZoneIcon_Wiki.jpg,nolink);|ポイントを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_SphereZoneIcon_Wiki.jpg,nolink);|球体のエリアを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_CylinderZoneIcon_Wiki.jpg,nolink);|円柱のエリアを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_BoxZoneIcon_Wiki.jpg,nolink);|直方体のエリアを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_CreateEffectIcon_Wiki.jpg,nolink);|エフェクトを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_CreateUnitIcon_Wiki.jpg,nolink);|ユニットを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_CreateEffectIcon_Wiki.jpg,nolink);|ウェイポイントを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_UnitChoiceIcon_Wiki.jpg,nolink);|作成するユニットのタイプを選択|
}}

#accordion(橙色（保存系）,***,close){{
|CENTER:BGCOLOR(#FFA500):SIZE(12):||c
|~&attachref(SandBox/WTmissionEditor/MissionEditor_NewMissionIcon_Wiki.jpg,nolink);|新しいミッションを作成|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_OpenMissionIcon_Wiki.jpg,nolink);|ミッションのファイルを開く|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_SaveMissionIcon_Wiki.jpg,nolink);|ミッションを保存する|
|~&attachref(SandBox/WTmissionEditor/MissionEditor_SaveMissionAsIcon_Wiki.jpg,nolink);|ミッションに名前を付けて保存する|
}}


アイコン画像引用元：[[【公式wiki】Instructions for Using the Mission Editor>https://wiki.warthunder.com/Instructions_for_Using_the_Mission_Editor]]

#fold(やっておいた方がいい設定){{
デフォルトでは移動や視点操作が非常に遅く、筆者はとても不便だと感じるのでカメラの移動量等を調整する事を強く推奨。
Setting->Cameraから設定画面を開く事が出来るので、好みの数値に設定しよう。
#attachref(SandBox/WTmissionEditor/camera.png,nolink,70%)
}}

**ミッションを作ってみよう[#bdwb5f53]
この項目では実際に簡単なミッションを作成しながら、ミッションエディタの基本を解説する。

***マップ選択[#bdsb4453]
以下の様なウィンドウが表示されたら、「…」をクリック。すると大量のファイルが表示されるはずである。これらは全てマップデータで、よく見るとファイル名にもそれっぽい名前が付いている。((例:avg_container_port.bin=貨物港,air_skyscraper_city.bin=都市))
#attachref(SandBox/WTmissionEditor/Select_map.jpg,nolink,70%)

今回は「avg_training_ground.bin」を開いてみよう。正しく選択されていれば、広大な海とそこそこ大きな島が表示されるはずである。
#attachref(SandBox/WTmissionEditor/map_1.jpg,nolink,70%)

***車両の配置[#ff5w4973]
マップのこの地点にプレイヤー用の車両を配置してみよう。&attachref(SandBox/WTmissionEditor/MissionEditor_UnitChoiceIcon_Wiki.jpg,nolink);にあるリストから「tankmodels」を選択したら、&attachref(SandBox/WTmissionEditor/MissionEditor_CreateUnitIcon_Wiki.jpg,nolink);をクリックして車両を配置しよう。配置出来たら、同じ要領で向かい合わせになるように敵用の車両を配置してみよう。車両を回転する際は&attachref(SandBox/WTmissionEditor/MissionEditor_RotateIcon_Wiki.jpg,nolink);を押して回転できるほか、左上のY軸に数値を打ち込む事でも可能。
#attachref(SandBox/WTmissionEditor/map_2.jpg,nolink,70%)
***プロパティの設定[#jifa0138]
プロパティではユニットの設定を自由自在に設定する事が出来る。今回はプレイヤー用の車両、敵車両のプロパティを設定しよう。
#accordion(プレイヤー車両の設定,***,close){{{
まずプレイヤー用の車両を変更するために「tankModels_01」を選択した状態で&attachref(SandBox/WTmissionEditor/MissionEditor_ShowHideObjectIcon_Wiki.jpg,nolink);をクリックし、プロパティを開こう。デフォルトでは「aaa_dummy」となっているが、ここを「ussr_bt_5」に、army((チームの設定。1がA,2がB))を1に設定しよう。

次にミッションで使用する車両の弾薬,改修を設定しよう。Object Properties->Weapon & Bullets内の「Bullets 0」の項目を「45mm_ussr_AP_1942」、「Bullets Count 0」を40に設定しよう。この設定を行う事でプレイヤーの車両にはAP弾が40発装填される設定になる。

続けてObject Properties->Modifications内の「Add」ボタンをクリックし、「tank_tool_kit」,「tank_medical_kit」,「manual_extinguisher」を追加しよう。これでプレイヤーの車両は修理キット,消火器,追加の搭乗員を使用できるようになった。((「new_tank_engine」等他にも項目等もあるのでおおよそ察しているかもしれないが、CDKでミッションを作成する際、この項目を設定しない限り全てのユニットは未改修状態である。この点は頭に入れておこう。))
以下の画像と同じ設定になっていれば設定は完了だ。
#fold(参考画像){{
#attachref(SandBox/WTmissionEditor/player.jpg,nolink,70%)
}}
この作業が完了したら、次はこの車両をプレイヤーが操作するユニットとして割り当てる作業をしよう。
Properties->Mission Settings->player_teamA内の「Wing」のボタンを押して、「tankModels_01」を割り当てよう。これでプレイヤー車両の設定は完了だ。

}}}

#accordion(敵車両の設定,***,close){{{
「tankModels_02」を選択し、こちらは「jp_type_97_chi_ha」に設定しよう。設定出来たらObject Properties->Properties内の「attack_type」((この項目ではAIが何を攻撃するか設定する事が出来る。))を開き、「fire_at_will」を「hold_fire」に変更しよう。以下の画像の様になっていれば正しく動作するはずだ。
#fold(参考画像){{
#attachref(SandBox/WTmissionEditor/enemy.jpg,nolink,70%)
}}
}}}

#fold(ユニット名が分からない！){{
そんな時に便利なのが、公式Wikiの[[CDK Reference/Units>https://wiki.warthunder.com/CDK_Reference/Units]]ページ。なんと全2,467ユニット全てのファイル名が網羅されているのだ。
ブクマしておくと非常に便利。
}}
***トリガーの設定[#jifa4438]
MissionEditorで最も重要かつ複雑難解な機能がトリガー機能である。しかし一度理解してしまえば世界が変わる程の便利な機能だ。
この項目では、「敵車両を撃破した際にミッションを完了させる」といった簡単なトリガーを作成する。

まずProperties->Triggers/Mission Obj. Navigation内にある「Trigger」ボタンをクリック。すると「Trigger_01」という名前の新しいトリガーが作成される。&attachref(SandBox/WTmissionEditor/MissionEditor_TriggersSettingIcon_Wiki.jpg,nolink);をクリックすると以下の画像の様になっているはずだ。
#attachref(SandBox/WTmissionEditor/Trigger_1.jpg,nolink,70%)

それではトリガーを設定するために以下の指示に従って3つの設定をやってみよう。
#accordion(Events,***,close){{{
「periodicEvent」((指定された間隔でトリガーを実行するイベント))のtime((実行頻度))を0.05に設定しよう。
#fold(参考画像){{
#attachref(SandBox/WTmissionEditor/Events.jpg,nolink,70%)
}}
}}}
#accordion(Conditions,***,close){{{
「Condition」ボタンをクリックし、敵車両のステータスを参照するために「unitWhenStatus」((指定したユニットのステータスをチェックするコンディション))を選択しよう。objectをtankModels_02、object_typeをisKiledに設定出来たら完了である。
#fold(参考画像){{
#attachref(SandBox/WTmissionEditor/Conditions.jpg,nolink,70%)
}}
}}}
#accordion(Actions,***,close){{{
「Action」ボタンをクリックし、ミッションを完了させるために「missionCompleted」((ミッションを完了させるアクション))を選択しよう。プレイヤー側のチームはAなので、teamをAに選択しよう。
#fold(参考画像){{
#attachref(./Actions.jpg,nolink,70%)
}}
}}}


#fold(Events?Conditions?Actions?WTF?){{
&color(red){Events};:いつ実行する？
&color(teal){Conditions};:どの条件で実行する？
&color(blue){Actions};:何を実行する？

例えば今回のトリガーであれば、&color(red){0.05秒間隔で};&color(teal){tankModels_02のステータスを参照して撃破されてたら};&color(blue){ミッションを完了させるよ};、と言った具合である。

}}

***マップの書き出し[#ffa5470a]
最後にマップの設定を行う。Propeties->missionタブを開き、「locname」((ゲーム内ではミッション名として表示される))に分かりやすい名前を付け、level((ユーザーミッションをプレイする時に読み込むマップファイルの指定。))の項目を「levels/avg_training_ground.bin」に設定したら全ての作業は完了。
&attachref(SandBox/WTmissionEditor/MissionEditor_SaveMissionAsIcon_Wiki.jpg,nolink);をクリックし、適当な名前でミッションを保存。この時、正しく「UserMissions」ファイルを選択しているか確認しよう。ゲームで正しく動作すれば、このミッションは完成だ。

***サンプルミッション [#pjo421k7]
&attachref(SandBox/WTmissionEditor/WarthunderCDK_Tutorial.blk);

**マルチ用ミッション [#h48fe12]
工事中…

** コメント [#comment]

----

#zcomment(t=warthunder%2F2903&h=350&style=wikiwiki&size=10)