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/ | 39 | Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused … | ゲームプレイMOD |
Enemies/ | 84 | Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer … | ゲームプレイMOD |
Allies/ | 7 | Allies/Commander, Allies/Ranger, Allies/Soldier … | 見た目のみ |
Buildings/ | 5 | Buildings/Barracks_1, Buildings/Factory_2, Buildings/Radar_1 … | 見た目のみ |
Factory/ | 101 | Factory/Assembler_1, Factory/Conveyor_4_4, Factory/Splitter_1 … | 見た目のみ |
Environment/ | 80 | Environment/Arena, Environment/Rubble_Cannon_1, Environment/ExpeditionTowerColumn … | 見た目のみ · Environment/Arena: ゲームプレイMOD |
Markers/ | 6 | Markers/PartnerCursor, Markers/RadarStop, Markers/TileCursor … | 見た目のみ |
Birds/ | 8 | Birds/Buzzard, Birds/Raven, Birds/Vulture … | 見た目のみ |
Snakes/ | 2 | Snakes/HornedViper, Snakes/SandRacer | 見た目のみ |
Microfauna/ | 6 | Microfauna/Ant, Microfauna/Cricket, Microfauna/Shelter … | 見た目のみ |
Attachments/ | 11 | Attachments/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の下に任意のMouthEmpty を置くと、飲み込むタワーの位置が決まります。
飛ぶ生き物
飛ぶ虫も同じピボットを使い、翅を 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 はレンジャーのパラシュートです。
