3D 模型
游戏中的每个模型都有一个键,例如 Towers/Gun_1 或 Buildings/Radar_1。模组在 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"
}
}
- 键区分大小写,文件路径相对于你的模组文件夹。直接写一个字符串等同于
{"file": …, "material": "imported"}。 - 每个等级和每种融合都是独立的键:替换
Towers/Gun_1不会改动 2 级和 3 级。如果一个文件的枢轴点适合多个键,可以让它们都指向这个文件。 - 模型只改变东西的外观,从不改变玩法:射程、伤害、占地和路线都保持游戏的设定。
准备 GLB
- 导出为 glTF 2.0 二进制(
.glb),嵌入所有纹理,Y 轴向上(Blender 的 +Y Up),缩放为 1。单个文件最大 64 MiB。 - 使用带法线的索引三角形(Blender 的默认设置)。不要骨架、蒙皮、动画片段、摄像机或灯光:游戏通过命名的 Empty 枢轴点来移动模型,所以要把每个活动部件放在它的枢轴点之下。
- 保持被替换模型的枢轴点、名称、缩放、原点和坐标轴。最简单的起点是拿某个示例中的 GLB,导入 Blender 后再编辑。
- 违反约定的模型会被拒绝,并在日志中留下一行记录,游戏会继续使用它自己的模型。
材质
"material": "imported"(默认)保留你的 PBR 材质:基础色、金属度和粗糙度、法线和遮蔽贴图、自发光。透明部分会被裁切,而不是混合。"material": "game"根据模型的顶点颜色(COLOR_0)用 Torreta 自己的风格为它上色,包括虫子的甲壳和发光的眼睛。
无论哪种方式,模型都会像游戏自带的模型一样从地面上逐步建起、受击、碎裂并在雨中被打湿。三角形和材质数量要与游戏的接近,尤其是虫子,它们会成百只地出现。
模型键
模组文件夹的 _vanilla_reference 文件夹中的 model_catalog.json 列出了每个键及其枢轴点和尺寸。分组如下:
| 键 | 数量 | 例如 | 模组类型 |
|---|---|---|---|
Towers/ | 39 | Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused … | 玩法模组 |
Enemies/ | 84 | Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer … | 玩法模组 |
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: 玩法模组 |
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 … | 玩法模组 |
替换防御塔、虫子或竞技场会让你的模组成为玩法模组,因为游戏用这些模型来瞄准和判定命中。其他分组都属于外观。
使用游戏自带的模型
永远不要附带游戏模型的副本。一个槽位可以改用游戏中存放在另一个键下的模型,用 game_model 指明:
"Towers/MachineGun_1": {"game_model": "Towers/Hangar_1"},
"Allies/Hero": {"game_model": "Allies/Commander"}
你指明的模型仍然必须带有该槽位需要的枢轴点。
你可以指明的每个模型,连同其图片、键和枢轴点,都列在游戏自带的模型中。你自己的防御塔也可以显示为其中任何一个:参见以建筑形式呈现的防御塔。示例模组自己的模型不属于游戏:要使用示例的 GLB,请把它复制到你的模组文件夹中。
远处更轻量
"generate_lods": true 会在游戏加载时为高密度模型生成简化版本,在镜头离得较远时绘制。对于由许多独立部件组成的刚性组合,加上 "lod_mode": "rigid_parts",它会单独简化每个部件。请在你关心的缩放级别下检查效果。
虫子与蠕虫
每个难度有十二个虫子家族,每个家族各有一个步行者和一个飞行者:在第一个难度中是 Enemies/<family> 和 Enemies/<family>_flyer,在第二和第三个难度中则在家族名前加上 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和它的六片颚Jaw0到Jaw5;Body下可选的MouthEmpty 用来定位它吞下的防御塔。
飞行生物
飞行者使用相同的枢轴点,翅膀放在 Wing0 到 Wing3 之下(只有两只翅膀的生物使用 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 单位的网格,共九列(X 从 −128 到 128)和十七行(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。至少要有一个材质命名为 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 是游骑兵的降落伞。
