extends CharacterBody3D
## 玩家协调器：只做三件事 —— 多人权限、依赖注入、按固定顺序编排各组件。
##
## 具体能力全在子节点组件里：
##   Look     视角      character/player/player_look.gd
##   Motor    移动跳跃  character/player/player_motor.gd
##   Pickup   拾取      character/player/player_pickup.gd
##   Animator 动画表现  character/player/player_animator.gd（挂在 Body/AnimationPlayer 上）
##
## 本脚本不实现任何操作，只负责「谁先谁后」和「谁有权跑」。

@onready var body: Node3D = $Body
@onready var camera_rig: Node3D = $CameraRig
@onready var camera: Camera3D = $CameraRig/Camera
@onready var animation_player: PlayerAnimator = $AnimationPlayer
@onready var look: PlayerLook = $Look
@onready var motor: PlayerMotor = $Motor
@onready var pickup: PlayerPickup = $Pickup


func _ready() -> void:
	# 远端玩家只是一具「回放身体」：
	#   拆掉相机 —— 否则每多一个玩家就多一台 Camera3D 抢渲染；
	#   关掉输入与物理 —— 否则与权威端双重模拟，表现为抖动、漂移、穿地。
	# 它的 position 与 Body.rotation 由 Sync 子节点同步；血条由 health 同步。
	#
	# 注意：输入已经分散到各组件里，所以这里必须把组件也一起关掉 ——
	# 只关自己是不够的，否则远端玩家照样读本机输入。
	if not is_multiplayer_authority():
		camera_rig.queue_free()
		set_physics_process(false)
		set_process_unhandled_input(false)
		look.set_process_unhandled_input(false)
		motor.set_process_unhandled_input(false)
		pickup.set_process_unhandled_input(false)
		return

	# 依赖注入：组件不自己去 get_node，由这里接线。
	# 好处是组件不认识玩家的场景结构，换场景 / 单测时注入别的节点即可。
	look.setup(camera_rig, camera, body)
	motor.setup(self, camera_rig)
	pickup.setup(
		camera.get_node("InteractionRay") as RayCast3D,
		camera.get_node("InteractionPos") as Marker3D
	)
	set_mouse_captured(true)


func _unhandled_input(event: InputEvent) -> void:
	# 这里只留「跨组件的全局开关」，具体操作归各组件自己处理。
	if event.is_action_pressed("ui_cancel"):
		set_mouse_captured(Input.mouse_mode != Input.MOUSE_MODE_CAPTURED)
	elif event is InputEventMouseButton and event.pressed \
			and Input.mouse_mode != Input.MOUSE_MODE_CAPTURED:
		set_mouse_captured(true)
		# 吃掉这一下点击：它的意义只是「把鼠标锁回游戏」，
		# 不该顺带触发拾取 —— 否则重新聚焦时会凭空抓起一个物体。
		get_viewport().set_input_as_handled()


func set_mouse_captured(captured: bool) -> void:
	Input.mouse_mode = Input.MOUSE_MODE_CAPTURED if captured else Input.MOUSE_MODE_VISIBLE


func _physics_process(delta: float) -> void:
	# 顺序固定：算速度 → 推进 → 播动画 → 搬物体。
	# 由根节点统一编排，各组件自己不许写 _physics_process ——
	# 否则顺序取决于节点树顺序，改个节点位置就会出现「先滑再算速度」这类隐形 bug。
	motor.step(delta)
	move_and_slide()
	animation_player.set_motion(velocity, is_on_floor(), motor.sprinting, motor.crouching)
	pickup.physics_step()