Merge branch 'main' of https://git.richard.work/siim/Bullosseum

.gitignore

@@ -0,0 +1,6 @@
+# Godot 4+ specific ignores
+.godot/
+/android/
+
+# JetBrains IDE — contains absolute paths (Godot binary, SDK dirs), varies per user
+.idea/

.idea/.gitignore

@@ -0,0 +1,15 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Rider ignored files
+/.idea.Bullosseum.iml
+/projectSettingsUpdater.xml
+/contentModel.xml
+/modules.xml
+# Ignored default folder with query files
+/queries/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
+# Editor-based HTTP Client requests
+/httpRequests/

.idea/encodings.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Encoding" addBOMForNewFiles="with BOM under Windows, with no BOM otherwise" />
+</project>

.idea/indexLayout.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="UserContentModel">
+    <attachedFolders />
+    <explicitIncludes />
+    <explicitExcludes />
+  </component>
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

3-rd-person-camera/.gitignore

@@ -1,3 +0,0 @@
-# Godot 4+ specific ignores
-.godot/
-/android/

3-rd-person-camera/Player.tscn

@@ -1,66 +0,0 @@
-[gd_scene format=3 uid="uid://crtm0xtiql3r8"]
-
-[ext_resource type="Script" uid="uid://bn777gguclud5" path="res://player.gd" id="1_xhfnw"]
-[ext_resource type="Script" uid="uid://b4td4k8yo5y78" path="res://camera_spring_arm.gd" id="2_kpjcp"]
-[ext_resource type="Script" uid="uid://b720l6m0ehrj3" path="res://camera_follow.gd" id="3_kne1u"]
-
-[sub_resource type="BoxShape3D" id="BoxShape3D_xhfnw"]
-size = Vector3(1, 1.4072266, 1)
-
-[sub_resource type="BoxMesh" id="BoxMesh_0rwas"]
-
-[sub_resource type="SphereShape3D" id="SphereShape3D_kne1u"]
-radius = 0.3
-
-[node name="Player" type="CharacterBody3D" unique_id=165510044]
-script = ExtResource("1_xhfnw")
-
-[node name="CollisionShape3D" type="CollisionShape3D" parent="." unique_id=1104396769]
-transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, -0.20361328, 0)
-shape = SubResource("BoxShape3D_xhfnw")
-
-[node name="CubeGuy" type="Node3D" parent="." unique_id=1651396216]
-
-[node name="MeshInstance3D" type="MeshInstance3D" parent="CubeGuy" unique_id=367855086]
-mesh = SubResource("BoxMesh_0rwas")
-
-[node name="MeshInstance3D2" type="MeshInstance3D" parent="CubeGuy" unique_id=1565560527]
-transform = Transform3D(0.22778136, 0, 0, 0, 0.4572928, 0, 0, 0, 0.2800231, 0.36544353, -0.65451574, 0)
-mesh = SubResource("BoxMesh_0rwas")
-
-[node name="MeshInstance3D3" type="MeshInstance3D" parent="CubeGuy" unique_id=2097296241]
-transform = Transform3D(0.22778136, 0, 0, 0, 0.4572928, 0, 0, 0, 0.2800231, -0.38543648, -0.65451574, 0)
-mesh = SubResource("BoxMesh_0rwas")
-
-[node name="MeshInstance3D4" type="MeshInstance3D" parent="CubeGuy" unique_id=383816037]
-transform = Transform3D(0.14033328, 0.3601992, 0, -0.17941824, 0.28173247, 0, 0, 0, 0.28002307, -0.60614854, -0.07838535, 0)
-mesh = SubResource("BoxMesh_0rwas")
-
-[node name="MeshInstance3D5" type="MeshInstance3D" parent="CubeGuy" unique_id=326472138]
-transform = Transform3D(-0.14033328, -0.3601992, 2.4480395e-08, -0.17941824, 0.28173247, 0, -1.2268325e-08, -3.1489616e-08, -0.28002307, 0.6122027, -0.07838535, 0)
-mesh = SubResource("BoxMesh_0rwas")
-
-[node name="MeshInstance3D6" type="MeshInstance3D" parent="CubeGuy" unique_id=1642768377]
-transform = Transform3D(-0.113692805, 0, -2.4480393e-08, 0, 0.11736439, 0, 9.939342e-09, 0, -0.28002304, -0.26236355, 0.3103568, 0.42819703)
-mesh = SubResource("BoxMesh_0rwas")
-
-[node name="MeshInstance3D7" type="MeshInstance3D" parent="CubeGuy" unique_id=695468518]
-transform = Transform3D(-0.113692805, 0, -2.4480393e-08, 0, 0.11736439, 0, 9.939342e-09, 0, -0.28002304, 0.2908606, 0.28320956, 0.42819703)
-mesh = SubResource("BoxMesh_0rwas")
-
-[node name="SpringArmPivot" type="Node3D" parent="." unique_id=1671817680]
-transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.22, 0)
-script = ExtResource("2_kpjcp")
-
-[node name="SpringArm3D" type="SpringArm3D" parent="SpringArmPivot" unique_id=141439848]
-collision_mask = 2
-shape = SubResource("SphereShape3D_kne1u")
-spring_length = 7.0
-
-[node name="SpringPosition" type="Node3D" parent="SpringArmPivot/SpringArm3D" unique_id=1307131677]
-
-[node name="Camera3D" type="Camera3D" parent="SpringArmPivot" unique_id=1120161087 node_paths=PackedStringArray("spring_arm")]
-keep_aspect = 0
-script = ExtResource("3_kne1u")
-spring_arm = NodePath("../SpringArm3D/SpringPosition")
-lerp_power = 6.0

3-rd-person-camera/camera_follow.gd

@@ -1,9 +0,0 @@
-extends Camera3D
-
-
-@export var spring_arm: Node3D
-@export var lerp_power: float = 1.0
-
-
-func _process(delta: float) -> void:
-	position = lerp(position, spring_arm.position, delta * lerp_power)

3-rd-person-camera/camera_spring_arm.gd

@@ -1,31 +0,0 @@
-extends Node3D
-
-
-@export var mouse_sensitivity: float = 0.005
-@export_range(-90.0, 0.0, 0.1, "radians_as_degrees") var min_vertical_angle: float = -PI/2
-@export_range(0.0, 90.0, 0.1, "radians_as_degrees") var max_vertical_angle: float = PI/4
-
-@onready var spring_arm := $SpringArm3D
-
-func _ready() -> void:
-	Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)
-
-
-func _unhandled_input(event : InputEvent) -> void:
-	if event is InputEventMouseMotion:
-		rotation.y -= event.relative.x * mouse_sensitivity
-		rotation.y = wrapf(rotation.y, 0.0, TAU)
-
-		rotation.x -= event.relative.y * mouse_sensitivity
-		rotation.x = clamp(rotation.x, min_vertical_angle, max_vertical_angle)
-
-	if event.is_action_pressed("wheel_up"):
-		spring_arm.spring_length -=1
-	if event.is_action_pressed("wheel_down"):
-		spring_arm.spring_length +=1
-		
-	if event.is_action_pressed("toggle_mouse_capture"):
-		if Input.mouse_mode == Input.MOUSE_MODE_CAPTURED:
-			Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
-		else:
-			Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)

3-rd-person-camera/player.gd

@@ -1,28 +0,0 @@
-extends CharacterBody3D
-
-
-const SPEED = 5.0
-const JUMP_VELOCITY = 4.5
-
-
-func _physics_process(delta: float) -> void:
-	# Add the gravity.
-	if not is_on_floor():
-		velocity += get_gravity() * delta
-
-	# Handle jump.
-	if Input.is_action_just_pressed("ui_accept") and is_on_floor():
-		velocity.y = JUMP_VELOCITY
-
-	# Get the input direction and handle the movement/deceleration.
-	# As good practice, you should replace UI actions with custom gameplay actions.
-	var input_dir := Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down")
-	var direction := (transform.basis * Vector3(input_dir.x, 0, input_dir.y)).normalized()
-	if direction:
-		velocity.x = direction.x * SPEED
-		velocity.z = direction.z * SPEED
-	else:
-		velocity.x = move_toward(velocity.x, 0, SPEED)
-		velocity.z = move_toward(velocity.z, 0, SPEED)
-
-	move_and_slide()

3-rd-person-camera/project.godot

@@ -1,41 +0,0 @@
-; Engine configuration file.
-; It's best edited using the editor UI and not directly,
-; since the parameters that go here are not all obvious.
-;
-; Format:
-;   [section] ; section goes between []
-;   param=value ; assign values to parameters
-
-config_version=5
-
-[application]
-
-config/name="3rd_person_camera"
-config/features=PackedStringArray("4.6", "Forward Plus")
-config/icon="res://icon.svg"
-
-[input]
-
-wheel_up={
-"deadzone": 0.2,
-"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":8,"position":Vector2(726, 8),"global_position":Vector2(735, 56),"factor":1.0,"button_index":4,"canceled":false,"pressed":true,"double_click":false,"script":null)
-]
-}
-wheel_down={
-"deadzone": 0.2,
-"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":16,"position":Vector2(400, 21),"global_position":Vector2(409, 69),"factor":1.0,"button_index":5,"canceled":false,"pressed":true,"double_click":false,"script":null)
-]
-}
-toggle_mouse_capture={
-"deadzone": 0.2,
-"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":4,"position":Vector2(461, 22),"global_position":Vector2(470, 70),"factor":1.0,"button_index":3,"canceled":false,"pressed":true,"double_click":false,"script":null)
-]
-}
-
-[physics]
-
-3d/physics_engine="Jolt Physics"
-
-[rendering]
-
-rendering_device/driver.windows="d3d12"

Assets/arena_placeholder_v01.glb.import

@@ -0,0 +1,42 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://dio67r8ambe7h"
+path="res://.godot/imported/arena_placeholder_v01.glb-fc11365d8ec7ae6778e90b13ba508b8a.scn"
+
+[deps]
+
+source_file="res://Assets/arena_placeholder_v01.glb"
+dest_files=["res://.godot/imported/arena_placeholder_v01.glb-fc11365d8ec7ae6778e90b13ba508b8a.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+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

Assets/bull_v10.fbx.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://qy6qrxdfgx2g"
+path="res://.godot/imported/bull_v10.fbx-0bb89c99686d56acf88cf41a200f2277.scn"
+
+[deps]
+
+source_file="res://Assets/bull_v10.fbx"
+dest_files=["res://.godot/imported/bull_v10.fbx-0bb89c99686d56acf88cf41a200f2277.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+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=true
+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={}
+fbx/importer=0
+fbx/allow_geometry_helper_nodes=false
+fbx/embedded_image_handling=1
+fbx/naming_version=2

Blender/bull_v11.blend.import

@@ -0,0 +1,60 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://b203q5pgrk5s3"
+path="res://.godot/imported/bull_v11.blend-0dd387f5e964c51fff069fa50a99986e.scn"
+
+[deps]
+
+source_file="res://Blender/bull_v11.blend"
+dest_files=["res://.godot/imported/bull_v11.blend-0dd387f5e964c51fff069fa50a99986e.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+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={}
+blender/nodes/visible=0
+blender/nodes/active_collection_only=false
+blender/nodes/punctual_lights=true
+blender/nodes/cameras=true
+blender/nodes/custom_properties=true
+blender/nodes/modifiers=1
+blender/meshes/colors=false
+blender/meshes/uvs=true
+blender/meshes/normals=true
+blender/meshes/export_geometry_nodes_instances=false
+blender/meshes/gpu_instances=false
+blender/meshes/tangents=true
+blender/meshes/skins=2
+blender/meshes/export_bones_deforming_mesh_only=false
+blender/materials/unpack_enabled=true
+blender/materials/export_materials=1
+blender/animation/limit_playback=true
+blender/animation/always_sample=true
+blender/animation/group_tracks=true
+gltf/naming_version=2

Blender/matador_v01.blend.import

@@ -0,0 +1,60 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://c6yhxdaba1nho"
+path="res://.godot/imported/matador_v01.blend-ca770df72393bcfc88aeadbf3f984fc9.scn"
+
+[deps]
+
+source_file="res://Blender/matador_v01.blend"
+dest_files=["res://.godot/imported/matador_v01.blend-ca770df72393bcfc88aeadbf3f984fc9.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+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={}
+blender/nodes/visible=0
+blender/nodes/active_collection_only=false
+blender/nodes/punctual_lights=true
+blender/nodes/cameras=true
+blender/nodes/custom_properties=true
+blender/nodes/modifiers=1
+blender/meshes/colors=false
+blender/meshes/uvs=true
+blender/meshes/normals=true
+blender/meshes/export_geometry_nodes_instances=false
+blender/meshes/gpu_instances=false
+blender/meshes/tangents=true
+blender/meshes/skins=2
+blender/meshes/export_bones_deforming_mesh_only=false
+blender/materials/unpack_enabled=true
+blender/materials/export_materials=1
+blender/animation/limit_playback=true
+blender/animation/always_sample=true
+blender/animation/group_tracks=true
+gltf/naming_version=2

Blender/matador_v02.blend.import

@@ -0,0 +1,60 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://cbkylf6ba2qmw"
+path="res://.godot/imported/matador_v02.blend-78c935c19487a89cf2e8e43e696513b9.scn"
+
+[deps]
+
+source_file="res://Blender/matador_v02.blend"
+dest_files=["res://.godot/imported/matador_v02.blend-78c935c19487a89cf2e8e43e696513b9.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+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={}
+blender/nodes/visible=0
+blender/nodes/active_collection_only=false
+blender/nodes/punctual_lights=true
+blender/nodes/cameras=true
+blender/nodes/custom_properties=true
+blender/nodes/modifiers=1
+blender/meshes/colors=false
+blender/meshes/uvs=true
+blender/meshes/normals=true
+blender/meshes/export_geometry_nodes_instances=false
+blender/meshes/gpu_instances=false
+blender/meshes/tangents=true
+blender/meshes/skins=2
+blender/meshes/export_bones_deforming_mesh_only=false
+blender/materials/unpack_enabled=true
+blender/materials/export_materials=1
+blender/animation/limit_playback=true
+blender/animation/always_sample=true
+blender/animation/group_tracks=true
+gltf/naming_version=2

Blender/matador_v02.fbx.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://qix7axtc0lf3"
+path="res://.godot/imported/matador_v02.fbx-220033ca52e262349a727eddc79dcf22.scn"
+
+[deps]
+
+source_file="res://Blender/matador_v02.fbx"
+dest_files=["res://.godot/imported/matador_v02.fbx-220033ca52e262349a727eddc79dcf22.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+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=true
+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={}
+fbx/importer=0
+fbx/allow_geometry_helper_nodes=false
+fbx/embedded_image_handling=1
+fbx/naming_version=2

CLAUDE.md

@@ -0,0 +1,59 @@
+# Bullosseum — CLAUDE.md
+
+## About this project
+
+A 3D arena game built in Godot 4.7 (Forward Plus renderer, Jolt Physics) where the player controls a bull. Currently features third-person camera, bull movement with charge mechanics, and a placeholder arena.
+
+## AI role
+
+I am a **Godot 4.6+ expert**. I follow current best practices for GDScript, scene architecture, physics, and performance. If a question suggests a suboptimal approach — wrong node type, unnecessary complexity, a pattern that fights the engine — I will say so and explain the better alternative before implementing anything.
+
+## Project structure
+
+| Path | Purpose |
+|---|---|
+| `scene.tscn` | Main scene (arena + player) |
+| `Player.tscn` | Player scene root (`CharacterBody3D`) |
+| `player.gd` | Movement, charge, turning logic |
+| `camera_spring_arm.gd` | Mouse-look pivot (`Node3D` + `SpringArm3D`) |
+| `camera_follow.gd` | Smooth camera follow (`Camera3D`) |
+| `Assets/` | Raw 3D assets (`.glb`, `.fbx`) |
+| `addons/rider-plugin/` | JetBrains Rider IDE integration |
+
+## Tech choices
+
+- **Physics:** Jolt Physics (not the default Godot Physics)
+- **Renderer:** Forward Plus
+- **Input map:** WASD + arrow keys, Shift = charge, Space = jump, scroll = zoom, middle-click = toggle mouse capture
+- **IDE:** JetBrains Rider via the rider-plugin addon
+
+## GDScript conventions
+
+- Typed GDScript everywhere (`var x: float`, return types on functions)
+- `@onready` for node references; never `get_node()` strings when avoidable
+- Constants in `SCREAMING_SNAKE_CASE`, variables in `snake_case`
+- One script per scene root — keep scripts focused
+- Signal names in `snake_case`; connect via `signal.connect()` not the legacy string form
+- Prefer `_physics_process` for physics/movement, `_process` for visuals/camera, `_unhandled_input` for input that shouldn't bubble
+- No comments that restate what the code already says; only comment non-obvious constraints or workarounds
+
+## Best practices to enforce
+
+- Use `CharacterBody3D` for player-controlled characters, not `RigidBody3D` (unless the design specifically needs physics simulation)
+- Use `SpringArm3D` for third-person cameras to get free collision avoidance
+- Prefer `move_and_slide()` with `velocity` over manual collision queries
+- Export variables (`@export`) for any value a designer might tune; keep magic numbers out of logic
+- Scene composition over inheritance — build behaviour from small focused scenes
+- Use `autoload` (singletons) sparingly: only for truly global state (e.g. GameManager, AudioBus); not as a shortcut for passing data
+- Keep `_physics_process` deterministic and frame-rate independent (always multiply by `delta`)
+- Prefer signals over direct node references for decoupling
+
+## Godot 4.x specifics
+
+- `wrapf` / `wrap` instead of manual modulo for angles
+- `lerp_angle` for smooth rotation interpolation (handles wrap-around correctly)
+- `move_toward` for speed ramps without overshooting
+- `PackedStringArray`, `PackedVector3Array`, etc. for performance-sensitive arrays
+- `@tool` scripts for editor helpers only — don't use in gameplay scripts
+- Resource (`extends Resource`) for shared data/config; no plain `Dictionary` for structured data
+- `StringName` (`&"action_name"`) for input action lookups in hot paths

DESIGN.md

@@ -0,0 +1,205 @@
+# Bullosseum — Game Design Document
+
+> Living document. `?` marks open questions.
+
+---
+
+## Elevator Pitch
+
+You are the bull. Waves of cowboys, matadors, and gladiators pour into your arena — each with their own tricks to dodge or counter your charge. Survive, wreck things, pick upgrades. Every run is different. Goofy low-poly mayhem.
+
+---
+
+## Art Direction
+
+- **Style:** Low-poly, chunky geometry, flat or minimal shading
+- **Tone:** Goofy and physical — think *Gang Beasts* meets *Vampire Survivors* energy
+- **Camera:** Third-person, spring-arm collision avoidance
+- **Palette:** Warm sand/terracotta arena, vivid faction colours (red/gold for matadors, brown/blue for cowboys, iron/purple for gladiators)
+- **Particles:** Stylised cartoon puffs — dust, impact sparks, ragdoll stars
+- **Audio direction:** ?
+
+---
+
+## Confirmed Mechanics
+
+- Third-person bull locomotion with momentum (walk, charge)
+- Wide committed turning arc during charge — charges feel like commitments
+- Visual turn lag (body leans)
+- Spring-arm camera with zoom
+- Sand dust particles at hooves (walk = small, charge = big)
+- Jolt Physics backend
+
+---
+
+## Run Structure (Vampire Survivors-inspired)
+
+```
+Start run → Wave spawns → Kill enemies → Wave cleared → Pick upgrade → Next wave → ... → Die or achieve target
+```
+
+- **No hard time limit per wave** — pressure comes from enemy density escalating
+- **Upgrade picks between waves** — choose 1 of 3 options (stat, ability, passive synergy)
+- **Fail state is soft** — getting overwhelmed is a death spiral, not a timeout. You stop being able to charge effectively and get cornered
+- **Run length:** ? (15–25 minutes for a full run feels right for web)
+- **Meta progression:** ? Unlock new starting abilities or bull cosmetics across runs
+
+### Wave Escalation — Faction Ramp
+
+Factions are introduced one at a time so each mechanic gets space to teach itself before mixing begins.
+
+| Waves | Faction makeup | Boss |
+|---|---|---|
+| 1–3 | Matadors only | — |
+| 4 | Matadors only | El Presidente |
+| 5–7 | Matadors + Cowboys introduced | — |
+| 8 | Mixed (matadors + cowboys) | Sheriff |
+| 9–11 | All three factions introduced | — |
+| 12 | Mixed (all three) | Centurion |
+| 13+ | Full chaos — all factions, escalating density | Repeat bosses + ? final boss |
+
+- Each new faction's first wave is a "pure" wave so the player can learn the pattern before it mixes
+- Bosses appear solo — the arena clears before a boss spawns, making it feel like a duel
+- ? After wave 12, does a loop begin (harder repeat) or does a final boss end the run?
+
+---
+
+## Enemy Factions
+
+### Matadors (the classics)
+The trickiest faction — they're designed around baiting your charge.
+
+| Enemy | Behaviour |
+|---|---|
+| Matador | Waves red cape to draw your charge, sidesteps at last moment. Must catch them off-guard or predict the dodge |
+| Banderillero | Plants slow-flags in the ground — charges into one stuns the bull briefly |
+| Picador | Mounted on horse, tanky, slow. Horse must be hit first before the rider is vulnerable |
+| ? El Presidente (boss) | Summons matadors and teleports around the arena in bursts |
+
+### Cowboys
+The herd faction — individually easy, dangerous in groups.
+
+| Enemy | Behaviour |
+|---|---|
+| Cowboy | Throws lasso to root you for 1–2s, then runs. Easy to hit, just annoying |
+| Wrangler | Herds other enemies toward you — a force multiplier |
+| Mounted Cowboy | Circles you on horseback, throwing dynamite. Must cut off the riding arc |
+| ? Sheriff (boss) | Shotgun blast that staggers the bull; spawns deputies on death |
+
+### Gladiators
+The armour faction — charge angles matter.
+
+| Enemy | Behaviour |
+|---|---|
+| Legionary | Front shield absorbs charges completely. Must hit from the side or behind |
+| Net-thrower | Long-range root that holds you in place for 3s |
+| Archer | Stationary on elevated platform (arena wall edge), fires slowing arrows |
+| ? Centurion (boss) | Buffs nearby gladiators, has a charge-reflect shield that bounces you back |
+
+---
+
+## Ability System
+
+Three slots total — always the same structure, filled differently every run.
+
+```
+[Charge ──────────] [Medium  □] [Ultimate  □]
+   always on           1 slot      1 slot
+```
+
+### Slot 1 — Charge (always on)
+| | Description |
+|---|---|
+| **Charge** | Hold to build, release to sprint. Committed arc, hard to steer. The foundation everything else is built around |
+
+### Slot 2 — Medium Ability
+Cooldown ~8–15s. Tactical, reactive, fills gaps that charge can't. One equipped at a time.
+
+| Ability | Description | Good against |
+|---|---|---|
+| **Stomp** | Slam front hooves — short-range AoE stun | Matador clusters, anything close |
+| **Gore** | Upward headbutt — launches a single target | Shielded gladiators (bypasses front shield) |
+| **Tail Whip** | 360° sweep behind and to the sides | Cowboys lassooing from behind |
+| **Bull Roar** | Knockback shockwave — no damage, pure space creation | Net-throwers, tight groups |
+| **Ground Pound** | From a jump, landing creates a shockwave crater | Mounted enemies (dismounts them) |
+| **Counter** | Narrow window — if you charge as an attack lands, explosive ricochet | Picadors, centurion reflect |
+
+### Slot 3 — Ultimate Ability
+Cooldown ~35–50s, or requires a full charge meter. High impact. One equipped at a time.
+
+| Ability | Description | Good against |
+|---|---|---|
+| **Stampede** | ~5s of zero deceleration — can't stop or steer well, flattens everything in the path | Boss phases, dense waves |
+| **Enrage** | ~8s berserk: charge speed +60%, hitbox wider, ignores all slows and roots | Lasso/net-heavy waves |
+| **Red Mist** | Every enemy on screen gets a red target marker and is pulled slightly toward you — brief guaranteed hits | Matador dodge phase |
+| **Thunder Horn** | Next charge is electrified — chains damage to up to 4 nearby enemies on contact | Gladiator formations |
+| **Call of the Herd** | Summon 3 ghost bulls that charge in parallel alongside you for 6s | Any — pure chaos |
+
+### Card Pick Screen (between every wave)
+Game pauses. Three cards shown — pick one.
+
+| Card type | Examples |
+|---|---|
+| **New medium** | Swap current medium for a different one |
+| **New ultimate** | Swap current ultimate for a different one |
+| **Stat boost** | +charge speed, +turn rate, −medium cooldown, −ultimate cooldown |
+| **Passive modifier** | Changes how your *current* ability behaves (see below) |
+| **Synergy** | Unlocks a cross-ability combo effect |
+
+**Passive modifier examples:**
+- Stomp → "Dust Blind" — stun cloud also blocks enemy vision for 2s
+- Gore → "Pinball" — launched enemy bounces off walls and damages others on landing
+- Stampede → "Aftershock" — leaves a trembling ground trail that slows enemies for 5s
+- Enrage → "Bloodlust" — kills during enrage reduce remaining cooldown
+
+**Synergy examples:**
+- Charge + Stomp = "Seismic Run" — charging for 2s+ turns your next stomp into a ground wave
+- Gore + Thunder Horn = "Lightning Rod" — electrified gore sends a chain to the whole group
+- ? Others to discover during design
+
+---
+
+## Arena Design
+
+Each faction maps to an arena environment. Mixed-faction waves could transition the arena or blend themes.
+
+| Faction | Arena | Hazards |
+|---|---|---|
+| Matadors | Sand bullring, wooden barrier ring | Flags slow movement, open centre is the danger zone |
+| Cowboys | Frontier rodeo grounds, hay bales, fences | Lasso posts (rope traps), horse stampede lanes |
+| Gladiators | Roman colosseum, stone floor, iron gates | Archer towers on walls, spike traps, wet stone (slide) |
+
+- ? Does the arena change mid-run or is one arena selected at run start?
+- ? Destructible fence/barrier sections throughout?
+
+---
+
+## Core Loop Revisited
+
+```
+Move → Spot threat pattern → Position approach angle → Charge/Ability → Chain hits → Wave clear
+         ↑                                                                                  ↓
+    Dodge/react to debuffs (lasso, net, slow-flag)                            Pick upgrade (1 of 3)
+```
+
+The **positioning** step is where skill expression lives: which enemy to hit first, what angle to approach a shielded gladiator, whether to charge the matador or fake him out.
+
+---
+
+## Open Questions
+
+1. **Meta progression** — cosmetic unlocks only, or do you unlock new starting medium/ultimate options across runs?
+2. **Arena change** — single arena per run, or does the arena theme shift when a new faction is introduced mid-run?
+3. **After wave 12** — infinite loop with scaling difficulty, or a final boss that ends the run cleanly?
+4. **Ability replacement** — when you pick a new medium/ultimate card, does it always replace the slot, or can you upgrade an existing ability through repeated picks (level 1→2→3)?
+5. **Web scope** — vertical slice (matadors only, 4 waves, one ability tree) or full 12-wave game?
+
+---
+
+## References
+
+- *Vampire Survivors* — wave escalation, upgrade pick loop, run length
+- *Gang Beasts* — ragdoll slapstick commitment
+- *Katamari* / *Donut County* — simple core verb scaled through variety
+- *Superhot* — charge-as-commitment, every move mattering
+- *Cult of the Lamb* — faction variety with distinct visual languages

Matador.tscn

@@ -0,0 +1,29 @@
+[gd_scene format=3 uid="uid://matador_scene_v1"]
+
+[ext_resource type="Script" path="res://matador.gd" id="1_matgd"]
+[ext_resource type="PackedScene" uid="uid://qix7axtc0lf3" path="res://Blender/matador_v02.fbx" id="2_matfbx"]
+
+[sub_resource type="CapsuleShape3D" id="CapsuleShape3D_body"]
+radius = 0.25
+height = 1.2
+
+[sub_resource type="CapsuleShape3D" id="CapsuleShape3D_hit"]
+radius = 0.45
+height = 1.4
+
+[node name="Matador" type="CharacterBody3D"]
+script = ExtResource("1_matgd")
+
+[node name="CollisionShape3D" type="CollisionShape3D" parent="."]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.85, 0)
+shape = SubResource("CapsuleShape3D_body")
+
+[node name="HitArea" type="Area3D" parent="."]
+monitoring = true
+monitorable = false
+
+[node name="CollisionShape3D" type="CollisionShape3D" parent="HitArea"]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.85, 0)
+shape = SubResource("CapsuleShape3D_hit")
+
+[node name="matador_v02" parent="." instance=ExtResource("2_matfbx")]

Player.tscn

@@ -0,0 +1,57 @@
+[gd_scene format=3 uid="uid://crtm0xtiql3r8"]
+
+[ext_resource type="Script" uid="uid://bn777gguclud5" path="res://player.gd" id="1_xhfnw"]
+[ext_resource type="Script" uid="uid://b4td4k8yo5y78" path="res://camera_spring_arm.gd" id="2_kpjcp"]
+[ext_resource type="Script" uid="uid://b720l6m0ehrj3" path="res://camera_follow.gd" id="3_kne1u"]
+[ext_resource type="PackedScene" uid="uid://qy6qrxdfgx2g" path="res://Assets/bull_v10.fbx" id="4_e80uo"]
+
+[sub_resource type="SphereShape3D" id="SphereShape3D_kne1u"]
+radius = 0.5
+
+[sub_resource type="SphereShape3D" id="SphereShape3D_chest"]
+radius = 0.35
+
+[sub_resource type="SphereShape3D" id="SphereShape3D_belly"]
+radius = 0.40
+
+[sub_resource type="SphereShape3D" id="SphereShape3D_hips"]
+radius = 0.30
+
+[node name="Player" type="CharacterBody3D" unique_id=165510044]
+collision_layer = 3
+script = ExtResource("1_xhfnw")
+
+[node name="CollisionChest" type="CollisionShape3D" parent="."]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, -0.2)
+shape = SubResource("SphereShape3D_chest")
+
+[node name="CollisionBelly" type="CollisionShape3D" parent="."]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0.1)
+shape = SubResource("SphereShape3D_belly")
+
+[node name="CollisionHips" type="CollisionShape3D" parent="."]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0.4)
+shape = SubResource("SphereShape3D_hips")
+
+[node name="SpringArmPivot" type="Node3D" parent="." unique_id=1671817680]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.22, 0)
+script = ExtResource("2_kpjcp")
+
+[node name="SpringArm3D" type="SpringArm3D" parent="SpringArmPivot" unique_id=141439848]
+collision_mask = 3
+shape = SubResource("SphereShape3D_kne1u")
+spring_length = 7.0
+margin = 0.5
+
+[node name="SpringPosition" type="Node3D" parent="SpringArmPivot/SpringArm3D" unique_id=1307131677]
+
+[node name="Camera3D" type="Camera3D" parent="SpringArmPivot" unique_id=1120161087 node_paths=PackedStringArray("spring_arm")]
+keep_aspect = 0
+script = ExtResource("3_kne1u")
+spring_arm = NodePath("../SpringArm3D/SpringPosition")
+lerp_power = 6.0
+
+[node name="bull_v10" parent="." unique_id=1386495166 instance=ExtResource("4_e80uo")]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, -0.655, 0.23)
+
+[editable path="bull_v10"]

addons/rider-plugin/CONTRIBUTING.md

@@ -0,0 +1,33 @@
+# Contribution
+
+Hello, thanks for taking time and helping out with the addon!
+
+Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. Please sign the CLA before sending the PR: https://www.jetbrains.com/agreements/cla/.
+
+#### Local setup
+
+Open the `godot-editor-plugin/CMakeLists.txt` in Rider 2026.1+, select `rider-gdextension` target in the run configuration selector.
+There are some more fixes coming in 2026.2, which will allow working on gdscript and cpp files within the same workspace.
+
+#### Signing the binaries
+
+Plugin binaries need to be signed to comply with modern operating system security requirements. Unsigned dynamic libraries may fail to load or trigger security warnings:
+
+- **macOS**: Requires code signing (and often notarization) for `.dylib` files. Unsigned libraries may simply fail to load.
+- **Windows**: SmartScreen may block unsigned binaries, and corporate environments often enforce signed code only.
+- **Linux**: Generally allows unsigned `.so` files, but some sandboxed environments (Flatpak, Snap) impose restrictions.
+
+**How signing is implemented:**
+
+1. **TeamCity Configuration**: [ijplatform_master_Net_Deploy_Plugins_Public_Godot](https://buildserver.labs.intellij.net/buildConfiguration/ijplatform_master_Net_Deploy_Plugins_Public_Godot) (internal JetBrains link)
+   - Note: The automatic trigger on new tags is currently not working, so manual triggering is required.
+
+2. **Release Process**:
+   - First, use your GitHub Action to prepare a **pre-release** with a tag
+   - Manually trigger the TeamCity configuration on the necessary branch/tag
+   - The configuration will download assets, sign them, and upload them back (removing the pre-release flag)
+   - The pre-release flag is required at the start; otherwise, the signing configuration will skip the release (protection against double signing)
+
+3. **Signing existing releases**:
+   - You can run signing on already existing old releases/tags
+   - Mark them as pre-release first, then run the configuration on the necessary tag

addons/rider-plugin/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 JetBrains
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

addons/rider-plugin/README.md

@@ -0,0 +1,51 @@
+# JetBrains Rider Integration – Godot addon
+
+This addon currently provides two features:
+1. Finds all Rider installations in the system and provides a selector on the `Text Editor` -> `External` tab in the settings to select one.
+2. Provides the "Use Rider" toggle in the Godot toolbar and, when enabled, applies a set of editor settings recommended for working with JetBrains Rider. The goal is to make it trivial to switch between Rider‑optimized settings and stock Godot settings with a single click.
+
+## Quick start
+
+Requirements:
+- Godot 4.2.2+
+
+Install:
+1. Inside the Godot editor, it can be installed from the AssetLib view or [downloaded](https://godotengine.org/asset-library/asset/4576)
+2. [Optional] Change the initial value of `active` in the plugin.cfg
+3. [Optional] Change the initial values in the presets.json file.
+4. Enable "JetBrains Rider External Editor" plugin in the Project → Project Settings… → Plugins tab.
+
+Use:
+- A toolbar toggle named "Use Rider" will appear. Click it to turn the preset On/Off.
+
+Screenshot:
+![Toolbar toggle](screenshots/Toolbar.png)
+
+## What the toggle changes
+
+The preset values live in `presets.json`.
+
+When ON:
+- Write the values from the "on" preset into the Editor Settings.
+
+When OFF:
+- Write the values from the "off" preset into the Editor Settings.
+
+Note: The plugin does not currently auto‑set Rider’s executable path or flags. See Plans below.
+
+## Setting Rider to be the external editor
+
+The plugin automatically detects installed Rider versions on your system and provides a convenient dropdown menu to
+select which installation to use as your external editor.
+
+- The plugin scans common installation locations for Rider on Windows, macOS, and Linux.
+- Detected installations appear in the "Select Rider" dropdown in the toolbar.
+- When you select a Rider installation, the plugin automatically updates the `dotnet/editor/external_editor_path` editor
+  setting.
+
+## License
+See `addons/rider-plugin/LICENCE`.
+
+## Acknowledgements
+Created by JetBrains to streamline using Rider with Godot. 
+Initial idea https://github.com/sszigeti/toggle_external_editor

addons/rider-plugin/bin/rider-plugin.gdextension

@@ -0,0 +1,16 @@
+[configuration]
+
+entry_symbol = "rider_library_init"
+compatibility_minimum = "4.2.2"
+
+[libraries]
+
+macos.single.debug = "./macos/librider-gdextension.macos.editor.dylib"
+
+windows.arm64.single.debug = "./windows/rider-gdextension.windows.editor.arm64.dll"
+
+windows.x86_64.single.debug = "./windows/rider-gdextension.windows.editor.x86_64.dll"
+
+linux.x86_64.single.debug = "./linux/librider-gdextension.linux.editor.x86_64.so"
+
+linux.arm64.single.debug = "./linux/librider-gdextension.linux.editor.arm64.so"

addons/rider-plugin/icons/icon.svg

@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generator: Adobe Illustrator 25.4.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+
+<svg
+   version="1.0"
+   id="katman_1"
+   x="0px"
+   y="0px"
+   viewBox="0 0 512 512"
+   xml:space="preserve"
+   sodipodi:docname="JetBrains Rider Icon.svg"
+   width="512"
+   height="512"
+   inkscape:version="1.1.1 (3bf5ae0d25, 2021-09-20)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"><defs
+   id="defs43" /><sodipodi:namedview
+   id="namedview41"
+   pagecolor="#505050"
+   bordercolor="#ffffff"
+   borderopacity="1"
+   inkscape:pageshadow="0"
+   inkscape:pageopacity="0"
+   inkscape:pagecheckerboard="1"
+   showgrid="false"
+   inkscape:zoom="1.0980553"
+   inkscape:cx="256.36233"
+   inkscape:cy="212.19333"
+   inkscape:window-width="1920"
+   inkscape:window-height="1027"
+   inkscape:window-x="-8"
+   inkscape:window-y="22"
+   inkscape:window-maximized="1"
+   inkscape:current-layer="katman_1" />
+<style
+   type="text/css"
+   id="style2">
+	.st0{fill:url(#SVGID_1_);}
+	.st1{fill:url(#SVGID_00000130622934180993703410000017420799098261276343_);}
+	.st2{fill:url(#SVGID_00000060739771362873723200000017991140373209755022_);}
+	.st3{fill:#FFFFFF;}
+</style>
+<symbol
+   id="rider"
+   viewBox="-35 -35 70 70">
+	<linearGradient
+   id="SVGID_1_"
+   gradientUnits="userSpaceOnUse"
+   x1="30.4897"
+   y1="5.1188998"
+   x2="-23.4683"
+   y2="-25.8451">
+		<stop
+   offset="0"
+   style="stop-color:#DD1265"
+   id="stop4" />
+		<stop
+   offset="0.483"
+   style="stop-color:#DD1265"
+   id="stop6" />
+		<stop
+   offset="0.942"
+   style="stop-color:#FDB60D"
+   id="stop8" />
+	</linearGradient>
+	<path
+   class="st0"
+   d="M 35,-7.7 -14.1,-35 18.8,13.9 25.5,9.5 Z"
+   id="path11" />
+	
+		<linearGradient
+   id="SVGID_00000169517474296634577950000016895268102491994795_"
+   gradientUnits="userSpaceOnUse"
+   x1="-1.5839"
+   y1="-28.888"
+   x2="19.805099"
+   y2="30.174999">
+		<stop
+   offset="0.139"
+   style="stop-color:#087CFA"
+   id="stop13" />
+		<stop
+   offset="0.476"
+   style="stop-color:#DD1265"
+   id="stop15" />
+		<stop
+   offset="0.958"
+   style="stop-color:#087CFA"
+   id="stop17" />
+	</linearGradient>
+	<path
+   style="fill:url(#SVGID_00000169517474296634577950000016895268102491994795_)"
+   d="M 15.5,-18.9 9.3,-33.9 -4.3,-20.5 1.2,28.1 14.4,35 35,23 Z"
+   id="path20" />
+	
+		<linearGradient
+   id="SVGID_00000135668350575375336630000014638141720088491653_"
+   gradientUnits="userSpaceOnUse"
+   x1="-17.5865"
+   y1="-27.071199"
+   x2="-1.7875"
+   y2="29.073799">
+		<stop
+   offset="0.278"
+   style="stop-color:#DD1265"
+   id="stop22" />
+		<stop
+   offset="0.968"
+   style="stop-color:#FDB60D"
+   id="stop24" />
+	</linearGradient>
+	<path
+   style="fill:url(#SVGID_00000135668350575375336630000014638141720088491653_)"
+   d="m -14.1,-35 -20.9,14.1 7.8,48.1 20.1,7.7 26,-21 z"
+   id="path27" />
+	<path
+   d="M 21,-21 H -21 V 21 H 21 Z"
+   id="path29" />
+	<path
+   class="st3"
+   d="m -0.6,13.6 h -15.8 v 2.7 h 15.8 z"
+   id="path31" />
+	<path
+   class="st3"
+   d="m 0.5,-15.8 h 6.2 c 5,0 8.4,3.4 8.4,7.7 0,4.4 -3.4,7.9 -8.4,7.9 L 0.5,0 Z m 3.5,3.2 v 9.5 h 2.7 c 2.8,0 4.8,-1.9 4.8,-4.6 0,-2.8 -1.9,-4.7 -4.8,-4.7 z"
+   id="path33" />
+	<path
+   class="st3"
+   d="m -15.7,-15.8 h 7.2 c 2,0 3.5,0.6 4.6,1.6 0.9,0.9 1.3,2.1 1.3,3.6 v 0.1 c 0,1.3 -0.3,2.3 -0.9,3.1 -0.6,0.8 -1.4,1.4 -2.4,1.8 L -2,0 h -4.1 l -3.3,-4.8 h -2.9 V 0 h -3.5 z m 7,7.7 c 0.8,0 1.5,-0.2 2,-0.6 0.5,-0.4 0.7,-1 0.7,-1.6 v -0.1 c 0,-0.8 -0.2,-1.3 -0.7,-1.7 -0.5,-0.3 -1.1,-0.6 -2,-0.6 h -3.4 v 4.5 h 3.4 z"
+   id="path35" />
+</symbol>
+<use
+   xlink:href="#rider"
+   width="70"
+   height="70"
+   x="-35"
+   y="-35"
+   transform="matrix(7.0682519,0,0,7.2481031,256,256)"
+   style="overflow:visible"
+   id="use38" />
+</svg>

addons/rider-plugin/icons/icon.svg.import

@@ -0,0 +1,43 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://wrdrj6wednn8"
+path="res://.godot/imported/icon.svg-45c914cff7482ba9564963fe65b548e4.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/rider-plugin/icons/icon.svg"
+dest_files=["res://.godot/imported/icon.svg-45c914cff7482ba9564963fe65b548e4.ctex"]
+
+[params]
+
+compress/mode=0
+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=false
+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=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

addons/rider-plugin/plugin.cfg

@@ -0,0 +1,12 @@
+[plugin]
+
+name="JetBrains Rider External Editor"
+description="Provides a toolbar toggle, to switch a set of settings on and off. Default set of settings helps to enable/disable the following settings recommended by the Rider documentation https://www.jetbrains.com/help/rider/Godot.html#optimize-godot-editor-for-rider"
+author="JetBrains"
+version="1.0.0"
+script="rider-plugin.gd"
+
+[presets]
+
+active="off"
+presets="presets.json"

addons/rider-plugin/presets.json

@@ -0,0 +1,15 @@
+{
+  "on": {
+    "text_editor/external/use_external_editor": true,
+    "interface/editor/import_resources_when_unfocused": true,
+    "interface/editor/save_on_focus_loss": true,
+    "text_editor/behavior/files/auto_reload_scripts_on_external_change": true,
+    "run/window_placement/game_embed_mode": -1
+  },
+  "off": {
+    "text_editor/external/use_external_editor": false,
+    "interface/editor/import_resources_when_unfocused": false,
+    "interface/editor/save_on_focus_loss": false,
+    "text_editor/behavior/files/auto_reload_scripts_on_external_change": false
+  }
+}

addons/rider-plugin/rider-plugin.gd

@@ -0,0 +1,66 @@
+@tool
+extends EditorPlugin
+
+var editor_settings: EditorSettings
+var checkbutton: CheckButton
+var _preset_applier: PresetApplier
+var _settings_service: EditorSettingsService
+var _locator_service: RiderLocatorService
+var _plugin_cfg_path: String
+var _presets_json_path: String
+
+func _enter_tree() -> void:
+	editor_settings = EditorInterface.get_editor_settings()
+	var script_path := (get_script() as Script).resource_path
+	var plugin_dir := script_path.get_base_dir()
+	_plugin_cfg_path = plugin_dir + "/plugin.cfg"
+	var cfg := ConfigFile.new()
+	var err := cfg.load(_plugin_cfg_path)
+	if err != OK:
+		push_warning("Failed to load plugin.cfg: %s" % [err])
+		return
+	var active_str := str(cfg.get_value("presets", "active", "on"))
+	var is_active := active_str == "on"
+	var presets_rel_path := str(cfg.get_value("presets", "presets", "presets.json"))
+	_presets_json_path = plugin_dir + "/" + presets_rel_path
+
+	# Build UI
+	checkbutton = CheckButton.new()
+	checkbutton.text = "Use Rider"
+	checkbutton.tooltip_text = "Shortcut for setting recommended settings"
+	checkbutton.button_pressed = is_active
+	checkbutton.pressed.connect(_on_checkbutton_pressed)
+	add_control_to_container(EditorPlugin.CONTAINER_TOOLBAR, checkbutton)
+
+	# Initialize services and panel
+	_settings_service = EditorSettingsService.new()
+	_locator_service = RiderLocatorService.new()
+	_preset_applier = PresetApplier.new(_presets_json_path)
+
+	_locator_service.add_selector_in_editor_interface(_settings_service)
+
+	# Ensure settings reflect current state on startup
+	_preset_applier.apply_preset(editor_settings, is_active)
+
+func _on_checkbutton_pressed() -> void:
+	var cfg := ConfigFile.new()
+	if cfg.load(_plugin_cfg_path) != OK:
+		push_warning("Failed to load plugin.cfg to update state")
+		return
+	var is_active := checkbutton.button_pressed
+	var key := _preset_applier.get_preset_key(is_active)
+	cfg.set_value("presets", "active", key)
+	var save_err := cfg.save(_plugin_cfg_path)
+	if save_err != OK:
+		push_warning("Failed to save plugin.cfg: %s" % [save_err])
+	# Apply selected preset to editor settings
+	_preset_applier.apply_preset(editor_settings, is_active)
+
+func _exit_tree() -> void:
+	if checkbutton != null:
+		remove_control_from_container(EditorPlugin.CONTAINER_TOOLBAR, checkbutton)
+		checkbutton.queue_free()
+		
+	var args = OS.get_cmdline_args()
+	if "--rider-addon-tests" in args:
+		print("==== rider-addon-tests finished ====")

addons/rider-plugin/rider-plugin.gd.uid

@@ -0,0 +1 @@
+uid://c1x58xm2w1n20

addons/rider-plugin/screenshots/Toolbar.png.import

@@ -0,0 +1,40 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://bro2w3ghx4xt7"
+path="res://.godot/imported/Toolbar.png-a521e2493bd3c08a829245b3129bb58f.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/rider-plugin/screenshots/Toolbar.png"
+dest_files=["res://.godot/imported/Toolbar.png-a521e2493bd3c08a829245b3129bb58f.ctex"]
+
+[params]
+
+compress/mode=0
+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=false
+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=1

addons/rider-plugin/scripts/json_utils.gd

@@ -0,0 +1,23 @@
+@tool
+## Simple JSON helpers for editor/runtime use.
+## Keeps file and JSON parsing concerns out of feature code.
+class_name JsonUtils
+
+static func load_from_file(path: String) -> Variant:
+	# Returns parsed JSON value (Dictionary/Array/etc.) or null on error.
+	var file := FileAccess.open(path, FileAccess.READ)
+	if file == null:
+		push_warning("JsonUtils: Failed to open file: %s" % path)
+		return null
+	var text := file.get_as_text()
+	file.close()
+	var data: Variant = JSON.parse_string(text)
+	if data == null:
+		push_warning("JsonUtils: Invalid JSON in file: %s" % path)
+		return null
+	return data
+
+static func load_dict_from_file(path: String) -> Dictionary:
+	# Returns Dictionary or empty {} on error.
+	var data := load_from_file(path) as Dictionary
+	return data

addons/rider-plugin/scripts/json_utils.gd.uid

@@ -0,0 +1 @@
+uid://bci4kmk7h4j6a

addons/rider-plugin/scripts/locator/rider_locator_service.gd

@@ -0,0 +1,112 @@
+@tool
+extends RefCounted
+class_name RiderLocatorService
+
+var _installations_found: Array = []
+var _thread: Thread = null
+
+func get_installations() -> Array:
+	var result: Array = RiderLocator.new().get_installations() # from the gdextension
+	return result
+
+# todo
+func fix_external_editor_if_supplied_in_commandline(_settings_service: EditorSettingsService, editor_settings: EditorSettings) -> bool:
+	# When Godot is started from Rider (or vice versa), we may receive the Rider path
+	# via command-line so we can keep Godot's external editor setting in sync.
+	# Supported form (only this one):
+	#   --my_rider_path="/absolute/path/to/rider with possible spaces"
+	var args : Array = OS.get_cmdline_args()
+	var provided_rider_path := ""
+	for a_raw in args:
+		var a: String = str(a_raw)
+		if a.begins_with("--my_rider_path="):
+			provided_rider_path = a.substr("--my_rider_path=".length())
+			break
+
+	if provided_rider_path.is_empty():
+		return false
+
+	provided_rider_path = trim_quotes(provided_rider_path)
+
+	# Validate existence (file or dir)
+	var looks_existing := FileAccess.file_exists(provided_rider_path) || DirAccess.dir_exists_absolute(provided_rider_path)
+	if looks_existing:
+		_settings_service.set_external_editor_path(editor_settings, provided_rider_path)
+		print("Rider path provided via CLI (my_rider_path): ", provided_rider_path)
+		return true
+	else:
+		push_warning("my_rider_path was provided but does not exist: %s" % [provided_rider_path])
+	return false
+
+func trim_quotes(s: String) -> String:
+	if s.begins_with('"') and s.ends_with('"') and s.length() >= 2:
+		return s.substr(1, s.length() - 2)
+	return s
+
+
+func add_selector_in_editor_interface(_settings_service: EditorSettingsService):
+	_update_selector(_installations_found)
+
+	if _installations_found.is_empty() and _thread == null:
+		_thread = Thread.new()
+		_thread.start(_load_installations)
+
+func _load_installations() -> void:
+	var array: Array = get_installations()
+	call_deferred("_on_installations_loaded", array)
+
+func _on_installations_loaded(array: Array):
+	_installations_found = array
+	if _thread:
+		_thread.wait_to_finish()
+		_thread = null
+	_update_selector(_installations_found)
+
+func _notification(what: int) -> void:
+	if what == NOTIFICATION_PREDELETE and _thread != null:
+		_thread.wait_to_finish()
+
+func _update_selector(array: Array):
+	var name := "text_editor/external/editor"
+	var settings := EditorInterface.get_editor_settings()
+
+	if !(settings.has_setting(name)):
+		settings.set(name, 0)
+
+	var installations: Array = ["Custom"]
+	for element in array:
+		var display_name: String = element.get("display", "")
+		# Replace special characters that break PROPERTY_HINT_ENUM format
+		# Comma is the enum delimiter, colon is used for explicit value assignment
+		display_name = display_name.replace(",", " •").replace(":", " -")
+		installations.append(display_name)
+	var options :String = ",".join(installations)
+
+	settings.add_property_info({
+		"name": name,
+		"type":TYPE_INT,
+		"hint":PROPERTY_HINT_ENUM,
+		"hint_string": options
+	})
+
+	# Connect to settings changes to update external editor path when selection changes
+	if not settings.settings_changed.is_connected(_on_selection_changed):
+		settings.settings_changed.connect(_on_selection_changed.bind())
+
+func _on_selection_changed() -> void:
+	var name := "text_editor/external/editor"
+	var settings := EditorInterface.get_editor_settings()
+	var selected_index: int = settings.get_setting(name)
+
+	# Index 0 is "Custom", so user manages the path manually
+	if selected_index == 0:
+		return
+
+	# Map to actual installation (offset by 1 because of "Custom" at index 0)
+	var installation_index := selected_index - 1
+	var installations_array = _installations_found
+	if installation_index >= 0 and installation_index < installations_array.size():
+		var installation = installations_array[installation_index]
+		var new_path: String = installation.get("path", "")
+		if not new_path.is_empty():
+			EditorSettingsService.new().set_external_editor_path(settings, new_path)

addons/rider-plugin/scripts/locator/rider_locator_service.gd.uid

@@ -0,0 +1 @@
+uid://cfsu1rbg0ypem

addons/rider-plugin/scripts/presets/preset_applier.gd

@@ -0,0 +1,35 @@
+@tool
+extends RefCounted
+class_name PresetApplier
+
+var presets_path: String
+
+func _init(p_path: String) -> void:
+	presets_path = p_path
+
+func get_preset_key(is_active: bool) -> String:
+	return "on" if is_active else "off"
+
+func apply_preset(editor_settings: EditorSettings, is_active: bool) -> void:
+	var data: Dictionary = JsonUtils.load_dict_from_file(presets_path)
+	if data.is_empty():
+		push_warning("Failed to load presets: %s" % presets_path)
+		return
+
+	var new_preset_key := get_preset_key(is_active)
+	var previous_preset_key := get_preset_key(not is_active)
+
+	if not data.has(new_preset_key):
+		push_warning("Preset '%s' not found in presets.json" % new_preset_key)
+		return
+
+	var new_preset := data[new_preset_key] as Dictionary
+	# Reset keys from previous preset that are missing in the new preset
+	if data.has(previous_preset_key):
+		var previous_preset := data[previous_preset_key] as Dictionary
+		for key in previous_preset:
+			if not new_preset.has(key):
+				editor_settings.set_setting(str(key), editor_settings.property_get_revert(str(key)))
+	# Apply the new preset
+	for key in new_preset:
+		editor_settings.set_setting(str(key), new_preset[key])

addons/rider-plugin/scripts/presets/preset_applier.gd.uid

@@ -0,0 +1 @@
+uid://bjiaycxso8h8u

addons/rider-plugin/scripts/settings/editor_settings_service.gd

@@ -0,0 +1,17 @@
+@tool
+extends RefCounted
+class_name EditorSettingsService
+
+func set_external_editor_path(editor_settings: EditorSettings, path: String) -> void:
+	editor_settings.set_setting("text_editor/external/exec_path", path)
+	
+func has_valid_external_editor_path(editor_settings: EditorSettings) -> bool:
+	var has_setting: bool = editor_settings.has_setting("text_editor/external/exec_path")
+	if not has_setting: 
+		return false
+	var path : String = editor_settings.get_setting("text_editor/external/exec_path")
+	var exists := not path.is_empty() && (FileAccess.file_exists(path) || DirAccess.dir_exists_absolute(path))
+	return exists
+
+func set_use_external_editor(editor_settings: EditorSettings, enabled: bool) -> void:
+	editor_settings.set_setting("text_editor/external/use_external_editor", enabled)

addons/rider-plugin/scripts/settings/editor_settings_service.gd.uid

@@ -0,0 +1 @@
+uid://bdiu78ot0rrkc

bull_legs.gd

@@ -0,0 +1,437 @@
+extends Node
+## Procedural leg stepping, body wobble, and tail simulation.
+## Created at runtime by player.gd; call setup() before the first _process tick.
+
+# ── Leg State Machine ─────────────────────────────────────────────────────────
+enum LegState { GALLOP, LAUNCH, RAGDOLL, TUCK, LAND }
+
+# Leg IK config — rest offsets are in bull_v10 local space
+const LEG_CFG: Dictionary = {
+	"FL": { "root": &"front_leg_1_L", "tip": &"front_leg_2_L_end",
+			"rest": Vector3(-0.30, -0.25, -0.50) },
+	"FR": { "root": &"front_leg_1_R", "tip": &"front_leg_2_R_end",
+			"rest": Vector3( 0.30, -0.25, -0.50) },
+	"BL": { "root": &"rear_leg_1_L",  "tip": &"rear_leg_3_L_end",
+			"rest": Vector3(-0.30, -0.25,  0.60) },
+	"BR": { "root": &"rear_leg_1_R",  "tip": &"rear_leg_3_R_end",
+			"rest": Vector3( 0.30, -0.25,  0.60) },
+}
+
+# Gallop gait phase offset per leg (0.0–1.0 cycle).
+const LEG_PHASES: Dictionary = { "BL": 0.0, "FL": 0.2, "BR": 0.5, "FR": 0.7 }
+
+# Per-leg ragdoll phase offsets for variety
+const RAGDOLL_PHASE: Dictionary = { "FL": 0.0, "FR": 1.3, "BL": 2.6, "BR": 3.9 }
+
+var _player:   CharacterBody3D
+var _bull:     Node3D
+var _skeleton: Skeleton3D
+
+# Per-leg state
+var _ik:         Dictionary = {}  # id -> SkeletonIK3D
+var _foot:       Dictionary = {}  # id -> current foot (world)
+var _step_from:  Dictionary = {}  # id -> Vector3
+var _step_to:    Dictionary = {}  # id -> Vector3
+var _step_t:     Dictionary = {}  # id -> float  (1.0 = planted)
+
+# Body wobble
+var _prev_vel:     Vector3 = Vector3.ZERO
+var _tilt_x:       float   = 0.0
+var _tilt_z:       float   = 0.0
+var _aerial_pitch: float   = 0.0
+
+# Leg state machine
+var _leg_state:    LegState = LegState.GALLOP
+var _state_time:   float    = 0.0   # time spent in current state
+var _was_on_floor: bool     = true
+var _launch_feet:  Dictionary = {}  # frozen foot positions at launch
+
+# Gait
+var _gait_phase: float = 0.0
+
+# Tail — Verlet chain simulation
+const TAIL_BONES: Array = [
+	&"tail_1", &"tail_2", &"tail_3", &"tail_4",
+	&"tail_5", &"tail_6",
+	&"tail_tip_1", &"tail_tip_2", &"tail_tip_2_end",
+]
+var _tail_idx:     Array[int]     = []
+var _tail_world:   Array[Vector3] = []
+var _tail_prev:    Array[Vector3] = []
+var _tail_lengths: Array[float]   = []
+var _tail_rest_dir: Array[Vector3] = []
+
+
+func setup(player: CharacterBody3D, bull: Node3D) -> void:
+	_player   = player
+	_bull     = bull
+	_skeleton = _find_skeleton(bull)
+	if not _skeleton:
+		push_error("BullLegs: Skeleton3D not found under bull_v10")
+		return
+
+	# Disable any physical bone simulator — we don't need it
+	var phys_sim := _find_physical_bones(_skeleton)
+	if phys_sim:
+		phys_sim.active = false
+
+	_setup_tail()
+
+	for id: String in LEG_CFG:
+		var cfg: Dictionary = LEG_CFG[id]
+
+		var ik := SkeletonIK3D.new()
+		ik.root_bone     = cfg["root"]
+		ik.tip_bone      = cfg["tip"]
+		ik.interpolation = 1.0
+		ik.min_distance  = 0.01
+		_skeleton.add_child(ik)
+		ik.start()
+		_ik[id] = ik
+
+		var world_rest: Vector3 = _bull.to_global(cfg["rest"])
+		_foot[id]      = world_rest
+		_step_from[id] = world_rest
+		_step_to[id]   = world_rest
+		_step_t[id]    = 1.0
+
+
+func _setup_tail() -> void:
+	for bone_name: StringName in TAIL_BONES:
+		var idx: int = _skeleton.find_bone(bone_name)
+		if idx == -1:
+			push_warning("BullLegs: tail bone '%s' not found" % bone_name)
+			continue
+		_tail_idx.append(idx)
+
+	if _tail_idx.size() < 2:
+		push_error("BullLegs: not enough tail bones found")
+		return
+
+	for i in range(_tail_idx.size() - 1):
+		var a: Transform3D = _skeleton.get_bone_global_rest(_tail_idx[i])
+		var b: Transform3D = _skeleton.get_bone_global_rest(_tail_idx[i + 1])
+		_tail_lengths.append((b.origin - a.origin).length())
+		_tail_rest_dir.append((b.origin - a.origin).normalized())
+	_tail_rest_dir.append(_tail_rest_dir[-1])
+
+	for idx: int in _tail_idx:
+		var world: Vector3 = _skeleton.to_global(_skeleton.get_bone_global_rest(idx).origin)
+		_tail_world.append(world)
+		_tail_prev.append(world)
+
+
+func _process(delta: float) -> void:
+	if not _skeleton:
+		return
+	_wobble_body(delta)
+	_update_leg_state(delta)
+	_step_feet(delta)
+	_apply_ik()
+	_update_tail(delta)
+	_apply_tail()
+
+
+# ── Body Wobble ───────────────────────────────────────────────────────────────
+
+func _wobble_body(delta: float) -> void:
+	var vel:   Vector3 = _player.velocity
+	var accel: Vector3 = (vel - _prev_vel) / maxf(delta, 0.001)
+	_prev_vel = vel
+
+	var la: Vector3 = _bull.global_transform.basis.inverse() * accel
+
+	var tx := clampf(-la.z * DP.f("body_tilt_fwd"),  -0.35, 0.35)
+	var tz := clampf(-la.x * DP.f("body_tilt_side"), -0.25, 0.25)
+
+	_tilt_x = lerpf(_tilt_x, tx, delta * 10.0)
+	_tilt_z = lerpf(_tilt_z, tz, delta * 10.0)
+
+	var flat_spd: float = Vector2(vel.x, vel.z).length()
+	var target_pitch: float = 0.0
+	if not _player.is_on_floor() and flat_spd > 0.5:
+		target_pitch = clampf(-atan2(vel.y, flat_spd) * DP.f("aerial_pitch_scale"), -1.4, 1.4)
+	_aerial_pitch = lerpf(_aerial_pitch, target_pitch, delta * DP.f("aerial_pitch_speed"))
+
+	_bull.rotation.x = _tilt_x + _aerial_pitch
+	_bull.rotation.z = _tilt_z
+
+
+# ── Leg State Machine ─────────────────────────────────────────────────────────
+
+func _update_leg_state(delta: float) -> void:
+	var on_floor: bool = _player.is_on_floor()
+	_state_time += delta
+
+	match _leg_state:
+		LegState.GALLOP:
+			if not on_floor and _was_on_floor:
+				# Just left the ground — enter LAUNCH
+				_leg_state = LegState.LAUNCH
+				_state_time = 0.0
+				# Freeze current foot positions
+				for id: String in _foot:
+					_launch_feet[id] = _foot[id]
+
+		LegState.LAUNCH:
+			if on_floor:
+				_leg_state = LegState.GALLOP
+				_state_time = 0.0
+			elif _state_time > DP.f("launch_hold_time"):
+				_leg_state = LegState.RAGDOLL
+				_state_time = 0.0
+
+		LegState.RAGDOLL:
+			if on_floor:
+				_leg_state = LegState.GALLOP
+				_state_time = 0.0
+			elif _player.velocity.y < DP.f("tuck_apex_threshold"):
+				# Approaching or past apex — start tucking
+				_leg_state = LegState.TUCK
+				_state_time = 0.0
+
+		LegState.TUCK:
+			if on_floor:
+				_leg_state = LegState.GALLOP
+				_state_time = 0.0
+			else:
+				# Check for ground proximity — transition to LAND
+				var space  := _player.get_world_3d().direct_space_state
+				var start  := _player.global_position
+				var end_pt := start + Vector3.DOWN * DP.f("jump_land_threshold")
+				var params := PhysicsRayQueryParameters3D.create(start, end_pt)
+				params.exclude = [_player.get_rid()]
+				var hit := space.intersect_ray(params)
+				if hit:
+					_leg_state = LegState.LAND
+					_state_time = 0.0
+
+		LegState.LAND:
+			if on_floor:
+				_leg_state = LegState.GALLOP
+				_state_time = 0.0
+
+	_was_on_floor = on_floor
+
+
+# ── Feet Stepping ─────────────────────────────────────────────────────────────
+
+func _step_feet(delta: float) -> void:
+	match _leg_state:
+		LegState.GALLOP:
+			_step_gallop(delta)
+		LegState.LAUNCH:
+			_step_launch(delta)
+		LegState.RAGDOLL:
+			_step_ragdoll(delta)
+		LegState.TUCK:
+			_step_tuck(delta)
+		LegState.LAND:
+			_step_land(delta)
+
+
+func _step_gallop(delta: float) -> void:
+	var threshold: float = DP.f("leg_step_threshold")
+	var duration:  float = DP.f("leg_step_duration")
+	var height:    float = DP.f("leg_step_height")
+	var overshoot: float = DP.f("leg_step_overshoot")
+	var flat_spd:  float = Vector2(_player.velocity.x, _player.velocity.z).length()
+
+	var prev_phase: float = _gait_phase
+	_gait_phase = fmod(_gait_phase + flat_spd * DP.f("gait_freq") * delta, 1.0)
+
+	# Advance in-progress steps
+	for id: String in _step_t:
+		if _step_t[id] >= 1.0:
+			continue
+		_step_t[id] = minf(_step_t[id] + delta / duration, 1.0)
+		var t: float   = _step_t[id]
+		var e: float   = t * t * (3.0 - 2.0 * t)
+		var arc: float = height * sin(t * PI)
+		_foot[id] = _step_from[id].lerp(_step_to[id], e) + Vector3(0.0, arc, 0.0)
+
+	# Trigger steps when gait phase crosses each leg's offset
+	for id: String in LEG_PHASES:
+		if _step_t[id] < 1.0:
+			continue
+		if not _phase_crossed(prev_phase, _gait_phase, LEG_PHASES[id]):
+			continue
+		var ideal: Vector3 = _ideal_foot(id)
+		if _foot[id].distance_to(ideal) < threshold:
+			continue
+		_step_from[id] = _foot[id]
+		_step_to[id]   = ideal + _player.velocity * duration * overshoot
+		_step_t[id]    = 0.0
+
+
+func _step_launch(_delta: float) -> void:
+	# Hold feet at their frozen launch positions
+	for id: String in _foot:
+		if _launch_feet.has(id):
+			_foot[id] = _launch_feet[id]
+
+
+func _step_ragdoll(delta: float) -> void:
+	# Procedural floppy dangle — NOT real physics ragdoll
+	var time: float = _state_time
+	var amp: float = DP.f("ragdoll_wobble_amp")
+	# Amplitude grows over time (legs spread more the longer airborne)
+	var grow: float = clampf(time * 0.8, 0.0, 1.5)
+
+	for id: String in _foot:
+		var rest: Vector3 = LEG_CFG[id]["rest"]
+		var phase: float = RAGDOLL_PHASE[id]
+		var dangle_offset := Vector3(
+			sin(time * 3.0 + phase) * amp * grow,          # side sway
+			-0.4 - sin(time * 2.0 + phase) * 0.1 * grow,  # gravity pull down
+			cos(time * 2.5 + phase) * amp * grow            # forward/back wobble
+		)
+		_foot[id] = _bull.to_global(rest + dangle_offset)
+
+
+func _step_tuck(delta: float) -> void:
+	# Smoothly pull legs into tucked position under the body
+	var speed: float = DP.f("jump_tuck_speed")
+	for id: String in _foot:
+		var tucked: Vector3 = _get_tucked_foot(id)
+		_foot[id] = _foot[id].lerp(tucked, clampf(delta * speed, 0.0, 1.0))
+
+
+func _step_land(delta: float) -> void:
+	# Extend legs from tucked pose toward ideal ground positions, resume gallop cycle
+	var speed: float = DP.f("jump_tuck_speed") * 1.5  # slightly faster extend
+	for id: String in _foot:
+		var ideal: Vector3 = _ideal_foot(id)
+		_foot[id] = _foot[id].lerp(ideal, clampf(delta * speed, 0.0, 1.0))
+
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+
+func _phase_crossed(prev: float, curr: float, target: float) -> bool:
+	if curr >= prev:
+		return target >= prev and target < curr
+	else:
+		return target >= prev or target < curr
+
+
+func _ideal_foot(id: String) -> Vector3:
+	var world_rest: Vector3 = _bull.to_global(LEG_CFG[id]["rest"])
+
+	# Raycast for ground
+	var space  := _player.get_world_3d().direct_space_state
+	var params := PhysicsRayQueryParameters3D.create(
+		world_rest + Vector3(0.0, 0.6, 0.0),
+		world_rest + Vector3(0.0, -1.4, 0.0),
+	)
+	params.exclude = [_player.get_rid()]
+	var hit := space.intersect_ray(params)
+	return hit["position"] if hit else world_rest
+
+
+func _get_tucked_foot(id: String) -> Vector3:
+	var rest: Vector3 = LEG_CFG[id]["rest"]
+	var tucked_local := rest + Vector3(0.0, DP.f("jump_tuck_up"), DP.f("jump_tuck_fwd"))
+	return _bull.to_global(tucked_local)
+
+
+func _apply_ik() -> void:
+	for id: String in _ik:
+		var ik: SkeletonIK3D = _ik[id]
+		var target_local: Vector3 = _skeleton.get_parent().to_local(_foot[id])
+		ik.target = Transform3D(Basis.IDENTITY, target_local)
+
+
+# ── Tail ──────────────────────────────────────────────────────────────────────
+
+func _update_tail(delta: float) -> void:
+	if _tail_world.is_empty():
+		return
+
+	var gravity := Vector3(0.0, -DP.f("tail_gravity"), 0.0)
+	var damping := 1.0 - clampf(DP.f("tail_damping"), 0.0, 0.99)
+
+	# Re-anchor root joint
+	var anchor: Vector3 = _skeleton.to_global(_skeleton.get_bone_global_rest(_tail_idx[0]).origin)
+	_tail_world[0] = anchor
+	_tail_prev[0]  = anchor
+
+	# Idle wag force
+	var flat_speed: float = Vector2(_player.velocity.x, _player.velocity.z).length()
+	var wag_strength: float = lerpf(DP.f("tail_wag_idle"), 0.0, clampf(flat_speed / 3.0, 0.0, 1.0))
+	var time: float = Time.get_ticks_msec() / 1000.0
+
+	# Verlet integrate
+	for i in range(1, _tail_world.size()):
+		var vel: Vector3 = (_tail_world[i] - _tail_prev[i]) * damping
+		_tail_prev[i]  = _tail_world[i]
+		# Add wag force (sinusoidal side-to-side)
+		var wag := _bull.global_transform.basis.x * sin(time * DP.f("tail_wag_freq") + i * 0.5) * wag_strength
+		_tail_world[i] = _tail_world[i] + vel + gravity * (delta * delta) + wag * delta
+
+	# Length constraint
+	for i in range(1, _tail_world.size()):
+		var dir: Vector3 = _tail_world[i] - _tail_world[i - 1]
+		var len: float   = dir.length()
+		var target_len: float = _tail_lengths[i - 1]
+		if len > 0.0001:
+			_tail_world[i] = _tail_world[i - 1] + dir * (target_len / len)
+		else:
+			_tail_world[i] = _tail_world[i - 1] + Vector3(0.0, -target_len, 0.0)
+
+	# Body collision pass — prevent tail from clipping through torso
+	# Use bull's local space; body is approximated as a capsule along Z axis
+	var body_radius: float = DP.f("tail_body_radius")
+	for i in range(1, _tail_world.size()):
+		var p := _bull.to_local(_tail_world[i])
+		# Capsule centered at roughly (0, 0, 0.1) in bull local space, half-length 0.4 along Z
+		var closest := Vector3(0.0, 0.0, clampf(p.z, -0.3, 0.5))
+		var diff := p - closest
+		var dist := diff.length()
+		if dist < body_radius and dist > 0.001:
+			p = closest + diff.normalized() * body_radius
+			_tail_world[i] = _bull.to_global(p)
+
+
+func _apply_tail() -> void:
+	if _tail_world.is_empty():
+		return
+
+	for i in range(_tail_world.size()):
+		var idx: int = _tail_idx[i]
+		var pos_skel: Vector3 = _skeleton.to_local(_tail_world[i])
+
+		var point_dir_skel: Vector3
+		if i < _tail_world.size() - 1:
+			point_dir_skel = (_skeleton.to_local(_tail_world[i + 1]) - pos_skel).normalized()
+		else:
+			var prev_skel: Vector3 = _skeleton.to_local(_tail_world[i - 1])
+			point_dir_skel = (pos_skel - prev_skel).normalized()
+
+		var rest_dir: Vector3 = _tail_rest_dir[i]
+		var rest_t: Transform3D = _skeleton.get_bone_global_rest(idx)
+		var new_basis: Basis
+		if rest_dir.length_squared() > 0.0001 and point_dir_skel.length_squared() > 0.0001:
+			new_basis = Basis(Quaternion(rest_dir, point_dir_skel)) * rest_t.basis
+		else:
+			new_basis = rest_t.basis
+
+		_skeleton.set_bone_global_pose_override(idx, Transform3D(new_basis, pos_skel), 1.0, false)
+
+
+# ── Utility ───────────────────────────────────────────────────────────────────
+
+func _find_skeleton(node: Node) -> Skeleton3D:
+	if node is Skeleton3D:
+		return node as Skeleton3D
+	for child in node.get_children():
+		var r := _find_skeleton(child)
+		if r:
+			return r
+	return null
+
+
+func _find_physical_bones(node: Node) -> PhysicalBoneSimulator3D:
+	for child in node.get_children():
+		if child is PhysicalBoneSimulator3D:
+			return child as PhysicalBoneSimulator3D
+	return null

bull_legs.gd.uid

@@ -0,0 +1 @@
+uid://bvtw8s41wrrx

camera_follow.gd

@@ -0,0 +1,9 @@
+extends Camera3D
+
+
+@export var spring_arm: Node3D
+
+
+func _process(delta: float) -> void:
+	var lerp_power: float = DP.f("cam_lerp_power")
+	position = position.lerp(spring_arm.position, delta * lerp_power)

camera_spring_arm.gd

@@ -0,0 +1,39 @@
+extends Node3D
+
+@onready var spring_arm: SpringArm3D = $SpringArm3D
+var _desired_length: float = 7.0
+
+
+func _ready() -> void:
+	Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)
+	_desired_length = DP.f("cam_spring_length")
+	spring_arm.spring_length = _desired_length
+
+
+func _unhandled_input(event: InputEvent) -> void:
+	var sensitivity: float = DP.f("cam_sensitivity")
+	var min_vert: float = deg_to_rad(DP.f("cam_min_vert_angle"))
+	var max_vert: float = deg_to_rad(DP.f("cam_max_vert_angle"))
+	var min_zoom: float = DP.f("cam_min_zoom")
+	var max_zoom: float = DP.f("cam_max_zoom")
+
+	if event is InputEventMouseMotion:
+		rotation.y -= event.relative.x * sensitivity
+		rotation.y = wrapf(rotation.y, 0.0, TAU)
+		rotation.x -= event.relative.y * sensitivity
+		rotation.x = clamp(rotation.x, min_vert, max_vert)
+
+	if event.is_action_pressed("zoom_in"):
+		_desired_length = clamp(_desired_length - 1.0, min_zoom, max_zoom)
+	if event.is_action_pressed("zoom_out"):
+		_desired_length = clamp(_desired_length + 1.0, min_zoom, max_zoom)
+
+	if event.is_action_pressed("toggle_mouse_capture"):
+		if Input.mouse_mode == Input.MOUSE_MODE_CAPTURED:
+			Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
+		else:
+			Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)
+
+
+func _process(_delta: float) -> void:
+	spring_arm.spring_length = _desired_length

debug_menu.gd

@@ -0,0 +1,216 @@
+extends Node
+## Runtime debug panel. Toggle with F1.
+## Reads DP.get_all() to build controls — adding a param to DP is all that's needed to show it here.
+
+var _panel: Control
+var _status_label: Label
+var _prev_mouse_mode: Input.MouseMode = Input.MOUSE_MODE_CAPTURED
+
+
+func _ready() -> void:
+	_build_ui()
+
+
+func _build_ui() -> void:
+	var canvas := CanvasLayer.new()
+	canvas.layer = 128
+	add_child(canvas)
+
+	_panel = PanelContainer.new()
+	_panel.anchor_left   = 1.0
+	_panel.anchor_right  = 1.0
+	_panel.anchor_top    = 0.0
+	_panel.anchor_bottom = 1.0
+	_panel.offset_left   = -390.0
+	_panel.offset_right  = 0.0
+	_panel.offset_top    = 0.0
+	_panel.offset_bottom = 0.0
+	_panel.mouse_filter  = Control.MOUSE_FILTER_STOP
+	_panel.visible       = false
+
+	var bg := StyleBoxFlat.new()
+	bg.bg_color = Color(0.08, 0.08, 0.10, 0.95)
+	_panel.add_theme_stylebox_override("panel", bg)
+	canvas.add_child(_panel)
+
+	var root_vbox := VBoxContainer.new()
+	root_vbox.size_flags_horizontal = Control.SIZE_FILL
+	_panel.add_child(root_vbox)
+
+	# ── Toolbar ───────────────────────────────────────────────────────────────
+	var toolbar_margin := MarginContainer.new()
+	toolbar_margin.add_theme_constant_override("margin_left",   8)
+	toolbar_margin.add_theme_constant_override("margin_right",  8)
+	toolbar_margin.add_theme_constant_override("margin_top",    6)
+	toolbar_margin.add_theme_constant_override("margin_bottom", 4)
+	root_vbox.add_child(toolbar_margin)
+
+	var toolbar := HBoxContainer.new()
+	toolbar.add_theme_constant_override("separation", 6)
+	toolbar_margin.add_child(toolbar)
+
+	var title := Label.new()
+	title.text = "DEBUG  [F1]"
+	title.size_flags_horizontal = Control.SIZE_EXPAND_FILL
+	toolbar.add_child(title)
+
+	_status_label = Label.new()
+	_status_label.modulate = Color(0.4, 1.0, 0.5)
+	toolbar.add_child(_status_label)
+
+	var save_btn := Button.new()
+	save_btn.text = "Save"
+	save_btn.pressed.connect(_on_save)
+	toolbar.add_child(save_btn)
+
+	var rand_all_btn := Button.new()
+	rand_all_btn.text = "Randomize All"
+	rand_all_btn.pressed.connect(_on_randomize_all)
+	toolbar.add_child(rand_all_btn)
+
+	var reset_btn := Button.new()
+	reset_btn.text = "Reset All"
+	reset_btn.pressed.connect(DP.reset_all)
+	toolbar.add_child(reset_btn)
+
+	root_vbox.add_child(HSeparator.new())
+
+	# ── Scrollable content ────────────────────────────────────────────────────
+	var scroll := ScrollContainer.new()
+	scroll.size_flags_vertical   = Control.SIZE_EXPAND_FILL
+	scroll.size_flags_horizontal = Control.SIZE_FILL
+	root_vbox.add_child(scroll)
+
+	var content_margin := MarginContainer.new()
+	content_margin.size_flags_horizontal = Control.SIZE_EXPAND_FILL
+	content_margin.add_theme_constant_override("margin_left",   8)
+	content_margin.add_theme_constant_override("margin_right",  8)
+	content_margin.add_theme_constant_override("margin_top",    4)
+	content_margin.add_theme_constant_override("margin_bottom", 8)
+	scroll.add_child(content_margin)
+
+	var content := VBoxContainer.new()
+	content.size_flags_horizontal = Control.SIZE_EXPAND_FILL
+	content_margin.add_child(content)
+
+	_build_params(content)
+
+
+func _build_params(content: VBoxContainer) -> void:
+	# Group keys by section preserving registration order
+	var sections: Dictionary = {}
+	for key: String in DP.get_all():
+		var sec: String = DP.get_all()[key]["section"]
+		if not sections.has(sec):
+			sections[sec] = []
+		sections[sec].append(key)
+
+	for section: String in sections:
+		content.add_child(HSeparator.new())
+
+		var header := Label.new()
+		header.text = section.to_upper()
+		header.modulate = Color(0.75, 0.85, 1.0)
+		content.add_child(header)
+
+		for key: String in sections[section]:
+			var meta: Dictionary = DP.get_all()[key]
+			if meta["type"] == TYPE_FLOAT:
+				_add_float_row(content, key, meta)
+
+
+func _add_float_row(parent: VBoxContainer, key: String, meta: Dictionary) -> void:
+	var row := HBoxContainer.new()
+	row.size_flags_horizontal = Control.SIZE_FILL
+	parent.add_child(row)
+
+	var lbl := Label.new()
+	lbl.text = key.replace("_", " ")
+	lbl.custom_minimum_size.x = 140
+	lbl.vertical_alignment = VERTICAL_ALIGNMENT_CENTER
+	row.add_child(lbl)
+
+	var slider := HSlider.new()
+	slider.min_value = meta["min"]
+	slider.max_value = meta["max"]
+	slider.step      = meta["step"]
+	slider.value     = meta["value"]
+	slider.size_flags_horizontal = Control.SIZE_EXPAND_FILL
+	slider.custom_minimum_size.x = 60
+	row.add_child(slider)
+
+	var spin := SpinBox.new()
+	spin.min_value = meta["min"]
+	spin.max_value = meta["max"]
+	spin.step      = meta["step"]
+	spin.value     = meta["value"]
+	spin.custom_minimum_size.x = 85
+	row.add_child(spin)
+
+	var rand_btn := Button.new()
+	rand_btn.text = "🎲"
+	rand_btn.tooltip_text = "Randomize"
+	rand_btn.pressed.connect(func() -> void:
+		var v := randf_range(meta["min"], meta["max"])
+		v = snappedf(v, meta["step"])
+		slider.value = v
+	)
+	row.add_child(rand_btn)
+
+	# Slider → SpinBox + DP (use no_signal to avoid echo)
+	slider.value_changed.connect(func(v: float) -> void:
+		spin.set_value_no_signal(v)
+		DP.set_value(key, v)
+	)
+	# SpinBox → Slider + DP
+	spin.value_changed.connect(func(v: float) -> void:
+		slider.set_value_no_signal(v)
+		DP.set_value(key, v)
+	)
+	# External changes (reset, load) → sync both controls
+	DP.any_changed.connect(func(changed_key: String, _val: Variant) -> void:
+		if changed_key != key and changed_key != "__all__":
+			return
+		var v := DP.f(key)
+		slider.set_value_no_signal(v)
+		spin.set_value_no_signal(v)
+	)
+
+
+
+func _on_save() -> void:
+	DP.save()
+	_status_label.text = "Saved!"
+	get_tree().create_timer(1.5).timeout.connect(func() -> void:
+		_status_label.text = ""
+	)
+
+
+
+
+func _input(event: InputEvent) -> void:
+	if _panel.visible and Input.is_key_pressed(KEY_CTRL) and event is InputEventMouseMotion:
+		get_viewport().set_input_as_handled()
+
+
+func _unhandled_input(event: InputEvent) -> void:
+	if not (event is InputEventKey and event.pressed and not event.echo):
+		return
+	if (event as InputEventKey).keycode != KEY_F1:
+		return
+	_panel.visible = not _panel.visible
+	if _panel.visible:
+		_prev_mouse_mode = Input.mouse_mode
+		Input.mouse_mode = Input.MOUSE_MODE_VISIBLE
+	else:
+		Input.mouse_mode = _prev_mouse_mode
+	get_viewport().set_input_as_handled()
+
+
+
+func _on_randomize_all() -> void:
+	for key: String in DP.get_all():
+		var meta: Dictionary = DP.get_all()[key]
+		if meta["type"] == TYPE_FLOAT:
+			var v := snappedf(randf_range(meta["min"], meta["max"]), meta["step"])
+			DP.set_value(key, v)

debug_menu.gd.uid

@@ -0,0 +1 @@
+uid://via815ow6p5r

debug_params.gd

@@ -0,0 +1,159 @@
+extends Node
+## Central registry for all runtime-tunable parameters.
+## Add a new param with one _reg_f() call in _register_all() — the menu picks it up automatically.
+## Access: DP.f("key")  •  Persist: DP.save() / DP.load_saved()  •  Reset: DP.reset_all()
+
+signal any_changed(key: String, value: Variant)
+
+const SAVE_PATH := "user://debug_params.cfg"
+
+var _params: Dictionary = {}
+
+
+func _ready() -> void:
+	_register_all()
+	load_saved()
+
+
+func _register_all() -> void:
+	# ── Movement ──────────────────────────────────────────────────────────────
+	_reg_f("Movement", "thrust_impulse",      18.0,  1.0,  200.0)
+	_reg_f("Movement", "thrust_vertical",      2.0,  0.0,   20.0)
+	_reg_f("Movement", "max_speed",           30.0,  2.0, 1000.0)
+	_reg_f("Movement", "roll_damping",         0.15, 0.01,  0.99, 0.01)
+	_reg_f("Movement", "jump_velocity",        4.5,  1.0,  200.0)
+	_reg_f("Movement", "visual_turn_speed",   12.0,  1.0,  200.0)
+	_reg_f("Movement", "bounce_restitution",   0.55, 0.0,    2.0, 0.05)
+	_reg_f("Movement", "bounce_min_impact",    1.0,  0.0,   20.0)
+	_reg_f("Movement", "kick_impulse",         8.0,  1.0,  50.0)
+	_reg_f("Movement", "kick_interval",        0.25, 0.05,  1.0, 0.01)
+	_reg_f("Movement", "kick_vertical",        3.0,  0.0,  15.0)
+	_reg_f("Movement", "kick_force_var",       0.2,  0.0,   1.0, 0.01)
+	_reg_f("Movement", "kick_spread",         10.0,  0.0,  45.0, 1.0)
+	_reg_f("Movement", "charge_kick_mult",     2.0,  1.0,   5.0)
+	# ── Dust speed thresholds ─────────────────────────────────────────────────
+	_reg_f("Dust",     "dust_walk_spd",       1.5,  0.1,  10.0)
+	_reg_f("Dust",     "dust_charge_spd",     7.0,  1.0,  20.0)
+	# ── Dust ──────────────────────────────────────────────────────────────────
+	_reg_f("Dust",     "dust_lifetime",       0.9,  0.1,   4.0)
+	_reg_f("Dust",     "dust_explosiveness",  0.35, 0.0,   1.0)
+	_reg_f("Dust",     "dust_spread",        45.0,  5.0,  90.0)
+	_reg_f("Dust",     "dust_gravity_y",     -1.5,-15.0,   0.0)
+	_reg_f("Dust",     "walk_scale_min",      0.35, 0.05,  3.0)
+	_reg_f("Dust",     "walk_scale_max",      0.65, 0.05,  3.0)
+	_reg_f("Dust",     "walk_vel_min",        0.8,  0.1,  12.0)
+	_reg_f("Dust",     "walk_vel_max",        1.8,  0.1,  12.0)
+	_reg_f("Dust",     "charge_scale_min",    1.0,  0.05,  6.0)
+	_reg_f("Dust",     "charge_scale_max",    2.2,  0.05,  6.0)
+	_reg_f("Dust",     "charge_vel_min",      2.8,  0.1,  20.0)
+	_reg_f("Dust",     "charge_vel_max",      5.5,  0.1,  20.0)
+	# ── Tail ──────────────────────────────────────────────────────────────────
+	_reg_f("Tail",     "tail_gravity",        9.8,   0.0, 30.0)
+	_reg_f("Tail",     "tail_damping",        0.08,  0.0,  0.5, 0.01)
+	_reg_f("Tail",     "tail_body_radius",    0.35,  0.05, 2.0, 0.05)
+	_reg_f("Tail",     "tail_wag_freq",       4.0,   0.5, 15.0)
+	_reg_f("Tail",     "tail_wag_idle",       0.3,   0.0,  2.0, 0.05)
+	# ── Body ──────────────────────────────────────────────────────────────────
+	_reg_f("Body",     "body_tilt_fwd",       0.015, 0.0,   0.1, 0.001)
+	_reg_f("Body",     "body_tilt_side",      0.01,  0.0,   0.1, 0.001)
+	_reg_f("Body",     "aerial_pitch_scale",  0.6,   0.0,   2.0)
+	_reg_f("Body",     "aerial_pitch_speed",  5.0,   0.5,  20.0)
+	# ── Legs ──────────────────────────────────────────────────────────────────
+	_reg_f("Legs",     "leg_step_threshold",  0.15,  0.01,  1.0, 0.01)
+	_reg_f("Legs",     "leg_step_duration",   0.12,  0.02,  0.5, 0.01)
+	_reg_f("Legs",     "leg_step_height",     0.15,  0.0,   0.5)
+	_reg_f("Legs",     "leg_step_overshoot",  0.3,   0.0,   1.0)
+	_reg_f("Legs",     "gait_freq",           1.5,   0.1,   5.0)
+	_reg_f("Legs",     "launch_hold_time",    0.15,  0.0,   1.0, 0.01)
+	_reg_f("Legs",     "ragdoll_wobble_amp",  0.15,  0.0,   1.0)
+	_reg_f("Legs",     "tuck_apex_threshold", 0.5,  -5.0,   5.0)
+	_reg_f("Legs",     "jump_tuck_speed",     8.0,   1.0,  30.0)
+	_reg_f("Legs",     "jump_tuck_up",        0.2,   0.0,   1.0)
+	_reg_f("Legs",     "jump_tuck_fwd",      -0.1,  -0.5,   0.5)
+	_reg_f("Legs",     "jump_land_threshold", 1.5,   0.5,   5.0)
+	# ── Camera ────────────────────────────────────────────────────────────────
+	_reg_f("Camera",   "cam_lerp_power",      6.0,   0.5,  30.0)
+	_reg_f("Camera",   "cam_sensitivity",     0.005, 0.001, 0.05, 0.001)
+	_reg_f("Camera",   "cam_min_zoom",        3.5,   0.5,  20.0)
+	_reg_f("Camera",   "cam_max_zoom",       12.0,   2.0,  50.0)
+	_reg_f("Camera",   "cam_spring_length",   7.0,   1.0,  30.0)
+	_reg_f("Camera",   "cam_min_vert_angle", -60.0, -90.0,   0.0,  1.0)
+	_reg_f("Camera",   "cam_max_vert_angle",  45.0,   0.0,  90.0,  1.0)
+	# ── Matador ───────────────────────────────────────────────────────────────
+	_reg_f("Matador",  "mat_spawn_count",     8.0,   1.0,  30.0,  1.0)
+	_reg_f("Matador",  "mat_walk_speed",      2.5,   0.5,  10.0)
+	_reg_f("Matador",  "mat_wander_radius",  22.0,   5.0,  50.0)
+	_reg_f("Matador",  "mat_idle_min",        0.5,   0.0,   5.0, 0.1)
+	_reg_f("Matador",  "mat_idle_max",        2.5,   0.5,  10.0, 0.1)
+	_reg_f("Matador",  "mat_hit_threshold",   4.0,   1.0,  30.0)
+	_reg_f("Matador",  "mat_ragdoll_impulse", 8.0,   1.0,  50.0)
+	# ── Debug ─────────────────────────────────────────────────────────────────
+	_reg_b("Debug",    "show_collisions",    false)
+
+
+func _reg_f(section: String, key: String, default: float,
+		min_val: float, max_val: float, step: float = 0.05) -> void:
+	_params[key] = {
+		"value":   default,
+		"default": default,
+		"section": section,
+		"type":    TYPE_FLOAT,
+		"min":     min_val,
+		"max":     max_val,
+		"step":    step,
+	}
+
+
+func _reg_b(section: String, key: String, default: bool) -> void:
+	_params[key] = {
+		"value":   default,
+		"default": default,
+		"section": section,
+		"type":    TYPE_BOOL,
+	}
+
+
+## Read a float param. Panics on unknown key — intentional: typos should be loud.
+func f(key: String) -> float:
+	return _params[key]["value"] as float
+
+
+## Read a bool param.
+func b(key: String) -> bool:
+	return _params[key]["value"] as bool
+
+
+func set_value(key: String, value: Variant) -> void:
+	if not _params.has(key):
+		return
+	_params[key]["value"] = value
+	any_changed.emit(key, value)
+
+
+## Returns the full metadata dict — used by DebugMenu to build UI.
+func get_all() -> Dictionary:
+	return _params
+
+
+func save() -> void:
+	var cfg := ConfigFile.new()
+	for key: String in _params:
+		var p: Dictionary = _params[key]
+		cfg.set_value(p["section"], key, p["value"])
+	cfg.save(SAVE_PATH)
+
+
+func load_saved() -> void:
+	var cfg := ConfigFile.new()
+	if cfg.load(SAVE_PATH) != OK:
+		return
+	for section: String in cfg.get_sections():
+		for key: String in cfg.get_section_keys(section):
+			if _params.has(key):
+				_params[key]["value"] = cfg.get_value(section, key)
+
+
+func reset_all() -> void:
+	for key: String in _params:
+		_params[key]["value"] = _params[key]["default"]
+	any_changed.emit("__all__", null)

debug_params.gd.uid

@@ -0,0 +1 @@
+uid://b3ix5yi7b3ynh

hello world.txt

@@ -1,2 +0,0 @@
-hello
-xd

matador.gd

@@ -0,0 +1,161 @@
+extends CharacterBody3D
+
+enum State { WANDER, RAGDOLL }
+
+var _state:         State                   = State.WANDER
+var _skeleton:      Skeleton3D              = null
+var _sim:           PhysicalBoneSimulator3D = null
+var _wander_target: Vector3                 = Vector3.ZERO
+var _idle_timer:    float                   = 0.0
+
+@onready var _mesh:     Node3D = $matador_v02
+@onready var _hit_area: Area3D = $HitArea
+
+
+func _ready() -> void:
+	add_to_group(&"matador")
+	_skeleton = _find_skeleton(_mesh)
+	if _skeleton:
+		_sim = _setup_physical_bones()
+	_hit_area.body_entered.connect(_on_body_entered)
+	_pick_wander_target()
+
+
+func _physics_process(delta: float) -> void:
+	if not is_on_floor():
+		velocity += get_gravity() * delta
+	match _state:
+		State.WANDER:  _tick_wander(delta)
+		State.RAGDOLL: _tick_ragdoll(delta)
+
+
+func _tick_wander(delta: float) -> void:
+	if _idle_timer > 0.0:
+		_idle_timer -= delta
+		velocity.x = move_toward(velocity.x, 0.0, 10.0 * delta)
+		velocity.z = move_toward(velocity.z, 0.0, 10.0 * delta)
+		move_and_slide()
+		return
+
+	var dx: float = _wander_target.x - global_position.x
+	var dz: float = _wander_target.z - global_position.z
+	if Vector2(dx, dz).length() < 0.8:
+		_idle_timer = randf_range(DP.f("mat_idle_min"), DP.f("mat_idle_max"))
+		_pick_wander_target()
+	else:
+		var dir := Vector3(dx, 0.0, dz).normalized()
+		var spd  := DP.f("mat_walk_speed")
+		velocity.x = dir.x * spd
+		velocity.z = dir.z * spd
+		_mesh.rotation.y = lerp_angle(
+			_mesh.rotation.y, atan2(velocity.x, velocity.z), delta * 8.0)
+	move_and_slide()
+
+
+func _tick_ragdoll(delta: float) -> void:
+	velocity.x = move_toward(velocity.x, 0.0, 5.0 * delta)
+	velocity.z = move_toward(velocity.z, 0.0, 5.0 * delta)
+	move_and_slide()
+
+
+func _on_body_entered(body: Node3D) -> void:
+	if _state == State.RAGDOLL:
+		return
+	if not body.is_in_group(&"player"):
+		return
+	var player := body as CharacterBody3D
+	if player.velocity.length() < DP.f("mat_hit_threshold"):
+		return
+	var hit_dir := (global_position - player.global_position).normalized()
+	_enter_ragdoll(hit_dir, player.velocity.length())
+
+
+func _enter_ragdoll(hit_dir: Vector3, bull_speed: float) -> void:
+	_state = State.RAGDOLL
+	hit_dir.y = 0.0
+	hit_dir    = hit_dir.normalized()
+	velocity   = Vector3(hit_dir.x, 0.5, hit_dir.z) * bull_speed * 0.4
+
+	if not _sim:
+		return
+	_sim.active = true
+	var strength := DP.f("mat_ragdoll_impulse")
+	for child: Node in _sim.get_children():
+		if child is PhysicalBone3D:
+			var scatter := Vector3(
+				randf_range(-0.3, 0.3),
+				randf_range(0.2, 0.8),
+				randf_range(-0.3, 0.3))
+			(child as PhysicalBone3D).apply_central_impulse(
+				(hit_dir + scatter).normalized() * strength)
+
+
+func _pick_wander_target() -> void:
+	var radius := DP.f("mat_wander_radius")
+	var angle  := randf() * TAU
+	var dist   := randf_range(2.0, radius)
+	_wander_target = Vector3(cos(angle) * dist, 0.0, sin(angle) * dist)
+
+
+# ── Ragdoll setup ─────────────────────────────────────────────────────────────
+
+func _setup_physical_bones() -> PhysicalBoneSimulator3D:
+	for child: Node in _skeleton.get_children():
+		if child is PhysicalBoneSimulator3D:
+			(child as PhysicalBoneSimulator3D).active = false
+			return child as PhysicalBoneSimulator3D
+
+	var sim := PhysicalBoneSimulator3D.new()
+	sim.active = false
+	_skeleton.add_child(sim)
+
+	# [bone_name, sphere_radius] or [bone_name, capsule_radius, capsule_height]
+	const BONES: Array = [
+		["matador",    0.18],
+		["chest",      0.13, 0.30],
+		["head",       0.14],
+		["arm_L",      0.07, 0.22],
+		["arm_R",      0.07, 0.22],
+		["forearm_L",  0.06, 0.22],
+		["forearm_R",  0.06, 0.22],
+		["leg_L",      0.10, 0.32],
+		["leg_R",      0.10, 0.32],
+		["shin_L",     0.08, 0.28],
+		["shin_R",     0.08, 0.28],
+	]
+
+	for entry: Array in BONES:
+		var bname: String = entry[0]
+		if _skeleton.find_bone(bname) == -1:
+			continue
+		var pb := PhysicalBone3D.new()
+		pb.bone_name    = bname
+		pb.linear_damp  = 0.5
+		pb.angular_damp = 0.5
+		var cs    := CollisionShape3D.new()
+		var use_capsule: bool = entry.size() >= 3
+		if use_capsule:
+			var cap    := CapsuleShape3D.new()
+			cap.radius  = entry[1]
+			cap.height  = entry[2]
+			cs.shape    = cap
+		else:
+			var sph    := SphereShape3D.new()
+			sph.radius  = entry[1]
+			cs.shape    = sph
+		pb.add_child(cs)
+		sim.add_child(pb)
+
+	return sim
+
+
+# ── Utility ───────────────────────────────────────────────────────────────────
+
+func _find_skeleton(node: Node) -> Skeleton3D:
+	if node is Skeleton3D:
+		return node as Skeleton3D
+	for child: Node in node.get_children():
+		var r := _find_skeleton(child)
+		if r:
+			return r
+	return null

matador_spawn.gd

@@ -0,0 +1,17 @@
+extends Node3D
+
+const MATADOR := preload("res://Matador.tscn")
+
+
+func _ready() -> void:
+	_spawn.call_deferred()
+
+
+func _spawn() -> void:
+	var count: int = int(DP.f("mat_spawn_count"))
+	for i: int in count:
+		var m: Node3D = MATADOR.instantiate()
+		var angle := randf() * TAU
+		var dist  := randf_range(6.0, DP.f("mat_wander_radius"))
+		m.position = Vector3(cos(angle) * dist, 1.0, sin(angle) * dist)
+		get_parent().add_child(m)

player.gd

@@ -0,0 +1,229 @@
+extends CharacterBody3D
+
+# Hoof positions in bull_v10 local space — dust emitter offsets
+const HOOF_OFFSETS: Array = [
+	Vector3(-0.30, -0.25, -0.50),
+	Vector3( 0.30, -0.25, -0.50),
+	Vector3(-0.30, -0.25,  0.60),
+	Vector3( 0.30, -0.25,  0.60),
+]
+
+@onready var camera_pivot: Node3D = $SpringArmPivot
+@onready var cube_guy:     Node3D = $bull_v10
+
+var _hoof_emitters: Array[CPUParticles3D] = []
+var _legs: Node
+
+var _kick_timer: float    = 0.0
+var _was_on_floor: bool   = false
+var _pre_slide_vel_y: float = 0.0
+
+enum _DustState { NONE, WALK, CHARGE }
+var _dust_state: _DustState = _DustState.NONE
+
+
+func _ready() -> void:
+	add_to_group(&"player")
+	_setup_hoof_dust()
+	_setup_legs()
+	DP.any_changed.connect(_on_dp_changed)
+
+
+func _setup_legs() -> void:
+	_legs = Node.new()
+	_legs.set_script(load("res://bull_legs.gd"))
+	add_child(_legs)
+	_legs.call(&"setup", self, cube_guy)
+
+
+func _setup_hoof_dust() -> void:
+	var mat := StandardMaterial3D.new()
+	mat.shading_mode = BaseMaterial3D.SHADING_MODE_UNSHADED
+	mat.transparency = BaseMaterial3D.TRANSPARENCY_ALPHA
+	mat.vertex_color_use_as_albedo = true
+	mat.cull_mode = BaseMaterial3D.CULL_DISABLED
+
+	var sphere := SphereMesh.new()
+	sphere.radius = 0.10
+	sphere.height = 0.20
+	sphere.radial_segments = 4
+	sphere.rings = 2
+	sphere.material = mat
+
+	var ramp := Gradient.new()
+	ramp.set_color(0, Color(0.80, 0.69, 0.46, 1.0))
+	ramp.set_color(1, Color(0.80, 0.69, 0.46, 0.0))
+
+	var scale_curve := Curve.new()
+	scale_curve.add_point(Vector2(0.0, 0.2))
+	scale_curve.add_point(Vector2(0.4, 1.0))
+	scale_curve.add_point(Vector2(1.0, 0.0))
+
+	for offset: Vector3 in HOOF_OFFSETS:
+		var p := CPUParticles3D.new()
+		p.position = offset
+		p.emitting = false
+		p.amount = 12
+		p.lifetime = DP.f("dust_lifetime")
+		p.explosiveness = DP.f("dust_explosiveness")
+		p.randomness = 0.6
+		p.local_coords = false
+		p.direction = Vector3(0.0, 1.0, 0.0)
+		p.spread = DP.f("dust_spread")
+		p.gravity = Vector3(0.0, DP.f("dust_gravity_y"), 0.0)
+		p.initial_velocity_min = DP.f("walk_vel_min")
+		p.initial_velocity_max = DP.f("walk_vel_max")
+		p.scale_amount_min = DP.f("walk_scale_min")
+		p.scale_amount_max = DP.f("walk_scale_max")
+		p.mesh = sphere
+		p.color_ramp = ramp
+		p.scale_amount_curve = scale_curve
+		cube_guy.add_child(p)
+		_hoof_emitters.append(p)
+
+
+func _set_dust_state(new_state: _DustState) -> void:
+	if new_state == _dust_state:
+		return
+	_dust_state = new_state
+	for p: CPUParticles3D in _hoof_emitters:
+		p.lifetime = DP.f("dust_lifetime")
+		p.explosiveness = DP.f("dust_explosiveness")
+		p.spread = DP.f("dust_spread")
+		p.gravity = Vector3(0.0, DP.f("dust_gravity_y"), 0.0)
+		match new_state:
+			_DustState.NONE:
+				p.emitting = false
+			_DustState.WALK:
+				p.scale_amount_min = DP.f("walk_scale_min")
+				p.scale_amount_max = DP.f("walk_scale_max")
+				p.initial_velocity_min = DP.f("walk_vel_min")
+				p.initial_velocity_max = DP.f("walk_vel_max")
+				p.emitting = true
+			_DustState.CHARGE:
+				p.scale_amount_min = DP.f("charge_scale_min")
+				p.scale_amount_max = DP.f("charge_scale_max")
+				p.initial_velocity_min = DP.f("charge_vel_min")
+				p.initial_velocity_max = DP.f("charge_vel_max")
+				p.emitting = true
+
+
+func _on_dp_changed(_key: String, _val: Variant) -> void:
+	if _hoof_emitters.is_empty() or _dust_state == _DustState.NONE:
+		return
+	var prev := _dust_state
+	_dust_state = _DustState.NONE
+	_set_dust_state(prev)
+
+
+
+
+func _apply_thrust(dir: Vector3) -> void:
+	var impulse := DP.f("thrust_impulse")
+	velocity.x += dir.x * impulse
+	velocity.z += dir.z * impulse
+	if is_on_floor():
+		velocity.y += DP.f("thrust_vertical")
+	var flat := Vector2(velocity.x, velocity.z)
+	var spd  := flat.length()
+	if spd > DP.f("max_speed"):
+		var s := DP.f("max_speed") / spd
+		velocity.x *= s
+		velocity.z *= s
+
+
+func _apply_kick(direction: Vector3, charging: bool) -> void:
+	var base := DP.f("kick_impulse") * (DP.f("charge_kick_mult") if charging else 1.0)
+
+	# Random force variance — each kick punches a different amount
+	var force := base * randf_range(1.0 - DP.f("kick_force_var"), 1.0 + DP.f("kick_force_var"))
+
+	# Random angle spread — slight mis-kick like a real ball
+	var spread := deg_to_rad(randf_range(-DP.f("kick_spread"), DP.f("kick_spread")))
+	var kick_dir := direction.rotated(Vector3.UP, spread)
+
+	velocity.x += kick_dir.x * force
+	velocity.z += kick_dir.z * force
+
+	# Vertical arc — only when grounded so arcs don't chain infinitely in the air
+	if is_on_floor():
+		velocity.y += DP.f("kick_vertical") * randf_range(0.75, 1.25)
+
+	# Cap immediately after kick so charge doesn't overshoot by too much
+	var flat := Vector2(velocity.x, velocity.z)
+	var spd  := flat.length()
+	var cap  := DP.f("max_speed") * (DP.f("charge_kick_mult") if charging else 1.0)
+	if spd > cap:
+		var s := cap / spd
+		velocity.x *= s
+		velocity.z *= s
+
+
+func _physics_process(delta: float) -> void:
+	# ── Gravity & jump ────────────────────────────────────────────────────────
+	if not is_on_floor():
+		velocity += get_gravity() * delta
+
+	if Input.is_action_just_pressed(&"jump") and is_on_floor():
+		velocity.y = DP.f("jump_velocity")
+
+	# ── Camera-relative input direction ───────────────────────────────────────
+	var input_dir    := Input.get_vector("move_left", "move_right", "move_forward", "move_back")
+	var cam_basis    := camera_pivot.global_transform.basis
+	var flat_forward := -Vector3(cam_basis.z.x, 0.0, cam_basis.z.z).normalized()
+	var flat_right   :=  Vector3(cam_basis.x.x, 0.0, cam_basis.x.z).normalized()
+	var direction    := (flat_forward * -input_dir.y + flat_right * input_dir.x).normalized()
+
+	var charging := Input.is_action_pressed(&"charge")
+	var on_floor  := is_on_floor()
+
+	# ── Left / right click thrust (only when mouse is captured) ─────────────
+	#   Left click  → thrust NE (forward-right diagonal)
+	#   Right click → thrust NW (forward-left diagonal)
+	if Input.mouse_mode == Input.MOUSE_MODE_CAPTURED:
+		if Input.is_action_just_pressed(&"thrust_left"):
+			var ne := (flat_forward + flat_right).normalized()
+			_apply_thrust(ne if ne.length() > 0.1 else flat_forward)
+		if Input.is_action_just_pressed(&"thrust_right"):
+			var nw := (flat_forward - flat_right).normalized()
+			_apply_thrust(nw if nw.length() > 0.1 else flat_forward)
+
+	# Reset kick timer on landing so the first kick after a bounce is immediate
+	if on_floor and not _was_on_floor and direction:
+		_kick_timer = 0.0
+	_was_on_floor = on_floor
+
+	# ── Periodic kick ─────────────────────────────────────────────────────────
+	_kick_timer = maxf(0.0, _kick_timer - delta)
+	if direction and _kick_timer <= 0.0:
+		_apply_kick(direction, charging)
+		_kick_timer = DP.f("kick_interval")
+
+	# ── Rolling friction (exponential, frame-rate independent) ────────────────
+	var retain := pow(DP.f("roll_damping"), delta)
+	velocity.x *= retain
+	velocity.z *= retain
+
+	# ── Visual rotation follows velocity direction ─────────────────────────────
+	var flat_speed := Vector2(velocity.x, velocity.z).length()
+	if flat_speed > 0.4:
+		var target_angle := atan2(velocity.x, velocity.z)
+		cube_guy.rotation.y = lerp_angle(
+			cube_guy.rotation.y, target_angle, delta * DP.f("visual_turn_speed"))
+
+	_pre_slide_vel_y = velocity.y
+	move_and_slide()
+
+	# ── Bounce on landing ─────────────────────────────────────────────────────
+	if is_on_floor() and not _was_on_floor:
+		var impact := -_pre_slide_vel_y
+		if impact > DP.f("bounce_min_impact"):
+			velocity.y = impact * DP.f("bounce_restitution")
+
+	# ── Dust ──────────────────────────────────────────────────────────────────
+	if flat_speed > DP.f("dust_charge_spd") and on_floor:
+		_set_dust_state(_DustState.CHARGE)
+	elif flat_speed > DP.f("dust_walk_spd") and on_floor:
+		_set_dust_state(_DustState.WALK)
+	else:
+		_set_dust_state(_DustState.NONE)

project.godot

@@ -0,0 +1,95 @@
+; Engine configuration file.
+; It's best edited using the editor UI and not directly,
+; since the parameters that go here are not all obvious.
+;
+; Format:
+;   [section] ; section goes between []
+;   param=value ; assign values to parameters
+
+config_version=5
+
+[application]
+
+config/name="Bullosseum"
+config/features=PackedStringArray("4.7", "Forward Plus")
+config/icon="res://icon.svg"
+config/run/main_scene="res://scene.tscn"
+
+[autoload]
+
+DP="*res://debug_params.gd"
+DebugMenu="*res://debug_menu.gd"
+
+[editor_plugins]
+
+enabled=PackedStringArray("res://addons/rider-plugin/plugin.cfg")
+
+[input]
+
+move_forward={
+"deadzone": 0.2,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":87,"key_label":0,"unicode":119,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194320,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+move_back={
+"deadzone": 0.2,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":83,"key_label":0,"unicode":115,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194322,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+move_left={
+"deadzone": 0.2,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":65,"key_label":0,"unicode":97,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194319,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+move_right={
+"deadzone": 0.2,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":68,"key_label":0,"unicode":100,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194321,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+jump={
+"deadzone": 0.2,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":32,"key_label":0,"unicode":32,"location":0,"echo":false,"script":null)
+]
+}
+zoom_in={
+"deadzone": 0.2,
+"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":8,"position":Vector2(726, 8),"global_position":Vector2(735, 56),"factor":1.0,"button_index":4,"canceled":false,"pressed":true,"double_click":false,"script":null)
+]
+}
+zoom_out={
+"deadzone": 0.2,
+"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":16,"position":Vector2(400, 21),"global_position":Vector2(409, 69),"factor":1.0,"button_index":5,"canceled":false,"pressed":true,"double_click":false,"script":null)
+]
+}
+toggle_mouse_capture={
+"deadzone": 0.2,
+"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":4,"position":Vector2(461, 22),"global_position":Vector2(470, 70),"factor":1.0,"button_index":3,"canceled":false,"pressed":true,"double_click":false,"script":null)
+]
+}
+charge={
+"deadzone": 0.2,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194325,"key_label":0,"unicode":0,"location":1,"echo":false,"script":null)
+]
+}
+thrust_left={
+"deadzone": 0.2,
+"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":1,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":1,"canceled":false,"pressed":true,"double_click":false,"script":null)
+]
+}
+thrust_right={
+"deadzone": 0.2,
+"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":2,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":2,"canceled":false,"pressed":true,"double_click":false,"script":null)
+]
+}
+
+[physics]
+
+3d/physics_engine="Jolt Physics"
+
+[rendering]
+
+rendering_device/driver.windows="d3d12"

scene.tscn

@@ -1,30 +1,31 @@
 [gd_scene format=3 uid="uid://b7afbx36ltb3f"]
 
 [ext_resource type="PackedScene" uid="uid://crtm0xtiql3r8" path="res://Player.tscn" id="1_ulcgi"]
-
-[sub_resource type="BoxMesh" id="BoxMesh_nxogm"]
+[ext_resource type="PackedScene" uid="uid://dio67r8ambe7h" path="res://Assets/arena_placeholder_v01.glb" id="2_nxogm"]
+[ext_resource type="Script" path="res://matador_spawn.gd" id="3_spawn"]
 
 [sub_resource type="BoxShape3D" id="BoxShape3D_ulcgi"]
 
 [node name="scene" type="Node3D" unique_id=22320312]
 
 [node name="Player" parent="." unique_id=165510044 instance=ExtResource("1_ulcgi")]
-transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 2.3040223, 0)
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 5.1711025, 0)
 
 [node name="DirectionalLight3D" type="DirectionalLight3D" parent="." unique_id=818712731]
 transform = Transform3D(0.030703627, 0.98235905, -0.18446636, -0.1612905, 0.18700416, 0.9690277, 0.9864293, -1.2735805e-08, 0.16418687, -4.08134, 0.3070748, 0.97087634)
 shadow_enabled = true
 
 [node name="Node3D" type="Node3D" parent="." unique_id=1081100876]
-transform = Transform3D(3.5710833, 0, 0, 0, 1, 0, 0, 0, 2.2964425, 0, 0, 0)
-
-[node name="MeshInstance3D" type="MeshInstance3D" parent="Node3D" unique_id=1193968330]
-transform = Transform3D(7.6892195, 0, 0, 0, 0.34217757, 0, 0, 0, 8.638922, 0, 0, 0)
-mesh = SubResource("BoxMesh_nxogm")
+transform = Transform3D(10, 0, 0, 0, 1, 0, 0, 0, 10, 0, 0, 0)
 
 [node name="StaticBody3D" type="StaticBody3D" parent="Node3D" unique_id=2072095624]
-transform = Transform3D(1.0000001, 0, 0, 0, 1.0000001, 0, 0, 0, 1.0000001, 0, 0, 0)
 
 [node name="CollisionShape3D" type="CollisionShape3D" parent="Node3D/StaticBody3D" unique_id=1444198204]
-transform = Transform3D(7.6892185, 0, 0, 0, 0.34217754, 0, 0, 0, 8.638921, 0, 0, 0)
+transform = Transform3D(30, 0, 0, 0, 1, 0, 0, 0, 30, 0, -0.5, 0)
 shape = SubResource("BoxShape3D_ulcgi")
+
+[node name="arena_placeholder_v01" parent="Node3D" unique_id=1341659233 instance=ExtResource("2_nxogm")]
+transform = Transform3D(0.28002706, 0, 0, 0, 1, 0, 0, 0, 0.43545616, -0.2506242, 0, 0)
+
+[node name="MatadorSpawner" type="Node3D" parent="." unique_id=3001000001]
+script = ExtResource("3_spawn")