规则与平衡
规则放在 mod.json 旁边的 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}会彻底移除卡牌:下一波会立即开始。
技能树
节点是 map_data.json 中的 PurchasableStats。每个节点都有一个 value、等级上限 limit、minLevel、dependency(它之前的节点,或 null)以及 icon。把节点的 icon 指向你文件夹中的图片("Assets/skill_dmg.png")即可更换图标;解锁你所替换的防御塔的节点会自动显示你的模型。最终的花费、上限和最低等级来自 balance.json 中的 skill_tree。
一局如何开始
{
"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 会拉长每一趟)。在 balance.json 的 difficulty.levels 下,每个难度可以有自己的散布数量,或者一个精确的石堆布局 layout,在每个种子上都相同:
{"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把它放在第一行。 balance.json中的factory.recipe_output_multipliers让配方每批产出更多:{"factory": {"recipe_output_multipliers": {"ammo_2": 2}}}。- 融合支付
balance.json中的tower_fusion.cost_materials。
新材料可以有自己的货物模型 Factory/Items/<material>。防御塔也可以只使用工厂的弹药射击:参见你自己的防御塔。Factory ammunition 就是这样重建工厂的。
