WIKI

模组

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/39Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused …玩法模组
Enemies/84Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer …玩法模组
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: 玩法模组
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 …玩法模组

替换防御塔、虫子或竞技场会让你的模组成为玩法模组,因为游戏用这些模型来瞄准和判定命中。其他分组都属于外观。

使用游戏自带的模型

永远不要附带游戏模型的副本。一个槽位可以改用游戏中存放在另一个键下的模型,用 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 下可选的 Mouth Empty 用来定位它吞下的防御塔。

飞行生物

飞行者使用相同的枢轴点,翅膀放在 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 是游骑兵的降落伞。