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