WIKI

Mods

Regras e balanceamento

As regras ficam em arquivos JSON ao lado do mod.json, e cada um é um remendo: escreva só os valores que mudam. A pasta _vanilla_reference da sua pasta de Mods traz a cópia do próprio jogo de cada um, com todas as chaves e os números do jogo; procure a chave lá em vez de adivinhar o nome dela. Qualquer um destes arquivos faz do seu mod um mod de jogabilidade.

  • balance.json: os números do jogo (torres, dinheiro, inimigos, cartas, custos de habilidade, clima, modos de jogo).
  • map_data.json: os nós da árvore de habilidades e o entulho no tabuleiro.
  • tower_data.json: as próprias torres, em suas próprias torres.
  • material_data.json: os materiais e as receitas da fábrica.

Números das torres

Os números de cada nível ficam em towers.stat_overrides, por torre e por nível:

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

Use este caminho para os números finais de uma torre: o balanceamento tem a última palavra sobre um número escrito no tower_data.json. towers.accuracy é a chance de acerto de cada torre de projétil ou fusão, de 0 a 1; um tiro errado ainda cai dentro de accuracy_miss_spread e pode acertar quem estiver ali.

Dinheiro, vidas e dificuldade

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

economy guarda as recompensas e a manutenção das torres, enemies a vida, a velocidade e a quantidade das ondas, bosses os chefes, e difficulty.levels os multiplicadores de cada dificuldade, de "1" a "3".

Cartas

  • cards.pool guarda os grupos de cartas (bonus_cards, feature_cards, tower_cards, recipe_cards…). Um grupo que você escreve substitui o grupo inteiro do jogo.
  • cards.pool_add acrescenta cartas pelo id, ou troca a carta do jogo com aquele id, sem repetir o grupo, então vários mods podem acrescentar lado a lado:
    {"cards": {"pool_add": {"tower_cards": [{"id": "unlock_bunker", "rarity": "rare", "min_wave": 20}]}}}
  • cards.effects guarda a força de cada carta, e cards.exclude lista ids de cartas que ficam fora do sorteio.
  • "cards": {"enabled": false} tira as cartas de vez: a próxima onda começa direto.

Árvore de habilidades

Os nós são os PurchasableStats do map_data.json. Cada um tem um value, um limit de níveis, um minLevel, uma dependency (o nó anterior, ou null) e um icon. Aponte o icon de um nó para uma imagem na sua pasta ("Assets/skill_dmg.png") para trocá-la; um nó que abre uma torre que você trocou mostra o seu modelo sozinho. Os custos, limites e níveis mínimos finais vêm do skill_tree do balance.json.

Como a partida começa

{
  "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 abre todas as torres e recursos desde a primeira onda.
  • all_materials dá esse estoque de todos os materiais, e materials define materiais avulsos.
  • player_level (até 99) e skill_points: "all" elevam o perfil próprio do seu mod, para que a árvore dele possa ser comprada.
  • cockpit.unlimited_time tira o cronômetro do cockpit.

Um Continuar mantém o que a partida dele recebeu. O All resources faz tudo isso.

Quais torres jogam

{
  "towers": {"disabled": ["Collect"], "upgrades_need_skills": false},
  "run_start": {"towers": ["Gun", "Cannon", "MachineGun"], "cockpit": true},
  "factory": {"tower_material_mult": 0}
}
  • towers.disabled: torres que nunca aparecem. Sem o Coletor, a fábrica fica fechada.
  • towers.upgrades_need_skills: false: os níveis 2 e 3 não esperam mais o nó deles na árvore de habilidades.
  • run_start.towers e run_start.cockpit: abertos desde a primeira onda.
  • factory.tower_material_mult: 0: as torres custam só dinheiro, para construir e para melhorar.

O Traditional path joga assim.

Entulho

{"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}}
}}}

No map_data.json: quantos montes de pedra uma partida nova espalha (0 para nenhum), se os destroços das torres bloqueiam os insetos como a pedra, e quantas viagens do Coletor um monte leva (de 1 a 32; trip_time_scale alonga cada viagem). Uma dificuldade pode ter o seu próprio espalhamento, ou uma disposição exata de montes, igual em toda semente, em difficulty.levels do balance.json:

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

Materiais e receitas da fábrica

O material_data.json mescla os seus materiais e receitas sobre os do jogo; copie o formato de uma entrada da cópia de referência. Depois:

  • null remove um material, uma receita ou o custo de uma torre: "biological": null.
  • O name e a description de um material podem ser textos por idioma: {"en": "Rifle rounds", "pt_br": "Balas de fuzil"}.
  • O default_cap de uma receita aumenta o limite padrão de estoque, max_stock o prende a um número, e requires_tower a mantém fechada até a carta daquela torre.
  • Um material novo ganha um contador na barra de cima; "hud_row": 1 o põe na primeira fileira.
  • factory.recipe_output_multipliers no balance.json faz uma receita render mais por lote: {"factory": {"recipe_output_multipliers": {"ammo_2": 2}}}.
  • As fusões pagam o tower_fusion.cost_materials do balance.json.

Um material novo pode ter o próprio modelo de carga, Factory/Items/<material>. As torres também podem atirar só com a munição da fábrica: veja suas próprias torres. O Factory ammunition refaz a fábrica desse jeito.