283 lines
7.8 KiB
GDScript
283 lines
7.8 KiB
GDScript
class_name CelesteLocomotionComponent extends JumpLocomotionComponent
|
||
|
||
#region 冲刺相关参数
|
||
@export_category("Dash Properties")
|
||
##最大的冲刺次数
|
||
@export var maxium_dash_count:int = 1
|
||
##Dash时的速度
|
||
@export var dash_speed: float = 240
|
||
##结束Dash的速度
|
||
@export var end_dash_speed: float = 160
|
||
##Dash的冷却时间
|
||
@export var dash_cold_down: float = .2
|
||
##是否在组件ready时自动补充所有的Dash次数
|
||
@export var auto_recover_dash_count_at_ready: bool = true
|
||
#endregion
|
||
|
||
#region 攀爬相关参数
|
||
@export_category("Climb Properties")
|
||
##角色最大耐力
|
||
@export var climb_max_stamina: float
|
||
##角色向上时的速度
|
||
@export var climb_max_speed_upward: float = 45.0
|
||
##角色向下时的速度
|
||
@export var climb_max_speed_downward: float = 80.0
|
||
##角色速度变化时的最大加速度
|
||
@export var climb_acceleration: float = 900.0
|
||
##攀爬到顶点时候的自动代偿速度X
|
||
@export var climb_hop_velocity_x: float = 80
|
||
##攀爬到顶点时候的自动代偿速度Y
|
||
@export var climb_hop_velocity_y: float = 160
|
||
##攀爬跳的速度X
|
||
@export var climb_jump_velocity_x: float = 160
|
||
##攀爬跳的速度Y
|
||
@export var climb_jump_velocity_y: float = 160
|
||
##攀爬跳的最大可输入时长
|
||
@export var climb_jump_time: float = .14
|
||
#endregion
|
||
|
||
#region Custom Move (拉扯移動)
|
||
@export_category("Custom Move")
|
||
##進行自定義運動時，移動的拉力
|
||
@export var custom_move_force: float = 25.0
|
||
##進行自定義運動時，移動的最大速度
|
||
@export var custom_move_max_speed: float = 420.0
|
||
##進行自定義運動時，如果于目標點小於此距離，則會解除自定義運動
|
||
@export var custom_move_stop_distance: float = 4.0
|
||
|
||
var _custom_move_target_node: Node = null
|
||
var _is_custom_moving: bool = false
|
||
signal hook_released
|
||
#endregion
|
||
|
||
#region 冲刺field
|
||
var last_dash_count: int
|
||
##此变量为总开关，如果关闭，则在物理更新里无论如何也是不会更新Dash的，这里默认为false，因为Dash需要手动触发，最好不要常开
|
||
var can_dash: bool = false
|
||
var _dash_direction: Vector2 #存储Dash的Direction
|
||
|
||
signal dash_count_changed(count: int)
|
||
signal dash_brusted
|
||
signal dash_prepared
|
||
#endregion
|
||
|
||
#region 攀爬field
|
||
var can_climb: bool = false
|
||
var _climb_input: float
|
||
var _climb_hop_flag: bool = false
|
||
var _is_climb_jumping: bool = false
|
||
#endregion
|
||
|
||
|
||
func _init_component() -> void:
|
||
super._init_component()
|
||
|
||
if auto_recover_dash_count_at_ready:
|
||
full_recover_dash_count()
|
||
|
||
func _physics_process(delta: float) -> void:
|
||
if Engine.is_editor_hint():
|
||
return
|
||
|
||
if _is_custom_moving:
|
||
_update_custom_move(delta)
|
||
characterbody.move_and_slide()
|
||
return
|
||
|
||
if can_climb:
|
||
_update_climb(delta)
|
||
characterbody.move_and_slide() #移动更新
|
||
return
|
||
|
||
if can_dash:
|
||
characterbody.move_and_slide()
|
||
return
|
||
|
||
super._physics_process(delta)
|
||
|
||
func _update_climb(delta) -> void:
|
||
var target_abs: float
|
||
|
||
#更新目标速度
|
||
if sign(_climb_input) == .0:
|
||
target_abs = 0
|
||
elif sign(_climb_input) > 0:
|
||
target_abs = climb_max_speed_downward
|
||
else:
|
||
target_abs = climb_max_speed_upward
|
||
|
||
var target = target_abs * _climb_input
|
||
characterbody.velocity.y = speed_approach(characterbody.velocity.y,target,climb_acceleration * delta)
|
||
|
||
func _update_dash(delta) -> void:
|
||
return
|
||
|
||
##特殊移動
|
||
func _custom_move_to(target_node: Node) -> bool:
|
||
if target_node == null:
|
||
return false
|
||
# 要求目標至少能提供 global_position（2D 常見）
|
||
if not ("global_position" in target_node):
|
||
push_warning("custom_move target_node has no global_position.")
|
||
return false
|
||
|
||
_custom_move_target_node = target_node
|
||
_is_custom_moving = true
|
||
|
||
# 進入自定義移動時，關掉其他行為（按你需求可調）
|
||
can_dash = false
|
||
can_climb = false
|
||
return true
|
||
|
||
## 停止特殊移動（Custom Move）
|
||
func stop_custom_move(
|
||
force_stop_velocity: bool = true,
|
||
clear_target: bool = true
|
||
) -> void:
|
||
if not _is_custom_moving:
|
||
return
|
||
|
||
_is_custom_moving = false
|
||
|
||
if clear_target:
|
||
_custom_move_target_node = null
|
||
|
||
if force_stop_velocity:
|
||
characterbody.velocity = Vector2.ZERO
|
||
|
||
##預製的保留速度的hook stop
|
||
func _release_hook_keep_momentum() -> void:
|
||
stop_custom_move(false)
|
||
hook_released.emit()
|
||
|
||
##特殊移動更新函數
|
||
func _update_custom_move(delta: float) -> void:
|
||
if not _is_custom_moving:
|
||
return
|
||
|
||
# 目標被刪掉/釋放了
|
||
if _custom_move_target_node == null or not is_instance_valid(_custom_move_target_node):
|
||
_is_custom_moving = false
|
||
_custom_move_target_node = null
|
||
return
|
||
|
||
var target_pos: Vector2 = _custom_move_target_node.global_position
|
||
var pos: Vector2 = characterbody.global_position
|
||
var to_target := target_pos - pos
|
||
var distance := to_target.length()
|
||
|
||
if distance <= custom_move_stop_distance:
|
||
_is_custom_moving = false
|
||
_custom_move_target_node = null
|
||
characterbody.velocity = Vector2.ZERO
|
||
return
|
||
|
||
var dir := to_target / distance
|
||
|
||
# 拉扯加速度：距離越遠越快（“被拉過去”的感覺）
|
||
var acceleration := dir * distance * custom_move_force
|
||
|
||
characterbody.velocity += acceleration * delta
|
||
|
||
# 限制最大速度
|
||
var v_len := characterbody.velocity.length()
|
||
if v_len > custom_move_max_speed:
|
||
characterbody.velocity = characterbody.velocity / v_len * custom_move_max_speed
|
||
|
||
##整合之后的函数，如果不需要额外的逻辑，可以直接通过这个触发Dash
|
||
func integrate_dash(dash_dir: Vector2) -> bool:
|
||
if not predash(dash_dir):
|
||
return false
|
||
await get_tree().process_frame #等待一帧
|
||
brust_dash()
|
||
return true
|
||
|
||
##dash函数，输入一个Dash的方向，返回是否成功
|
||
func brust_dash() -> bool:
|
||
var old: Vector2 = characterbody.velocity;
|
||
var burst: Vector2 = _dash_direction.normalized() * dash_speed;
|
||
|
||
if sign(old.x) == sign(burst.x) and abs(old.x) > abs(burst.x):
|
||
burst.x = old.x
|
||
|
||
characterbody.velocity = burst
|
||
dash_brusted.emit()
|
||
return true
|
||
|
||
##dash准备函数，需要在dash的前一帧触发
|
||
func predash(dash_dir: Vector2) -> bool:
|
||
if not get_can_dash():
|
||
return false
|
||
|
||
dash_prepared.emit()
|
||
last_dash_count = maxi(last_dash_count -1,0)
|
||
can_dash = true
|
||
|
||
_dash_direction = dash_dir
|
||
return true
|
||
|
||
##停止Dash，实际上是关闭Dash标识符
|
||
func stop_dash(force_stop: bool = false) -> void:
|
||
if force_stop:
|
||
characterbody.velocity = Vector2.ZERO
|
||
characterbody.move_and_slide()
|
||
can_dash = false
|
||
|
||
##完全回复的Dash次数
|
||
func full_recover_dash_count() -> void:
|
||
dash_count_changed.emit(last_dash_count)
|
||
last_dash_count = maxium_dash_count
|
||
|
||
##回复指定数量的Dash次数
|
||
func recover_dash_count(recover_count : int) -> void:
|
||
last_dash_count = clampi(last_dash_count+ recover_count, 0,maxium_dash_count)
|
||
|
||
##子类可以重写此方法以自定义Dash的条件
|
||
func get_can_dash() -> bool:
|
||
return last_dash_count > 0
|
||
|
||
##添加攀爬的输入
|
||
func add_climb_input(input: float) -> bool:
|
||
_climb_input = input
|
||
return true
|
||
|
||
##开始攀爬
|
||
func start_climb(force_reset: bool = false) -> void:
|
||
if force_reset:
|
||
characterbody.velocity = Vector2.ZERO
|
||
characterbody.move_and_slide()
|
||
|
||
can_climb = true
|
||
|
||
##终止攀爬
|
||
func suspend_climb() -> void:
|
||
can_climb = false
|
||
|
||
##攀爬补充跳跃
|
||
func climb_hop() -> void:
|
||
_climb_hop_flag = true
|
||
characterbody.velocity = Vector2(climb_hop_velocity_x * Player.get_direction_vector(characterbody.direction).x,-1 * climb_hop_velocity_y)
|
||
|
||
func start_climb_jump() -> bool:
|
||
if _is_jumping : return false
|
||
|
||
#给与一个跳跃的补正速度
|
||
characterbody.velocity.x = _movement_input * climb_jump_velocity_x # 跳跃的水平补正速度
|
||
|
||
_jump_timer = climb_jump_time
|
||
_is_jumping = true
|
||
_is_climb_jumping = true
|
||
can_climb = false #取消掉原本的climb，如果后续重新触发climb，则重新判断
|
||
characterbody.velocity.y = _get_jump_force()
|
||
|
||
return true
|
||
|
||
func stop_climb_jump() -> void:
|
||
_is_jumping = false
|
||
_is_climb_jumping = false
|
||
|
||
func _get_jump_force() -> float:
|
||
if _is_climb_jumping:
|
||
return -1 * climb_jump_velocity_y
|
||
return super._get_jump_force()
|