Restructure into core/ and content/official/

2026-07-12 01:12:27 -05:00
parent e65c48c1e3
commit 69f2028ce3
132 changed files with 1269 additions and 1323 deletions
@@ -0,0 +1,173 @@
+class_name Dartboard
+extends StaticBody3D
+
+## The board. 21 material slots: sector_1 .. sector_20, plus "bulls".
+##
+## Owns the face -> surface -> slot mapping, which is what makes hit detection
+## survive the board moving, rotating, or having its sectors remapped. Ask the
+## geometry which sector was hit; don't calculate it from an angle.
+
+## Every slot on the board, in the order Blender exported them (order doesn't
+## matter — we index by name).
+const BULL_SLOT := &"bulls"
+
+@onready var mesh_instance: MeshInstance3D = $Model/dartboard
+
+## StringName -> surface index
+var _slot_to_surface: Dictionary = {}
+## global face index -> StringName
+var _face_to_slot: Dictionary = {}
+
+var _outer_radius: float = 0.0
+
+
+func _ready() -> void:
+	_index_slots()
+	_index_faces()
+	_cache_radius()
+
+
+# --- Indexing -----------------------------------------------------------
+
+func _index_slots() -> void:
+	var mesh := mesh_instance.mesh
+	if mesh == null:
+		push_error("Dartboard has no mesh.")
+		return
+
+	for i in mesh.get_surface_count():
+		var mat := mesh.surface_get_material(i)
+		if mat == null:
+			push_warning("Surface %d has no material — can't be skinned or hit." % i)
+			continue
+
+		var slot := StringName(mat.resource_name)
+		if slot == &"":
+			push_warning("Surface %d's material has no name." % i)
+			continue
+
+		_slot_to_surface[slot] = i
+
+	print("Dartboard: indexed %d slots." % _slot_to_surface.size())
+	if _slot_to_surface.size() != 21:
+		push_warning("Expected 21 slots (20 sectors + bulls), got %d." % _slot_to_surface.size())
+
+
+## Build a global-face-index -> slot map.
+##
+## The physics engine reports face_index as an index into the WHOLE trimesh,
+## but the mesh stores faces per-surface. So we walk the surfaces in order,
+## accumulating a running face count, and record which range belongs to which.
+##
+## This assumes the ConcavePolygonShape3D was built from the mesh with surfaces
+## in the same order — which is what create_trimesh_shape() does.
+func _index_faces() -> void:
+	var mesh := mesh_instance.mesh
+	if mesh == null:
+		return
+
+	var running := 0
+	for i in mesh.get_surface_count():
+		var arrays := mesh.surface_get_arrays(i)
+		if arrays.is_empty():
+			continue
+
+		var indices: PackedInt32Array = arrays[Mesh.ARRAY_INDEX]
+		var verts: PackedVector3Array = arrays[Mesh.ARRAY_VERTEX]
+
+		# Triangle count: from the index buffer if present, else from vertices.
+		var tri_count := (indices.size() / 3) if indices.size() > 0 else (verts.size() / 3)
+
+		var mat := mesh.surface_get_material(i)
+		var slot := StringName(mat.resource_name) if mat else &""
+
+		for f in tri_count:
+			_face_to_slot[running + f] = slot
+
+		running += tri_count
+
+	print("Dartboard: mapped %d faces." % _face_to_slot.size())
+
+
+func _cache_radius() -> void:
+	var aabb := mesh_instance.get_aabb()
+	# The disc's two large axes. The third is the board's thickness.
+	var sizes := [aabb.size.x, aabb.size.y, aabb.size.z]
+	sizes.sort()
+	_outer_radius = sizes[2] * 0.5   # largest dimension = diameter
+
+
+# --- Public -------------------------------------------------------------
+
+## Which slot does this trimesh face belong to?
+func slot_for_face(face_index: int) -> StringName:
+	return _face_to_slot.get(face_index, &"")
+
+
+## Paint a texture onto one slot. Used for both skins and modifier overlays.
+func paint_slot(slot: StringName, texture: Texture2D) -> void:
+	if not _slot_to_surface.has(slot):
+		push_warning("No slot named '%s'." % slot)
+		return
+
+	var surface: int = _slot_to_surface[slot]
+	var mat := mesh_instance.get_active_material(surface)
+	if mat == null:
+		return
+
+	# Duplicate, or we mutate the shared material from the .glb — which leaks
+	# to every instance AND can get written back to disk in the editor.
+	var unique := mat.duplicate() as StandardMaterial3D
+	unique.albedo_texture = texture
+	unique.albedo_color = Color.WHITE   # don't tint the texture
+	mesh_instance.set_surface_override_material(surface, unique)
+
+
+## Reset a slot to its imported material.
+func clear_slot(slot: StringName) -> void:
+	if not _slot_to_surface.has(slot):
+		return
+	mesh_instance.set_surface_override_material(_slot_to_surface[slot], null)
+
+
+func get_slots() -> Array[StringName]:
+	var out: Array[StringName] = []
+	out.assign(_slot_to_surface.keys())
+	return out
+
+
+## Board radius in local units.
+func outer_radius() -> float:
+	return _outer_radius
+
+
+## Project a LOCAL point onto the board's face plane, returning 2D coords
+## where +Y is "up" on the board (toward the 20).
+##
+## Which two axes those are depends on how the .glb imported. glTF is +Y up,
+## so a board modeled facing +Z in Blender usually lands facing +Z here, with
+## the disc in the X/Y plane. If sector detection is 90 degrees off, this is
+## the function to fix.
+func planar_coords(local_point: Vector3) -> Vector2:
+	var aabb := mesh_instance.get_aabb()
+	var center := aabb.position + aabb.size * 0.5
+
+	# Identify the thin axis — that's the board's normal.
+	var s := aabb.size
+	if s.z <= s.x and s.z <= s.y:
+		return Vector2(local_point.x - center.x, local_point.y - center.y)
+	elif s.y <= s.x and s.y <= s.z:
+		return Vector2(local_point.x - center.x, local_point.z - center.z)
+	else:
+		return Vector2(local_point.z - center.z, local_point.y - center.y)
+
+
+## Debug: what did Blender actually export?
+func print_slots() -> void:
+	var mesh := mesh_instance.mesh
+	print("=== Dartboard slots ===")
+	for i in mesh.get_surface_count():
+		var mat := mesh.surface_get_material(i)
+		print("  surface %2d: '%s'" % [i, mat.resource_name if mat else "(none)"])
+	print("  radius: %.4f  aabb: %s" % [_outer_radius, mesh_instance.get_aabb().size])
+	print("=======================")
@@ -0,0 +1 @@
+uid://cme5xqn2hlrlu
@@ -0,0 +1,45 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://djr5vbnb652ax"
+path="res://.godot/imported/dartboard.glb-8db0957180c245aae0575b1ad098f883.scn"
+
+[deps]
+
+source_file="res://core/board/dartboard.glb"
+dest_files=["res://.godot/imported/dartboard.glb-8db0957180c245aae0575b1ad098f883.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+mesh_library/use_node_names_as_mesh_names=false
+array_mesh/deduplicate_surfaces=true
+nodes/apply_root_scale=true
+nodes/root_scale=1.0
+nodes/import_as_skeleton_bones=false
+nodes/use_name_suffixes=true
+nodes/use_node_type_suffixes=true
+meshes/ensure_tangents=true
+meshes/generate_lods=true
+meshes/create_shadow_meshes=true
+meshes/light_baking=1
+meshes/lightmap_texel_size=0.2
+meshes/force_disable_compression=false
+skins/use_named_skins=true
+animation/import=true
+animation/fps=30
+animation/trimming=false
+animation/remove_immutable_tracks=true
+animation/import_rest_as_RESET=false
+import_script/path=""
+materials/extract=0
+materials/extract_format=0
+materials/extract_path=""
+_subresources={}
+gltf/naming_version=2
+gltf/embedded_image_handling=1
+gltf/texture_map_mode=1
@@ -0,0 +1,27 @@
+[gd_scene format=3 uid="uid://dojbd5wl7ntp0"]
+
+[ext_resource type="Script" uid="uid://cme5xqn2hlrlu" path="res://core/board/dartboard.gd" id="1"]
+[ext_resource type="PackedScene" uid="uid://djr5vbnb652ax" path="res://core/board/dartboard.glb" id="2"]
+[ext_resource type="Shape3D" uid="uid://vr03k1qlo10y" path="res://core/board/dartboard_collision.res" id="3_6aacy"]
+[ext_resource type="Shape3D" uid="uid://c0vqtoe8q7yly" path="res://core/board/spider_collision.res" id="4_khw4q"]
+
+[sub_resource type="PhysicsMaterial" id="PhysicsMaterial_uomu6"]
+friction = 0.15
+bounce = 0.6
+
+[node name="Dartboard" type="StaticBody3D" unique_id=838863701]
+script = ExtResource("1")
+
+[node name="Model" parent="." unique_id=1556270899 instance=ExtResource("2")]
+
+[node name="CollisionShape3D" type="CollisionShape3D" parent="." unique_id=1180985747]
+shape = ExtResource("3_6aacy")
+
+[node name="SpiderBody" type="StaticBody3D" parent="." unique_id=216948518]
+collision_layer = 8
+physics_material_override = SubResource("PhysicsMaterial_uomu6")
+
+[node name="CollisionShape3D" type="CollisionShape3D" parent="SpiderBody" unique_id=1618627145]
+shape = ExtResource("4_khw4q")
+
+[editable path="Model"]
@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://dj6wb70lh5s4f"
+path.s3tc="res://.godot/imported/dartboard_bulls.png-354417d2f083e713950eed8be5c54f73.s3tc.ctex"
+metadata={
+"imported_formats": ["s3tc_bptc"],
+"vram_texture": true
+}
+generator_parameters={
+"md5": "ce1804f3e86fea26503097d5e278c919"
+}
+
+[deps]
+
+source_file="res://core/board/dartboard_bulls.png"
+dest_files=["res://.godot/imported/dartboard_bulls.png-354417d2f083e713950eed8be5c54f73.s3tc.ctex"]
+
+[params]
+
+compress/mode=2
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=true
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=0
@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://da2elnsphlc5i"
+path.s3tc="res://.godot/imported/dartboard_flat_tire.png-97f4bd426c06f71b009cd942664be6fa.s3tc.ctex"
+metadata={
+"imported_formats": ["s3tc_bptc"],
+"vram_texture": true
+}
+generator_parameters={
+"md5": "d24ebe44ff702bdbd5528c9d29427568"
+}
+
+[deps]
+
+source_file="res://core/board/dartboard_flat_tire.png"
+dest_files=["res://.godot/imported/dartboard_flat_tire.png-97f4bd426c06f71b009cd942664be6fa.s3tc.ctex"]
+
+[params]
+
+compress/mode=2
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=true
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=0
@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://cjw6x7ig1ogbo"
+path.s3tc="res://.godot/imported/dartboard_sector_black.png-39f98bf69c481faad6b8976a0994ecb5.s3tc.ctex"
+metadata={
+"imported_formats": ["s3tc_bptc"],
+"vram_texture": true
+}
+generator_parameters={
+"md5": "831beecb2a48df4a1f6850e3e8c938dd"
+}
+
+[deps]
+
+source_file="res://core/board/dartboard_sector_black.png"
+dest_files=["res://.godot/imported/dartboard_sector_black.png-39f98bf69c481faad6b8976a0994ecb5.s3tc.ctex"]
+
+[params]
+
+compress/mode=2
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=true
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=0
@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://cry28pcmt01gk"
+path.s3tc="res://.godot/imported/dartboard_sector_white.png-6dbf28d122f3327d568bcbb29e7f70a0.s3tc.ctex"
+metadata={
+"imported_formats": ["s3tc_bptc"],
+"vram_texture": true
+}
+generator_parameters={
+"md5": "aa25e4080cfa45ac8064cbf217904fb3"
+}
+
+[deps]
+
+source_file="res://core/board/dartboard_sector_white.png"
+dest_files=["res://.godot/imported/dartboard_sector_white.png-6dbf28d122f3327d568bcbb29e7f70a0.s3tc.ctex"]
+
+[params]
+
+compress/mode=2
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=true
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=0
@@ -0,0 +1,44 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://b87cl0ullks7x"
+path.s3tc="res://.godot/imported/dartboard_spider.png-c5fe87c929f66762aaaaefebd3359c9d.s3tc.ctex"
+metadata={
+"imported_formats": ["s3tc_bptc"],
+"vram_texture": true
+}
+generator_parameters={
+"md5": "693560c0ab922fba23ec09a26ead7f48"
+}
+
+[deps]
+
+source_file="res://core/board/dartboard_spider.png"
+dest_files=["res://.godot/imported/dartboard_spider.png-c5fe87c929f66762aaaaefebd3359c9d.s3tc.ctex"]
+
+[params]
+
+compress/mode=2
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=true
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=0