Skip to content
1        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 [])