WIKI

Моды

3D-модели

У каждой модели в игре есть ключ, например Towers/Gun_1 или Buildings/Radar_1. Мод сопоставляет ключи со своими файлами GLB в models.json; каждый ключ, который он не указал, сохраняет модель игры. У башен своя страница: модели башен.

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 МиБ.
  • Используйте индексированные треугольники с нормалями (по умолчанию в Blender). Никаких арматур, скиннинга, анимационных клипов, камер и источников света: игра двигает модели за их именованные точки вращения — объекты Empty, поэтому кладите каждую подвижную часть под её точку.
  • Сохраняйте точки вращения, имена, масштаб, начало координат и оси заменяемой модели. Проще всего начать с GLB из одного из примеров: импортировать его в Blender и править.
  • Модель, нарушающая свой контракт, отклоняется со строкой в журнале, и игра оставляет свою.

Материалы

  • "material": "imported" (по умолчанию) сохраняет ваши PBR-материалы: базовый цвет, металличность и шероховатость, карты нормалей и затенения, свечение. Прозрачные части вырезаются, а не смешиваются.
  • "material": "game" раскрашивает модель в собственном стиле Torreta по цветам вершин (COLOR_0), включая хитин насекомых и светящиеся глаза.

В любом случае модель вырастает из земли при постройке, принимает попадания, разваливается и мокнет под дождём, как игровые. Держите число треугольников и материалов близким к игровому, особенно у насекомых, которые приходят сотнями.

Ключи моделей

model_catalog.json в папке _vanilla_reference вашей папки модов перечисляет все ключи с их точками вращения и размерами. Группы:

КлючиСколькоНапримерВид мода
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 — его передние клешни.
  • Ваша геометрия — это тело, в которое попадают выстрелы из кабины.
  • Что-то вертикальное, что должно парить, а не ходить, получает "locomotion": "float" в своей записи models.json.
  • Необязательно: TraitRegenerator, TraitSplitter, TraitShielded, TraitHaste и TraitNecromancer под Body показывают орган чемпиона, а ElytronL и ElytronR под Body держат надкрылья жука.
  • Червь, Enemies/Worm, сохраняет Body и шесть челюстей от Jaw0 до Jaw5; необязательный Empty Mouth под Body задаёт место для проглатываемой башни.

Летающие существа

Летун использует те же точки вращения, с крыльями под 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 — купол рейнджера.