WIKI

MOD

3D モデル

ゲームのモデルにはそれぞれキーがあります。たとえば Towers/Gun_1 や Buildings/Radar_1 です。MOD は models.json でキーを自作の GLB ファイルに対応付け、指定しなかったキーはゲームのモデルのままです。タワーには専用のページがあります:タワーのモデル。

models.json

{
  "version": 1,
  "models": {
    "Towers/Gun_1": {"file": "Models/Gun_1.glb", "material": "imported"},
    "Towers/Gun_2": "Models/Gun_2.glb",
    "Buildings/Factory_1": "Models/Factory_1.glb",
    "Enemies/garden_flyer": "Models/Flyer.glb"
  }
}
  • キーは大文字と小文字を区別し、ファイルパスは MOD フォルダからの相対パスです。文字列だけを書くと {"file": …, "material": "imported"} と同じ意味になります。
  • レベルと融合はそれぞれ別のキーです。Towers/Gun_1 を置き換えても、レベル2と3は元のままです。ピボットが合うなら、複数のキーを1つのファイルに向けてもかまいません。
  • モデルが変えるのは見た目だけで、遊び方は変わりません。射程、ダメージ、占有範囲、経路はゲームのままです。

GLB の準備

  • glTF 2.0 バイナリ(.glb)で、テクスチャをすべて埋め込み、Y を上(Blender の +Y Up)、スケール1で書き出します。ファイルは 64 MiB までです。
  • 法線付きのインデックス付き三角形を使います(Blender の初期設定)。アーマチュア、スキン、アニメーションクリップ、カメラ、ライトは使えません。ゲームは名前付きの Empty ピボットでモデルを動かすので、動くパーツはそれぞれのピボットの下に置いてください。
  • 置き換えるモデルのピボット、名前、スケール、原点、軸を保ちましょう。いちばん簡単なのは、例の GLB を Blender にインポートして編集することです。
  • 規約に反するモデルはログに1行残して拒否され、ゲームは自分のモデルを使い続けます。

マテリアル

  • "material": "imported"(初期設定)は、あなたの PBR マテリアルをそのまま使います。ベースカラー、メタリックとラフネス、法線マップとオクルージョンマップ、発光です。透明な部分はブレンドではなく切り抜きになります。
  • "material": "game" は、頂点カラー(COLOR_0)から Torreta 独自の質感でモデルを塗ります。虫のキチン質や光る目も含みます。

どちらの場合も、モデルはゲームのものと同じように地面から組み上がり、攻撃を受け、壊れ、雨で濡れます。三角形とマテリアルの数はゲームのものに近づけましょう。とくに何百匹も現れる虫では重要です。

モデルのキー

MOD フォルダの _vanilla_reference フォルダにある model_catalog.json に、すべてのキーとそのピボット、サイズが載っています。グループは次のとおりです。

キー数例MOD の種類
Towers/39Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused …ゲームプレイMOD
Enemies/84Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer …ゲームプレイMOD
Allies/7Allies/Commander, Allies/Ranger, Allies/Soldier …見た目のみ
Buildings/5Buildings/Barracks_1, Buildings/Factory_2, Buildings/Radar_1 …見た目のみ
Factory/101Factory/Assembler_1, Factory/Conveyor_4_4, Factory/Splitter_1 …見た目のみ
Environment/80Environment/Arena, Environment/Rubble_Cannon_1, Environment/ExpeditionTowerColumn …見た目のみ · Environment/Arena: ゲームプレイMOD
Markers/6Markers/PartnerCursor, Markers/RadarStop, Markers/TileCursor …見た目のみ
Birds/8Birds/Buzzard, Birds/Raven, Birds/Vulture …見た目のみ
Snakes/2Snakes/HornedViper, Snakes/SandRacer見た目のみ
Microfauna/6Microfauna/Ant, Microfauna/Cricket, Microfauna/Shelter …見た目のみ
Attachments/11Attachments/AmmoEjector_Cannon, Attachments/FrostLinkManifold, Attachments/SpentCase_MachineGun …ゲームプレイMOD

タワー、虫、アリーナを置き換えると、その MOD はゲームプレイ MOD になります。ゲームがそれらのモデルで狙いと当たり判定を行うからです。ほかのグループはコスメティックです。

ゲームのモデルを使う

ゲームのモデルのコピーを同梱してはいけません。代わりに、スロットには別のキーで保持されているゲームのモデルを game_model で指定して使わせられます。

"Towers/MachineGun_1": {"game_model": "Towers/Hangar_1"},
"Allies/Hero": {"game_model": "Allies/Commander"}

指定したモデルは、そのスロットに必要なピボットを持っていなければなりません。

指定できるすべてのモデルは、画像、キー、ピボットとともにゲームのモデルに載っています。独自のタワーをそのどれかの姿で置くこともできます。建物として描かれるタワーをご覧ください。サンプル MOD 独自のモデルはゲームのものではありません。使うには、サンプルの GLB を自分の MOD フォルダにコピーしてください。

遠くでは軽く

"generate_lods": true を使うと、ゲームの読み込み時に密度の高いモデルの簡略版が作られ、カメラが遠いときに描画されます。多数の別々のパーツからなる硬い組み立て品には "lod_mode": "rigid_parts" を加えると、パーツごとに簡略化されます。気になるズームで結果を確認してください。

虫とワーム

難易度ごとに虫の種族が12あり、各種族に歩く虫と飛ぶ虫がいます。最初の難易度では Enemies/<family> と Enemies/<family>_flyer、2番目と3番目の難易度では種族名の前に dusk_ または night_ が付きます(Enemies/night_garden_flyer)。種族は acrobat, army, bullet, carpenter, fire, garden, harvester, honeypot, leafcutter, trapjaw, turtle, weaver です。ウェーブ6以降、一部の虫は代わりにカースト Enemies/Castes/<caste> の姿になります:atlas, brain, cricket, dragonfly, hornet, jewel, rhino, stag, termite, tiger, tortoise。ボスはその種族のモデルを拡大したものです。

  • 虫のリグを保ちましょう。Body の下に Head、Abdomen、Armor、Shield、Leg0〜Leg5、Wing0〜Wing3 があり、Head の下に JawL、JawR、AntennaL、AntennaR、EyesL、EyesR、ShieldHead があります。使わないピボットは空のままでかまいません。
  • 歩く虫は Leg1、Leg2、Leg4、Leg5 で立つので、これらには本物の足が必要です。Leg0 と Leg3 は前の鉤爪です。
  • あなたのジオメトリが、コックピットの射撃が当たる体になります。
  • 歩くのではなく浮かぶべき直立したものには、models.json の項目に "locomotion": "float" を指定します。
  • 任意:Body の下の TraitRegenerator、TraitSplitter、TraitShielded、TraitHaste、TraitNecromancer はチャンピオンの器官を表示し、Body の下の ElytronL と ElytronR は甲虫の翅鞘を保持します。
  • ワーム Enemies/Worm は Body と6つの顎 Jaw0〜Jaw5 を保ちます。Body の下に任意の Mouth Empty を置くと、飲み込むタワーの位置が決まります。

飛ぶ生き物

飛ぶ虫も同じピボットを使い、翅を Wing0〜Wing3 の下に置き(翅が2枚の生き物は Wing0 と Wing2 を使います)、脚は折りたたみます。Blender では X が前、Y が左、Z が上です。Body を 5.8 単位の高さに置き、羽ばたいている翅も含めて生き物全体を中心から約40単位以内に収めてください。flight_cycle_speed(0.05〜4、初期値1)は、飛ぶ速さを変えずに羽ばたきを遅くしたり速くしたりします。

"Enemies/garden_flyer": {"file": "Models/Ptero.glb", "material": "imported", "flight_cycle_speed": 0.22}

飛ぶカーストは dragonfly、hornet、jewel、atlas で、ほかのカーストは歩きます。Ptero flyers はすべての飛ぶ虫を置き換えます。

建物と工場のパーツ

Buildings/Factory_1〜_3、Buildings/Barracks_1、Buildings/Radar_1 は、カタログに載っている動くパーツとランプのピボット(Flywheel、PressHead、Rotor、DishTilt、LampSocketLeft…)を保ちます。工場の中では、Factory/Assembler_1〜_3、Factory/Splitter_1、Factory/Conveyor_* のキーが機械とベルトで、Factory/Items/<material> が各素材の貨物箱です。あなたが追加した新しい素材も含みます。

工場の部屋

Factory/Room は、ズームできる工場の内部の床と壁です。工場自身の座標を Godot の単位で使います。Y が上、床の上面が Y = 0、32単位のグリッドで9列(X は −128〜128)と17行(Z は 0〜512)、建設可能な範囲は X −144〜144、Z −16〜528 です。Blender では、Godot の点 (x, y, z) は (x, −z, y) になります。マスの上は空けておき、背の高い装飾は端に置いてください。ピボットは不要です。Cobalt factory room が完成した例です。

地面のマーカー

マスのカーソル、協力プレイの相方のカーソル、射程リング、レーダーの経路もモデルです。

  • Markers/TileCursor と Markers/PartnerCursor:原点を中心に、64 × 64 のマスに収まるもの(X と Z は −32〜32)。
  • Markers/RangeRing:原点を囲む半径128のリング。ゲームが各タワーの実際の射程に合わせて伸ばします。円盤ではなくリングにしてください。
  • Markers/RadarChevron(+Z を指す矢印で、経路に沿って32単位ごとに繰り返されます)、Markers/RadarGuide(側面のタブ、64単位ごと)、Markers/RadarStop(経路がふさがれた場所の横棒)。

薄く作り、底面を Y = 0 にしてください。少なくとも1つのマテリアルに MarkerSignal という名前を付けます(MarkerSignal.001 でも可)。ゲームがそれを設置判定の色(緑、黄、青、赤)で光らせるので、光る形をモデリングし、色はゲームに任せましょう。

瓦礫とアリーナのパーツ

  • Environment/Rubble_Natural_0〜_2 は岩の山で、Environment/Rubble_<Tower> は各タワーの残骸です(レベル1と2で別の残骸にするには _1 と _2 を付けます)。ノードに Piece_1、Piece_2… と名前を付けると、コレクターのマグネットが各往復でどの石を運び去るかを選べます。番号の小さいものから運ばれます。
  • Environment/Barrier_1〜_3 は Drill_0〜Drill_4 を保ちます。追加の Drill_5、Drill_6… も回転します。
  • Environment/Fence(PostLeft、PostRight、Rails)、Environment/CollectorClaw(Jaw0〜Jaw2)、Environment/Core(コアルールのエネルギーコア。幅約18単位、高さ20)、Environment/PlainShrubs(平原の枯れた低木)、Environment/Debris_0〜_2。
  • Environment/Arena はアリーナ全体を置き換えます。難易度やウェーブごとのアリーナについては景観と盤面をご覧ください。

味方

Allies/Soldier、Allies/Reinforcement、Allies/Hero は、兵舎のユニット、増援の能力、英雄の外見です。Allies/Sentinel、Allies/Ranger、Allies/Commander はメック格納庫のものです。これらは Body とその下の Weapon を保ち、増援以外は Shield も持ちます。メックは歩行用に MechRig、StrideLeft、StrideRight、KneeLeft、KneeRight を加えます。Allies/Parachute はレンジャーのパラシュートです。