3D 모델
게임의 모든 모델에는 Towers/Gun_1이나 Buildings/Radar_1 같은 키가 있습니다. 모드는 models.json에서 키를 자기 GLB 파일에 연결하고, 빠진 키는 모두 게임의 모델을 그대로 씁니다. 타워에는 별도의 페이지가 있습니다: 타워 모델.
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"
}
}
- 키는 대소문자를 구분하며, 파일 경로는 모드 폴더 기준의 상대 경로입니다. 문자열만 쓰면
{"file": …, "material": "imported"}와 같습니다. - 레벨과 퓨전은 각각 별도의 키입니다.
Towers/Gun_1을 바꿔도 레벨 2와 3은 그대로입니다. 피벗이 모두에 맞는다면 여러 키를 한 파일에 연결해도 됩니다. - 모델은 겉모습만 바꾸고 플레이 방식은 바꾸지 않습니다. 사거리, 피해, 차지하는 칸, 경로는 게임의 것을 따릅니다.
GLB 준비하기
- 모든 텍스처를 포함한 glTF 2.0 바이너리(
.glb)로, Y 위쪽(Blender의 +Y Up), 스케일 1로 내보내세요. 파일은 최대 64 MiB까지입니다. - 법선이 있는 인덱스 삼각형을 쓰세요(Blender 기본값). 아마추어, 스킨, 애니메이션 클립, 카메라, 조명은 쓰지 마세요. 게임은 이름 붙은 Empty 피벗으로 모델을 움직이므로, 움직이는 부품은 각각 해당 피벗 아래에 두세요.
- 바꾸려는 모델의 피벗, 이름, 스케일, 원점, 축을 유지하세요. 가장 쉬운 시작은 예제의 GLB를 Blender로 가져와 고치는 것입니다.
- 규약을 어긴 모델은 로그에 한 줄을 남기고 거부되며, 게임은 자기 모델을 유지합니다.
재질
"material": "imported"(기본값)는 직접 만든 PBR 재질을 유지합니다: 기본 색상, 금속성과 거칠기, 노멀 맵과 오클루전 맵, 발광. 투명한 부분은 섞이지 않고 잘려 나갑니다."material": "game"은 정점 색상(COLOR_0)을 바탕으로 곤충의 키틴질과 빛나는 눈을 포함해 Torreta 고유의 외형으로 모델을 칠합니다.
어느 쪽이든 모델은 게임의 모델처럼 땅에서부터 지어지고, 공격을 맞고, 부서지고, 비에 젖습니다. 삼각형 수와 재질 수는 게임의 것과 비슷하게 유지하세요. 특히 수백 마리씩 나오는 곤충은 더욱 그렇습니다.
모델 키
모드 폴더의 _vanilla_reference 폴더에 있는 model_catalog.json에 모든 키와 피벗, 크기가 나와 있습니다. 그룹은 다음과 같습니다.
| 키 | 개수 | 예시 | 모드 종류 |
|---|---|---|---|
Towers/ | 39 | Towers/Bolt_1, Towers/Gun_2, Towers/Poison_3_Fused … | 게임플레이 모드 |
Enemies/ | 84 | Enemies/Castes/atlas, Enemies/dusk_weaver, Enemies/weaver_flyer … | 게임플레이 모드 |
Allies/ | 7 | Allies/Commander, Allies/Ranger, Allies/Soldier … | 외형 |
Buildings/ | 5 | Buildings/Barracks_1, Buildings/Factory_2, Buildings/Radar_1 … | 외형 |
Factory/ | 101 | Factory/Assembler_1, Factory/Conveyor_4_4, Factory/Splitter_1 … | 외형 |
Environment/ | 80 | Environment/Arena, Environment/Rubble_Cannon_1, Environment/ExpeditionTowerColumn … | 외형 · Environment/Arena: 게임플레이 모드 |
Markers/ | 6 | Markers/PartnerCursor, Markers/RadarStop, Markers/TileCursor … | 외형 |
Birds/ | 8 | Birds/Buzzard, Birds/Raven, Birds/Vulture … | 외형 |
Snakes/ | 2 | Snakes/HornedViper, Snakes/SandRacer | 외형 |
Microfauna/ | 6 | Microfauna/Ant, Microfauna/Cricket, Microfauna/Shelter … | 외형 |
Attachments/ | 11 | Attachments/AmmoEjector_Cannon, Attachments/FrostLinkManifold, Attachments/SpentCase_MachineGun … | 게임플레이 모드 |
게임은 타워, 곤충, 경기장 모델로 조준하고 명중을 판정하므로, 이것들을 바꾸면 모드가 게임플레이 모드가 됩니다. 나머지 그룹은 외형용입니다.
게임 모델 입히기
게임 모델의 복사본은 절대 배포하지 마세요. 대신 슬롯에 다른 키로 보관된 게임 모델을 game_model로 지정해 입힐 수 있습니다.
"Towers/MachineGun_1": {"game_model": "Towers/Hangar_1"},
"Allies/Hero": {"game_model": "Allies/Commander"}
지정한 모델에도 그 슬롯에 필요한 피벗이 있어야 합니다.
지정할 수 있는 모든 모델은 그림, 키, 피벗과 함께 게임 모델에 있습니다. 나만의 타워도 그중 어떤 모델의 모습으로든 세울 수 있습니다: 건물로 그려지는 타워를 보세요. 예시 모드에 들어 있는 모델은 게임 모델이 아닙니다. 쓰려면 그 예시의 GLB를 모드 폴더에 복사하세요.
멀리서는 가볍게
"generate_lods": true를 쓰면 게임이 로드할 때 조밀한 모델의 단순화 버전을 만들어, 카메라가 멀리 있을 때 그립니다. 따로 떨어진 부품이 많은 단단한 조립체라면 "lod_mode": "rigid_parts"를 더하세요. 부품마다 따로 단순화합니다. 중요한 확대 배율에서 결과를 확인하세요.
곤충과 웜
난이도마다 곤충 계열이 열두 개 있고, 계열마다 걷는 개체와 나는 개체가 있습니다. 첫 번째 난이도에서는 Enemies/<family>와 Enemies/<family>_flyer이고, 두 번째와 세 번째 난이도에서는 계열 앞에 dusk_나 night_가 붙습니다(Enemies/night_garden_flyer). 계열은 acrobat, army, bullet, carpenter, fire, garden, harvester, honeypot, leafcutter, trapjaw, turtle, weaver입니다. 6웨이브부터는 일부 곤충이 대신 계급 모델 Enemies/Castes/<caste>를 입습니다: atlas, brain, cricket, dragonfly, hornet, jewel, rhino, stag, termite, tiger, tortoise. 보스는 그 계열의 모델을 키운 것입니다.
- 곤충 리그를 유지하세요:
Body아래에Head,Abdomen,Armor,Shield,Leg0~Leg5,Wing0~Wing3가 있고,Head아래에JawL,JawR,AntennaL,AntennaR,EyesL,EyesR,ShieldHead가 있습니다. 쓰지 않는 피벗은 비워 둬도 됩니다. - 걷는 개체는
Leg1,Leg2,Leg4,Leg5로 서므로 이 다리에는 실제 발이 필요합니다.Leg0과Leg3은 앞발톱입니다. - 직접 만든 지오메트리가 곧 조종석 사격이 맞히는 몸체입니다.
- 걷지 않고 떠다녀야 하는 직립형 개체는
models.json항목에"locomotion": "float"를 넣으세요. - 선택 사항:
Body아래의TraitRegenerator,TraitSplitter,TraitShielded,TraitHaste,TraitNecromancer는 챔피언의 기관을 보여 주고,Body아래의ElytronL과ElytronR은 딱정벌레의 겉날개를 담습니다. - 웜
Enemies/Worm은Body와 여섯 개의 턱Jaw0~Jaw5를 유지합니다.Body아래에 선택 사항인MouthEmpty를 두면 삼키는 타워의 위치가 정해집니다.
나는 생물
나는 개체도 같은 피벗을 쓰며, 날개는 Wing0~Wing3 아래에 두고(날개가 둘인 생물은 Wing0과 Wing2) 다리는 접습니다. Blender에서 X가 앞, Y가 왼쪽, Z가 위입니다. Body를 5.8 단위 높이에 두고, 날갯짓하는 생물 전체가 중심에서 약 40 단위 안에 들어오게 하세요. flight_cycle_speed는 0.05에서 4까지(기본 1)이며, 비행 속도는 바꾸지 않고 날갯짓만 느리게 하거나 빠르게 합니다.
"Enemies/garden_flyer": {"file": "Models/Ptero.glb", "material": "imported", "flight_cycle_speed": 0.22}
나는 계급은 dragonfly, hornet, jewel, atlas이고, 나머지 계급은 걷습니다. Ptero flyers는 모든 비행 개체를 바꿉니다.
건물과 공장 부품
Buildings/Factory_1~_3, Buildings/Barracks_1, Buildings/Radar_1은 카탈로그에 나열된 움직이는 부품과 조명 피벗(Flywheel, PressHead, Rotor, DishTilt, LampSocketLeft…)을 유지합니다. 공장 안에서는 Factory/Assembler_1~_3, Factory/Splitter_1, Factory/Conveyor_* 키가 기계와 벨트이고, Factory/Items/<material>은 각 재료의 화물 상자이며, 직접 만든 새 재료도 포함됩니다.
공장 내부
Factory/Room은 확대해서 보는 공장 안의 바닥과 벽입니다. 공장 고유의 좌표를 Godot 단위로 씁니다: Y가 위, 바닥 윗면이 Y = 0, 32 단위 격자로 열 아홉 개(X는 −128에서 128)와 행 열일곱 개(Z는 0에서 512), 건설 가능 영역은 X −144~144, Z −16~528입니다. Blender에서 Godot의 점 (x, y, z)는 (x, −z, y)입니다. 칸은 비워 두고 높은 장식은 가장자리에 두세요. 피벗은 필요 없습니다. Cobalt factory room이 완성된 예입니다.
지면 마커
칸 커서, 협동 파트너의 커서, 사거리 고리, 레이더 경로도 모델입니다.
Markers/TileCursor와Markers/PartnerCursor: 원점을 중심으로 64 × 64 칸에 맞춥니다(X와 Z는 −32에서 32).Markers/RangeRing: 원점을 둘러싼 반지름 128의 고리입니다. 게임이 각 타워의 실제 사거리에 맞게 늘립니다. 원판이 아니라 고리로 유지하세요.Markers/RadarChevron(+Z를 가리키는 화살표로, 경로를 따라 32 단위마다 반복),Markers/RadarGuide(옆쪽 탭, 64 단위마다),Markers/RadarStop(경로가 막힌 곳의 가로대).
얕게 만들고 밑면을 Y = 0에 두세요. 재질 하나 이상의 이름이 MarkerSignal이어야 합니다(MarkerSignal.001도 됩니다). 게임이 이 재질을 설치 가능 여부의 색인 초록, 노랑, 파랑, 빨강으로 밝히므로, 빛나는 모양만 모델링하고 색은 게임에 맡기세요.
잔해와 경기장 부품
Environment/Rubble_Natural_0~_2는 바위 더미이고,Environment/Rubble_<Tower>는 각 타워의 잔해입니다(레벨 1과 2에서 다른 잔해를 쓰려면_1과_2를 붙이세요). 노드 이름을Piece_1,Piece_2…로 지으면 수집기의 자석이 매번 어떤 돌을 가져갈지 정할 수 있으며, 번호가 낮은 것부터 가져갑니다.Environment/Barrier_1~_3은Drill_0~Drill_4를 유지합니다. 추가한Drill_5,Drill_6…도 회전합니다.Environment/Fence(PostLeft,PostRight,Rails),Environment/CollectorClaw(Jaw0~Jaw2),Environment/Core(코어 규칙의 에너지 코어로, 너비 약 18, 높이 20 단위),Environment/PlainShrubs(평원의 마른 덤불),Environment/Debris_0~_2.Environment/Arena는 경기장 전체를 바꿉니다. 난이도와 웨이브별 경기장은 풍경과 보드를 보세요.
아군
Allies/Soldier, Allies/Reinforcement, Allies/Hero는 병영의 유닛, 지원군 능력의 유닛, 영웅의 외형이고, Allies/Sentinel, Allies/Ranger, Allies/Commander는 메크 격납고의 것입니다. 이 모델들은 Body와 그 아래의 Weapon을 유지하고, 지원군을 제외하면 Shield도 유지합니다. 메크는 걷기를 위해 MechRig, StrideLeft, StrideRight, KneeLeft, KneeRight를 더합니다. Allies/Parachute는 레인저의 낙하산입니다.
