daddy/modbison
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bb65274a49ef05bc9b48dd6b7738808fe513b9fb
modbison/scripts/tools/gen_placeholder_avatars.gd
T

428 lines
17 KiB
GDScript
Raw Blame History

extends SceneTree
## Generates the placeholder avatar asset pack (GLB files) referenced by
## assets/avatars/catalog.json.
##
## These are deliberately crude primitive stand-ins so the avatar loader /
## customization / in-world rendering can be built and tested now; real art
## swaps in later as a pure content change (catalog paths are unchanged).
##
## The base body is a Roblox-classic (R6) style blocky figure: six chunky box
## parts (head, torso, two arms, two legs) skinned one-part-per-bone onto the
## 24-bone canonical rig, arms hanging at the sides, plus a painted-on face.
##
## Run: godot --headless --path . --script res://scripts/tools/gen_placeholder_avatars.gd
## Output: res://assets/avatars/*.glb (13 attachments + 1 rigged base body)
const OUT_DIR := "res://assets/avatars/"
# Canonical rig -- must match avatar_loader.gd CANONICAL_BONES. Each entry:
# name -> [parent_name, global_rest_position] (A-pose, arms down, Y-up, metres)
# The character faces -Z (Godot's node "forward"), so the face, toes and
# front-mounted attachments live at negative Z.
const BONES := {
"Root": ["", Vector3(0.00, 0.00, 0.00)],
"Hips": ["Root", Vector3(0.00, 0.76, 0.00)],
"Spine": ["Hips", Vector3(0.00, 1.00, 0.00)],
"Chest": ["Spine", Vector3(0.00, 1.30, 0.00)],
"Neck": ["Chest", Vector3(0.00, 1.50, 0.00)],
# Head bone sits at the visual head's centre and HeadTop just above its
# crown, so hats / hair / helmets mount where you'd expect. (The body mesh
# is rigidly bound, so moving these bones doesn't move the mesh.)
"Head": ["Neck", Vector3(0.00, 1.74, 0.00)],
"HeadTop": ["Head", Vector3(0.00, 2.06, 0.00)],
"Jaw": ["Head", Vector3(0.00, 1.66, -0.22)],
"LeftEye": ["Head", Vector3(0.12, 1.80, -0.28)],
"RightEye": ["Head", Vector3(-0.12, 1.80, -0.28)],
"LeftShoulder": ["Chest", Vector3(0.42, 1.50, 0.00)],
"LeftUpperArm": ["LeftShoulder", Vector3(0.60, 1.44, 0.00)],
"LeftLowerArm": ["LeftUpperArm", Vector3(0.60, 1.14, 0.00)],
"LeftHand": ["LeftLowerArm", Vector3(0.60, 0.82, 0.00)],
"RightShoulder": ["Chest", Vector3(-0.42, 1.50, 0.00)],
"RightUpperArm": ["RightShoulder", Vector3(-0.60, 1.44, 0.00)],
"RightLowerArm": ["RightUpperArm", Vector3(-0.60, 1.14, 0.00)],
"RightHand": ["RightLowerArm", Vector3(-0.60, 0.82, 0.00)],
"LeftUpperLeg": ["Hips", Vector3(0.21, 0.74, 0.00)],
"LeftLowerLeg": ["LeftUpperLeg", Vector3(0.21, 0.38, 0.00)],
"LeftFoot": ["LeftLowerLeg", Vector3(0.21, 0.05, -0.06)],
"RightUpperLeg": ["Hips", Vector3(-0.21, 0.74, 0.00)],
"RightLowerLeg": ["RightUpperLeg", Vector3(-0.21, 0.38, 0.00)],
"RightFoot": ["RightLowerLeg", Vector3(-0.21, 0.05, -0.06)],
}
# Order matters: parents before children.
const BONE_ORDER := [
"Root", "Hips", "Spine", "Chest", "Neck", "Head", "HeadTop", "Jaw",
"LeftEye", "RightEye",
"LeftShoulder", "LeftUpperArm", "LeftLowerArm", "LeftHand",
"RightShoulder", "RightUpperArm", "RightLowerArm", "RightHand",
"LeftUpperLeg", "LeftLowerLeg", "LeftFoot",
"RightUpperLeg", "RightLowerLeg", "RightFoot",
]
# Roblox-classic colour blocks.
const C_SKIN := Color(0.96, 0.80, 0.19) # bright yellow (head + arms)
const C_SHIRT := Color(0.05, 0.41, 0.67) # bright blue (torso)
const C_PANTS := Color(0.18, 0.49, 0.30) # bright green (legs)
const C_FACE := Color(0.05, 0.05, 0.06) # near-black (eyes + smile)
# Body parts: [bone, centre, size, colour]. Each part is one rigid box, fully
# weighted to its bone -- so the rig still drives it, but it reads as a clean
# solid block (no banding, no capsule taper).
const PARTS := [
# Torso, arms and legs all share the same 0.46 depth so a limb always fully
# covers the slice of torso behind it -- otherwise a brightly-lit sliver of
# the torso side peeks past the arm and reads as a cyan seam.
["Head", Vector3(0.00, 1.74, 0.00), Vector3(0.58, 0.56, 0.58), C_SKIN],
["Spine", Vector3(0.00, 1.14, 0.00), Vector3(0.90, 0.80, 0.46), C_SHIRT],
["LeftUpperArm", Vector3(0.57, 1.14, 0.00), Vector3(0.34, 0.78, 0.46), C_SKIN],
["RightUpperArm", Vector3(-0.57, 1.14, 0.00), Vector3(0.34, 0.78, 0.46), C_SKIN],
["LeftUpperLeg", Vector3(0.21, 0.38, 0.00), Vector3(0.40, 0.78, 0.46), C_PANTS],
["RightUpperLeg", Vector3(-0.21, 0.38, 0.00), Vector3(0.40, 0.78, 0.46), C_PANTS],
# painted-on face -- thin plates on the front of the head (-Z), rigged to Head
["Head", Vector3(0.13, 1.78, -0.30), Vector3(0.09, 0.12, 0.02), C_FACE],
["Head", Vector3(-0.13, 1.78, -0.30), Vector3(0.09, 0.12, 0.02), C_FACE],
["Head", Vector3(0.00, 1.64, -0.30), Vector3(0.32, 0.05, 0.02), C_FACE],
]
# Attachments: id -> [Mesh, local_offset_from_mount_bone, colour]
# Mesh is built in _attachment_mesh().
const ATTACHMENTS := {
"head_cyber_01": ["head", Vector3(0, 0.12, 0.0), Color(0.20, 0.85, 0.95)],
"hair_mohawk_01": ["mohawk", Vector3(0, 0.10, 0.0), Color(0.90, 0.20, 0.35)],
"hair_ponytail_01": ["ponytail", Vector3(0, -0.22, 0.24), Color(0.45, 0.30, 0.15)],
"face_glasses_01": ["glasses", Vector3(0, 0.12, -0.07), Color(0.10, 0.10, 0.12)],
"chest_bandit_01": ["torso", Vector3(0, -0.12, 0.0), Color(0.55, 0.20, 0.20)],
"back_backpack_01": ["box", Vector3(0, -0.06, 0.28), Color(0.30, 0.35, 0.25)],
"pants_cargo_01": ["hips", Vector3(0, -0.04, 0.0), Color(0.30, 0.35, 0.45)],
"left_hand_glove_01": ["blob", Vector3(0, 0.0, 0.0), Color(0.15, 0.15, 0.18)],
"right_hand_glove_01": ["blob", Vector3(0, 0.0, 0.0), Color(0.15, 0.15, 0.18)],
"left_hand_wristband_01": ["band", Vector3(0, 0.02, 0.0), Color(0.95, 0.80, 0.15)],
"right_hand_wristband_01": ["band", Vector3(0, 0.02, 0.0), Color(0.95, 0.80, 0.15)],
"left_foot_boot_01": ["boot", Vector3(0, -0.02, -0.05), Color(0.12, 0.10, 0.09)],
"right_foot_boot_01": ["boot", Vector3(0, -0.02, -0.05), Color(0.12, 0.10, 0.09)],
"left_foot_sneaker_01": ["sneaker", Vector3(0, -0.02, -0.05), Color(0.85, 0.25, 0.25)],
"right_foot_sneaker_01": ["sneaker", Vector3(0, -0.02, -0.05), Color(0.85, 0.25, 0.25)],
"accessory_belt_01": ["belt", Vector3(0, 0.74, 0.0), Color(0.20, 0.18, 0.12)],
"accessory_necklace_01": ["necklace", Vector3(0, 1.34, -0.10), Color(0.85, 0.75, 0.20)],
}
var _fail := 0
func _initialize() -> void:
var abs_dir := ProjectSettings.globalize_path(OUT_DIR)
DirAccess.make_dir_recursive_absolute(abs_dir)
_gen_base_body()
for id in ATTACHMENTS:
var spec: Array = ATTACHMENTS[id]
_gen_attachment(id, spec[0], spec[1], spec[2])
_gen_water_buffalo_hat()
print("\n%s" % ("DONE — all placeholder avatar GLBs written" if _fail == 0
else "FAILED (%d errors)" % _fail))
quit(_fail)
# ---------------------------------------------------------------------------
# Base body -- rigged, skinned
# ---------------------------------------------------------------------------
func _global_rest(bone: String) -> Transform3D:
return Transform3D(Basis.IDENTITY, BONES[bone][1])
func _gen_base_body() -> void:
var root := Node3D.new()
root.name = "AvatarRoot"
var skel := Skeleton3D.new()
skel.name = "Skeleton3D"
root.add_child(skel)
var idx := {}
for bone in BONE_ORDER:
var i := skel.add_bone(bone)
idx[bone] = i
for bone in BONE_ORDER:
var parent: String = BONES[bone][0]
var g := _global_rest(bone)
if parent == "":
skel.set_bone_rest(idx[bone], g)
else:
skel.set_bone_parent(idx[bone], idx[parent])
skel.set_bone_rest(idx[bone], _global_rest(parent).affine_inverse() * g)
for bone in BONE_ORDER:
skel.set_bone_pose_position(idx[bone], skel.get_bone_rest(idx[bone]).origin)
# Skin: one bind per bone, bind pose = inverse global rest.
var skin := Skin.new()
for bone in BONE_ORDER:
skin.add_named_bind(bone, _global_rest(bone).affine_inverse())
var bind_index := {}
for b in range(BONE_ORDER.size()):
bind_index[BONE_ORDER[b]] = b
# One surface per distinct colour so parts stay flat-shaded solids.
var groups: Dictionary = {} # Color (as key string) -> {color, verts, normals, bones, weights}
for part in PARTS:
var bone: String = part[0]
var centre: Vector3 = part[1]
var size: Vector3 = part[2]
var col: Color = part[3]
var key := col.to_html()
if not groups.has(key):
groups[key] = {
"color": col,
"verts": PackedVector3Array(),
"normals": PackedVector3Array(),
"bones": PackedInt32Array(),
"weights": PackedFloat32Array(),
}
var gg = groups[key]
_append_box(gg.verts, gg.normals, gg.bones, gg.weights,
centre, size, bind_index[bone])
var mesh := ArrayMesh.new()
var surf := 0
for key in groups:
var gg = groups[key]
var arr := []
arr.resize(Mesh.ARRAY_MAX)
arr[Mesh.ARRAY_VERTEX] = gg.verts
arr[Mesh.ARRAY_NORMAL] = gg.normals
arr[Mesh.ARRAY_BONES] = gg.bones
arr[Mesh.ARRAY_WEIGHTS] = gg.weights
mesh.add_surface_from_arrays(Mesh.PRIMITIVE_TRIANGLES, arr)
var mat := StandardMaterial3D.new()
mat.albedo_color = gg.color
mat.roughness = 0.9
mesh.surface_set_material(surf, mat)
surf += 1
var mi := MeshInstance3D.new()
mi.name = "Body"
mi.mesh = mesh
mi.skin = skin
skel.add_child(mi)
mi.skeleton = mi.get_path_to(skel)
_write_glb(root, "base_human_male_01")
root.free()
# Append an axis-aligned box (centre, size) with every vert weighted 1.0 to bone_idx.
func _append_box(verts: PackedVector3Array, normals: PackedVector3Array,
bones: PackedInt32Array, weights: PackedFloat32Array,
centre: Vector3, size: Vector3, bone_idx: int) -> void:
var h := size * 0.5
# 8 corners
var c: Array[Vector3] = [
centre + Vector3(-h.x, -h.y, -h.z), centre + Vector3(h.x, -h.y, -h.z),
centre + Vector3(h.x, -h.y, h.z), centre + Vector3(-h.x, -h.y, h.z),
centre + Vector3(-h.x, h.y, -h.z), centre + Vector3(h.x, h.y, -h.z),
centre + Vector3(h.x, h.y, h.z), centre + Vector3(-h.x, h.y, h.z),
]
# Vertex order per face is CCW seen from outside -> the computed normal
# points outward. (Getting this backwards renders the whole mesh as an
# inside-out black shell: every face is lit from behind.)
var faces := [
[3, 2, 6, 7], # +Z front
[1, 0, 4, 5], # -Z back
[7, 6, 5, 4], # +Y top
[0, 1, 2, 3], # -Y bottom
[2, 1, 5, 6], # +X right
[3, 7, 4, 0], # -X left
]
for f in faces:
var q: Array[Vector3] = [c[f[0]], c[f[1]], c[f[2]], c[f[3]]]
var n: Vector3 = (q[1] - q[0]).cross(q[2] - q[0]).normalized()
for tri in [[0, 2, 1], [0, 3, 2]]:
for vi in tri:
verts.append(q[vi])
normals.append(n)
bones.append_array([bone_idx, 0, 0, 0])
weights.append_array([1.0, 0.0, 0.0, 0.0])
# ---------------------------------------------------------------------------
# Attachments -- plain static meshes
# ---------------------------------------------------------------------------
func _gen_attachment(id: String, kind: String, offset: Vector3, col: Color) -> void:
var root := Node3D.new()
root.name = "AttachmentRoot"
var mi := MeshInstance3D.new()
mi.name = id
mi.mesh = _attachment_mesh(kind)
mi.position = offset
var mat := StandardMaterial3D.new()
mat.albedo_color = col
mat.roughness = 0.9
mi.material_override = mat
root.add_child(mi)
_write_glb(root, id)
root.free()
func _attachment_mesh(kind: String) -> Mesh:
match kind:
"head":
# A cyber visor band across the upper half of the ~0.58 head box.
var m := BoxMesh.new(); m.size = Vector3(0.64, 0.30, 0.62); return m
"mohawk":
var m := PrismMesh.new(); m.size = Vector3(0.10, 0.24, 0.50); return m
"ponytail":
var m := BoxMesh.new(); m.size = Vector3(0.16, 0.36, 0.20); return m
"glasses":
var m := BoxMesh.new(); m.size = Vector3(0.48, 0.11, 0.05); return m
"torso":
var m := BoxMesh.new(); m.size = Vector3(0.80, 0.66, 0.42); return m
"box":
var m := BoxMesh.new(); m.size = Vector3(0.34, 0.40, 0.16); return m
"hips":
var m := BoxMesh.new(); m.size = Vector3(0.66, 0.34, 0.40); return m
"blob":
var m := BoxMesh.new(); m.size = Vector3(0.30, 0.24, 0.34); return m
"boot":
var m := BoxMesh.new(); m.size = Vector3(0.34, 0.16, 0.42); return m
"sneaker":
var m := BoxMesh.new(); m.size = Vector3(0.32, 0.14, 0.40); return m
"band":
var m := TorusMesh.new(); m.inner_radius = 0.10; m.outer_radius = 0.16; return m
"belt":
var m := TorusMesh.new(); m.inner_radius = 0.22; m.outer_radius = 0.30; return m
"necklace":
var m := TorusMesh.new(); m.inner_radius = 0.10; m.outer_radius = 0.14; return m
_:
return BoxMesh.new()
func _gen_water_buffalo_hat() -> void:
var root := Node3D.new()
root.name = "AttachmentRoot"
var cap_mat := StandardMaterial3D.new()
cap_mat.albedo_color = Color(0.13, 0.20, 0.58) # Flintstones Water Buffalo blue
cap_mat.roughness = 0.95
# 1. Hat Cap Base (taller cylindrical body)
var cap := MeshInstance3D.new()
cap.name = "HatCap"
var cap_mesh := CylinderMesh.new()
cap_mesh.top_radius = 0.30
cap_mesh.bottom_radius = 0.32
cap_mesh.height = 0.30
cap.mesh = cap_mesh
cap.position = Vector3(0.0, 0.15, 0.0)
cap.material_override = cap_mat
root.add_child(cap)
# 1b. Rounded Dome Top (makes the hat taller and rounded, less flat)
var dome := MeshInstance3D.new()
dome.name = "HatDome"
var dome_mesh := SphereMesh.new()
dome_mesh.radius = 0.30
dome_mesh.height = 0.28
dome.mesh = dome_mesh
dome.position = Vector3(0.0, 0.26, 0.0)
dome.material_override = cap_mat
root.add_child(dome)
# 2. Fur Brim / Rim at bottom edge of cap
var brim := MeshInstance3D.new()
brim.name = "FurBrim"
var brim_mesh := TorusMesh.new()
brim_mesh.inner_radius = 0.28
brim_mesh.outer_radius = 0.36
brim.mesh = brim_mesh
brim.position = Vector3(0.0, 0.01, 0.0)
var brim_mat := StandardMaterial3D.new()
brim_mat.albedo_color = Color(0.24, 0.18, 0.13) # Fur trim
brim_mat.roughness = 1.0
brim.material_override = brim_mat
root.add_child(brim)
# 3. Lodge Gold Medallion on front (-Z is forward)
var medal := MeshInstance3D.new()
medal.name = "LodgeBadge"
var medal_mesh := BoxMesh.new()
medal_mesh.size = Vector3(0.12, 0.10, 0.04)
medal.mesh = medal_mesh
medal.position = Vector3(0.0, 0.16, -0.32)
var medal_mat := StandardMaterial3D.new()
medal_mat.albedo_color = Color(0.96, 0.82, 0.18) # Gold lodge crest
medal_mat.metallic = 0.7
medal_mat.roughness = 0.3
medal.material_override = medal_mat
root.add_child(medal)
# Horn material: first part is ivory/white, tip is brown (no middle piece)
var horn_mat := StandardMaterial3D.new()
horn_mat.albedo_color = Color(0.93, 0.90, 0.82) # Bone/ivory white
horn_mat.roughness = 0.45
var tip_mat := StandardMaterial3D.new()
tip_mat.albedo_color = Color(0.28, 0.18, 0.12) # Buffalo horn brown
tip_mat.roughness = 0.55
# 4. Short Water Buffalo Horns: white base + brown tip only
for side in [-1.0, 1.0]:
var side_name := "Right" if side < 0.0 else "Left"
# First part: white base segment projecting outward from side of hat
var h_base := MeshInstance3D.new()
h_base.name = "Horn_%s_Base" % side_name
var base_mesh := CylinderMesh.new()
base_mesh.bottom_radius = 0.08
base_mesh.top_radius = 0.055
base_mesh.height = 0.17
h_base.mesh = base_mesh
h_base.position = Vector3(side * 0.34, 0.18, 0.01)
h_base.rotation_degrees = Vector3(5.0, side * -10.0, side * -60.0)
h_base.material_override = horn_mat
root.add_child(h_base)
# Second part: brown tip segment curving upward (middle piece removed)
var h_tip := MeshInstance3D.new()
h_tip.name = "Horn_%s_Tip" % side_name
var tip_mesh := CylinderMesh.new()
tip_mesh.bottom_radius = 0.055
tip_mesh.top_radius = 0.005
tip_mesh.height = 0.15
h_tip.mesh = tip_mesh
h_tip.position = Vector3(side * 0.46, 0.28, -0.01)
h_tip.rotation_degrees = Vector3(12.0, 0.0, side * 10.0)
h_tip.material_override = tip_mat
root.add_child(h_tip)
_write_glb(root, "hair_waterbuffalo_01")
root.free()
# ---------------------------------------------------------------------------
# GLB export
# ---------------------------------------------------------------------------
func _write_glb(scene_root: Node, basename: String) -> void:
# append_from_scene needs the node in a tree.
get_root().add_child(scene_root)
var doc := GLTFDocument.new()
var state := GLTFState.new()
var err := doc.append_from_scene(scene_root, state)
if err != OK:
push_error("append_from_scene failed for %s: %s" % [basename, error_string(err)])
_fail += 1
get_root().remove_child(scene_root)
return
var out_path := ProjectSettings.globalize_path("%s%s.glb" % [OUT_DIR, basename])
err = doc.write_to_filesystem(state, out_path)
get_root().remove_child(scene_root)
if err != OK:
push_error("write_to_filesystem failed for %s: %s" % [basename, error_string(err)])
_fail += 1
return
print(" wrote %s.glb (%d bytes)" % [basename, FileAccess.get_file_as_bytes(out_path).size()])
Reference in New Issue View Git Blame Copy Permalink