148 lines
6.5 KiB
GDScript
148 lines
6.5 KiB
GDScript
class_name PlayerPickup
|
||
extends Node
|
||
## 拾取组件：**按住左键拖拽，松手放下，按 Q 朝准心方向甩出去**。
|
||
## 按下左键时用射线抓起正前方的 RigidBody3D，按住期间持续吸在 InteractionPos 前；
|
||
## 松开左键即原地放开，按 Q 则沿视线方向把手上的物体甩出去。
|
||
## 只管「抓 / 拖 / 放 / 甩」，不碰移动与视角。
|
||
##
|
||
## 接法：Player 下挂一个普通 Node，脚本挂上去；由 Player._ready() 注入射线、持握点与玩家本体。
|
||
|
||
## 拖拽力度：物体被拉向持握点的速度系数。越大跟手越紧，但过大容易来回抖。
|
||
## 注意：它同时决定了拖拽时的稳态滞后 —— 滞后距离 = 移动速度 / pick_power。
|
||
@export var pick_power: float = 10.0
|
||
## 投掷初速度（米/秒）：按 Q 甩出去时给物体的速度大小。
|
||
@export var throw_speed: float = 12.0
|
||
## 拖拽速度上限（米/秒）。防止物体离得远时被一股脑拽飞。
|
||
@export var max_drag_speed: float = 30.0
|
||
|
||
## 交互状态变化时发出。
|
||
## hovering = 准心正指着可拖拽的刚体（还没抓）；holding = 正抓着东西。
|
||
## Player 接住这个信号去切准心外观。只在两者之一变化时发，避免每帧刷 UI。
|
||
signal interact_state_changed(hovering: bool, holding: bool)
|
||
|
||
var _current: RigidBody3D = null
|
||
var _ray: RayCast3D
|
||
var _hold_pos: Marker3D
|
||
## 玩家本体。用来给被拖物体加碰撞例外，以及做速度前馈。
|
||
var _body: CharacterBody3D
|
||
## 上一次发出的状态，用来只在「变化那一刻」发信号。
|
||
var _hovering: bool = false
|
||
var _holding: bool = false
|
||
|
||
|
||
## 由 Player 在 _ready() 注入依赖。body 是玩家本体（CharacterBody3D）。
|
||
func setup(ray: RayCast3D, hold_pos: Marker3D, body: CharacterBody3D) -> void:
|
||
_ray = ray
|
||
_hold_pos = hold_pos
|
||
_body = body
|
||
|
||
|
||
func _unhandled_input(event: InputEvent) -> void:
|
||
# 只有鼠标锁进游戏（真正在玩）时才响应抓 / 拖 / 放 / 甩。
|
||
# 否则「点一下把鼠标锁回来」的那次点击会顺带抓起一个物体。
|
||
if Input.mouse_mode != Input.MOUSE_MODE_CAPTURED:
|
||
return
|
||
# 长按拖拽：按下抓起，松开放下；拖拽途中按 Q 可以把手上的东西甩出去。
|
||
# 按住期间不需要任何输入处理 —— 物体靠 physics_step() 每物理帧持续吸住。
|
||
if event.is_action_pressed("carry"):
|
||
_grab()
|
||
elif event.is_action_released("carry"):
|
||
_drop()
|
||
elif event.is_action_pressed("throw_carry"):
|
||
_throw()
|
||
|
||
|
||
## 每物理帧由 Player 调用一次，排在 move_and_slide() 之后。
|
||
## 用速度把物体拽向持握点，而不是直接改 global_position ——
|
||
## 这样它仍会和场景里其他刚体正常碰撞，不会被硬塞进墙里。
|
||
func physics_step() -> void:
|
||
_update_interact_state()
|
||
# 用 is_instance_valid 而不是 `== null`：物体可能在拖拽途中被 destroy，
|
||
# 那种情况下引用不是 null 而是「已被释放」，直接取 global_position 会报错。
|
||
if not is_instance_valid(_current) or not is_instance_valid(_hold_pos):
|
||
return
|
||
|
||
var to_hold := _hold_pos.global_position - _current.global_position
|
||
var desired := to_hold * pick_power
|
||
# 速度前馈：把玩家自身的速度加进去。
|
||
#
|
||
# 只靠 to_hold * pick_power 的话，它是一个一阶跟随 —— 人匀速前进时物体必然
|
||
# 落后一个稳态距离，大小 = 移动速度 / pick_power。按 5 / 10 算就是 0.5 米，
|
||
# 比持握点离身体的 0.44 米还远，于是走着走着物体就退进了玩家碰撞体里，
|
||
# 被物理推出来、又被拽回去，两边打架 —— 看起来就是「一卡一卡」。
|
||
# 加上玩家速度后，匀速行走时滞后归零，物体稳稳待在身前。
|
||
if _body != null:
|
||
desired += _body.velocity
|
||
if desired.length() > max_drag_speed:
|
||
desired = desired.normalized() * max_drag_speed
|
||
_current.set_linear_velocity(desired)
|
||
|
||
|
||
## 检测「指着可拖拽物 / 正抓着东西」这两个状态，**只在变化时**发信号。
|
||
## 每帧都发会让 UI 无谓重绘，所以这里自己记着上一次的结果。
|
||
func _update_interact_state() -> void:
|
||
if _ray == null:
|
||
return
|
||
# 主动刷新一次：RayCast3D 的结果通常滞后于本帧的 move_and_slide，
|
||
# 不强制更新的话，跑动中瞄到物体要慢一帧才亮。
|
||
_ray.force_raycast_update()
|
||
var hovering := _ray.get_collider() is RigidBody3D
|
||
var holding := is_instance_valid(_current)
|
||
if hovering == _hovering and holding == _holding:
|
||
return
|
||
_hovering = hovering
|
||
_holding = holding
|
||
interact_state_changed.emit(_hovering, _holding)
|
||
|
||
|
||
func _grab() -> void:
|
||
if _ray == null or is_instance_valid(_current):
|
||
return
|
||
var collider := _ray.get_collider()
|
||
if collider is RigidBody3D:
|
||
_current = collider as RigidBody3D
|
||
# 让被拖的物体和玩家本体**互不碰撞**。
|
||
# 否则物体一旦挨到身体就会被物理推出，而拖拽又立刻把它拉回来 ——
|
||
# 两个解算器互相打架，表现就是持续的高频抖动。
|
||
# 只解除「物体 ↔ 玩家」这一对，物体和场景里其他东西照样正常碰撞。
|
||
if _body != null:
|
||
_current.add_collision_exception_with(_body)
|
||
|
||
|
||
func _drop() -> void:
|
||
# 故意不清零线速度：松手时保留拖动惯性，甩出去的手感更自然。
|
||
# 想要「就地放下、不再滑出去」的话，这里补一句：
|
||
# if is_instance_valid(_current): _current.set_linear_velocity(Vector3.ZERO)
|
||
_forget(_current)
|
||
_current = null
|
||
|
||
|
||
## 清掉抓取时留下的碰撞例外。物体可能已被销毁，所以先判有效性。
|
||
func _forget(body: RigidBody3D) -> void:
|
||
if is_instance_valid(body) and _body != null:
|
||
body.remove_collision_exception_with(_body)
|
||
|
||
|
||
## 按 Q 投掷：沿视线方向把物体甩出去，随后立刻松手。
|
||
func _throw() -> void:
|
||
if not is_instance_valid(_current) or not is_instance_valid(_hold_pos):
|
||
return
|
||
# 持握点挂在摄像机下、且只有平移没有旋转，所以它的 basis 就是视线朝向，
|
||
# 其 -Z 即「准心正前方」。这样不必再给组件注入一台摄像机。
|
||
var dir := -_hold_pos.global_transform.basis.z
|
||
_current.set_linear_velocity(dir * throw_speed)
|
||
# 想让手感更「物理」（重物飞得慢、轻物飞得远）可以换成给冲量：
|
||
# _current.apply_central_impulse(dir * throw_speed)
|
||
_forget(_current)
|
||
_current = null
|
||
|
||
|
||
## 当前是否抓着东西。调试用，也方便以后加「搬运时不能开枪」这类规则。
|
||
func has_object() -> bool:
|
||
return is_instance_valid(_current)
|
||
|
||
|
||
## 当前准心是否指着可拖拽的刚体（还没抓）。调试用。
|
||
func is_hovering() -> bool:
|
||
return _hovering
|