WIKI

Mods

Modèles 3D

Chaque modèle du jeu a une clé, comme Towers/Gun_1 ou Buildings/Radar_1. Un mod associe des clés à ses propres fichiers GLB dans models.json ; chaque clé qu'il omet garde le modèle du jeu. Les tours ont leur propre page : modèles de tours.

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"
  }
}
  • Les clés sont sensibles à la casse, et les chemins de fichiers sont relatifs au dossier de votre mod. Une simple chaîne équivaut à {"file": …, "material": "imported"}.
  • Chaque niveau et chaque fusion a sa propre clé : remplacer Towers/Gun_1 laisse les niveaux 2 et 3 tels quels. Faites pointer plusieurs clés vers un même fichier si ses pivots conviennent à toutes.
  • Un modèle change l'apparence d'une chose, jamais sa façon de jouer : la portée, les dégâts, l'emprise et les chemins restent ceux du jeu.

Préparer le GLB

  • Exportez en glTF 2.0 binaire (.glb) avec toutes les textures intégrées, Y vers le haut (+Y Up dans Blender) et une échelle de 1. Un fichier peut peser jusqu'à 64 Mio.
  • Utilisez des triangles indexés avec des normales (le réglage par défaut de Blender). Pas d'armatures, de skins, de clips d'animation, de caméras ni de lumières : le jeu anime les modèles par leurs pivots Empty nommés, donc placez chaque pièce mobile sous son pivot.
  • Gardez les pivots, les noms, l'échelle, l'origine et les axes du modèle que vous remplacez. Le plus simple est de partir d'un GLB de l'un des exemples, importé dans Blender et modifié.
  • Un modèle qui ne respecte pas son contrat est refusé, avec une ligne dans le journal, et le jeu garde le sien.

Matériaux

  • "material": "imported" (par défaut) garde vos matériaux PBR : couleur de base, métal et rugosité, cartes de normales et d'occlusion, émission. Les parties transparentes sont découpées, pas mélangées.
  • "material": "game" peint le modèle avec le rendu propre à Torreta à partir de ses couleurs de sommets (COLOR_0), y compris la chitine et les yeux lumineux des insectes.

Dans les deux cas, le modèle se construit depuis le sol, encaisse les coups, se brise et se mouille sous la pluie comme ceux du jeu. Gardez un nombre de triangles et de matériaux proche de celui du jeu, surtout pour les insectes, qui arrivent par centaines.

Clés de modèle

model_catalog.json, dans le dossier _vanilla_reference de votre dossier Mods, liste chaque clé avec ses pivots et sa taille. Les groupes :

ClésCombienPar exempleType 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étique
Buildings/5Buildings/Barracks_1, Buildings/Factory_2, Buildings/Radar_1 …Cosmétique
Factory/101Factory/Assembler_1, Factory/Conveyor_4_4, Factory/Splitter_1 …Cosmétique
Environment/80Environment/Arena, Environment/Rubble_Cannon_1, Environment/ExpeditionTowerColumn …Cosmétique · Environment/Arena: Mod de gameplay
Markers/6Markers/PartnerCursor, Markers/RadarStop, Markers/TileCursor …Cosmétique
Birds/8Birds/Buzzard, Birds/Raven, Birds/Vulture …Cosmétique
Snakes/2Snakes/HornedViper, Snakes/SandRacerCosmétique
Microfauna/6Microfauna/Ant, Microfauna/Cricket, Microfauna/Shelter …Cosmétique
Attachments/11Attachments/AmmoEjector_Cannon, Attachments/FrostLinkManifold, Attachments/SpentCase_MachineGun …Mod de gameplay

Remplacer une tour, un insecte ou l'arène fait de votre mod un mod de gameplay, puisque le jeu vise et touche avec ces modèles. Les autres groupes sont cosmétiques.

Utiliser l'un des modèles du jeu

Ne fournissez jamais une copie d'un modèle du jeu. Un emplacement peut plutôt utiliser l'un des modèles du jeu rangé sous une autre clé, désigné par game_model :

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

Le modèle que vous désignez doit quand même porter les pivots dont l'emplacement a besoin.

Chaque modèle que vous pouvez désigner, avec son image, sa clé et ses pivots, se trouve dans les modèles du jeu. Une tour à vous peut aussi prendre l'apparence de n'importe lequel d'entre eux : voir une tour dessinée comme un bâtiment. Les modèles propres aux mods d'exemple ne font pas partie du jeu : copiez le GLB d'un exemple dans le dossier de votre mod pour l'utiliser.

Plus léger de loin

"generate_lods": true crée des versions simplifiées d'un modèle dense au chargement du jeu, affichées quand la caméra est loin. Pour un assemblage rigide de nombreuses pièces séparées, ajoutez "lod_mode": "rigid_parts", qui simplifie chaque pièce séparément. Vérifiez le résultat aux niveaux de zoom qui vous importent.

Insectes et ver

Chaque difficulté a douze familles d'insectes, et chaque famille un marcheur et un volant : Enemies/<family> et Enemies/<family>_flyer pour la première difficulté, avec dusk_ ou night_ devant la famille pour la deuxième et la troisième (Enemies/night_garden_flyer). Les familles sont acrobat, army, bullet, carpenter, fire, garden, harvester, honeypot, leafcutter, trapjaw, turtle, weaver. À partir de la vague 6, certains insectes portent plutôt une caste, Enemies/Castes/<caste> : atlas, brain, cricket, dragonfly, hornet, jewel, rhino, stag, termite, tiger, tortoise. Les boss sont le modèle de leur famille, agrandi.

  • Gardez le squelette de l'insecte : Body, avec Head, Abdomen, Armor, Shield, Leg0 à Leg5 et Wing0 à Wing3 en dessous, et JawL, JawR, AntennaL, AntennaR, EyesL, EyesR et ShieldHead sous Head. Les pivots que vous n'utilisez pas peuvent rester vides.
  • Un marcheur se tient sur Leg1, Leg2, Leg4 et Leg5, qui ont besoin de vrais pieds ; Leg0 et Leg3 sont ses pinces avant.
  • Votre géométrie est le corps que touchent les tirs du cockpit.
  • Une créature dressée qui doit flotter plutôt que marcher prend "locomotion": "float" dans son entrée de models.json.
  • Facultatif : TraitRegenerator, TraitSplitter, TraitShielded, TraitHaste et TraitNecromancer sous Body montrent l'organe d'un champion, et ElytronL et ElytronR sous Body portent les élytres d'un scarabée.
  • Le ver, Enemies/Worm, garde Body et ses six mâchoires Jaw0 à Jaw5 ; un Empty Mouth facultatif sous Body place la tour qu'il avale.

Créatures volantes

Un volant utilise les mêmes pivots, avec ses ailes sous Wing0 à Wing3 (une créature à deux ailes utilise Wing0 et Wing2) et ses pattes repliées. Dans Blender, X pointe vers l'avant, Y vers la gauche et Z vers le haut ; gardez Body à 5,8 unités de hauteur et toute la créature, ailes battantes, à environ 40 unités de son centre au maximum. flight_cycle_speed, de 0,05 à 4 (1 par défaut), ralentit ou accélère le battement d'ailes sans changer la vitesse du volant :

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

Les castes volantes sont dragonfly, hornet, jewel et atlas ; les autres castes marchent. Ptero flyers remplace tous les volants.

Bâtiments et pièces de l'usine

Buildings/Factory_1 à _3, Buildings/Barracks_1 et Buildings/Radar_1 gardent les pièces mobiles et les pivots de lampes que liste le catalogue (Flywheel, PressHead, Rotor, DishTilt, LampSocketLeft…). Dans l'usine, Factory/Assembler_1 à _3, Factory/Splitter_1 et les clés Factory/Conveyor_* sont les machines et les convoyeurs, et Factory/Items/<material> est la caisse de chaque matériau, y compris un nouveau matériau à vous.

La salle de l'usine

Factory/Room est le sol et les murs à l'intérieur de l'usine zoomable. Elle utilise les coordonnées propres à l'usine, en unités Godot : Y vers le haut, le dessus du sol à Y = 0, une grille de 32 unités de neuf colonnes (X de −128 à 128) et dix-sept rangées (Z de 0 à 512), et la zone constructible entre X −144 et 144 et Z −16 et 528. Dans Blender, un point Godot (x, y, z) devient (x, −z, y). Laissez les cases libres et placez les détails hauts sur les bords ; aucun pivot n'est nécessaire. Cobalt factory room en est un exemple complet.

Marqueurs au sol

Le curseur de case, le curseur du partenaire en co-op, l'anneau de portée et la route du radar sont aussi des modèles :

  • Markers/TileCursor et Markers/PartnerCursor : centrés sur l'origine, tenant dans une case de 64 × 64 (X et Z de −32 à 32).
  • Markers/RangeRing : un anneau de rayon 128 autour de l'origine ; le jeu l'étire à la portée réelle de chaque tour. Gardez un anneau, pas un disque.
  • Markers/RadarChevron (une flèche pointant vers +Z, répétée toutes les 32 unités le long de la route), Markers/RadarGuide (des languettes latérales, toutes les 64 unités) et Markers/RadarStop (une barre transversale là où la route est bloquée).

Gardez-les plats, avec le dessous à Y = 0. Au moins un matériau doit s'appeler MarkerSignal (MarkerSignal.001 fonctionne aussi) : le jeu l'éclaire de la couleur du placement, vert, jaune, bleu ou rouge, donc modélisez la forme lumineuse et laissez sa couleur au jeu.

Décombres et éléments de l'arène

  • Environment/Rubble_Natural_0 à _2 sont les tas de rochers, et Environment/Rubble_<Tower> l'épave de chaque tour (ajoutez _1 et _2 pour une épave différente aux niveaux 1 et 2). Nommez des nœuds Piece_1, Piece_2… pour choisir quelles pierres l'aimant du Collecteur emporte à chaque trajet, du plus petit numéro au plus grand.
  • Environment/Barrier_1 à _3 gardent Drill_0 à Drill_4 ; des Drill_5, Drill_6… supplémentaires tournent aussi.
  • Environment/Fence (PostLeft, PostRight, Rails), Environment/CollectorClaw (Jaw0 à Jaw2), Environment/Core (le noyau d'énergie de la règle des noyaux, environ 18 unités de large et 20 de haut), Environment/PlainShrubs (les arbustes secs de la plaine) et Environment/Debris_0 à _2.
  • Environment/Arena remplace toute l'arène. Pour des arènes par difficulté et par vague, voir décor et plateau.

Alliés

Allies/Soldier, Allies/Reinforcement et Allies/Hero habillent les unités d'une caserne, d'un pouvoir de renfort et d'un héros ; Allies/Sentinel, Allies/Ranger et Allies/Commander sont ceux du Hangar à mechs. Ils gardent Body avec Weapon en dessous, et Shield sur tous sauf le renfort ; les mechs ajoutent MechRig, StrideLeft, StrideRight, KneeLeft et KneeRight pour leur marche. Allies/Parachute est la voilure du Ranger.