TpF モデルとして組み立てる

3Dモデルとテクスチャが完成したら、TpFモデルエディタを使って TpF2 向けのモデルを組み立てていきます。

1. MOD フォルダを作成する

まずは、TpF2 モデルを MOD として格納するためのフォルダを作成します。ユーザデータフォルダの staging_area フォルダの下にフォルダを作成してください。MOD フォルダのフォルダ名は、「(ユーザ名)_(モデル名)_(バージョン番号)」とする必要があります。

フォルダができたら、その中に「mod.lua」という名前のファイルを作成してください。そしてファイルをテキストエディタで開き、次の内容を入力して保存してください。

function data()
  return {
    info = {
      name = "Demo",
      description = "This is a demo",
      authors = {
        {
          name = "Nosrith",
          role = "CREATOR",
        },
      },
      tags = {"vehicle"},
    },
  }
end

name や description にはご想像の通り、MOD の名前や説明、作者の名前などが入ります。ご自身の好きな名前を付けてください。

この状態で TpF モデルエディタを起動すると、左上のコンボボックスに新しく追加した MOD フォルダが追加されています。ここに、これまで作成した 3D モデルやテクスチャを設定していきます。

2. 3D モデルを Blender からエクスポートする

次は、Blender で作成した 3D モデルを TpF モデルエディタにインポートするために、TpF モデルエディタが読み込み可能な形式（FBX）でモデルをエクスポートします。

まずは、オブジェクトに設定しているモディファイアーをすべて適用する必要があります。Blender 上ですべてのオブジェクトを選択し、ヘッダーの「オブジェクト」→「変換」から「カーブ/メタ/サーフェス/テキストからメッシュ」を選択してください。すべてのモディファイアーがオブジェクトに適用されます。

オブジェクトに設定していたモディファイアーは、一度適用されると削除されます。あとで修正作業を行うときにはモディファイアーがある方が便利なので、このエクスポートの手順が終わったら、「編集」→「元に戻す」を使ってモディファイアーを復元することをお勧めします。

モディファイアーを適用したら、エクスポートの操作に移ります。Blender の「ファイル」メニューから「エクスポート」→「FBX (.fbx)」を選択してください。エクスポート用のダイアログが開きます。

ダイアログが開いたら、まずは保存先フォルダと保存ファイル名を次の通り設定してください。フォルダが存在しない場合、ダイアログ内のボタンでフォルダを新規作成できます。

設定項目

設定値

保存先フォルダ

(ユーザ設定フォルダ)\fbx_import\vehicle-train-demo

保存ファイル名

vehicle-train-demo_lod0.fbx

エクスポートするフォルダ名・ファイル名は、名前の形式が厳密に決まっています。上の設定では、次のような意味になります。

vehicle
- 乗り物のモデルであることを示します。他には station や building などがあります。
train
- 動力付きの鉄道車両であることを示します。他には bus や plain などがあります。動力なしの場合は waggon になります。
demo
- モデルファイルの名前で、制作者が自由に決められますが、他の MOD と重ならない名前にしてください。この名前はファイル名またはフォルダ名としてだけ使われ、ゲーム内で使われることはありません。
lod0
- Level 0 の LOD モデルであることを示します。LOD については後ほど説明します。

フォルダとファイル名を指定したら、ダイアログの右上にある歯車マークのボタンを押して、設定画面を開いてください。そして、「トランスフォーム」グループの中にある「トランスフォーム適用」にチェックを入れてください。

ここまでできたら、「FBXをエクスポート」ボタンを押して、モデルをエクスポートしてください。エクスポートが終わったら、メニューの「編集」→「元に戻す」で、適用したモディファイアーを元に戻してください。

3. モデルエディタに 3D モデルをインポートする

Blender からモデルがエクスポートできたら、次はモデルエディタに 3D モデルをインポートします。モデルエディタを開き、左上のコンボボックスで MOD フォルダ名が選択されている状態で、ヘッダーの「IMPORT」→「fbx」→「vehicle-train-demo」から、先ほどエクスポートしたファイル「vehicle-train-demo_lod0.fbx」を選択してください。

ダミーのテクスチャが張られた 3D モデルが表示されたら、インポートは成功です。

4. テクスチャファイルを配置する

続いて、テクスチャを作成するで作成したテクスチャ画像ファイルを、MOD フォルダの下に配置します。

MOD フォルダ内の res\textures\models\vehicle\train\demo にフォルダを作成して、カラーテクスチャと MGA テクスチャの2つの画像ファイルをコピーしてください。「demo」の部分は自由に決められます。

5. マテリアルを設定する

テクスチャ画像ファイルの用意ができたら、モデルにマテリアルを設定していきます。TpF モデルのマテリアルは、一般的な 3D モデルのマテリアルとは異なった構造になっており、モデルエディタ上で設定する必要があります。

まず、モデルエディタのヘッダーにある「MATERIALS」をクリックしてください。マテリアルエディタ画面が開き、3Dモデルを作成するで設定したマテリアルの一覧と、選択中のマテリアルの設定項目が表示されます。

まずは外装マテリアルの設定を行います。「vehicle/train/demo/Demo_Exterior.mtl」が選択されていることを確認したら、右端真ん中ほどにある歯車アイコンをクリックし、リストの中から「Convert to "PHYS_TRANSPARENT"」を選択してください。

リストにある「PHYS_TRANSPARENT」などは、TpF におけるマテリアルの種別を表しており、透過・発光の有無やテクスチャの数など、種別によって設定できる項目と効果が変わります。マテリアルの種別の詳細は、MOD 仕様の詳細ページを参照してください。

次に、「Map albedo」の項目を展開し、「Filename」の項目の入力欄で、テクスチャを作成するで作成したカラーテクスチャのファイルを指定してください。ファイルを指定すると、モデルにテクスチャが適用されます。

続いて、MGA テクスチャも設定します。「Map metal gloss ao」の項目を展開し、「Filename」の項目の入力欄で MGA テクスチャのファイルを指定してください。モデルがメタリックになるはずです。

外装マテリアルが設定できたら、今度は内装マテリアルを設定します。マテリアルエディタ画面を開き、「vehicle/train/demo/Demo_Interior.mtl」を選択してください。内装マテリアルでは、マテリアルの種別を「PHYSICAL」にして、カラーテクスチャのみを割り当てます。設定後の画面は次のようになります。

ここまでできたら、いったん TpF モデルのデータを保存しましょう。ヘッダーの「SAVE」をクリックすると、3D モデルやマテリアルなどのモデル情報が MOD フォルダ下にファイルとして出力されます。

6. メタデータを設定する

続いて、車両の性能値などのメタデータを設定します。メタデータはモデルエディタ上で直接編集することもできますが、テキストエディタで編集する方が操作の手数がかからないため、ここではテキストエディタを使用した方法を紹介します。

「SAVE」でモデルを保存すると、MOD フォルダ下の res\models\model\vehicle\train の下に demo.mdl というファイルが生成されます（この demo という名前は、Blender からエクスポートする際につけたモデルの名前です）。このファイルをテキストエディタで開いてください。

ファイルを開いたら、下の方にある「metadata = { }」の部分を、次の通り修正してください。

demo.mdl（修正前）

	metadata = { },

demo.mdl（修正後）

	metadata = {
		availability = {
			yearFrom = 0,
			yearTo = 0,
		},
		cost = {
			price = -1,
		},
		description = {
			description = _("This is a demo"),
			name = _("Demo"),
		},
		emission = {
			idleEmission = -1,
			powerEmission = -1,
			speedEmission = -1,
		},
		maintenance = {
			lifespan = 32873,
			runningCosts = -1,
		},
		railVehicle = {
			configs = {
				{
					axles = { "vehicle/train/demo/Wheel_lod0.msh" },
				},
			},
			engines = {
				{
					power = 800,
					tractiveEffort = 100,
					type = "ELECTRIC",
				},
			},
			soundSet = {
				horn = "vehicle/train_steam_old/steam_horn_14.wav",
				name = "train_electric_modern",
			},
			topSpeed = 33.3333,
			weight = 96,
		},
		transportVehicle = {
			carrier = "RAIL",
			loadSpeed = 1,
			multipleUnitOnly = false,
			reversible = false,
		},
	},