mtgodot-poc/project/fx/effect_registry.gd

# EffectRegistry (P5) —— 按名字 / 路径找 `.mse`，缓存解析结果，生成 EffectPlayer。
#
#   var fxr := preload("res://fx/effect_registry.gd").new()
#   fxr.setup(assets_root)
#   fxr.spawn("geompung_3_sword", weapon_bone_node)      # 挂到某节点下播一次性
#   var pv := fxr.spawn_at("hit_spark", world, global_pos)
extends RefCounted

const Mse = preload("res://fx/mse.gd")
const EffectPlayer = preload("res://fx/effect_player.gd")

var assets_root := ""
var _path_cache := {}    # name -> abs .mse path ("" = not found)
var _spec_cache := {}    # abs path -> parsed spec

func setup(assets: String) -> void:
	assets_root = assets

# name 可为： 裸名 "xxx"（扫 **/effect/ 下 xxx.mse）· 相对 "effect/xxx.mse" · "d:/ymir work/.../xxx.mse"
func resolve(name: String) -> String:
	if _path_cache.has(name):
		return _path_cache[name]
	var p := _resolve_uncached(name)
	_path_cache[name] = p
	return p

func _resolve_uncached(name: String) -> String:
	if assets_root == "":
		return ""
	var rel := name.replace("\\", "/")
	if rel.length() >= 2 and rel[1] == ":":
		rel = rel.substr(2)
	rel = rel.lstrip("/")
	if not rel.ends_with(".mse"):
		rel += ".mse"
	# 直接 / 散包相对
	for cand in [assets_root.path_join(rel)]:
		if FileAccess.file_exists(cand):
			return cand
	var da := DirAccess.open(assets_root)
	if da:
		for sub in da.get_directories():
			var c := assets_root.path_join(sub).path_join(rel)
			if FileAccess.file_exists(c):
				return c
	# 裸名：按 basename 递归找（限定 effect 目录，限量）
	if not name.contains("/"):
		var bn := rel.get_file()
		var hit := _scan_for(assets_root, bn, 7)
		if hit != "":
			return hit
	return ""

func _scan_for(dir: String, basename: String, depth: int) -> String:
	if depth < 0:
		return ""
	var da := DirAccess.open(dir)
	if da == null:
		return ""
	for f in da.get_files():
		if f == basename:
			return dir.path_join(f)
	for sub in da.get_directories():
		if sub.begins_with("."):
			continue
		var r := _scan_for(dir.path_join(sub), basename, depth - 1)
		if r != "":
			return r
	return ""

func spec_for(name: String) -> Dictionary:
	var p := resolve(name)
	if p == "":
		return {}
	if _spec_cache.has(p):
		return _spec_cache[p]
	var s := Mse.new().parse_file(p)
	_spec_cache[p] = s
	return s

# 挂到 parent 下（跟随 parent 变换），播一次性
func spawn(name: String, parent: Node3D, one_shot := true) -> Node3D:
	var s := spec_for(name)
	if s.is_empty() or parent == null:
		return null
	var fx: Node3D = EffectPlayer.new()
	fx.name = "fx_" + name.get_file().get_basename()
	fx.one_shot = one_shot
	fx.build(s, assets_root)
	parent.add_child(fx)
	fx.play(one_shot)
	return fx

# 在世界某点播一次性
func spawn_at(name: String, world_parent: Node3D, global_pos: Vector3, one_shot := true) -> Node3D:
	var fx := spawn(name, world_parent, one_shot)
	if fx:
		fx.global_position = global_pos
	return fx