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_1laisse 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és | Combien | Par exemple | Type de mod |
|---|---|---|---|
Towers/ | 39 | Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused … | Mod de gameplay |
Enemies/ | 84 | Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer … | Mod de gameplay |
Allies/ | 7 | Allies/Commander, Allies/Ranger, Allies/Soldier … | Cosmétique |
Buildings/ | 5 | Buildings/Barracks_1, Buildings/Factory_2, Buildings/Radar_1 … | Cosmétique |
Factory/ | 101 | Factory/Assembler_1, Factory/Conveyor_4_4, Factory/Splitter_1 … | Cosmétique |
Environment/ | 80 | Environment/Arena, Environment/Rubble_Cannon_1, Environment/ExpeditionTowerColumn … | Cosmétique · Environment/Arena: Mod de gameplay |
Markers/ | 6 | Markers/PartnerCursor, Markers/RadarStop, Markers/TileCursor … | Cosmétique |
Birds/ | 8 | Birds/Buzzard, Birds/Raven, Birds/Vulture … | Cosmétique |
Snakes/ | 2 | Snakes/HornedViper, Snakes/SandRacer | Cosmétique |
Microfauna/ | 6 | Microfauna/Ant, Microfauna/Cricket, Microfauna/Shelter … | Cosmétique |
Attachments/ | 11 | Attachments/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, avecHead,Abdomen,Armor,Shield,Leg0àLeg5etWing0àWing3en dessous, etJawL,JawR,AntennaL,AntennaR,EyesL,EyesRetShieldHeadsousHead. Les pivots que vous n'utilisez pas peuvent rester vides. - Un marcheur se tient sur
Leg1,Leg2,Leg4etLeg5, qui ont besoin de vrais pieds ;Leg0etLeg3sont 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 demodels.json. - Facultatif :
TraitRegenerator,TraitSplitter,TraitShielded,TraitHasteetTraitNecromancersousBodymontrent l'organe d'un champion, etElytronLetElytronRsousBodyportent les élytres d'un scarabée. - Le ver,
Enemies/Worm, gardeBodyet ses six mâchoiresJaw0àJaw5; un EmptyMouthfacultatif sousBodyplace 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/TileCursoretMarkers/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) etMarkers/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à_2sont les tas de rochers, etEnvironment/Rubble_<Tower>l'épave de chaque tour (ajoutez_1et_2pour une épave différente aux niveaux 1 et 2). Nommez des nœudsPiece_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à_3gardentDrill_0àDrill_4; desDrill_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) etEnvironment/Debris_0à_2.Environment/Arenaremplace 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.
