WIKI

Моды

Правила и баланс

Правила хранятся в JSON-файлах рядом с mod.json, и каждый из них — патч: пишите только меняемые значения. Папка _vanilla_reference в вашей папке модов содержит собственную копию каждого файла игры со всеми ключами и числами из поставки; ищите ключ там, а не угадывайте его имя. Любой из этих файлов делает ваш мод игровым.

  • balance.json: числа игры (башни, деньги, враги, карты, стоимость навыков, погода, игровые режимы).
  • map_data.json: узлы дерева навыков и завалы на поле.
  • tower_data.json: сами башни — на странице свои башни.
  • material_data.json: материалы и рецепты фабрики.

Числа башен

Числа каждого уровня хранятся в towers.stat_overrides, по башне и уровню:

{
  "towers": {
    "stat_overrides": {
      "Gun": {"1": {"damage": 40, "range": 260, "price": 15}}
    },
    "accuracy": {"Gun": 0.9, "Sniper": 1.0},
    "accuracy_miss_spread": 32
  }
}

Используйте этот путь для окончательных чисел башни: последнее слово за балансом, а не за числом, записанным в tower_data.json. towers.accuracy — шанс попадания каждой башни со снарядами или слияния, от 0 до 1; промах всё равно приходится в пределах accuracy_miss_spread и может задеть того, кто там окажется.

Деньги, жизни и сложность

{
  "general": {"starting_gold": 100, "starting_lives": 20},
  "multiplayer": {"starting_gold": 100},
  "difficulty": {"levels": {"2": {"health_mult": 1.3}}}
}

economy хранит награды и содержание башен, enemies — здоровье, скорость и численность волн, bosses — боссов, а difficulty.levels — множители каждой сложности, от "1" до "3".

Карты

  • cards.pool хранит группы карт (bonus_cards, feature_cards, tower_cards, recipe_cards…). Записанная вами группа заменяет всю группу игры.
  • cards.pool_add добавляет карты по id или заменяет карту игры с этим id, не переписывая группу, так что несколько модов могут добавлять карты рядом друг с другом:
    {"cards": {"pool_add": {"tower_cards": [{"id": "unlock_bunker", "rarity": "rare", "min_wave": 20}]}}}
  • cards.effects хранит силу каждой карты, а cards.exclude перечисляет id карт, которые не попадают в раздачу.
  • "cards": {"enabled": false} убирает карты совсем: следующая волна начинается сразу.

Дерево навыков

Узлы — это PurchasableStats в map_data.json. У каждого есть value, limit рангов, minLevel, dependency (предыдущий узел или null) и icon. Направьте icon узла на картинку в своей папке ("Assets/skill_dmg.png"), чтобы сменить его; узел, открывающий заменённую вами башню, сам покажет вашу модель. Окончательные стоимости, лимиты и минимальные уровни берутся из skill_tree в balance.json.

Как начинается забег

{
  "general": {"starting_gold": 10000, "starting_lives": 99},
  "cockpit": {"unlimited_time": true},
  "run_start": {
    "unlock_everything": true,
    "all_materials": 999,
    "materials": {"debris": 9999},
    "player_level": 99,
    "skill_points": "all"
  }
}
  • unlock_everything открывает все башни и механики с первой волны.
  • all_materials даёт такой запас каждого материала, а materials задаёт отдельные.
  • player_level (до 99) и skill_points: "all" поднимают собственный профиль мода, чтобы его дерево навыков можно было купить.
  • cockpit.unlimited_time убирает секундомер кабины.

«Продолжить» сохраняет то, что было выдано забегу. All resources делает всё это.

Какие башни в игре

{
  "towers": {"disabled": ["Collect"], "upgrades_need_skills": false},
  "run_start": {"towers": ["Gun", "Cannon", "MachineGun"], "cockpit": true},
  "factory": {"tower_material_mult": 0}
}
  • towers.disabled: башни, которые никогда не появляются. Без Сборщика фабрика остаётся закрытой.
  • towers.upgrades_need_skills: false: уровни 2 и 3 больше не ждут своего узла в дереве навыков.
  • run_start.towers и run_start.cockpit: открыты с первой волны.
  • factory.tower_material_mult: 0: башни стоят только денег — и постройка, и улучшение.

Так устроен Traditional path.

Завалы

{"MapCoords": {"rubble": {
  "initial_min": 3, "initial_max": 10, "blocks_enemies": false,
  "removal": {"natural": {"trips": 4, "trip_time_scale": 1.0}, "wreck": {"trips": 1, "trip_time_scale": 1.0}}
}}}

В map_data.json: сколько каменных завалов разбрасывает новый забег (0 — ни одного), блокируют ли обломки башен насекомых, как камень, и сколько рейсов Сборщика нужно на один завал (от 1 до 32; trip_time_scale растягивает каждый рейс). У сложности может быть свой разброс или точная раскладка layout, одинаковая на любом сиде, в difficulty.levels файла balance.json:

{"difficulty": {"levels": {"1": {"rubble": {"layout": [{"x": 12, "y": 6, "variant": 0}]}}}}}

Материалы и рецепты фабрики

material_data.json накладывает ваши материалы и рецепты поверх игровых; форму записи копируйте из справочной копии. Далее:

  • null удаляет материал, рецепт или стоимость башни: "biological": null.
  • name и description материала могут быть текстами по языкам: {"en": "Rifle rounds", "pt_br": "Balas de fuzil"}.
  • default_cap рецепта поднимает его лимит запаса по умолчанию, max_stock держит его на заданном числе, а requires_tower держит рецепт закрытым до карты этой башни.
  • Новый материал получает счётчик в верхней панели; "hud_row": 1 ставит его в первый ряд.
  • factory.recipe_output_multipliers в balance.json увеличивает выход рецепта за партию: {"factory": {"recipe_output_multipliers": {"ammo_2": 2}}}.
  • Слияния оплачивают tower_fusion.cost_materials из balance.json.

У нового материала может быть своя модель груза, Factory/Items/<material>. Башни также могут стрелять только боеприпасами фабрики: см. свои башни. Factory ammunition перестраивает фабрику именно так.