phenom/i-want-to-heal-mmo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 22 Wiki Activity

Release v0.1.1 2026-07-10

Browse Source
This commit is contained in:
Warren H
2026-07-10 23:47:37 -04:00
parent 537a311f52
commit 6726c600e4
40 changed files with 2987 additions and 192 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scripts/blender/build_ember_mantis_duelist.py
+832
View File
@@ -0,0 +1,832 @@
"""Build Ember Mantis Duelist as a rigged, animated, runtime-ready GLB.
Run with:
blender --background --factory-startup --python scripts/blender/build_ember_mantis_duelist.py
The asset is an original 3D interpretation of the IWT2 Ember Mantis concept.
"""
from __future__ import annotations
import json
import math
from pathlib import Path
import bpy
from mathutils import Vector
ROOT = Path(__file__).resolve().parents[2]
OUT_DIR = ROOT / "game_assets/models/original/bosses/ember-mantis-duelist"
PREVIEW_DIR = OUT_DIR / "previews"
BLEND_PATH = OUT_DIR / "ember_mantis_duelist.blend"
GLB_PATH = OUT_DIR / "ember_mantis_duelist.glb"
COLLISION_PATH = OUT_DIR / "ember_mantis_duelist_collision.glb"
METADATA_PATH = OUT_DIR / "ember_mantis_duelist.asset.json"
FPS = 30
TAU = math.tau
PARTS: list[bpy.types.Object] = []
RUNTIME_MATERIALS: list[bpy.types.Material] = []
def reset_scene() -> None:
bpy.ops.object.mode_set(mode="OBJECT") if bpy.context.object and bpy.context.object.mode != "OBJECT" else None
bpy.ops.object.select_all(action="SELECT")
bpy.ops.object.delete(use_global=False)
for datablocks in (
bpy.data.meshes,
bpy.data.curves,
bpy.data.armatures,
bpy.data.materials,
bpy.data.cameras,
bpy.data.lights,
bpy.data.actions,
):
for datablock in list(datablocks):
datablocks.remove(datablock)
def make_material(
name: str,
color: tuple[float, float, float, float],
*,
metallic: float = 0.0,
roughness: float = 0.5,
emission: tuple[float, float, float, float] | None = None,
emission_strength: float = 0.0,
) -> bpy.types.Material:
mat = bpy.data.materials.new(name)
mat.use_nodes = True
mat.diffuse_color = color
mat.metallic = metallic
mat.roughness = roughness
bsdf = mat.node_tree.nodes.get("Principled BSDF")
bsdf.inputs["Base Color"].default_value = color
bsdf.inputs["Metallic"].default_value = metallic
bsdf.inputs["Roughness"].default_value = roughness
if emission:
bsdf.inputs["Emission Color"].default_value = emission
bsdf.inputs["Emission Strength"].default_value = emission_strength
return mat
def assign_rigid_group(obj: bpy.types.Object, bone_name: str) -> bpy.types.Object:
group = obj.vertex_groups.new(name=bone_name)
group.add(range(len(obj.data.vertices)), 1.0, "REPLACE")
PARTS.append(obj)
return obj
def finish_mesh(
obj: bpy.types.Object,
name: str,
material: bpy.types.Material,
bone_name: str,
*,
smooth: bool = True,
) -> bpy.types.Object:
obj.name = name
obj.data.name = f"{name}_Mesh"
# Every source part uses the same ordered slots. Blender 5.1 otherwise keeps
# joined material slots but resets joined face indices to slot zero.
for runtime_material in RUNTIME_MATERIALS:
obj.data.materials.append(runtime_material)
material_index = next(
index for index, runtime_material in enumerate(RUNTIME_MATERIALS) if runtime_material.name == material.name
)
for polygon in obj.data.polygons:
polygon.material_index = material_index
material_group = obj.vertex_groups.new(name=f"__MAT_{material_index}")
material_group.add(range(len(obj.data.vertices)), 1.0, "REPLACE")
bpy.context.view_layer.objects.active = obj
obj.select_set(True)
bpy.ops.object.transform_apply(location=False, rotation=False, scale=True)
if smooth:
for polygon in obj.data.polygons:
polygon.use_smooth = True
return assign_rigid_group(obj, bone_name)
def add_ellipsoid(
name: str,
location: tuple[float, float, float],
scale: tuple[float, float, float],
material: bpy.types.Material,
bone_name: str,
*,
subdivisions: int = 2,
rotation: tuple[float, float, float] = (0.0, 0.0, 0.0),
) -> bpy.types.Object:
bpy.ops.mesh.primitive_ico_sphere_add(subdivisions=subdivisions, radius=1.0, location=location, rotation=rotation)
obj = bpy.context.object
obj.scale = scale
return finish_mesh(obj, name, material, bone_name)
def add_cone_between(
name: str,
start: tuple[float, float, float],
end: tuple[float, float, float],
radius_start: float,
radius_end: float,
material: bpy.types.Material,
bone_name: str,
*,
vertices: int = 8,
) -> bpy.types.Object:
start_v = Vector(start)
end_v = Vector(end)
direction = end_v - start_v
midpoint = (start_v + end_v) * 0.5
bpy.ops.mesh.primitive_cone_add(
vertices=vertices,
radius1=radius_start,
radius2=radius_end,
depth=direction.length,
location=midpoint,
)
obj = bpy.context.object
obj.rotation_mode = "QUATERNION"
obj.rotation_quaternion = direction.to_track_quat("Z", "Y")
obj.rotation_mode = "XYZ"
bpy.context.view_layer.objects.active = obj
bpy.ops.object.transform_apply(location=False, rotation=True, scale=True)
return finish_mesh(obj, name, material, bone_name)
def add_blade(
name: str,
side: float,
material: bpy.types.Material,
bone_name: str,
*,
variant: str = "main",
) -> bpy.types.Object:
# Extruded hook polygon. Forward is Blender -Y; mirrored across X.
x_center = side * 1.42
thickness = {"main": 0.095, "edge": 0.104, "scar": 0.108}[variant]
if variant == "edge":
yz = [
(-0.72, 2.78),
(-1.34, 2.55),
(-2.62, 1.72),
(-2.42, 2.06),
(-1.31, 2.78),
]
elif variant == "scar":
yz = [
(-0.82, 2.94),
(-1.33, 2.72),
(-2.30, 2.02),
(-2.10, 2.33),
(-1.33, 2.91),
]
else:
yz = [
(-0.50, 3.12),
(-0.72, 2.78),
(-1.34, 2.55),
(-2.62, 1.72),
(-2.31, 2.28),
(-1.45, 3.18),
(-0.82, 3.34),
]
vertices = []
for x in (x_center - thickness, x_center + thickness):
vertices.extend((x, y, z) for y, z in yz)
count = len(yz)
faces = [tuple(range(count)), tuple(range(count, count * 2))[::-1]]
for index in range(count):
nxt = (index + 1) % count
faces.append((index, nxt, count + nxt, count + index))
mesh = bpy.data.meshes.new(f"{name}_Mesh")
mesh.from_pydata(vertices, [], faces)
mesh.validate()
mesh.update()
obj = bpy.data.objects.new(name, mesh)
bpy.context.collection.objects.link(obj)
return finish_mesh(obj, name, material, bone_name, smooth=False)
def add_plate(
name: str,
location: tuple[float, float, float],
scale: tuple[float, float, float],
rotation: tuple[float, float, float],
material: bpy.types.Material,
bone_name: str,
) -> bpy.types.Object:
bpy.ops.mesh.primitive_cone_add(vertices=6, radius1=1.0, radius2=0.72, depth=0.46, location=location, rotation=rotation)
obj = bpy.context.object
obj.scale = scale
return finish_mesh(obj, name, material, bone_name, smooth=False)
def create_armature() -> bpy.types.Object:
arm_data = bpy.data.armatures.new("EmberMantis_Rig")
armature = bpy.data.objects.new("EmberMantis_Rig", arm_data)
bpy.context.collection.objects.link(armature)
bpy.context.view_layer.objects.active = armature
armature.select_set(True)
bpy.ops.object.mode_set(mode="EDIT")
bones = {
"Root": ((0, 0, 0), (0, 0, 0.55), None),
"Pelvis": ((0, 0, 1.70), (0, 0, 2.35), "Root"),
"Abdomen": ((0, 0.05, 2.15), (0, 0.42, 2.78), "Pelvis"),
"Tail": ((0, 0.38, 2.58), (0, 1.30, 2.18), "Abdomen"),
"Chest": ((0, 0.02, 2.65), (0, -0.04, 3.48), "Abdomen"),
"Neck": ((0, -0.03, 3.38), (0, -0.14, 3.88), "Chest"),
"Head": ((0, -0.13, 3.78), (0, -0.34, 4.35), "Neck"),
"UpperArm.L": ((-0.34, -0.02, 3.30), (-0.98, -0.27, 3.20), "Chest"),
"Forearm.L": ((-0.98, -0.27, 3.20), (-1.38, -0.60, 3.02), "UpperArm.L"),
"Blade.L": ((-1.38, -0.60, 3.02), (-1.46, -1.48, 2.55), "Forearm.L"),
"UpperArm.R": ((0.34, -0.02, 3.30), (0.98, -0.27, 3.20), "Chest"),
"Forearm.R": ((0.98, -0.27, 3.20), (1.38, -0.60, 3.02), "UpperArm.R"),
"Blade.R": ((1.38, -0.60, 3.02), (1.46, -1.48, 2.55), "Forearm.R"),
"Thigh.L": ((-0.30, 0.02, 2.00), (-0.66, 0.02, 1.18), "Pelvis"),
"Shin.L": ((-0.66, 0.02, 1.18), (-0.76, -0.34, 0.38), "Thigh.L"),
"Foot.L": ((-0.76, -0.34, 0.38), (-0.76, -0.96, 0.15), "Shin.L"),
"Thigh.R": ((0.30, 0.02, 2.00), (0.66, 0.02, 1.18), "Pelvis"),
"Shin.R": ((0.66, 0.02, 1.18), (0.76, -0.34, 0.38), "Thigh.R"),
"Foot.R": ((0.76, -0.34, 0.38), (0.76, -0.96, 0.15), "Shin.R"),
}
for name, (head, tail, parent) in bones.items():
bone = arm_data.edit_bones.new(name)
bone.head = head
bone.tail = tail
if parent:
bone.parent = arm_data.edit_bones[parent]
bpy.ops.object.mode_set(mode="POSE")
for pose_bone in armature.pose.bones:
pose_bone.rotation_mode = "XYZ"
bpy.ops.object.mode_set(mode="OBJECT")
armature.show_in_front = True
return armature
def create_model(armature: bpy.types.Object, mats: dict[str, bpy.types.Material]) -> bpy.types.Object:
chitin = mats["chitin"]
crimson = mats["crimson"]
deep_red = mats["deep_red"]
ember = mats["ember"]
bone = mats["bone"]
eye = mats["eye"]
# Core insect anatomy.
add_ellipsoid("Thorax", (0, 0.00, 3.05), (0.54, 0.47, 0.72), chitin, "Chest")
add_ellipsoid("ChestArmor", (0, -0.35, 3.18), (0.47, 0.18, 0.57), crimson, "Chest")
add_ellipsoid("Pelvis", (0, 0.08, 2.13), (0.48, 0.42, 0.55), deep_red, "Pelvis")
add_ellipsoid("Abdomen", (0, 0.52, 2.34), (0.58, 0.82, 0.49), chitin, "Abdomen")
add_ellipsoid("TailMass", (0, 1.18, 2.10), (0.56, 0.92, 0.40), deep_red, "Tail")
add_cone_between("TailTip", (0, 1.44, 2.13), (0, 2.20, 1.88), 0.50, 0.06, crimson, "Tail", vertices=7)
# Overlapping abdominal armor plates.
for index, y in enumerate((0.33, 0.72, 1.10, 1.47)):
scale = 0.52 - index * 0.055
add_plate(
f"AbdomenPlate_{index + 1}",
(0, y, 2.50 - index * 0.10),
(scale, 0.42, 0.20),
(math.radians(83), 0, 0),
crimson if index % 2 == 0 else deep_red,
"Abdomen" if index < 2 else "Tail",
)
for side in (-1, 1):
add_cone_between(
f"AbdomenSpike_{index}_{side:+d}",
(side * scale * 0.72, y, 2.48 - index * 0.10),
(side * (scale + 0.38), y + 0.08, 2.34 - index * 0.12),
0.10,
0.0,
crimson,
"Abdomen" if index < 2 else "Tail",
vertices=6,
)
# Neck, predatory head, jaws, eyes, crown spikes.
add_cone_between("NeckCore", (0, -0.03, 3.40), (0, -0.20, 3.88), 0.30, 0.25, chitin, "Neck")
add_ellipsoid("Head", (0, -0.34, 4.10), (0.43, 0.50, 0.38), crimson, "Head")
add_ellipsoid("FaceMask", (0, -0.73, 4.05), (0.32, 0.19, 0.28), chitin, "Head")
for side in (-1, 1):
suffix = "L" if side < 0 else "R"
add_ellipsoid(f"Eye_{suffix}", (side * 0.30, -0.67, 4.16), (0.09, 0.045, 0.075), eye, "Head", subdivisions=1)
add_cone_between(f"Mandible_{suffix}", (side * 0.18, -0.70, 3.98), (side * 0.34, -1.05, 3.83), 0.10, 0.02, bone, "Head", vertices=6)
add_cone_between(f"AntennaBase_{suffix}", (side * 0.22, -0.33, 4.34), (side * 0.46, -0.45, 4.82), 0.055, 0.035, deep_red, "Head", vertices=6)
add_cone_between(f"AntennaTip_{suffix}", (side * 0.46, -0.45, 4.82), (side * 0.76, -0.88, 5.20), 0.04, 0.0, ember, "Head", vertices=6)
add_cone_between(f"CrownSpike_{suffix}", (side * 0.23, -0.05, 4.31), (side * 0.48, 0.13, 4.90), 0.12, 0.0, crimson, "Head", vertices=6)
add_cone_between("CrownSpike_Center", (0, 0.02, 4.34), (0, 0.32, 5.02), 0.13, 0.0, crimson, "Head", vertices=6)
# Scythe arms: dark joints, crimson armor, pale blades, emissive blade scars.
for side in (-1, 1):
suffix = "L" if side < 0 else "R"
bones = (f"UpperArm.{suffix}", f"Forearm.{suffix}", f"Blade.{suffix}")
add_cone_between(
f"UpperArm_{suffix}",
(side * 0.34, -0.02, 3.30),
(side * 0.98, -0.27, 3.20),
0.25,
0.17,
chitin,
bones[0],
)
add_plate(
f"ShoulderPlate_{suffix}",
(side * 0.55, -0.07, 3.42),
(0.27, 0.33, 0.24),
(0, math.radians(side * 18), math.radians(side * 12)),
crimson,
bones[0],
)
add_cone_between(
f"Forearm_{suffix}",
(side * 0.98, -0.27, 3.20),
(side * 1.40, -0.64, 3.02),
0.19,
0.13,
deep_red,
bones[1],
)
add_ellipsoid(f"BladeJoint_{suffix}", (side * 1.41, -0.62, 3.02), (0.22, 0.24, 0.22), crimson, bones[2], subdivisions=1)
add_blade(f"ScytheBlade_{suffix}", side, deep_red, bones[2])
add_blade(f"ScytheBoneEdge_{suffix}", side, bone, bones[2], variant="edge")
add_blade(f"ScytheEmberScar_{suffix}", side, ember, bones[2], variant="scar")
add_cone_between(
f"ElbowSpike_{suffix}",
(side * 1.00, -0.22, 3.30),
(side * 1.28, 0.04, 3.55),
0.09,
0.0,
crimson,
bones[1],
vertices=6,
)
# Digitigrade legs and hooked feet.
for side in (-1, 1):
suffix = "L" if side < 0 else "R"
thigh_bone, shin_bone, foot_bone = f"Thigh.{suffix}", f"Shin.{suffix}", f"Foot.{suffix}"
add_cone_between(f"Thigh_{suffix}", (side * 0.30, 0.02, 2.00), (side * 0.66, 0.02, 1.18), 0.25, 0.18, chitin, thigh_bone)
add_plate(
f"ThighPlate_{suffix}",
(side * 0.47, -0.02, 1.72),
(0.28, 0.31, 0.34),
(0, math.radians(side * 12), 0),
crimson,
thigh_bone,
)
add_cone_between(f"Shin_{suffix}", (side * 0.66, 0.02, 1.18), (side * 0.76, -0.34, 0.38), 0.18, 0.11, deep_red, shin_bone)
add_cone_between(f"Foot_{suffix}", (side * 0.76, -0.34, 0.38), (side * 0.76, -0.96, 0.15), 0.14, 0.08, chitin, foot_bone)
for toe_index, toe_x in enumerate((-0.13, 0.0, 0.13)):
add_cone_between(
f"Toe_{suffix}_{toe_index + 1}",
(side * 0.76 + toe_x, -0.88, 0.15),
(side * 0.76 + toe_x * 1.35, -1.25, 0.07),
0.055,
0.0,
bone,
foot_bone,
vertices=5,
)
add_cone_between(
f"KneeSpike_{suffix}",
(side * 0.68, 0.00, 1.20),
(side * 0.95, 0.28, 1.25),
0.09,
0.0,
crimson,
shin_bone,
vertices=6,
)
# Ember fissures: limited emissive geometry gives strong read without textures.
fissures = [
("ChestFissure", (-0.05, -0.535, 3.48), (0.12, -0.535, 2.92), "Chest"),
("AbdomenFissure", (-0.07, -0.27, 2.47), (0.15, -0.31, 2.11), "Abdomen"),
]
for name, start, end, group in fissures:
add_cone_between(name, start, end, 0.035, 0.02, ember, group, vertices=5)
# Join all render meshes into one skinned mesh; keep four material primitives.
bpy.ops.object.select_all(action="DESELECT")
for obj in PARTS:
obj.select_set(True)
bpy.context.view_layer.objects.active = PARTS[0]
bpy.ops.object.join()
body = bpy.context.object
body.name = "EmberMantis_Body"
body.data.name = "EmberMantis_Body_Mesh"
consolidate_material_slots(body)
modifier = body.modifiers.new("EmberMantis_Armature", "ARMATURE")
modifier.object = armature
modifier.use_deform_preserve_volume = False
body.parent = armature
return body
def consolidate_material_slots(obj: bpy.types.Object) -> None:
old_materials = [slot.material for slot in obj.material_slots]
unique: list[bpy.types.Material] = []
new_index_by_name: dict[str, int] = {}
old_to_new: dict[int, int] = {}
for old_index, material in enumerate(old_materials):
if material.name not in new_index_by_name:
new_index_by_name[material.name] = len(unique)
unique.append(material)
old_to_new[old_index] = new_index_by_name[material.name]
material_groups = {
group.index: int(group.name.removeprefix("__MAT_"))
for group in obj.vertex_groups
if group.name.startswith("__MAT_")
}
face_material_ids: list[int] = []
for polygon in obj.data.polygons:
vertex = obj.data.vertices[polygon.vertices[0]]
face_material_ids.append(next(
material_groups[assignment.group]
for assignment in vertex.groups
if assignment.group in material_groups
))
obj.data.materials.clear()
for material in unique:
obj.data.materials.append(material)
for polygon, material_id in zip(obj.data.polygons, face_material_ids, strict=True):
polygon.material_index = material_id
for group in [group for group in obj.vertex_groups if group.name.startswith("__MAT_")]:
obj.vertex_groups.remove(group)
def reset_pose(armature: bpy.types.Object) -> None:
for bone in armature.pose.bones:
bone.location = (0, 0, 0)
bone.rotation_euler = (0, 0, 0)
bone.scale = (1, 1, 1)
def key_pose(
armature: bpy.types.Object,
frame: int,
rotations: dict[str, tuple[float, float, float]] | None = None,
locations: dict[str, tuple[float, float, float]] | None = None,
scales: dict[str, tuple[float, float, float]] | None = None,
) -> None:
reset_pose(armature)
for name, value in (rotations or {}).items():
armature.pose.bones[name].rotation_euler = tuple(math.radians(component) for component in value)
for name, value in (locations or {}).items():
armature.pose.bones[name].location = value
for name, value in (scales or {}).items():
armature.pose.bones[name].scale = value
for bone in armature.pose.bones:
bone.keyframe_insert("location", frame=frame, group=bone.name)
bone.keyframe_insert("rotation_euler", frame=frame, group=bone.name)
bone.keyframe_insert("scale", frame=frame, group=bone.name)
def build_action(
armature: bpy.types.Object,
name: str,
end_frame: int,
poses: list[dict],
*,
loop: bool = False,
) -> bpy.types.Action:
action = bpy.data.actions.new(name)
action.use_fake_user = True
action.use_frame_range = True
action.frame_start = 1
action.frame_end = end_frame
action.use_cyclic = loop
armature.animation_data.action = action
for pose in poses:
key_pose(armature, **pose)
armature.animation_data.action = None
return action
def create_animations(armature: bpy.types.Object) -> dict[str, dict]:
armature.animation_data_create()
clips: dict[str, dict] = {}
def add(name: str, frames: int, poses: list[dict], loop: bool = False) -> None:
build_action(armature, name, frames, poses, loop=loop)
clips[name] = {"frames": frames, "seconds": round(frames / FPS, 3), "loop": loop}
add(
"Idle",
60,
[
{"frame": 1, "rotations": {"Chest": (0, 0, -2), "Head": (2, 0, 3), "Blade.L": (0, 0, -4), "Blade.R": (0, 0, 4)}},
{"frame": 16, "locations": {"Root": (0, 0, 0.045)}, "rotations": {"Chest": (-2, 0, 2), "Abdomen": (3, 0, -2), "Head": (-2, 0, -3), "Blade.L": (2, 0, 2), "Blade.R": (-2, 0, -2)}},
{"frame": 31, "rotations": {"Chest": (0, 0, -2), "Head": (2, 0, 3), "Blade.L": (0, 0, -4), "Blade.R": (0, 0, 4)}},
{"frame": 46, "locations": {"Root": (0, 0, 0.045)}, "rotations": {"Chest": (-2, 0, 2), "Abdomen": (3, 0, -2), "Head": (-2, 0, -3), "Blade.L": (2, 0, 2), "Blade.R": (-2, 0, -2)}},
{"frame": 60, "rotations": {"Chest": (0, 0, -2), "Head": (2, 0, 3), "Blade.L": (0, 0, -4), "Blade.R": (0, 0, 4)}},
],
loop=True,
)
walk_a = {"Thigh.L": (-24, 0, 4), "Shin.L": (18, 0, 0), "Foot.L": (-8, 0, 0), "Thigh.R": (22, 0, -4), "Shin.R": (-12, 0, 0), "Foot.R": (8, 0, 0), "UpperArm.L": (5, 0, 2), "UpperArm.R": (-5, 0, -2)}
walk_b = {name: tuple(-component for component in rotation) for name, rotation in walk_a.items()}
add(
"Walk",
30,
[
{"frame": 1, "rotations": walk_a},
{"frame": 8, "locations": {"Root": (0, 0, 0.055)}, "rotations": {"Chest": (-3, 0, 0), "Abdomen": (4, 0, 0)}},
{"frame": 16, "rotations": walk_b},
{"frame": 23, "locations": {"Root": (0, 0, 0.055)}, "rotations": {"Chest": (-3, 0, 0), "Abdomen": (4, 0, 0)}},
{"frame": 30, "rotations": walk_a},
],
loop=True,
)
add(
"Sidestep",
18,
[
{"frame": 1, "rotations": {"Chest": (0, 0, 0)}},
{"frame": 5, "locations": {"Root": (-0.10, 0, -0.03)}, "rotations": {"Chest": (0, -8, -12), "Thigh.L": (8, 0, 15), "Thigh.R": (-10, 0, 16), "Blade.L": (0, 0, 8), "Blade.R": (0, 0, 12)}},
{"frame": 11, "locations": {"Root": (0.12, 0, 0.04)}, "rotations": {"Chest": (0, 7, 10), "Thigh.L": (-8, 0, -12), "Thigh.R": (10, 0, -15)}},
{"frame": 18, "rotations": {"Chest": (0, 0, 0)}},
],
)
add(
"Melee",
24,
[
{"frame": 1},
{"frame": 7, "rotations": {"Chest": (0, 0, 7), "UpperArm.R": (-12, 18, 25), "Forearm.R": (10, 0, 38), "Blade.R": (-16, 5, 42), "UpperArm.L": (5, 0, -8)}},
{"frame": 11, "locations": {"Root": (0, -0.08, 0)}, "rotations": {"Chest": (9, 0, -12), "UpperArm.R": (18, -12, -52), "Forearm.R": (-24, 0, -62), "Blade.R": (30, 0, -58), "Head": (-8, 0, 0)}},
{"frame": 16, "rotations": {"UpperArm.R": (6, 0, -20), "Forearm.R": (-10, 0, -25)}},
{"frame": 24},
],
)
add(
"LineSlash",
32,
[
{"frame": 1},
{"frame": 10, "locations": {"Root": (0, 0.05, -0.03)}, "rotations": {"Chest": (-7, 0, 10), "Head": (7, 0, -5), "UpperArm.L": (-15, 12, -30), "Forearm.L": (0, 0, -46), "Blade.L": (-20, 0, -35), "UpperArm.R": (8, 0, 8)}},
{"frame": 15, "locations": {"Root": (0, -0.12, 0.03)}, "rotations": {"Chest": (12, 0, -16), "UpperArm.L": (24, -10, 58), "Forearm.L": (-18, 0, 74), "Blade.L": (34, 0, 70), "Head": (-9, 0, 5)}},
{"frame": 21, "rotations": {"Chest": (5, 0, -6), "UpperArm.L": (8, 0, 20), "Forearm.L": (-5, 0, 28), "Blade.L": (10, 0, 20)}},
{"frame": 32},
],
)
add(
"CrossSlash",
38,
[
{"frame": 1},
{"frame": 11, "locations": {"Root": (0, 0.04, -0.05)}, "rotations": {"Chest": (-9, 0, 0), "UpperArm.L": (-8, 18, 38), "Forearm.L": (10, 0, 52), "Blade.L": (-15, 0, 32), "UpperArm.R": (-8, -18, -38), "Forearm.R": (10, 0, -52), "Blade.R": (-15, 0, -32)}},
{"frame": 16, "locations": {"Root": (0, -0.10, 0.08)}, "rotations": {"Chest": (14, 0, 0), "UpperArm.L": (22, -14, -52), "Forearm.L": (-18, 0, -72), "Blade.L": (28, 0, -64), "UpperArm.R": (22, 14, 52), "Forearm.R": (-18, 0, 72), "Blade.R": (28, 0, 64), "Head": (-10, 0, 0)}},
{"frame": 21, "locations": {"Root": (0, -0.04, 0.02)}, "rotations": {"Chest": (5, 0, 0), "UpperArm.L": (8, 0, -22), "Forearm.L": (-6, 0, -30), "UpperArm.R": (8, 0, 22), "Forearm.R": (-6, 0, 30)}},
{"frame": 38},
],
)
add(
"Recover",
22,
[
{"frame": 1, "locations": {"Root": (0, -0.04, -0.05)}, "rotations": {"Chest": (14, 0, 0), "Head": (-9, 0, 0), "UpperArm.L": (12, 0, -18), "UpperArm.R": (12, 0, 18)}},
{"frame": 8, "rotations": {"Chest": (-4, 0, 0), "Abdomen": (6, 0, 0), "Head": (4, 0, 0)}},
{"frame": 15, "rotations": {"Chest": (2, 0, 0), "Abdomen": (-2, 0, 0)}},
{"frame": 22},
],
)
add(
"Stagger",
28,
[
{"frame": 1},
{"frame": 4, "locations": {"Root": (0, 0.10, -0.07)}, "rotations": {"Chest": (-18, 0, -10), "Head": (24, 0, 12), "UpperArm.L": (-16, 0, -22), "UpperArm.R": (-16, 0, 22), "Thigh.L": (12, 0, 0), "Thigh.R": (12, 0, 0)}},
{"frame": 10, "rotations": {"Chest": (8, 0, 6), "Head": (-12, 0, -8), "Blade.L": (14, 0, 0), "Blade.R": (14, 0, 0)}},
{"frame": 18, "rotations": {"Chest": (-3, 0, -2), "Head": (4, 0, 2)}},
{"frame": 28},
],
)
add(
"Death",
72,
[
{"frame": 1},
{"frame": 12, "locations": {"Root": (0, 0.08, -0.10)}, "rotations": {"Chest": (-20, 0, 9), "Head": (18, 0, -12), "UpperArm.L": (-20, 0, -25), "UpperArm.R": (-20, 0, 25), "Thigh.L": (14, 0, 0), "Thigh.R": (14, 0, 0)}},
{"frame": 28, "locations": {"Root": (0.10, 0.20, -0.55)}, "rotations": {"Root": (0, 38, 74), "Chest": (-34, 8, -18), "Head": (28, 0, 15), "UpperArm.L": (30, 0, -48), "UpperArm.R": (-12, 0, 48), "Thigh.L": (28, 0, 22), "Thigh.R": (-14, 0, -18)}},
{"frame": 48, "locations": {"Root": (0.18, 0.20, -1.12)}, "rotations": {"Root": (0, 52, 88), "Chest": (-24, 12, -22), "Head": (38, 0, 22), "UpperArm.L": (42, 0, -62), "UpperArm.R": (8, 0, 58), "Thigh.L": (36, 0, 28), "Thigh.R": (-20, 0, -22)}},
{"frame": 72, "locations": {"Root": (0.18, 0.20, -1.18)}, "rotations": {"Root": (0, 52, 88), "Chest": (-24, 12, -22), "Head": (42, 0, 25), "UpperArm.L": (44, 0, -64), "UpperArm.R": (10, 0, 60), "Thigh.L": (38, 0, 28), "Thigh.R": (-20, 0, -22)}},
],
)
return clips
def create_collision_meshes() -> list[bpy.types.Object]:
collision_material = make_material("CollisionProxy", (0.05, 0.8, 0.2, 0.35), roughness=1.0)
collision_parts: list[bpy.types.Object] = []
specs = [
("COLLISION_Body", (0, 0.18, 2.55), (0.72, 1.12, 1.55)),
("COLLISION_Head", (0, -0.38, 4.08), (0.52, 0.62, 0.48)),
("COLLISION_ScytheReach", (0, -1.35, 2.66), (1.82, 1.18, 0.84)),
]
for name, location, scale in specs:
bpy.ops.mesh.primitive_ico_sphere_add(subdivisions=1, radius=1, location=location)
obj = bpy.context.object
obj.name = name
obj.scale = scale
bpy.ops.object.transform_apply(location=False, rotation=False, scale=True)
obj.data.materials.append(collision_material)
collision_parts.append(obj)
return collision_parts
def select_only(objects: list[bpy.types.Object]) -> None:
bpy.ops.object.select_all(action="DESELECT")
for obj in objects:
obj.hide_set(False)
obj.select_set(True)
if objects:
bpy.context.view_layer.objects.active = objects[0]
def export_glbs(armature: bpy.types.Object, body: bpy.types.Object, collision_parts: list[bpy.types.Object]) -> None:
select_only([armature, body])
bpy.ops.export_scene.gltf(
filepath=str(GLB_PATH),
export_format="GLB",
use_selection=True,
export_animations=True,
export_animation_mode="ACTIONS",
export_frame_range=True,
export_skins=True,
export_morph=False,
export_yup=True,
export_apply=False,
export_cameras=False,
export_lights=False,
)
select_only(collision_parts)
bpy.ops.export_scene.gltf(
filepath=str(COLLISION_PATH),
export_format="GLB",
use_selection=True,
export_animations=False,
export_skins=False,
export_materials="NONE",
export_yup=True,
export_apply=True,
)
for obj in collision_parts:
obj.hide_render = True
obj.hide_set(True)
def look_at(obj: bpy.types.Object, target: tuple[float, float, float]) -> None:
direction = Vector(target) - obj.location
obj.rotation_euler = direction.to_track_quat("-Z", "Y").to_euler()
def setup_preview_scene() -> tuple[bpy.types.Object, list[bpy.types.Object]]:
scene = bpy.context.scene
scene.render.engine = "BLENDER_EEVEE"
scene.render.resolution_x = 900
scene.render.resolution_y = 900
scene.render.resolution_percentage = 100
scene.render.image_settings.file_format = "PNG"
scene.render.image_settings.color_mode = "RGBA"
scene.render.film_transparent = False
scene.render.fps = FPS
scene.world.color = (0.006, 0.008, 0.014)
world_nodes = scene.world.node_tree.nodes if scene.world.use_nodes else None
if not scene.world.use_nodes:
scene.world.use_nodes = True
world_nodes = scene.world.node_tree.nodes
world_nodes["Background"].inputs["Color"].default_value = (0.006, 0.009, 0.018, 1)
world_nodes["Background"].inputs["Strength"].default_value = 0.28
camera_data = bpy.data.cameras.new("PreviewCamera")
camera = bpy.data.objects.new("PreviewCamera", camera_data)
bpy.context.collection.objects.link(camera)
camera_data.lens = 58
scene.camera = camera
lights: list[bpy.types.Object] = []
light_specs = [
("Key", "AREA", (4.5, -6.5, 7.5), (1.0, 0.30, 0.10), 1150, 5.0),
("Fill", "AREA", (-5.5, -3.0, 4.5), (0.10, 0.25, 1.0), 850, 4.0),
("Rim", "AREA", (1.0, 5.5, 6.5), (1.0, 0.08, 0.02), 1300, 3.0),
]
for name, kind, location, color, energy, size in light_specs:
data = bpy.data.lights.new(name, type=kind)
data.energy = energy
data.color = color
data.shape = "DISK"
data.size = size
light = bpy.data.objects.new(name, data)
light.location = location
bpy.context.collection.objects.link(light)
look_at(light, (0, 0, 2.5))
lights.append(light)
floor_mat = make_material("PreviewFloor", (0.018, 0.022, 0.032, 1), metallic=0.05, roughness=0.82)
bpy.ops.mesh.primitive_plane_add(size=30, location=(0, 0, 0))
floor = bpy.context.object
floor.name = "PreviewFloor"
floor.data.materials.append(floor_mat)
return camera, lights + [floor]
def activate_action(armature: bpy.types.Object, name: str, frame: int) -> None:
armature.animation_data.action = bpy.data.actions[name]
bpy.context.scene.frame_set(frame)
def render_previews(armature: bpy.types.Object) -> None:
camera, _studio = setup_preview_scene()
views = [
("ember_mantis_three_quarter.png", (7.4, -10.5, 5.8), "Idle", 16, 58),
("ember_mantis_front.png", (0.0, -12.5, 4.2), "Idle", 16, 62),
("ember_mantis_side.png", (10.8, -0.2, 4.3), "Idle", 16, 60),
("ember_mantis_cross_slash.png", (7.4, -10.5, 5.8), "CrossSlash", 16, 58),
]
for filename, camera_position, action_name, frame, lens in views:
activate_action(armature, action_name, frame)
camera.location = camera_position
camera.data.lens = lens
look_at(camera, (0, -0.05, 2.55))
bpy.context.scene.render.filepath = str(PREVIEW_DIR / filename)
bpy.ops.render.render(write_still=True)
armature.animation_data.action = None
bpy.context.scene.frame_set(1)
def write_metadata(body: bpy.types.Object, clips: dict[str, dict]) -> None:
triangles = sum(len(poly.vertices) - 2 for poly in body.data.polygons)
metadata = {
"name": "Ember Mantis Duelist",
"assetId": "ember-mantis-duelist",
"license": "Original project asset",
"sourceConcept": "IWT2 Ember Mantis Duelist side-cel concept",
"authoringTool": bpy.app.version_string,
"format": "glTF 2.0 binary (GLB)",
"coordinateConvention": {"up": "+Y after glTF export", "blenderForward": "-Y", "units": "meters"},
"runtime": {
"renderMesh": "EmberMantis_Body",
"armature": "EmberMantis_Rig",
"collisionAsset": COLLISION_PATH.name,
"materials": [material.name for material in body.data.materials],
"trianglesApprox": triangles,
},
"animations": clips,
}
METADATA_PATH.write_text(json.dumps(metadata, indent=2) + "\n", encoding="utf-8")
def main() -> None:
OUT_DIR.mkdir(parents=True, exist_ok=True)
PREVIEW_DIR.mkdir(parents=True, exist_ok=True)
reset_scene()
mats = {
"chitin": make_material("M_Chitin", (0.025, 0.022, 0.026, 1), metallic=0.18, roughness=0.42),
"crimson": make_material("M_CrimsonArmor", (0.34, 0.025, 0.018, 1), metallic=0.22, roughness=0.36),
"deep_red": make_material("M_DeepRed", (0.13, 0.012, 0.012, 1), metallic=0.15, roughness=0.48),
"bone": make_material("M_BoneBlade", (0.62, 0.45, 0.26, 1), metallic=0.12, roughness=0.28),
"ember": make_material(
"M_EmberGlow",
(1.0, 0.075, 0.004, 1),
roughness=0.2,
emission=(1.0, 0.028, 0.0, 1),
emission_strength=8.0,
),
"eye": make_material(
"M_EyeGlow",
(1.0, 0.33, 0.01, 1),
roughness=0.16,
emission=(1.0, 0.14, 0.0, 1),
emission_strength=12.0,
),
}
RUNTIME_MATERIALS.extend(
[mats["chitin"], mats["crimson"], mats["deep_red"], mats["eye"], mats["bone"], mats["ember"]]
)
armature = create_armature()
body = create_model(armature, mats)
clips = create_animations(armature)
collision_parts = create_collision_meshes()
export_glbs(armature, body, collision_parts)
write_metadata(body, clips)
render_previews(armature)
bpy.ops.wm.save_as_mainfile(filepath=str(BLEND_PATH))
print(f"BUILT={BLEND_PATH}")
print(f"EXPORTED={GLB_PATH}")
print(f"COLLISION={COLLISION_PATH}")
print(f"ANIMATIONS={','.join(clips)}")
if __name__ == "__main__":
main()
scripts/publish_gitea.py
+38 -11
View File
@@ -28,7 +28,10 @@ GITEA_TOKEN = "ed2db3fd54546e9658377d0551b3fc3961583f1d"
GITEA_OWNER = "phenom"
GITEA_REPO = "i-want-to-heal-mmo"
BRANCH = "main"
TRUENAS_PATH = Path("/mnt/usbssds/apps/iwanttoheal/app")
TRUENAS_PATH = Path("/mnt/usbssds/apps/iwanttoheal-mmo/app")
TRUENAS_GITEA_REPO = Path(
"/mnt/.ix-apps/app_mounts/gitea/data/git/repositories/phenom/i-want-to-heal-mmo.git"
)
SEMVER = re.compile(r"^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$")
@@ -256,8 +259,7 @@ def ensure_tag(version: str, commit: str, message: str) -> str:
def gitea_token() -> str:
token = "ed2db3fd54546e9658377d0551b3fc3961583f1d"
token = os.environ.get("GITEA_TOKEN", GITEA_TOKEN).strip()
if not token:
raise SystemExit(
"GITEA_TOKEN is required to create the release and upload the APK. "
@@ -402,21 +404,46 @@ def upload_apk(release: dict[str, object], apk: Path, token: str) -> None:
def update_truenas() -> None:
if (TRUENAS_PATH / ".git").is_dir():
origin = capture(["git", "remote", "get-url", "origin"], cwd=TRUENAS_PATH)
if normalized_remote(origin) != normalized_remote(GITEA_REMOTE):
accepted_origins = {
normalized_remote(GITEA_REMOTE),
normalized_remote(str(TRUENAS_GITEA_REPO)),
}
if normalized_remote(origin) not in accepted_origins:
raise SystemExit(
"Refusing to update TrueNAS from its old repository origin "
f"{origin!r}. Replace that checkout with {GITEA_REMOTE!r} first."
f"{origin!r}. Replace that checkout with this game's repository first."
)
run(["git", "pull", "--ff-only", "origin", BRANCH], cwd=TRUENAS_PATH)
print("TrueNAS source updated. Restart the iwanttoheal app in the TrueNAS UI.")
if TRUENAS_GITEA_REPO.is_dir():
run(
[
"git",
"-c",
f"safe.directory={TRUENAS_GITEA_REPO}",
"pull",
"--ff-only",
str(TRUENAS_GITEA_REPO),
BRANCH,
],
cwd=TRUENAS_PATH,
)
print(f"TrueNAS source updated from local Gitea storage: {TRUENAS_GITEA_REPO}")
else:
run(["git", "pull", "--ff-only", "origin", BRANCH], cwd=TRUENAS_PATH)
print("TrueNAS source updated from its configured origin.")
print("Restart the iwanttoheal-mmo app in the TrueNAS UI.")
return
print("New TrueNAS app clone is not mounted on this machine.")
print(f"Move or remove the old app directory at {TRUENAS_PATH}, then run:")
print(f" git clone {GITEA_REMOTE} {TRUENAS_PATH}")
print("Run these commands in the TrueNAS shell:")
print(f" sudo git config --global --add safe.directory {TRUENAS_GITEA_REPO}")
print(f" sudo git clone {TRUENAS_GITEA_REPO} {TRUENAS_PATH}")
print(f" sudo chown -R truenas_admin:truenas_admin {TRUENAS_PATH.parent}")
print("For later releases:")
print(f" git -C {TRUENAS_PATH} pull --ff-only origin {BRANCH}")
print("Then restart the iwanttoheal app in the TrueNAS UI.")
print(
f" git -C {TRUENAS_PATH} pull --ff-only "
f"{TRUENAS_GITEA_REPO} {BRANCH}"
)
print("Then restart the iwanttoheal-mmo app in the TrueNAS UI.")
def main(argv: list[str] | None = None) -> int: