WIKI

Mod

Modelli 3D

Ogni modello del gioco ha una chiave, come Towers/Gun_1 o Buildings/Radar_1. Una mod associa le chiavi a file GLB propri in models.json; ogni chiave che tralascia mantiene il modello del gioco. Le torri hanno una pagina a parte: modelli delle torri.

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"
  }
}
  • Le chiavi distinguono maiuscole e minuscole, e i percorsi dei file sono relativi alla cartella della tua mod. Una semplice stringa equivale a {"file": …, "material": "imported"}.
  • Ogni livello e ogni fusione ha la sua chiave: sostituire Towers/Gun_1 lascia i livelli 2 e 3 come erano. Fai puntare più chiavi allo stesso file se i suoi pivot vanno bene per tutte.
  • Un modello cambia l'aspetto di qualcosa, mai il modo in cui si gioca: gittata, danno, ingombro e percorsi restano quelli del gioco.

Preparare il GLB

  • Esporta glTF 2.0 binario (.glb) con tutte le texture incorporate, Y verso l'alto (+Y Up di Blender) e scala 1. Un file può arrivare a 64 MiB.
  • Usa triangoli indicizzati con normali (l'impostazione predefinita di Blender). Niente armature, skin, clip di animazione, telecamere o luci: il gioco muove i modelli tramite i loro pivot Empty con nome, quindi metti ogni parte mobile sotto il suo pivot.
  • Mantieni pivot, nomi, scala, origine e assi del modello che sostituisci. Il modo più semplice di iniziare è un GLB di uno degli esempi, importato in Blender e modificato.
  • Un modello che non rispetta il suo contratto viene rifiutato, con una riga nel log, e il gioco mantiene il proprio.

Materiali

  • "material": "imported" (il predefinito) mantiene i tuoi materiali PBR: colore base, metallo e ruvidità, mappe normali e di occlusione, emissione. Le parti trasparenti vengono ritagliate, non sfumate.
  • "material": "game" dipinge il modello con lo stile di Torreta a partire dai colori dei vertici (COLOR_0), compresa la chitina degli insetti e i loro occhi luminosi.

In entrambi i casi il modello si costruisce dal suolo, subisce colpi, va in pezzi e si bagna sotto la pioggia come quelli del gioco. Mantieni il numero di triangoli e di materiali vicino a quello del gioco, soprattutto per gli insetti, che arrivano a centinaia.

Chiavi dei modelli

model_catalog.json, nella cartella _vanilla_reference della tua cartella Mods, elenca ogni chiave con i suoi pivot e le sue dimensioni. I gruppi:

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

Sostituire una torre, un insetto o l'arena rende la tua mod una mod di gameplay, perché il gioco mira e colpisce con quei modelli. Gli altri gruppi sono estetici.

Usare uno dei modelli del gioco

Non includere mai una copia di un modello del gioco. Uno slot può invece usare uno dei modelli del gioco registrato sotto un'altra chiave, indicato con game_model:

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

Il modello che indichi deve comunque avere i pivot di cui lo slot ha bisogno.

Trovi ogni modello che puoi indicare, con immagine, chiave e pivot, tra i modelli del gioco. Una torre tua può anche presentarsi come uno qualsiasi di essi: vedi una torre disegnata come edificio. I modelli propri delle mod di esempio non fanno parte del gioco: copia il GLB di un esempio nella cartella della tua mod per usarlo.

Più leggero da lontano

"generate_lods": true crea versioni più semplici di un modello denso al caricamento del gioco, disegnate quando la telecamera è lontana. Per un assemblaggio rigido di molti pezzi separati aggiungi "lod_mode": "rigid_parts", che semplifica ogni pezzo per conto suo. Controlla il risultato ai livelli di zoom che ti interessano.

Insetti e verme

Ogni difficoltà ha dodici famiglie di insetti, e ogni famiglia un camminatore e un volante: Enemies/<family> e Enemies/<family>_flyer nella prima difficoltà, con dusk_ o night_ davanti alla famiglia nella seconda e nella terza (Enemies/night_garden_flyer). Le famiglie sono acrobat, army, bullet, carpenter, fire, garden, harvester, honeypot, leafcutter, trapjaw, turtle, weaver. Dall'ondata 6 alcuni insetti indossano invece una casta, Enemies/Castes/<caste>: atlas, brain, cricket, dragonfly, hornet, jewel, rhino, stag, termite, tiger, tortoise. I boss sono il modello della loro famiglia, ingrandito.

  • Mantieni lo scheletro dell'insetto: Body, con sotto Head, Abdomen, Armor, Shield, da Leg0 a Leg5 e da Wing0 a Wing3, e JawL, JawR, AntennaL, AntennaR, EyesL, EyesR e ShieldHead sotto Head. I pivot che non usi possono restare vuoti.
  • Un camminatore poggia su Leg1, Leg2, Leg4 e Leg5, che hanno bisogno di veri piedi; Leg0 e Leg3 sono le sue chele anteriori.
  • La tua geometria è il corpo che colpiscono i tiri dalla cabina.
  • Qualcosa di eretto che debba fluttuare invece di camminare prende "locomotion": "float" nella sua voce di models.json.
  • Facoltativi: TraitRegenerator, TraitSplitter, TraitShielded, TraitHaste e TraitNecromancer sotto Body mostrano l'organo di un campione, e ElytronL e ElytronR sotto Body portano le elitre di uno scarabeo.
  • Il verme, Enemies/Worm, mantiene Body e le sue sei mascelle da Jaw0 a Jaw5; un Empty facoltativo Mouth sotto Body posiziona la torre che inghiotte.

Creature volanti

Un volante usa gli stessi pivot, con le ali sotto i pivot da Wing0 a Wing3 (una creatura con due ali usa Wing0 e Wing2) e le zampe ripiegate. In Blender, X è in avanti, Y a sinistra e Z in alto; tieni Body a 5,8 unità d'altezza e l'intera creatura, ali in movimento comprese, entro circa 40 unità dal suo centro. flight_cycle_speed, da 0,05 a 4 (1 per impostazione predefinita), rallenta o accelera il battito d'ali senza cambiare la velocità del volante:

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

Le caste volanti sono dragonfly, hornet, jewel e atlas; le altre caste camminano. Ptero flyers sostituisce tutti i volanti.

Edifici e pezzi della fabbrica

Da Buildings/Factory_1 a _3, Buildings/Barracks_1 e Buildings/Radar_1 mantengono le parti mobili e i pivot delle lampade elencati nel catalogo (Flywheel, PressHead, Rotor, DishTilt, LampSocketLeft…). Dentro la fabbrica, da Factory/Assembler_1 a _3, Factory/Splitter_1 e le chiavi Factory/Conveyor_* sono le macchine e i nastri, e Factory/Items/<material> è la cassa di carico di ogni materiale, compreso un tuo nuovo materiale.

La sala della fabbrica

Factory/Room è il pavimento con le pareti all'interno della fabbrica zoomabile. Usa le coordinate della fabbrica stessa, in unità Godot: Y in alto, la superficie del pavimento a Y = 0, una griglia di 32 unità di nove colonne (X da −128 a 128) e diciassette righe (Z da 0 a 512), e l'area edificabile entro X da −144 a 144 e Z da −16 a 528. In Blender un punto Godot (x, y, z) è (x, −z, y). Lascia libere le celle e metti i dettagli alti ai bordi; non servono pivot. Cobalt factory room ne è un esempio completo.

Indicatori sul terreno

Anche il cursore della casella, il cursore del compagno in cooperativa, l'anello della gittata e il percorso del radar sono modelli:

  • Markers/TileCursor e Markers/PartnerCursor: centrati sull'origine, entro una casella di 64 × 64 (X e Z da −32 a 32).
  • Markers/RangeRing: un anello di raggio 128 attorno all'origine; il gioco lo allarga alla gittata reale di ogni torre. Mantienilo un anello, non un disco.
  • Markers/RadarChevron (una freccia che punta verso +Z, ripetuta ogni 32 unità lungo il percorso), Markers/RadarGuide (linguette laterali, ogni 64 unità) e Markers/RadarStop (una sbarra dove il percorso è bloccato).

Mantienili bassi, con il fondo a Y = 0. Almeno un materiale deve chiamarsi MarkerSignal (va bene anche MarkerSignal.001): il gioco lo illumina con il colore del piazzamento, verde, giallo, blu o rosso, quindi modella la forma luminosa e lascia il colore al gioco.

Macerie ed elementi dell'arena

  • Da Environment/Rubble_Natural_0 a _2 sono i cumuli di rocce, e Environment/Rubble_<Tower> i rottami di ogni torre (aggiungi _1 e _2 per rottami diversi ai livelli 1 e 2). Chiama i nodi Piece_1, Piece_2… per scegliere quali pietre la calamita del Collettore porta via a ogni viaggio, a partire dal numero più basso.
  • Da Environment/Barrier_1 a _3 mantengono i pivot da Drill_0 a Drill_4; anche gli extra Drill_5, Drill_6… girano.
  • Environment/Fence (PostLeft, PostRight, Rails), Environment/CollectorClaw (da Jaw0 a Jaw2), Environment/Core (il nucleo di energia della regola dei nuclei, largo circa 18 unità e alto 20), Environment/PlainShrubs (gli arbusti secchi della pianura) e da Environment/Debris_0 a _2.
  • Environment/Arena sostituisce l'intera arena. Per arene diverse per difficoltà e ondata, vedi scenario e tabellone.

Alleati

Allies/Soldier, Allies/Reinforcement e Allies/Hero vestono le unità di una caserma, di un potere di rinforzo e di un eroe; Allies/Sentinel, Allies/Ranger e Allies/Commander sono quelle dell'Hangar dei mech. Mantengono Body con Weapon sotto, e Shield in tutti tranne il rinforzo; i mech aggiungono MechRig, StrideLeft, StrideRight, KneeLeft e KneeRight per la camminata. Allies/Parachute è la vela del paracadute del Ranger.