Files
tidewall/tools/models/figure.py
T
claudeandClaude Opus 5.5 aa797580a7 #72: The packet ship, the lifeline mortar and the gull-kite
Eric chose option B on #72. The drop is now the GDD's launch:

- A packet ship sails a seeded straight line past the island, offshore,
  as close in as it can while keeping 45 m of open water from any land
  (eight-way probes; up to 32 headings, then the four world sides).
- Jump fires the lifeline mortar along the look heading. How high the
  player aims sets the charge (-10 to 45 degrees: 16 to 110 m/s over
  the ground; every shot climbs at 75 m/s). The climb can't be steered
  and the kite can't open until the arc tops out. Riders still aboard at
  the end are fired towards the middle of the island.
- Drop.reach() mirrors the fall for both ways down (kite at the top, or
  a fall with the kite opening by itself); bots, the soak and autoplay
  clients and the tutorial pilot aim with Drop.aim_charge().
- Bots fire at their landing spot once abeam of it, when in easy reach
  at their own staggered moment, or just before the route ends, and open
  the kite early only when the spot is beyond the rest of a fall.
- Art: VesselModels.ship() (two-masted packet, tanned square sails, a
  salt-white boot-top, a bowsprit and the mortar on its bed, mirrored to
  face the island), the figure's gull-kite (figure.py), and a lifeline
  cord from the muzzle to each player still climbing.
- Renamed barge to ship and wing-sail to gull-kite throughout code,
  tests, captures, docs and the tutorial text. make match now defaults to
  seed 2, where the scripted player still harvests and builds.

Closes #72

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 12:49:21 -05:00

293 lines
12 KiB
Python

"""Tidewall's player figure (A2), built in headless Blender.
blender --background --factory-startup --python tools/models/figure.py
A low-poly islander in an oilskin coat and a sou'wester, with sea boots, a rolled
bedding bundle on the back and a gull-kite for the glide. Writes:
assets/models/figure/<part>.obj one model per moving part, with <part>.mtl
assets/models/figure/figure.json the joints, which part hangs from which, and
where the right hand closes
Debian's Blender can't export glTF (its exporter needs numpy), and OBJ carries no
skeleton, so the figure is a set of rigid parts. Each part's origin is the joint it
turns about; the client (FigureRig) hangs them on a hierarchy of pivots from
figure.json and animates the pivots with an AnimationTree.
Conventions, in Godot's axes after export: +Y up, the figure faces +Z, its right is
-X, and it stands with its feet at the origin, 1.8 m tall to the hat's crown.
Materials are named after Palette colours, as for items; COAT and COAT_DARK are the
player's own oilskin colour and a darker shade of it, which the client fills in.
Everything is built from primitives here, with no randomness.
"""
import json
import math
import os
import sys
import bpy
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
import items # noqa: E402 (the shared builders: box, tube, ball, ring, material)
OUT_DIR = os.path.join(items.ROOT, "assets", "models", "figure")
# Joints, in Godot's axes (x, y, z): +Y up, facing +Z, the figure's right toward -X.
JOINTS = {
"hips": (0.0, 0.92, 0.0),
"waist": (0.0, 1.02, 0.0),
"neck": (0.0, 1.50, 0.0),
"shoulder_r": (-0.225, 1.42, 0.0),
"shoulder_l": (0.225, 1.42, 0.0),
"elbow_r": (-0.235, 1.14, 0.0),
"elbow_l": (0.235, 1.14, 0.0),
"hip_r": (-0.11, 0.90, 0.0),
"hip_l": (0.11, 0.90, 0.0),
"knee_r": (-0.11, 0.49, 0.0),
"knee_l": (0.11, 0.49, 0.0),
"kite": (0.0, 1.46, -0.2),
}
# Part -> (the joint it turns about, the joint it hangs from or None for the root).
PARTS = {
"pelvis": ("hips", None),
"torso": ("waist", "hips"),
"head": ("neck", "waist"),
"upper_arm_r": ("shoulder_r", "waist"),
"upper_arm_l": ("shoulder_l", "waist"),
"forearm_r": ("elbow_r", "shoulder_r"),
"forearm_l": ("elbow_l", "shoulder_l"),
"thigh_r": ("hip_r", "hips"),
"thigh_l": ("hip_l", "hips"),
"shin_r": ("knee_r", "hip_r"),
"shin_l": ("knee_l", "hip_l"),
"kite": ("kite", None),
}
# Where the right hand closes on a grip, and the left on a support, in Godot axes.
HAND_R = (-0.24, 0.86, 0.03)
HAND_L = (0.24, 0.86, 0.03)
# Placeholder colours for the player's own oilskin, so the .mtl files look right.
OWN = {"COAT": items.PALETTE["OILSKIN"], "COAT_DARK": tuple(c * 0.72 for c in items.PALETTE["OILSKIN"])}
def b(x, y, z):
"""Godot (x, y, z) to Blender (x, -z, y)."""
return (x, -z, y)
def own_materials():
for name, rgb in OWN.items():
made = bpy.data.materials.new(name)
made.use_nodes = True
linear = tuple(items.srgb_to_linear(c) for c in rgb)
made.node_tree.nodes.get("Principled BSDF").inputs["Base Color"].default_value = linear + (1.0,)
made.diffuse_color = linear + (1.0,)
def built(make):
"""Runs a builder and returns the objects it added."""
before = set(bpy.data.objects)
make()
return [obj for obj in bpy.data.objects if obj not in before]
# --- Parts, built where they stand in the rest pose (Godot axes via b()) ---------
def pelvis():
# The coat's skirt, flaring a little, over a tarred belt.
items.tube(0.25, 0.34, b(0.0, 0.84, 0.0), "COAT", axis="Z", sides=8, radius2=0.205)
obj = bpy.context.active_object
obj.scale = (1.0, 0.72, 1.0)
items.tube(0.21, 0.05, b(0.0, 1.0, 0.0), "TAR", axis="Z", sides=8)
bpy.context.active_object.scale = (1.0, 0.74, 1.0)
items.box((0.07, 0.02, 0.05), b(0.0, 1.0, 0.155), "GILT", bevel=0.0)
def torso():
items.tube(0.205, 0.46, b(0.0, 1.25, 0.0), "COAT", axis="Z", sides=8, radius2=0.235)
bpy.context.active_object.scale = (1.0, 0.68, 1.0)
# The coat's front edge and its toggles.
items.box((0.03, 0.012, 0.44), b(0.0, 1.25, 0.158), "COAT_DARK", bevel=0.0)
for index in range(3):
items.box((0.06, 0.02, 0.016), b(0.0, 1.12 + index * 0.12, 0.166), "BARK", bevel=0.0)
# A turned-up collar.
items.tube(0.13, 0.08, b(0.0, 1.49, -0.01), "COAT_DARK", axis="Z", sides=8, radius2=0.15)
# A rolled bedding bundle across the back, tied with tarred cord.
items.tube(0.075, 0.42, b(0.0, 1.38, -0.21), "TANNED_SAIL", axis="X", sides=8)
for side in (-1.0, 1.0):
items.ring(0.078, 0.01, b(side * 0.13, 1.38, -0.21), "TAR", axis="X")
items.box((0.05, 0.02, 0.36), b(-0.1, 1.3, -0.17), "TAR", rot=(0.0, math.radians(-28), 0.0), bevel=0.0)
def head():
items.tube(0.055, 0.1, b(0.0, 1.53, 0.0), "SKIN", axis="Z", sides=8)
items.ball(0.115, b(0.0, 1.635, 0.01), "SKIN", rings=6, segments=10)
items.box((0.03, 0.04, 0.05), b(0.0, 1.63, 0.125), "SKIN", rot=(math.radians(10), 0.0, 0.0), bevel=0.005)
for side in (-1.0, 1.0):
items.box((0.026, 0.01, 0.016), b(side * 0.045, 1.665, 0.108), "INK", bevel=0.0)
# A short, square beard.
items.box((0.17, 0.08, 0.09), b(0.0, 1.56, 0.07), "BARK", bevel=0.01)
# The sou'wester: a soft crown and a brim that runs long down the back.
items.tube(0.128, 0.11, b(0.0, 1.735, -0.005), "COAT", axis="Z", sides=10, radius2=0.1)
bpy.ops.mesh.primitive_cylinder_add(vertices=12, radius=0.2, depth=0.022, location=b(0.0, 1.69, -0.045))
brim = bpy.context.active_object
brim.scale = (1.0, 1.22, 1.0)
brim.rotation_euler = (math.radians(-9), 0.0, 0.0)
items.finish(brim, "COAT_DARK")
def upper_arm(side):
x = side * 0.225
items.ball(0.075, b(x, 1.41, 0.0), "COAT", rings=5, segments=8)
items.tube(0.068, 0.27, b(side * 0.23, 1.28, 0.0), "COAT", axis="Z", sides=8, radius2=0.06)
def forearm(side):
x = side * 0.236
items.tube(0.06, 0.2, b(x, 1.04, 0.0), "COAT", axis="Z", sides=8, radius2=0.054)
items.tube(0.064, 0.05, b(x, 0.93, 0.0), "COAT_DARK", axis="Z", sides=8)
# A mitten: the hand closed on nothing, its thumb toward the front.
items.box((0.07, 0.085, 0.1), b(x, 0.86, 0.015), "SKIN", bevel=0.015)
items.box((0.025, 0.035, 0.05), b(x - side * 0.03, 0.885, 0.055), "SKIN", bevel=0.006)
def thigh(side):
items.tube(0.085, 0.42, b(side * 0.11, 0.7, 0.0), "TAR", axis="Z", sides=8, radius2=0.075)
def shin(side):
x = side * 0.11
items.tube(0.07, 0.22, b(x, 0.38, 0.0), "TAR", axis="Z", sides=8)
# A sea boot to below the knee, with its top turned down, and its foot.
items.tube(0.086, 0.26, b(x, 0.16, 0.0), "TAR_WEATHERED", axis="Z", sides=8, radius2=0.08)
items.tube(0.094, 0.05, b(x, 0.3, 0.0), "TAR", axis="Z", sides=8)
items.box((0.13, 0.25, 0.08), b(x, 0.04, 0.05), "TAR_WEATHERED", bevel=0.02)
def kite():
# A gull-kite: a gull's wings in sailcloth on spars, the inner half of each wing
# raised and the outer half drooping, as a gull holds them on the wind, with tarred
# tips, an ochre leading edge and a short fanned tail, hung from a yoke over the
# shoulders.
base = 2.06
for side in (-1.0, 1.0):
# Inner wing: from the body out to the bend, raised 20 degrees.
inner_up = math.radians(20)
inner_len = 0.82
ix = side * (0.06 + inner_len * 0.5 * math.cos(inner_up))
iy = base + inner_len * 0.5 * math.sin(inner_up)
bend_x = side * (0.06 + inner_len * math.cos(inner_up))
bend_y = base + inner_len * math.sin(inner_up)
rot_in = (math.radians(3), side * -inner_up, side * math.radians(6))
bpy.ops.mesh.primitive_cube_add(size=1.0, location=b(ix, iy, -0.06))
panel = bpy.context.active_object
panel.scale = (inner_len, 0.78, 0.012)
panel.rotation_euler = rot_in
items.finish(panel, "SALT")
# Outer wing: from the bend to the tip, drooping 16 degrees and swept back.
outer_down = math.radians(16)
outer_len = 0.78
ox = bend_x + side * outer_len * 0.5 * math.cos(outer_down)
oy = bend_y - outer_len * 0.5 * math.sin(outer_down)
rot_out = (math.radians(3), side * outer_down, side * math.radians(16))
bpy.ops.mesh.primitive_cube_add(size=1.0, location=b(ox, oy, -0.16))
panel = bpy.context.active_object
panel.scale = (outer_len, 0.56, 0.012)
panel.rotation_euler = rot_out
items.finish(panel, "SALT")
# Tarred wingtip, like a gull's black primaries.
tx = bend_x + side * outer_len * 0.92 * math.cos(outer_down)
ty = bend_y - outer_len * 0.92 * math.sin(outer_down)
bpy.ops.mesh.primitive_cube_add(size=1.0, location=b(tx, ty + 0.004, -0.24))
tip = bpy.context.active_object
tip.scale = (0.2, 0.44, 0.016)
tip.rotation_euler = rot_out
items.finish(tip, "TAR")
# Ochre leading edges on both halves.
for (cx, cy, z, length, rot) in ((ix, iy, 0.3, inner_len, rot_in), (ox, oy, 0.1, outer_len, rot_out)):
bpy.ops.mesh.primitive_cube_add(size=1.0, location=b(cx, cy + 0.006, z))
band = bpy.context.active_object
band.scale = (length, 0.1, 0.018)
band.rotation_euler = rot
items.finish(band, "OCHRE_RED")
# Spars along each half, and the bridle lines down to the yoke.
items.tube(0.02, inner_len, b(ix, iy + 0.02, 0.28), "PLANK", axis="X", sides=6,
rot_extra=(0.0, side * -inner_up, side * math.radians(6)))
items.tube(0.018, outer_len, b(ox, oy + 0.02, 0.08), "PLANK", axis="X", sides=6,
rot_extra=(0.0, side * outer_down, side * math.radians(16)))
items.tube(0.007, 0.66, b(side * 0.32, 1.80, -0.12), "TAR", axis="Z", sides=4,
rot_extra=(0.0, math.radians(side * 32), 0.0))
items.tube(0.007, 0.80, b(side * 0.5, 1.84, -0.12), "TAR", axis="Z", sides=4,
rot_extra=(0.0, math.radians(side * 48), 0.0))
# The body: a spindle of canvas down the middle, and a fanned tail behind it.
items.tube(0.07, 0.9, b(0.0, base + 0.02, -0.08), "CANVAS", axis="Y", sides=8, radius2=0.03)
bpy.ops.mesh.primitive_cube_add(size=1.0, location=b(0.0, base, -0.68))
tail = bpy.context.active_object
tail.scale = (0.42, 0.3, 0.012)
items.finish(tail, "SALT")
items.box((0.36, 0.05, 0.05), b(0.0, 1.5, -0.2), "PLANK", bevel=0.008)
BUILDERS = {
"pelvis": pelvis,
"torso": torso,
"head": head,
"upper_arm_r": lambda: upper_arm(-1.0),
"upper_arm_l": lambda: upper_arm(1.0),
"forearm_r": lambda: forearm(-1.0),
"forearm_l": lambda: forearm(1.0),
"thigh_r": lambda: thigh(-1.0),
"thigh_l": lambda: thigh(1.0),
"shin_r": lambda: shin(-1.0),
"shin_l": lambda: shin(1.0),
"kite": kite,
}
def export_part(name, objects):
"""Moves a part so its joint is at the origin and writes it as an OBJ."""
joint = b(*JOINTS[PARTS[name][0]])
bpy.ops.object.select_all(action="DESELECT")
for obj in objects:
obj.location = (obj.location[0] - joint[0], obj.location[1] - joint[1], obj.location[2] - joint[2])
obj.select_set(True)
bpy.ops.wm.obj_export(
filepath=os.path.join(OUT_DIR, name + ".obj"), export_selected_objects=True,
apply_modifiers=True, export_uv=False, export_normals=True, export_materials=True,
export_triangulated_mesh=True, forward_axis="NEGATIVE_Z", up_axis="Y",
export_object_groups=False, export_material_groups=False, path_mode="STRIP",
)
for obj in objects:
obj.hide_set(True)
def main():
os.makedirs(OUT_DIR, exist_ok=True)
items.clear_scene()
own_materials()
triangles = 0
for name, make in BUILDERS.items():
objects = built(make)
for obj in objects:
obj.data.update()
triangles += sum(len(poly.vertices) - 2 for poly in obj.data.polygons)
export_part(name, objects)
print("figure part %s done" % name)
info = {
"generator": "tools/models/figure.py",
"joints": {name: [round(v, 4) for v in at] for name, at in JOINTS.items()},
"parts": {name: {"joint": joint, "parent": parent} for name, (joint, parent) in PARTS.items()},
"hand_r": list(HAND_R),
"hand_l": list(HAND_L),
"height": 1.8,
"triangles_before_bevel": triangles,
}
with open(os.path.join(OUT_DIR, "figure.json"), "w") as out:
json.dump(info, out, indent="\t", sort_keys=True)
out.write("\n")
if __name__ == "__main__":
main()