WIKI

Mods

Modelos 3D

Todo modelo do jogo tem uma chave, como Towers/Gun_1 ou Buildings/Radar_1. Um mod liga chaves a arquivos GLB seus no models.json; toda chave que ele não cita mantém o modelo do jogo. As torres têm uma página só delas: modelos de torres.

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/Voador.glb"
  }
}
  • As chaves diferenciam maiúsculas de minúsculas, e os caminhos dos arquivos são relativos à pasta do seu mod. Um texto simples equivale a {"file": …, "material": "imported"}.
  • Cada nível e cada fusão é uma chave própria: trocar Towers/Gun_1 deixa os níveis 2 e 3 como estavam. Aponte várias chaves para um arquivo se os pivôs dele servirem a todas.
  • Um modelo muda a aparência, nunca o jogo: alcance, dano, área ocupada e caminhos continuam os do jogo.

Preparando o GLB

  • Exporte glTF 2.0 binário (.glb) com todas as texturas embutidas, Y para cima (o +Y Up do Blender) e escala 1. Um arquivo pode ter até 64 MiB.
  • Use triângulos indexados com normais (o padrão do Blender). Nada de armaduras, skins, clipes de animação, câmeras ou luzes: o jogo move os modelos pelos pivôs Empty nomeados, então ponha cada parte móvel embaixo do seu pivô.
  • Mantenha os pivôs, os nomes, a escala, a origem e os eixos do modelo que você troca. O começo mais fácil é um GLB de um dos exemplos, importado no Blender e editado.
  • Um modelo que quebra o contrato é recusado, com uma linha no log, e o jogo mantém o dele.

Materiais

  • "material": "imported" (o padrão) mantém os seus materiais PBR: cor base, metal e rugosidade, normal map e oclusão, emissão. Partes transparentes são recortadas, não misturadas.
  • "material": "game" pinta o modelo com a aparência do próprio Torreta a partir das cores de vértice (COLOR_0), incluindo a quitina e os olhos brilhantes dos insetos.

Nos dois casos o modelo sobe do chão na construção, leva golpes, se parte e fica molhado na chuva como os do jogo. Mantenha a contagem de triângulos e de materiais perto da do jogo, sobretudo nos insetos, que vêm às centenas.

Chaves de modelo

O model_catalog.json, na pasta _vanilla_reference da sua pasta de Mods, lista todas as chaves com seus pivôs e tamanhos. Os grupos:

ChavesQuantasPor exemploTipo de mod
Towers/39Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused …Mod de gameplay
Enemies/84Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer …Mod de gameplay
Allies/7Allies/Commander, Allies/Ranger, Allies/Soldier …Cosmético
Buildings/5Buildings/Barracks_1, Buildings/Factory_2, Buildings/Radar_1 …Cosmético
Factory/101Factory/Assembler_1, Factory/Conveyor_4_4, Factory/Splitter_1 …Cosmético
Environment/80Environment/Arena, Environment/Rubble_Cannon_1, Environment/ExpeditionTowerColumn …Cosmético · Environment/Arena: Mod de gameplay
Markers/6Markers/PartnerCursor, Markers/RadarStop, Markers/TileCursor …Cosmético
Birds/8Birds/Buzzard, Birds/Raven, Birds/Vulture …Cosmético
Snakes/2Snakes/HornedViper, Snakes/SandRacerCosmético
Microfauna/6Microfauna/Ant, Microfauna/Cricket, Microfauna/Shelter …Cosmético
Attachments/11Attachments/AmmoEjector_Cannon, Attachments/FrostLinkManifold, Attachments/SpentCase_MachineGun …Mod de gameplay

Trocar uma torre, um inseto ou a arena faz do seu mod um mod de jogabilidade, porque o jogo mira e acerta com esses modelos. Os outros grupos são cosméticos.

Vestindo um modelo do próprio jogo

Nunca leve uma cópia de um modelo do jogo. Uma chave pode vestir um modelo do jogo guardado sob outra chave, citado com game_model:

"Towers/MachineGun_1": {"game_model": "Towers/Hangar_1"},
"Allies/Hero": {"game_model": "Allies/Commander"}

O modelo citado ainda precisa ter os pivôs que a chave pede.

Todo modelo que você pode citar, com imagem, chave e pivôs, está em modelos do jogo. Uma torre sua também pode ficar de pé como qualquer um deles: veja uma torre desenhada como construção. Os modelos próprios dos mods de exemplo não são do jogo: copie o GLB do exemplo para a pasta do seu mod para usá-lo.

Mais leve de longe

"generate_lods": true faz versões mais simples de um modelo denso quando o jogo carrega, desenhadas quando a câmera está longe. Para uma montagem rígida de muitas peças separadas, acrescente "lod_mode": "rigid_parts", que simplifica cada peça por conta própria. Confira o resultado nos zooms que importam para você.

Insetos e o verme

Cada dificuldade tem doze famílias de insetos, e cada família um que anda e um que voa: Enemies/<família> e Enemies/<família>_flyer na primeira dificuldade, com dusk_ ou night_ antes da família na segunda e na terceira (Enemies/night_garden_flyer). As famílias são acrobat, army, bullet, carpenter, fire, garden, harvester, honeypot, leafcutter, trapjaw, turtle, weaver. A partir da onda 6, alguns insetos vestem uma casta, Enemies/Castes/<casta>: atlas, brain, cricket, dragonfly, hornet, jewel, rhino, stag, termite, tiger, tortoise. Os chefes são o modelo da família deles, ampliado.

  • Mantenha o esqueleto do inseto: Body, com Head, Abdomen, Armor, Shield, Leg0 a Leg5 e Wing0 a Wing3 embaixo dele, e JawL, JawR, AntennaL, AntennaR, EyesL, EyesR e ShieldHead embaixo de Head. Pivôs que você não usa podem ficar vazios.
  • Um inseto que anda se apoia em Leg1, Leg2, Leg4 e Leg5, que precisam de pés de verdade; Leg0 e Leg3 são as garras da frente.
  • A sua geometria é o corpo que os tiros do cockpit acertam.
  • Algo em pé que deve flutuar em vez de andar recebe "locomotion": "float" na sua entrada do models.json.
  • Opcional: TraitRegenerator, TraitSplitter, TraitShielded, TraitHaste e TraitNecromancer embaixo de Body mostram o órgão de um campeão, e ElytronL e ElytronR embaixo de Body seguram os élitros de um besouro.
  • O verme, Enemies/Worm, mantém Body e as seis mandíbulas Jaw0 a Jaw5; um Empty Mouth opcional embaixo de Body posiciona a torre que ele engole.

Criaturas voadoras

Um voador usa os mesmos pivôs, com as asas embaixo de Wing0 a Wing3 (uma criatura de duas asas usa Wing0 e Wing2) e as pernas dobradas. No Blender, X é a frente, Y a esquerda e Z o alto; mantenha Body a 5,8 unidades de altura e a criatura inteira, batendo as asas, a umas 40 unidades do centro. flight_cycle_speed, de 0,05 a 4 (1 por padrão), desacelera ou acelera o bater de asas sem mudar a velocidade do voador:

"Enemies/garden_flyer": {"file": "Models/Ptero.glb", "material": "imported", "flight_cycle_speed": 0.22}

As castas voadoras são dragonfly, hornet, jewel e atlas; as outras andam. O Ptero flyers troca todos os voadores.

Construções e peças da fábrica

Buildings/Factory_1 a _3, Buildings/Barracks_1 e Buildings/Radar_1 mantêm as partes móveis e os pivôs das lâmpadas que o catálogo lista (Flywheel, PressHead, Rotor, DishTilt, LampSocketLeft…). Dentro da fábrica, Factory/Assembler_1 a _3, Factory/Splitter_1 e as chaves Factory/Conveyor_* são as máquinas e as esteiras, e Factory/Items/<material> é a caixa de carga de cada material, inclusive um material novo seu.

A sala da fábrica

Factory/Room é o piso e as paredes dentro da fábrica com zoom. Ela usa as coordenadas da própria fábrica, em unidades do Godot: Y para cima, o topo do piso em Y = 0, uma grade de 32 unidades com nove colunas (X de −128 a 128) e dezessete linhas (Z de 0 a 512), e a área de construção dentro de X −144 a 144 e Z −16 a 528. No Blender, um ponto (x, y, z) do Godot fica em (x, −z, y). Deixe as casas livres e os detalhes altos nas bordas; nenhum pivô é necessário. O Cobalt factory room é uma sala completa.

Marcadores no chão

O cursor de casa, o cursor do parceiro no co-op, o anel de alcance e a rota do radar também são modelos:

  • Markers/TileCursor e Markers/PartnerCursor: centrados na origem, cabendo numa casa de 64 × 64 (X e Z de −32 a 32).
  • Markers/RangeRing: um anel de raio 128 em volta da origem; o jogo o estica até o alcance real de cada torre. Mantenha um anel, não um disco.
  • Markers/RadarChevron (uma seta apontando para +Z, repetida a cada 32 unidades ao longo da rota), Markers/RadarGuide (abas laterais, a cada 64 unidades) e Markers/RadarStop (uma barra onde a rota está bloqueada).

Faça-os rasos, com a parte de baixo em Y = 0. Pelo menos um material precisa se chamar MarkerSignal (MarkerSignal.001 também serve): o jogo o acende na cor da posição, verde, amarelo, azul ou vermelho, então modele a forma que brilha e deixe a cor com o jogo.

Entulho e peças da arena

  • Environment/Rubble_Natural_0 a _2 são os montes de pedra, e Environment/Rubble_<Torre> os destroços de cada torre (acrescente _1 e _2 para destroços diferentes nos níveis 1 e 2). Nomeie nós Piece_1, Piece_2… para escolher quais pedras o ímã do Coletor leva em cada viagem, do menor número para o maior.
  • Environment/Barrier_1 a _3 mantêm Drill_0 a Drill_4; Drill_5, Drill_6… a mais também giram.
  • Environment/Fence (PostLeft, PostRight, Rails), Environment/CollectorClaw (Jaw0 a Jaw2), Environment/Core (o núcleo de energia da regra dos núcleos, com uns 18 de largura e 20 de altura), Environment/PlainShrubs (os arbustos secos da planície) e Environment/Debris_0 a _2.
  • Environment/Arena troca a arena inteira. Para arenas por dificuldade e onda, veja cenário e tabuleiro.

Aliados

Allies/Soldier, Allies/Reinforcement e Allies/Hero vestem as unidades de um quartel, de um poder de reforço e de um herói; Allies/Sentinel, Allies/Ranger e Allies/Commander são as do Hangar de Mechs. Eles mantêm Body com Weapon embaixo, e Shield em todos menos no reforço; os mechs acrescentam MechRig, StrideLeft, StrideRight, KneeLeft e KneeRight para o andar. Allies/Parachute é o paraquedas do Ranger.