foitin/engine/core/character_data.gd
m3ultra b067bf7f0b Scaffold: deterministic 60Hz combat core, drop-in character format, MODELBEAST pipeline
- Godot 4.7 project; fixed-tick FSM fighter, facing-relative input buffer
  with numpad motion parsing, box collision, training-mode hitbox overlay
- characters/ = self-describing drop-in folders (spec in _spec/); two
  generated placeholder fighters (alpha, beta)
- pipeline/: pack_character.py + autohitbox.py (pose/silhouette hurtboxes)
- STUDY.md: reverse-engineering study of the BKB reference games

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-28 18:45:44 +10:00

58 lines
2.1 KiB
GDScript

class_name CharacterData
## Loads one character folder (see characters/_spec/CHARACTER_SPEC.md).
## The roster is whatever folders exist under characters/ — adding a
## fighter is dropping a folder in, no code changes.
var id := ""
var display_name := ""
var health := 1000
var walk_speed := 3.0
var back_speed := 2.5
var jump_velocity := -13.5
var color := Color.WHITE
var normals := {} # "P" -> move name, "6P" -> forward+P, "K" -> ...
var command_moves: Array = [] # [{motion:[2,3,6], button:"P", move:"rush_palm"}]
var moves := {} # name -> MoveData
var portrait: Texture2D = null
static func load_dir(dir_path: String) -> CharacterData:
var c := CharacterData.new()
var manifest_text := FileAccess.get_file_as_string(dir_path + "/manifest.json")
if manifest_text.is_empty():
push_error("CharacterData: missing manifest.json in " + dir_path)
return c
var d = JSON.parse_string(manifest_text)
c.id = d.get("id", dir_path.get_file())
c.display_name = d.get("name", c.id.to_upper())
c.health = int(d.get("health", 1000))
c.walk_speed = float(d.get("walk_speed", 3.0))
c.back_speed = float(d.get("back_speed", 2.5))
c.jump_velocity = float(d.get("jump_velocity", -13.5))
c.color = Color(d.get("color", "#ffffff"))
c.normals = d.get("normals", {})
c.command_moves = d.get("command_moves", [])
var moves_global := ProjectSettings.globalize_path(dir_path + "/moves")
for move_dir in DirAccess.get_directories_at(moves_global):
c.moves[move_dir] = MoveData.load_dir(dir_path + "/moves/" + move_dir)
var portrait_path := ProjectSettings.globalize_path(dir_path + "/portrait.png")
if FileAccess.file_exists(portrait_path):
var img := Image.load_from_file(portrait_path)
if img:
c.portrait = ImageTexture.create_from_image(img)
return c
static func scan_roster(root := "res://characters") -> Array:
var out: Array = []
var global := ProjectSettings.globalize_path(root)
var dirs := Array(DirAccess.get_directories_at(global))
dirs.sort()
for d in dirs:
if d.begins_with("_") or d.begins_with("."):
continue
out.append(root + "/" + d)
return out