記事をシェア
B!

MSFS SDKのプロジェクトの作り方/Google Earth Decoderのためのプロジェクトを作る

ユーザーは、MSFS SDKを使って、マイクロソフトフライトシミュレーター用のアドオンコンテンツを作ることができます。これは、SDKによって定義される「プロジェクト」というフォルダー構造に格納されます。
ここではMSFS SDKのプロジェクトの解説と、Google Earth Decoder(Google Earthの3DマップをMSFS用に変換するツール)のためのプロジェクトを作る方法を解説します。

Show this page in English

各種ツール類のインストール
プロジェクトとパッケージとアセットグループ
プロジェクトの構造
パッケージの命名規則
MSFS SDKでプロジェクトを作る
Blenderのプラグインでプロジェクトを作る
プロジェクトをビルドする
ゲーム画面でプロジェクトのビルド結果を確認する

各種ツール類のインストール

マイクロソフトフライトシミュレーター用のアドオンコンテンツを作るには、まず各種ツール類をパソコンにインストールしてください。下記のページをご参照ください。

MSFS SDK/Blender/プラグインのダウンロードとインストールの方法

プロジェクトとパッケージとアセットグループ

MSFS SDKの「プロジェクト」には複数の「パッケージ」を作ることができます。そして各「パッケージ」には、複数の「アセットグループ」を組み込むことができます。
「パッケージ」とは、アドオンとして配布される単位です。 flightsim.to などのサイトで配布されているシーナリーや航空機、空港などのアドオンは、この「パッケージ」フォルダーを圧縮したものです。
「アセットグループ」とは、パッケージに組み込まれる部品です。「アセットグループ」の種類には、ModelLib、ArtProj、BGL、Mission、SimObjectなどがあります。これらアセットグループの詳細については、MSFS SDK docsの ASSET TYPES のページで読めます。
「パッケージ」フォルダーは、MSFSのデータ格納フォルダの中にある"Community"フォルダーに保存すると、ゲームに読み込まれ(インストールされ)ます。ゲーム内のマーケットプレースからダウンロード購入したアドオン「パッケージ」は、MSFSのデータ格納フォルダの中にある"Official"フォルダーに保存されます。

USING THE SDK (MSFS SDK docs)

ASSET TYPES (MSFS SDK docs)

プロジェクトの構造

各プロジェクトフォルダーの中には、次のようなフォルダーが生成されます。

General Package Folder Structure
Folder	Description
_PackageInt	開発に伴い、パッケージに加えられた変更の履歴や各種パラメーターなどの情報が記録されていきます。SDKによって生成されます。
PackageDefinitions	パッケージに組み込まれたアセットグループの情報など、パッケージの内部構造を示す情報が格納されます。SDKによって生成されます。
Packages	パッケージの完成品が格納されます。この中身を、アドオンとしてほかのユーザーに配布することができます。ビルドという操作を行うことで、SDKによって生成されます。
PackagesMetadata	(??)
PackageSources	シーナリーの3Dモデルなど、パッケージを構成する元データ(アセットグループ)を保存します。開発者が準備します。
[プロジェクト名].xml	プロジェクトの基本情報が格納されます。MSFS SDKでプロジェクトを開くときは、このファイルを指定します。SDKによって生成されます。

これらの詳細については、MSFS SDK docsの USING THE SDK のページで読めます。

USING THE SDK (MSFS SDK docs)

パッケージの命名規則

MSFS SDKでは、パッケージの命名規則が厳密に決められています。あなたが開発したアドオンを、広くほかのユーザーに配布する場合は、この命名規則にのっとった名前を付ける必要があります。また、パッケージ名は英数字128文字以内に収める必要があります。

Basics of package naming conventions
基本規則	developer - type ( - subtype ) - name-of-asset ( - variation-of-named-asset ) ( - subcontent )

"developer"とは開発者(あなた)の名前です。下記の一覧表では"company(会社名)"と表現されています。 MSFS SDKでプロジェクトを作ると、自動的に付加されます。
"type"とは、アドオンのタイプを示す単語で、下記の表のように決められています。
この後ろに、アドオンの内容を示す名前を付けます。

Package naming conventions
Package Type	Naming conventions
空港(Airports)	<company>-airport-<ICAO>-<airport_name>
航空機(Aircraft)	<company>-aircraft-<aircraft_name>
航空機のペイント(Aircraft Liveries)	<company>-aircraft-<aircraft_name>-livery-<livery_name>
着陸チャレンジ(Landing Challenges)	<company>-landingchalenge-<ICAO>-<name>
ディスカバリーミッション	<company>-discovery-<name>
ブッシュトリップ	<company>-bushtrip-<name>
モデルライブラリ	<company>-modellib-<name>
動くオブジェクト(SimObjects)	<company>-simobjects-<type>
シーナリー	<company>-scenery-<name>

Google Earth Decoderを使って作成するアドオンのタイプは「シーナリー」になります。
例えば開発者someoneさんが、tokyoという名前のシーナリーを配布する場合は、パッケージに"someone-scenery-tokyo"という名前を付ける必要があります。
命名規則の詳細については、MSFS SDK docsの THE PROJECT EDITOR のページで読めます。

THE PROJECT EDITOR (MSFS SDK docs)

MSFS SDKでプロジェクトを作る

例として、Google Earth Decoder(Google Earthの3DマップをMSFS用に変換するツール)のためのシーナリープロジェクトを作る手順を紹介します。これには、MSFS SDKで作る方法と、Blenderプラグインで作る方法があります。まずは、MSFS SDKで作る方法を紹介します。

パッケージ名の決定

ここでは仮に、開発者名を"someone"、シーナリーの名前を"tokyo"とします。すると、上に示した命名規則にのっとり、パッケージ名は"someone-scenery-tokyo"となります。

プロジェクトの作成

MSFSを起動し、開発者メニューで[File]-[New project]を選びます。

このようなウインドウが開きます。
Projects Folder欄には、プロジェクトを保存するフォルダーを指定します。大量のデータを何度も読み書きするので、SSDではなく、大容量のハードディスクを使うのがおすすめです。
Project Name欄には、開発者名の部分を除いたプロジェクト名を指定します。今回の例では"scenery-tokyo"となります。
Default creator name欄には、開発者の名前を入れます。あなたの名前、ペンネームなどを指定します。今回の例では"someone"となります。
Default company name欄には、制作会社名を入れます。個人開発者の場合はDefault creator name欄と同じで良いでしょう。今回の例では"someone"となります。
そして画面右下の[Create new project]ボタンをクリックします。するとProjects Folder欄で指定したフォルダーの下に、"scenery-tokyo"という名前のプロジェクトフォルダーが生成されます。

次にこのようなウィザード画面が開きます。今回作成するのはパッケージなので、画面の一番左にある[Package]ボタンをクリックします。そして画面右下の[Next]をクリックします。
なお、Packs(複数の作成済みパッケージをセットにして配布する)やBundles(すでにマーケットプレースで公開済みのパッケージをセットにして販売する)を作るときは[Bundle/Pack]を選びます。この場合は、一つのプロジェクトに複数のパッケージを含むことになります。
また、PacksやBundlesを新しいプロジェクトとして作成するときには、今回作る新しいプロジェクトに、既存のパッケージを追加することができます。この場合は[Import Item]を選びます。

つづいてこのような画面になります。航空機を作るときは[Aircraft]、空港を作るときは[Airport]、炎や煙などの視覚効果を作るときは[Visual effect]ボタンをクリックします。シーナリーなど、その他のタイプのアドオンを作る場合は、画面一番右の[Custom]ボタンをクリックします。
[Custom]をクリックすると、その下に次のような項目が現れます。
Display title欄には、このパッケージの表示名を指定します。これはマーケットプレイスなどで配布するときのタイトルとして表示されます。
Company name欄には、制作会社名を入れます。個人開発者の場合は、あなたの名前やペンネームなどを指定します。
Package name欄には、命名規則にのっとって決めたパッケージ名"scenery-tokyo"を指定します。
Content-Type欄のドロップダウンリストで、パッケージのタイプを指定します。今回は"SCENARY"を指定します。
そして画面右下の[Next]をクリックします。

つづいてアセットグループの指定画面になります。パッケージには最低一つのアセットグループが必要です。まずは最も基本的な情報を保存する"BGL"タイプのアセットグループを作ります。
Asset group name欄には、アセットグループの名前を指定します。 Google Earth Decoderを使うと、"scene"というBGLアセットグループが生成されます。今回は、これに合わせて"scene"と入力することにします。
Asset type欄には、アセットグループのタイプを指定します。ここでは"BGL"を選択します。
そして画面下の[Create]をクリックします。

MSFSの画面には"Project Editor"が表示されます。その中には、青い文字で、このプロジェクトに含まれているパッケージ名の一覧が表示されます。図の例では、"someone-scenery-tokyo"というパッケージ1つだけが含まれています。
パッケージ名をクリックすると、そこに含まれるアセットグループの一覧が表示されます。図の例では、"scene"という名前の"BGL"タイプのアセットグループ1つだけが含まれています。
なお、この画面の下にある[Add Item]ボタンを使うと、新たなパッケージを追加することができます。また[Import Item]ボタンを使うと、既存のパッケージを追加(Bundle/Pack)することができます。

以上でGoogle Earth Decoderのためのシーナリープロジェクトの作成は完了しました。 Project Editorの[Project]-[Save]を選んでプロジェクトを保存し、[Project]-[Close]を選んでプロジェクトを閉じ、MSFSを終了します。

プロジェクト保存フォルダーの下には、このようなフォルダーが生成されます。この中にある"PackageSources"フォルダーを、Google Earth Decoderの出力先として指定します。

Google Earth Decoder使用後の設定

Google Earth Decoderを起動して、マップデーターをダウンロードします。
Google Earth Decoderのインストール方法については、下記をご覧ください。

MSFS SDK/Blender/プラグインのダウンロードとインストールの方法

すると"PackageSources"フォルダーの下に"modelLib"と"scene"という2つのアセットグループが生成されます。これらをプロジェクトに追加します。
なお、この図で見えている"Scenery"というフォルダーは、SDKでプロジェクトにBGLアセットグループを追加したときに、SDKによって自動的に生成されたものです。

MSFSを起動し、開発者メニューで[File]-[Open project]を選びます。
またはこの下の[Open resent]を選ぶと、最近開いたプロジェクトの一覧から選択することも可能です。

するとファイル選択ダイアログボックスが表示されるので、プロジェクトフォルダーの直下にある"[パッケージ名].xml"ファイルを選択します。
なお、一つのプロジェクトに複数のパッケージを作ると、ここに複数の"[パッケージ名].xml"ファイルが生成されます。

プロジェクトが読み込まれて、"Project Editor"が表示されます。青い文字のパッケージ名("someone-scenery-tokyo")をクリックし、アセットグループの一覧を表示させます。そしてプロジェクトの新規作成時に追加した、"scene"という名前の"BGL"アセットグループを選択します。

アセットグループ"scene"の設定を変更します。 Project Editorのメニューから[View]-[Inspector]を選びます。

するとInspectorが開き、アセットグループ"scene"の詳細情報が表示されます。ソースフォルダー(AssetDir欄)が、SDKによって自動生成されたフォルダーとなっているので、これをGoogle Earth Decoderが生成した"scene"フォルダーに変更します。

"AssetDir"と書かれている場所の左にある[...]をクリックすると、フォルダー選択ダイアログ画面が表示されます。 "PackageSources"フォルダー直下にある、Google Earth Decoderが生成した"scene"を選びます。

このようになりました。
"OutputDir"については特に変更は不要です。あなたのパッケージの設計に合わせて、お好みで修正してください。一般に配布されているGoogle Earthから生成されたシーナリーアドオンでは、ここには"scenery/world/scenery"が指定されることが多いようです。

つづいてプロジェクトに、3Dマップデーターが保存されている"modelLib"を追加します。 Project Editorの画面で、青い文字のパッケージ名("someone-scenery-tokyo")をクリックします。

するとInspectorの画面が、パッケージ全体情報に切り替わります。画面下部のアセットグループ一覧にある[Add asset group]ボタンをクリックします。
もしInspectorを閉じてしまった場合は、Project Editorの画面で[View]-[Inspector]を選んでください。

追加するアセットグループのタイプは[Custom]を選びます。そして画面下の[Next]をクリックします。

つづいて追加するアセットグループの情報を入力します。
Asset group name欄には、アセットグループの名前を指定します。 Google Earth Decoderを使うと、"modelLib"というModelLibアセットグループが生成されます。今回は、これに合わせて"modelLib"と入力することにします。
Asset type欄には、アセットグループのタイプを指定します。ここでは"ModelLib"を選択します。
そして画面下の[Create]をクリックします。

するとパッケージに"modelLib"という名前の"ModelLib"アセットグループが追加されました。

アセットグループ"modelLib"の設定を変更します。 "scene BGL"の設定を変更したときと同じように、Project Editorの画面で"modelLib"をクリックし、Inspectorの画面でソースフォルダー(AssetDir)を変更します。
"OutputDir"については特に変更は不要です。あなたのパッケージの設計に合わせて、お好みで修正してください。一般に配布されているGoogle Earthから生成されたシーナリーアドオンでは、ここには"scenery/global/scenery"が指定されることが多いようです。

以上でGoogle Earth Decoder向けのプロジェクトの作成は完了です。 Project Editorの画面で[Project]-[Save]を選んで、プロジェクトを保存しましょう。つづいてプロジェクトのビルド作業に進みましょう。

プロジェクトをビルドする

PackageSourcesフォルダーの下にある"Scenery"フォルダーは、MSFS SDKによって自動生成されたアセットグループのフォルダーです。 Google Earth Decoderで生成したアセットグループを使用する場合は、このフォルダーは使用しないので、削除しておきましょう。

Blenderのプラグインでプロジェクトを作る

ここでは、Blenderのプラグイン「Google Earth Decoder Optimization Tools」を使って、Google Earth Decoderのためのシーナリープロジェクトを作成する方法を解説します。