WIKI

Mods

Modelos 3D

Cada modelo del juego tiene una clave, como Towers/Gun_1 o Buildings/Radar_1. Un mod asigna claves a archivos GLB propios en models.json; cada clave que deja fuera conserva el modelo del juego. Las torres tienen una página propia: 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/Flyer.glb"
  }
}
  • Las claves distinguen mayúsculas y minúsculas, y las rutas de archivo son relativas a la carpeta de tu mod. Una cadena simple equivale a {"file": …, "material": "imported"}.
  • Cada nivel y cada fusión es una clave propia: sustituir Towers/Gun_1 deja los niveles 2 y 3 como estaban. Apunta varias claves al mismo archivo si sus pivotes sirven para todas.
  • Un modelo cambia el aspecto de algo, nunca cómo se juega: el alcance, el daño, la huella y los caminos siguen siendo los del juego.

Preparar el GLB

  • Exporta glTF 2.0 binario (.glb) con todas las texturas incrustadas, Y hacia arriba (+Y Up en Blender) y escala 1. Un archivo puede tener hasta 64 MiB.
  • Usa triángulos indexados con normales (lo predeterminado en Blender). Sin armaduras, skins, clips de animación, cámaras ni luces: el juego mueve los modelos mediante sus pivotes Empty con nombre, así que pon cada parte móvil bajo su pivote.
  • Conserva los pivotes, los nombres, la escala, el origen y los ejes del modelo que sustituyes. Lo más fácil es partir de un GLB de uno de los ejemplos, importarlo en Blender y editarlo.
  • Un modelo que incumple su contrato se rechaza, con una línea en el registro, y el juego conserva el suyo.

Materiales

  • "material": "imported" (lo predeterminado) conserva tus materiales PBR: color base, metal y rugosidad, mapas de normales y de oclusión, emisión. Las partes transparentes se recortan, no se mezclan.
  • "material": "game" pinta el modelo con el aspecto propio de Torreta a partir de sus colores de vértice (COLOR_0), incluida la quitina de los insectos y sus ojos brillantes.

En ambos casos el modelo se construye desde el suelo, recibe impactos, se rompe y se moja con la lluvia como los del juego. Mantén el número de triángulos y de materiales cerca de los del juego, sobre todo en los insectos, que llegan por centenares.

Claves de modelo

model_catalog.json, en la carpeta _vanilla_reference de tu carpeta de Mods, enumera cada clave con sus pivotes y su tamaño. Los grupos:

ClavesCuántasPor ejemploTipo de mod
Towers/39Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused …Mod de jugabilidad
Enemies/84Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer …Mod de jugabilidad
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 jugabilidad
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 jugabilidad

Sustituir una torre, un insecto o la arena convierte tu mod en un mod de jugabilidad, ya que el juego apunta y acierta con esos modelos. Los demás grupos son cosméticos.

Usar uno de los modelos del juego

Nunca incluyas una copia de un modelo del juego. En su lugar, un espacio puede usar uno de los modelos del juego guardado bajo otra clave, indicado con game_model:

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

El modelo que indiques tiene que tener los pivotes que necesita el espacio.

Todos los modelos que puedes indicar, con su imagen, su clave y sus pivotes, aparecen en los modelos del juego. Una torre tuya también puede tomar la forma de cualquiera de ellos: consulta una torre dibujada como edificio. Los modelos propios de los mods de ejemplo no son del juego: copia el GLB de un ejemplo a la carpeta de tu mod para usarlo.

Más ligero de lejos

"generate_lods": true crea versiones más simples de un modelo denso al cargar el juego, que se dibujan cuando la cámara está lejos. Para un conjunto rígido de muchas piezas separadas, añade "lod_mode": "rigid_parts", que simplifica cada pieza por separado. Comprueba el resultado con los zooms que te importan.

Insectos y el gusano

Cada dificultad tiene doce familias de insectos, y cada familia un caminante y un volador: Enemies/<family> y Enemies/<family>_flyer en la primera dificultad, con dusk_ o night_ delante de la familia en la segunda y la tercera (Enemies/night_garden_flyer). Las familias son acrobat, army, bullet, carpenter, fire, garden, harvester, honeypot, leafcutter, trapjaw, turtle, weaver. Desde la oleada 6, algunos insectos llevan en su lugar una casta, Enemies/Castes/<caste>: atlas, brain, cricket, dragonfly, hornet, jewel, rhino, stag, termite, tiger, tortoise. Los jefes son el modelo de su familia, agrandado.

  • Conserva el rig del insecto: Body, con Head, Abdomen, Armor, Shield, Leg0 a Leg5 y Wing0 a Wing3 debajo, y JawL, JawR, AntennaL, AntennaR, EyesL, EyesR y ShieldHead bajo Head. Los pivotes que no uses pueden quedar vacíos.
  • Un caminante se apoya en Leg1, Leg2, Leg4 y Leg5, que necesitan pies de verdad; Leg0 y Leg3 son sus garras delanteras.
  • Tu geometría es el cuerpo que alcanzan los disparos de la cabina.
  • Algo erguido que deba flotar en vez de caminar lleva "locomotion": "float" en su entrada de models.json.
  • Opcional: TraitRegenerator, TraitSplitter, TraitShielded, TraitHaste y TraitNecromancer bajo Body muestran el órgano de un campeón, y ElytronL y ElytronR bajo Body llevan los élitros de un escarabajo.
  • El gusano, Enemies/Worm, conserva Body y sus seis mandíbulas Jaw0 a Jaw5; un Empty opcional Mouth bajo Body coloca la torre que se traga.

Criaturas voladoras

Un volador usa los mismos pivotes, con las alas bajo Wing0 a Wing3 (una criatura de dos alas usa Wing0 y Wing2) y las patas plegadas. En Blender, X es hacia delante, Y a la izquierda y Z hacia arriba; mantén Body a 5,8 unidades de altura y toda la criatura, con las alas batiendo, a unas 40 unidades de su centro como mucho. flight_cycle_speed, de 0,05 a 4 (1 por defecto), ralentiza o acelera el aleteo sin cambiar la velocidad del volador:

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

Las castas voladoras son dragonfly, hornet, jewel y atlas; las demás castas caminan. Ptero flyers sustituye a todos los voladores.

Edificios y piezas de la fábrica

Buildings/Factory_1 a _3, Buildings/Barracks_1 y Buildings/Radar_1 conservan las partes móviles y los pivotes de lámparas que enumera el catálogo (Flywheel, PressHead, Rotor, DishTilt, LampSocketLeft…). Dentro de la fábrica, Factory/Assembler_1 a _3, Factory/Splitter_1 y las claves Factory/Conveyor_* son las máquinas y las cintas, y Factory/Items/<material> es la caja de carga de cada material, incluido un material nuevo tuyo.

La sala de la fábrica

Factory/Room es el suelo y las paredes del interior de la fábrica con zoom. Usa las coordenadas propias de la fábrica, en unidades de Godot: Y hacia arriba, la parte superior del suelo en Y = 0, una cuadrícula de 32 unidades con nueve columnas (X de −128 a 128) y diecisiete filas (Z de 0 a 512), y la zona construible dentro de X −144 a 144 y Z −16 a 528. En Blender, un punto de Godot (x, y, z) es (x, −z, y). Deja libres las celdas y pon los detalles altos en los bordes; no hacen falta pivotes. Cobalt factory room es una completa.

Marcadores en el suelo

El cursor de casilla, el cursor del compañero de cooperativo, el anillo de alcance y la ruta del radar también son modelos:

  • Markers/TileCursor y Markers/PartnerCursor: centrados en el origen, ajustados a una casilla de 64 × 64 (X y Z de −32 a 32).
  • Markers/RangeRing: un anillo de radio 128 alrededor del origen; el juego lo estira hasta el alcance real de cada torre. Que siga siendo un anillo, no un disco.
  • Markers/RadarChevron (una flecha que apunta a +Z, repetida cada 32 unidades a lo largo de la ruta), Markers/RadarGuide (pestañas laterales, cada 64 unidades) y Markers/RadarStop (un travesaño donde la ruta está bloqueada).

Hazlos planos, con la cara inferior en Y = 0. Al menos un material tiene que llamarse MarkerSignal (MarkerSignal.001 también vale): el juego lo ilumina con el color de la colocación, verde, amarillo, azul o rojo, así que modela la forma luminosa y deja su color al juego.

Escombros y piezas de la arena

  • Environment/Rubble_Natural_0 a _2 son los montones de rocas, y Environment/Rubble_<Tower> los restos de cada torre (añade _1 y _2 para unos restos distintos en los niveles 1 y 2). Llama a los nodos Piece_1, Piece_2… para elegir qué piedras se lleva el imán del Colector en cada viaje, empezando por el número más bajo.
  • Environment/Barrier_1 a _3 conservan Drill_0 a Drill_4; los Drill_5, Drill_6… extra también giran.
  • Environment/Fence (PostLeft, PostRight, Rails), Environment/CollectorClaw (Jaw0 a Jaw2), Environment/Core (el núcleo de energía de la regla de núcleos, de unas 18 unidades de ancho y 20 de alto), Environment/PlainShrubs (los arbustos secos de la llanura) y Environment/Debris_0 a _2.
  • Environment/Arena sustituye la arena entera. Para arenas por dificultad y oleada, consulta escenario y tablero.

Aliados

Allies/Soldier, Allies/Reinforcement y Allies/Hero visten a las unidades de un cuartel, de un poder de refuerzos y de un héroe; Allies/Sentinel, Allies/Ranger y Allies/Commander son los del Hangar de Mechs. Conservan Body con Weapon debajo, y Shield en todos salvo el refuerzo; los mechs añaden MechRig, StrideLeft, StrideRight, KneeLeft y KneeRight para su forma de andar. Allies/Parachute es el paracaídas del Ranger.