LINE1 10 20 30 40 50 60 70 80 90 100 110 1201"""Build Atlanta the Huntress as a game-ready GLB.23Atlanta is the swift huntress of the wild: tall and sun-browned, in a layered4green tunic and leather hunting gear, with a feathered mantle, a quiver of5arrows, and a tall recurve bow. The whole model is procedural, so it can be6rebuilt and tweaked from a terminal.78 blender -b --factory-startup -P tools/blender/atlanta.py -- \9 --out assets/models/atlanta.glb1011The character is about 1.8 Blender units tall and faces -Y in Blender, which12becomes +Z (towards the game camera) after the glTF Y-up conversion.13"""1415import argparse16import math17import sys18from pathlib import Path1920import bpy21from mathutils import Quaternion, Vector2223sys.path.insert(0, str(Path(__file__).resolve().parent))24from export_glb import export_scene # noqa: E402 (needs Blender's sys.path)25from rig import rig_character # noqa: E402 (needs Blender's sys.path)26from hero_parts import ( # noqa: E402 (needs Blender's sys.path)27 box,28 cone,29 cylinder,30 group,31 limb,32 material,33 revolve,34 sphere,35 torus,36 tube,37)3839SKIN = (0.79, 0.60, 0.46)40SKIN_SHADE = (0.64, 0.45, 0.34)41HAIR = (0.35, 0.20, 0.11)42HAIR_LIGHT = (0.56, 0.35, 0.17)43HAIR_SHADE = (0.22, 0.12, 0.07)44TUNIC = (0.17, 0.31, 0.20)45TUNIC_DARK = (0.09, 0.19, 0.12)46LEATHER = (0.29, 0.19, 0.12)47LEATHER_LIGHT = (0.43, 0.30, 0.18)48BRONZE = (0.72, 0.49, 0.22)49FEATHER = (0.86, 0.80, 0.64)50FEATHER_SHADE = (0.63, 0.56, 0.43)51WOOD = (0.42, 0.25, 0.12)52STRING = (0.86, 0.84, 0.72)53EYE = (0.05, 0.08, 0.05)54IRIS = (0.17, 0.46, 0.26)55LIPS = (0.53, 0.32, 0.29)565758def feather(name, base, direction, length, width, mat):59 """A broad, flattened feather, built as an oriented ellipsoid."""60 base = Vector(base)61 axis = Vector(direction).normalized()62 obj = sphere(63 name,64 tuple(base + axis * (length / 2)),65 1.0,66 mat,67 scale=(width / 2, width * 0.16, length / 2),68 segments=14,69 rings=10,70 )71 obj.rotation_euler = axis.to_track_quat("Z", "Y").to_euler()72 return obj737475def arrow(name, start, end, *, shaft, bronze, fletch):76 """A slim arrow with a bronze head and a feather fletching."""77 start = Vector(start)78 end = Vector(end)79 axis = (end - start).normalized()80 parts = [81 limb(f"{name} Shaft", start, end, 0.0055, 0.0055, shaft, vertices=5),82 cone(83 f"{name} Head",84 tuple(end + axis * 0.045),85 0.018,86 0.002,87 0.09,88 bronze,89 vertices=6,90 rotation=tuple(axis.to_track_quat("Z", "Y").to_euler()),91 ),92 ]93 for index, spin in enumerate((0, 2.1, 4.2)):94 across = axis.cross(Vector((0, 0, 1)))95 if across.length < 0.1:96 across = axis.cross(Vector((1, 0, 0)))97 across.normalize()98 side = Quaternion(axis, spin) @ across99 parts.append(100 feather(101 f"{name} Fletch {index + 1}",102 tuple(start + axis * 0.02 + side * 0.007),103 tuple(axis * 0.8 + side * 0.35),104 0.075,105 0.026,106 fletch,107 )108 )109 return parts110111112def build():113 bpy.ops.wm.read_factory_settings(use_empty=True)114115 skin = material("Atlanta Skin", SKIN, roughness=0.6)116 skin_shade = material("Atlanta Skin Shade", SKIN_SHADE, roughness=0.64)117 hair = material("Atlanta Hair", HAIR, roughness=0.42)118 hair_light = material("Atlanta Hair Light", HAIR_LIGHT, roughness=0.46)119 hair_shade = material("Atlanta Hair Shade", HAIR_SHADE, roughness=0.44)120 tunic = material("Atlanta Tunic", TUNIC, roughness=0.74)121 tunic_dark = material("Atlanta Tunic Dark", TUNIC_DARK, roughness=0.8)122 leather = material("Atlanta Leather", LEATHER, roughness=0.68)123 leather_light = material("Atlanta Leather Light", LEATHER_LIGHT, roughness=0.62)124 bronze = material("Atlanta Bronze", BRONZE, metallic=0.78, roughness=0.3)125 feather_mat = material("Atlanta Feather", FEATHER, roughness=0.58)126 feather_shade = material("Atlanta Feather Shade", FEATHER_SHADE, roughness=0.64)127 wood = material("Atlanta Bow Wood", WOOD, roughness=0.46)128 string = material("Atlanta Bowstring", STRING, roughness=0.7)129 eye = material("Atlanta Eyes", EYE, roughness=0.28)130 sclera = material("Atlanta Sclera", (0.93, 0.94, 0.92), roughness=0.34)131 iris = material(132 "Atlanta Iris",133 IRIS,134 roughness=0.24,135 emission=(0.04, 0.16, 0.07),136 emission_strength=0.55,137 )138 lips = material("Atlanta Lips", LIPS, roughness=0.58)139140 parts = []141142 # Long legs, laced boots, and a slightly staggered hunting stance.143 legs = [144 ("R", 1, (0.086, 0.00, 0.90), (0.096, -0.09, 0.49), (0.108, -0.15, 0.10)),145 ("L", -1, (-0.086, 0.01, 0.90), (-0.10, 0.03, 0.49), (-0.112, 0.06, 0.10)),146 ]147 for label, side, hip, knee, ankle in legs:148 hip = Vector(hip)149 knee = Vector(knee)150 ankle = Vector(ankle)151 parts.append(limb(f"Atlanta Thigh {label}", hip, knee, 0.074, 0.052, skin, vertices=12))152 parts.append(limb(f"Atlanta Calf {label}", knee, ankle, 0.052, 0.037, leather, vertices=12))153 boot = knee.lerp(ankle, 0.46)154 parts.append(155 cylinder(f"Atlanta Boot {label}", tuple(boot), 0.058, 0.26, leather, vertices=14)156 )157 for lace in range(3):158 point = boot.lerp(knee, 0.12 + lace * 0.14)159 parts.append(160 tube(161 f"Atlanta Boot Lace {label} {lace + 1}",162 [163 (point.x - 0.056, point.y - 0.02, point.z),164 (point.x, point.y - 0.062, point.z + 0.008),165 (point.x + 0.056, point.y - 0.02, point.z),166 ],167 [0.004, 0.005, 0.004],168 leather_light,169 sides=4,170 )171 )172 parts.append(173 sphere(174 f"Atlanta Knee Guard {label}",175 tuple(knee + Vector((side * 0.006, -0.052, 0.01))),176 0.056,177 bronze,178 scale=(1.0, 0.55, 0.82),179 segments=14,180 rings=10,181 )182 )183 # A low boot shaft joins calf and foot; without it the foot floats.184 parts.append(185 cylinder(186 f"Atlanta Boot Shaft {label}",187 (ankle.x, ankle.y, ankle.z - 0.045),188 0.045,189 0.09,190 leather,191 vertices=14,192 )193 )194 parts.append(195 sphere(196 f"Atlanta Foot {label}",197 (ankle.x, ankle.y - 0.075, 0.045),198 0.064,199 leather,200 scale=(0.7, 1.62, 0.52),201 segments=14,202 rings=10,203 )204 )205206 # Layered hunting tunic with a split, wind-caught hem.207 parts.append(208 revolve(209 "Atlanta Tunic Skirt",210 [211 (0.62, 0.225),212 (0.70, 0.215),213 (0.79, 0.198),214 (0.87, 0.182),215 (0.94, 0.170),216 ],217 tunic,218 y_scale=0.86,219 ripple=0.035,220 wave=0.02,221 thickness=0.011,222 )223 )224 parts.append(225 revolve(226 "Atlanta Under Skirt",227 [(0.60, 0.205), (0.68, 0.193), (0.78, 0.178)],228 tunic_dark,229 y_scale=0.87,230 ripple=0.02,231 wave=0.01,232 thickness=0.009,233 )234 )235 parts.append(236 revolve(237 "Atlanta Bodice",238 [239 (0.92, 0.172),240 (0.98, 0.155),241 (1.04, 0.142),242 (1.10, 0.148),243 (1.16, 0.164),244 (1.22, 0.180),245 (1.28, 0.188),246 (1.33, 0.184),247 (1.37, 0.155),248 (1.39, 0.118),249 ],250 tunic,251 y_scale=0.72,252 ripple=0.014,253 thickness=0.012,254 )255 )256 for side in (-1, 1):257 parts.append(258 sphere(259 f"Atlanta Bust {'L' if side < 0 else 'R'}",260 (side * 0.064, -0.05, 1.2),261 0.078,262 tunic,263 scale=(1.0, 0.82, 0.7),264 segments=18,265 rings=12,266 )267 )268269 # Underbust strap, wide belt, buckle, and a huntress's hip pouch.270 parts.append(torus("Atlanta Underbust", (0, 0, 1.115), 0.158, 0.019, leather, major_segments=36))271 parts.append(torus("Atlanta Belt", (0, 0, 0.945), 0.172, 0.026, leather, major_segments=36))272 parts.append(box("Atlanta Buckle", (0, -0.158, 0.945), (0.075, 0.028, 0.06), bronze))273 parts.append(box("Atlanta Buckle Inset", (0, -0.174, 0.945), (0.038, 0.014, 0.03), leather))274 parts.append(275 sphere(276 "Atlanta Hip Pouch",277 (-0.16, -0.075, 0.86),278 0.06,279 leather_light,280 scale=(0.9, 0.72, 1.05),281 segments=12,282 rings=8,283 )284 )285 parts.append(286 sphere(287 "Atlanta Pouch Flap",288 (-0.16, -0.128, 0.885),289 0.05,290 leather,291 scale=(0.95, 0.3, 0.6),292 segments=12,293 rings=8,294 )295 )296 parts.append(297 limb(298 "Atlanta Hip Knife",299 (-0.185, 0.06, 0.78),300 (-0.175, 0.09, 0.60),301 0.022,302 0.004,303 leather_light,304 vertices=6,305 )306 )307308 # Two rows of overlapping feathers drape down over the shoulders and back.309 for layer, (z, count, length, width, spread, phase) in enumerate(310 [311 (1.355, 12, 0.34, 0.09, 0.5, 0),312 (1.315, 10, 0.27, 0.075, 0.62, 17),313 ]314 ):315 for index in range(count):316 angle = math.radians(phase + index * (360 / count))317 if math.radians(215) < angle < math.radians(325):318 continue319 base = (320 math.cos(angle) * 0.19,321 math.sin(angle) * 0.155 + 0.035,322 z,323 )324 direction = (math.cos(angle) * spread, math.sin(angle) * spread, -1.0)325 parts.append(326 feather(327 f"Atlanta Mantle {layer + 1} Feather {index + 1}",328 base,329 direction,330 length if index % 2 else length + 0.04,331 width,332 feather_mat if (index + layer) % 3 else feather_shade,333 )334 )335 parts.append(336 sphere(337 "Atlanta Mantle Clasp",338 (0, -0.135, 1.315),339 0.04,340 bronze,341 scale=(1.3, 0.65, 1.0),342 segments=14,343 rings=10,344 )345 )346 mantle_glass = material(347 "Atlanta Mantle Glass",348 (0.15, 0.55, 0.30),349 roughness=0.22,350 emission=(0.05, 0.25, 0.10),351 emission_strength=0.8,352 )353 parts.append(sphere("Atlanta Mantle Gem", (0, -0.162, 1.315), 0.021, mantle_glass, segments=12, rings=8))354355 # A bronze stag brooch with antlers at the breast.356 parts.append(sphere("Atlanta Stag", (0, -0.148, 1.245), 0.026, bronze, scale=(1.0, 0.7, 1.15), segments=12, rings=8))357 for side in (-1, 1):358 parts.append(359 tube(360 f"Atlanta Antler {'L' if side < 0 else 'R'}",361 [362 (side * 0.012, -0.152, 1.262),363 (side * 0.04, -0.150, 1.295),364 (side * 0.07, -0.142, 1.315),365 ],366 [0.008, 0.005, 0.0015],367 bronze,368 sides=4,369 )370 )371 parts.append(372 tube(373 f"Atlanta Antler Tine {'L' if side < 0 else 'R'}",374 [375 (side * 0.045, -0.149, 1.298),376 (side * 0.055, -0.145, 1.335),377 ],378 [0.004, 0.0012],379 bronze,380 sides=4,381 )382 )383384 # Neck and a sun-browned, freckled face.385 parts.append(cylinder("Atlanta Neck", (0, 0, 1.41), 0.042, 0.12, skin, vertices=20))386 parts.append(sphere("Atlanta Head", (0, -0.005, 1.555), 0.113, skin, scale=(1.0, 0.98, 1.16)))387 parts.append(sphere("Atlanta Jaw", (0, -0.02, 1.483), 0.092, skin, scale=(0.88, 0.92, 0.74), segments=20, rings=14))388 parts.append(sphere("Atlanta Chin", (0, -0.088, 1.456), 0.03, skin, scale=(1.03, 0.86, 0.96), segments=14, rings=10))389 for side in (-1, 1):390 parts.append(391 sphere(392 f"Atlanta Ear {'L' if side < 0 else 'R'}",393 (side * 0.114, -0.002, 1.535),394 0.029,395 skin,396 scale=(0.4, 0.8, 1.1),397 segments=12,398 rings=8,399 )400 )401402 for side in (-1, 1):403 label = "L" if side < 0 else "R"404 parts.append(405 sphere(406 f"Atlanta Cheek {label}",407 (side * 0.062, -0.072, 1.512),408 0.038,409 skin_shade,410 scale=(0.82, 0.42, 0.6),411 segments=14,412 rings=10,413 )414 )415 parts.append(416 sphere(417 f"Atlanta Sclera {label}",418 (side * 0.046, -0.114, 1.556),419 0.024,420 sclera,421 scale=(1.25, 0.5, 0.84),422 segments=16,423 rings=10,424 )425 )426 parts.append(427 sphere(428 f"Atlanta Iris {label}",429 (side * 0.046, -0.127, 1.556),430 0.0135,431 iris,432 scale=(1.0, 0.35, 1.0),433 segments=14,434 rings=10,435 )436 )437 parts.append(438 sphere(439 f"Atlanta Pupil {label}",440 (side * 0.046, -0.132, 1.556),441 0.0062,442 eye,443 scale=(1.0, 0.35, 1.0),444 segments=10,445 rings=8,446 )447 )448 parts.append(449 sphere(450 f"Atlanta Catchlight {label}",451 (side * 0.05, -0.135, 1.561),452 0.003,453 sclera,454 segments=8,455 rings=6,456 )457 )458 parts.append(459 sphere(460 f"Atlanta Lash {label}",461 (side * 0.046, -0.124, 1.572),462 0.019,463 eye,464 scale=(1.32, 0.26, 0.17),465 segments=14,466 rings=8,467 )468 )469 parts.append(470 tube(471 f"Atlanta Brow {label}",472 [473 (side * 0.018, -0.118, 1.592),474 (side * 0.048, -0.124, 1.598),475 (side * 0.08, -0.112, 1.586),476 ],477 [0.0055, 0.005, 0.0018],478 hair_light,479 sides=5,480 )481 )482483 # Freckles across the nose and cheeks.484 for index, (x, z) in enumerate(485 [(-0.052, 1.523), (-0.03, 1.532), (0.032, 1.531), (0.056, 1.522), (-0.012, 1.515), (0.014, 1.512)]486 ):487 parts.append(488 sphere(f"Atlanta Freckle {index + 1}", (x, -0.124, z), 0.0035, skin_shade, segments=6, rings=4)489 )490491 parts.append(492 tube(493 "Atlanta Nose",494 [(0, -0.108, 1.574), (0, -0.125, 1.541), (0, -0.132, 1.526)],495 [0.01, 0.008, 0.006],496 skin,497 sides=7,498 )499 )500 parts.append(sphere("Atlanta Nose Tip", (0, -0.134, 1.522), 0.013, skin, scale=(1.2, 0.9, 0.8), segments=12, rings=8))501 for side in (-1, 1):502 parts.append(503 sphere(504 f"Atlanta Upper Lip {'L' if side < 0 else 'R'}",505 (side * 0.009, -0.123, 1.488),506 0.009,507 lips,508 scale=(1.0, 0.32, 0.35),509 segments=12,510 rings=8,511 )512 )513 parts.append(sphere("Atlanta Lower Lip", (0, -0.125, 1.480), 0.013, lips, scale=(1.28, 0.38, 0.4), segments=14, rings=10))514515 # Hair: a crown, a centre part, loose bangs, and a long braid down her back.516 parts.append(sphere("Atlanta Hair Crown", (0, 0.012, 1.615), 0.132, hair, scale=(1.02, 1.04, 1.02)))517 parts.append(torus("Atlanta Circlet", (0, 0.0, 1.642), 0.128, 0.008, bronze, major_segments=32))518 parts.append(519 tube(520 "Atlanta Hair Part",521 [522 (0, -0.118, 1.64),523 (0, -0.05, 1.735),524 (0, 0.03, 1.752),525 (0, 0.10, 1.72),526 ],527 [0.004, 0.005, 0.005, 0.002],528 hair_shade,529 sides=5,530 )531 )532 for side, label in ((-1, "L"), (1, "R")):533 parts.append(534 tube(535 f"Atlanta Bangs {label}",536 [537 (side * 0.03, -0.115, 1.64),538 (side * 0.072, -0.128, 1.6),539 (side * 0.108, -0.114, 1.55),540 (side * 0.127, -0.078, 1.495),541 ],542 [0.016, 0.014, 0.009, 0.002],543 hair,544 sides=6,545 )546 )547 parts.append(548 tube(549 "Atlanta Braid",550 [551 (0, 0.075, 1.64),552 (-0.01, 0.16, 1.56),553 (-0.02, 0.21, 1.40),554 (-0.01, 0.23, 1.22),555 (0.01, 0.235, 1.04),556 (0.03, 0.23, 0.90),557 ],558 [0.042, 0.04, 0.034, 0.026, 0.016, 0.004],559 hair,560 sides=8,561 )562 )563 parts.append(torus("Atlanta Braid Band", (0, 0.14, 1.585), 0.034, 0.009, bronze, major_segments=20))564 for index, (x, z) in enumerate([(-0.1, 1.6), (-0.12, 1.47), (0.1, 1.58)]):565 parts.append(566 tube(567 f"Atlanta Loose Strand {index + 1}",568 [(x * 0.6, -0.06, z), (x, -0.02, z - 0.12), (x * 1.1, 0.02, z - 0.24)],569 [0.014, 0.008, 0.002],570 hair_light,571 sides=5,572 )573 )574575 # Arms. The left hand carries the bow; the right rests with an arrow.576 left = {577 "shoulder": (0.225, 0.0, 1.33),578 "elbow": (0.36, -0.11, 1.16),579 "hand": (0.483, -0.278, 1.02),580 }581 right = {582 "shoulder": (-0.225, 0.0, 1.33),583 "elbow": (-0.285, 0.01, 1.10),584 "hand": (-0.235, -0.09, 0.93),585 }586 for label, arm, sleeve in (("L", left, tunic), ("R", right, tunic_dark)):587 shoulder = Vector(arm["shoulder"])588 elbow = Vector(arm["elbow"])589 hand = Vector(arm["hand"])590 parts.append(limb(f"Atlanta Upper Arm {label}", shoulder, elbow, 0.076, 0.05, sleeve, vertices=12))591 parts.append(592 limb(593 f"Atlanta Bracer {label}",594 elbow,595 hand,596 0.052,597 0.039,598 leather_light,599 vertices=10,600 )601 )602 parts.append(603 sphere(604 f"Atlanta Hand {label}",605 tuple(hand),606 0.047,607 skin,608 scale=(1.1, 1.3, 0.72),609 segments=14,610 rings=10,611 )612 )613 parts.append(614 tube(615 f"Atlanta Bracer Lace {label}",616 [(elbow.x, elbow.y - 0.03, elbow.z - 0.06), (hand.x, hand.y - 0.03, hand.z + 0.07)],617 [0.006, 0.004],618 leather,619 sides=4,620 )621 )622623 # A tall recurve bow held upright beside her.624 bow_path = [625 (0.475, -0.09, 0.40),626 (0.49, -0.21, 0.60),627 (0.50, -0.29, 0.82),628 (0.49, -0.315, 1.02),629 (0.50, -0.29, 1.22),630 (0.49, -0.21, 1.44),631 (0.478, -0.09, 1.64),632 ]633 parts.append(634 tube(635 "Atlanta Recurve Bow",636 bow_path,637 [0.014, 0.02, 0.024, 0.026, 0.024, 0.02, 0.014],638 wood,639 sides=8,640 )641 )642 parts.append(643 limb(644 "Atlanta Bowstring",645 bow_path[0],646 bow_path[-1],647 0.0035,648 0.0035,649 string,650 vertices=4,651 )652 )653 parts.append(654 cylinder("Atlanta Bow Grip", (0.49, -0.315, 1.02), 0.025, 0.12, leather, vertices=12)655 )656 for index, (z, spin) in enumerate(((0.42, 0.35), (1.62, -0.35))):657 parts.append(658 cone(659 f"Atlanta Bow Tip {index + 1}",660 (0.475, -0.09, z),661 0.02,662 0.002,663 0.09,664 bronze,665 vertices=6,666 rotation=(spin, 0, 0),667 )668 )669 parts.append(feather("Atlanta Bow Charm", (0.475, -0.09, 0.44), (0.1, -0.2, -1.0), 0.13, 0.045, feather_mat))670671 # Arrow in her right hand, ready to be nocked.672 parts.extend(673 arrow(674 "Atlanta Hand Arrow",675 (-0.235, -0.09, 0.93),676 (-0.22, -0.42, 0.98),677 shaft=wood,678 bronze=bronze,679 fletch=feather_mat,680 )681 )682683 # Quiver on her back with a fan of arrows.684 quiver_base = Vector((-0.16, 0.20, 0.86))685 quiver_top = Vector((0.06, 0.205, 1.38))686 parts.append(limb("Atlanta Quiver", quiver_base, quiver_top, 0.075, 0.083, leather, vertices=14))687 quiver_axis = (quiver_top - quiver_base).normalized()688 parts.append(689 limb(690 "Atlanta Quiver Rim",691 tuple(quiver_top - quiver_axis * 0.018),692 tuple(quiver_top + quiver_axis * 0.018),693 0.088,694 0.088,695 leather_light,696 vertices=14,697 )698 )699 for index in range(5):700 spread = (index - 2) * 0.032701 around = math.cos(index * 1.7) * 0.03702 start = quiver_top + Vector((spread, around, 0.0))703 end = start + Vector((spread * 0.5, 0.02, 0.23))704 parts.extend(705 arrow(706 f"Atlanta Quiver Arrow {index + 1}",707 tuple(start),708 tuple(end),709 shaft=wood,710 bronze=bronze,711 fletch=feather_mat if index % 2 else feather_shade,712 )713 )714715 return group(parts, "Atlanta")716717718def main(argv):719 parser = argparse.ArgumentParser()720 parser.add_argument("--out", required=True)721 args = parser.parse_args(argv)722 root = build()723 rig_character(root, "Atlanta")724 export_scene(args.out, animations=True)725726727if __name__ == "__main__":728 main(sys.argv[sys.argv.index("--") + 1 :] if "--" in sys.argv else [])