bazar_alea/client/player/CharacterMovementComponent.gd

extends Node
class_name CharacterMovementComponent

signal start_jump(vertical_velocity:Vector3)

#####################################
@export_category("References")
#Refrences

## Refrence to character mesh, should be assigned to a [Node3D] that is a parent to the actual mesh (Skeleton3D)
@export var mesh_ref : Node
## Refrence to AnimationTree that uses the AnimBlend Script provided in the addon
@export var anim_ref : AnimBlend 
## Refrence to character mesh which should probably be [Skeleton3D]
@export var skeleton_ref : Skeleton3D 
## Refrence to the [CollisionShape3D] used for the character
@export var collision_shape_ref : CollisionShape3D
#@onready var bonker = $CollisionShape3D/HeadBonker
## Refrence to [CameraComponent] Node provided by the addon
@export var camera_root : CameraComponent 

## Refrence to Tree Root, which should be either a [CharacterBody3D] or [RigidBody3D]
@export var character_node : PhysicsBody3D
## Refrence to a [RayCast3D] that should detect if character is on ground
@export var ground_check : RayCast3D
## Reference to a [Market3D]
@export var look_at_object : Marker3D

#####################################



#####################################
#Movement Settings
@export_category("Movement Data")
@export var AI := false

@export var is_flying := false
var gravity : float = ProjectSettings.get_setting("physics/3d/default_gravity")

@export var tilt := false
@export var tilt_power := 1.0


@export var ragdoll := false :
	get: return ragdoll
	set(Newragdoll):
		ragdoll = Newragdoll
		if ragdoll == true:
			if skeleton_ref:
				skeleton_ref.physical_bones_start_simulation()
		else:
			if skeleton_ref:
				skeleton_ref.physical_bones_stop_simulation()


@export var jump_magnitude := 4.0

## the maximum height of stair that the character can step on
@export var max_stair_climb_height : float = 0.5

## the distance to the stair that the script will start detecting it
@export var max_close_stair_distance : float = 0.75


@export var roll_magnitude := 17.0

var default_height := 2.0
var crouch_height := 1.0

@export var crouch_switch_speed := 5.0 

## the maximum angle between the camera and the character's rotation.
## when the angle between them exceeds this value, the character will rotate in place to face the camera direction.
@export var rotation_in_place_min_angle := 90.0 

@export var deacceleration := 0.5
## Movement Values Settings
## you can change the values to achieve different movement settings
@export var looking_direction_standing_data : MovementValues
## Movement Values Settings
## you can change the values to achieve different movement settings
@export var looking_direction_crouch_data : MovementValues
## Movement Values Settings
## you can change the values to achieve different movement settings
@export var velocity_direction_standing_data : MovementValues
## Movement Values Settings
## you can change the values to achieve different movement settings
@export var velocity_direction_crouch_data : MovementValues
## Movement Values Settings
## you can change the values to achieve different movement settings
@export var aim_standing_data : MovementValues
## Movement Values Settings
## you can change the values to achieve different movement settings
@export var aim_crouch_data : MovementValues
#####################################














#####################################
#for logic #it is better not to change it if you don't want to break the system / only change it if you want to redesign the system

## returns the actual acceleration in [Vector3]
var actual_acceleration :Vector3
## returns the acceleration that the character should move with, aka input acceleration
var input_acceleration :Vector3

var input_direction:Vector3

var vertical_velocity :Vector3

## returns the actual velocity for the player.
## so for example if player is holding forward key, but character is stuck by wall, it will return 0 velocity.
var actual_velocity :Vector3
var velocity :Vector3
## returns the input velocity for the player.
## so for example if player is holding forward key, but character is stuck by wall, it will return the velocity that the character should move using it.
var input_velocity :Vector3

## the Y/UP rotation of the movement direction
var movement_direction : float

var tiltVector : Vector3

## is the character actually moving ? regardless of the player input.
var is_moving := false
## is the player trying to move / holding input key.
var input_is_moving := false

var head_bonked := false

var is_rotating_in_place := false
var rotation_difference_camera_mesh : float

var aim_rate_h :float

var is_moving_on_stair :bool


var current_movement_data : MovementValues = MovementValues.new()
#####################################

#animation
var animation_is_moving_backward_relative_to_camera : bool
var animation_velocity : Vector3

#status
@export var movement_state = Global.MOVEMENT_STATE.GROUNDED
var movement_action = Global.MOVEMENT_ACTION.NONE
@export_category("States")
@export var rotation_mode : Global.ROTATION_MODE = Global.ROTATION_MODE.VELOCITY_DIRECTION :
	get: return rotation_mode
	set(Newrotation_mode):
		rotation_mode = Newrotation_mode
		update_character_movement()
		
		
@export var gait : Global.GAIT = Global.GAIT.WALKING : # Demarche (attente, marche, ...)
	get: return gait
	set(Newgait):
		gait = Newgait
		update_character_movement()
@export var stance : Global.STANCE = Global.STANCE.STANDING : # Position (debout, accroupi, ..)
	set(Newstance):
		stance = Newstance
		update_character_movement()
@export var overlay_state = Global.OVERLAY_STATE

@export_category("Animations")
@export var TurnLeftAnim : String = "TurnLeft":
	set(value):
		TurnLeftAnim = value
		update_animations()
@export var TurnRightAnim : String = "TurnRight":
	set(value):
		TurnRightAnim = value
		update_animations()
@export var FallingAnim : String = "Falling":
	set(value):
		FallingAnim = value
		update_animations()
@export var IdleAnim : String = "Idle":
	set(value):
		IdleAnim = value
		update_animations()
@export var WalkForwardAnim : String = "WalkForward":
	set(value):
		WalkForwardAnim = value
		update_animations()
@export var WalkBackwardAnim : String = "WalkBackward":
	set(value):
		WalkBackwardAnim = value
		update_animations()
@export var JogForwardAnim : String = "JogForward":
	set(value):
		JogForwardAnim = value
		update_animations()
@export var JogBackwardAnim : String = "Jogbackward":
	set(value):
		JogBackwardAnim = value
		update_animations()
@export var RunAnim : String = "Run":
	set(value):
		RunAnim = value
		update_animations()
@export var StopAnim : String = "RunToStop":
	set(value):
		StopAnim = value
		update_animations()
@export var CrouchIdleAnim : String = "CrouchIdle":
	set(value):
		CrouchIdleAnim = value
		update_animations()
@export var CrouchWalkAnim : String = "CrouchWalkingForward":
	set(value):
		CrouchWalkAnim = value
		update_animations()
#####################################


func update_animations():
	if !anim_ref:
		return
	anim_ref.get_tree_root().get_node("AnimTurnLeft").set_animation(TurnLeftAnim)
	anim_ref.get_tree_root().get_node("AnimTurnRight").animation = TurnRightAnim
	anim_ref.get_tree_root().get_node("FallAnimation").animation = FallingAnim
	#var velocity_direction : AnimationNodeBlendTree = anim_ref.get_tree_root().get_node("VelocityDirection")
	anim_ref.get_tree_root().get_node("Idle").animation = IdleAnim
	anim_ref.get_tree_root().get_node("WalkForward").animation = WalkForwardAnim
	anim_ref.get_tree_root().get_node("WalkBackward").animation = WalkBackwardAnim
	anim_ref.get_tree_root().get_node("JogForward").animation = JogForwardAnim
	anim_ref.get_tree_root().get_node("JogBackward").animation = JogBackwardAnim
	anim_ref.get_tree_root().get_node("Run").animation = RunAnim
	anim_ref.get_tree_root().get_node("StopAnim").animation = StopAnim
	anim_ref.get_tree_root().get_node("CrouchIdle").animation = CrouchIdleAnim
	anim_ref.get_tree_root().get_node("CrouchWalkingForward").animation = CrouchWalkAnim

func update_character_movement():
	match rotation_mode:
		Global.ROTATION_MODE.VELOCITY_DIRECTION:
#			if skeleton_ref:
#				skeleton_ref.modification_stack.enabled = false
			tilt = false
			match stance:
				Global.STANCE.STANDING:
					current_movement_data = velocity_direction_standing_data
				Global.STANCE.CROUCHING:
					current_movement_data = velocity_direction_crouch_data
					
					
		Global.ROTATION_MODE.LOOKING_DIRECTION:
#			if skeleton_ref:
#				skeleton_ref.modification_stack.enabled = false #Change to true when Godot fixes the bug.
			tilt = true
			match stance:
				Global.STANCE.STANDING:
					current_movement_data = looking_direction_standing_data
				Global.STANCE.CROUCHING:
					current_movement_data = looking_direction_crouch_data
					
					
		Global.ROTATION_MODE.AIMING:
			match stance:
				Global.STANCE.STANDING:
					current_movement_data = aim_standing_data
				Global.STANCE.CROUCHING:
					current_movement_data = aim_crouch_data
#####################################

var previous_aim_rate_h :float


var test_sphere : MeshInstance3D = MeshInstance3D.new()
var test_sphere1 : MeshInstance3D = MeshInstance3D.new()
func _ready():
	if not character_node is CharacterBody3D and not character_node is RigidBody3D:
		assert(false, "Character Node Must be either CharacterBody3D or RigidBody3D, please choose the right node from the inspector.")
		
	if character_node is RigidBody3D:
		character_node.mass = 80
		character_node.continuous_cd = true
		character_node.max_contacts_reported = 1
		character_node.contact_monitor = true
		character_node.freeze_mode = RigidBody3D.FREEZE_MODE_KINEMATIC
		character_node.axis_lock_angular_x = true
		character_node.axis_lock_angular_y = true
		character_node.axis_lock_angular_z = true
		character_node.linear_damp = deacceleration
	#--------- These tests are for stride warping ---------# 
#	test_sphere.mesh = SphereMesh.new()
#	test_sphere1.mesh = SphereMesh.new()
#	test_sphere.mesh.height = 0.2
#	test_sphere.mesh.radius = 0.1
#	test_sphere1.mesh.height = 0.2
#	test_sphere1.mesh.radius = 0.1
#	test_sphere.mesh.material = StandardMaterial3D.new()
#	test_sphere1.mesh.material = StandardMaterial3D.new()
#	test_sphere.mesh.material.albedo_color = Color.GREEN
#	test_sphere1.mesh.material.albedo_color = Color.RED
	
	update_animations()
	update_character_movement()
var pose_warping_instance = PoseWarping.new()


func _process(delta):
	calc_animation_data()
	var orientation_warping_condition = rotation_mode != Global.ROTATION_MODE.VELOCITY_DIRECTION and \
		movement_state == Global.MOVEMENT_STATE.GROUNDED and \
		movement_action == Global.MOVEMENT_ACTION.NONE and \
		gait != Global.GAIT.SPRINTING and \
		input_is_moving
	pose_warping_instance.orientation_warping( orientation_warping_condition,camera_root.HObject,animation_velocity,skeleton_ref,"Hips",["Spine","Spine1","Spine2"],0.0,delta)


func _physics_process(delta):
	#Debug()
	#
	aim_rate_h = abs((camera_root.HObject.rotation.y - previous_aim_rate_h) / delta)
	previous_aim_rate_h = camera_root.HObject.rotation.y
	#
	#animation_stride_warping()

	match movement_state:
		Global.MOVEMENT_STATE.NONE:
			pass
		Global.MOVEMENT_STATE.GROUNDED:
			#------------------ Rotate Character Mesh ------------------#
			match movement_action:
				Global.MOVEMENT_ACTION.NONE:
					match rotation_mode:
							Global.ROTATION_MODE.VELOCITY_DIRECTION: 
								if (is_moving and input_is_moving) or (actual_velocity * Vector3(1.0,0.0,1.0)).length() > 0.5:
									smooth_character_rotation(actual_velocity,calc_grounded_rotation_rate(),delta)
							Global.ROTATION_MODE.LOOKING_DIRECTION:
								if (is_moving and input_is_moving) or (actual_velocity * Vector3(1.0,0.0,1.0)).length() > 0.5:
									smooth_character_rotation(-camera_root.HObject.transform.basis.z if gait != Global.GAIT.SPRINTING else actual_velocity,calc_grounded_rotation_rate(),delta)
								rotate_in_place_check()
							Global.ROTATION_MODE.AIMING:
								if (is_moving and input_is_moving) or (actual_velocity * Vector3(1.0,0.0,1.0)).length() > 0.5:
									smooth_character_rotation(-camera_root.HObject.transform.basis.z,calc_grounded_rotation_rate(),delta)
								rotate_in_place_check()
				Global.MOVEMENT_ACTION.ROLLING:
					if input_is_moving == true:
						smooth_character_rotation(input_acceleration ,2.0,delta)
		
		Global.MOVEMENT_STATE.IN_AIR:
			#------------------ Rotate Character Mesh In Air ------------------#
			match rotation_mode:
					Global.ROTATION_MODE.VELOCITY_DIRECTION: 
						smooth_character_rotation(actual_velocity if (actual_velocity * Vector3(1.0,0.0,1.0)).length() > 1.0 else  -camera_root.HObject.transform.basis.z,5.0,delta)
					Global.ROTATION_MODE.LOOKING_DIRECTION:
						smooth_character_rotation(actual_velocity if (actual_velocity * Vector3(1.0,0.0,1.0)).length() > 1.0 else  -camera_root.HObject.transform.basis.z,5.0,delta)
					Global.ROTATION_MODE.AIMING:
						smooth_character_rotation(-camera_root.HObject.transform.basis.z ,15.0,delta)
			#------------------ Mantle Check ------------------#
			if input_is_moving == true:
				mantle_check()
		Global.MOVEMENT_STATE.MANTLING:
			pass
		Global.MOVEMENT_STATE.RAGDOLL:
			pass
	
	#------------------ Crouch ------------------#
	crouch_update(delta)

	#------------------ Gravity ------------------#
	if is_flying == false and character_node is CharacterBody3D:
		character_node.velocity.y =  lerp(character_node.velocity.y,vertical_velocity.y - character_node.get_floor_normal().y,delta * gravity)
		character_node.move_and_slide()
	if ground_check.is_colliding() and is_flying == false:
		movement_state = Global.MOVEMENT_STATE.GROUNDED
	else:
		await get_tree().create_timer(0.1).timeout #wait a moment to see if the character lands fast (this means that the character didn't fall, but stepped down a bit.)
		movement_state = Global.MOVEMENT_STATE.IN_AIR
		if character_node is CharacterBody3D:
			vertical_velocity += Vector3.DOWN * gravity * delta
	if character_node is CharacterBody3D and character_node.is_on_ceiling():
		vertical_velocity.y = 0
	#------------------ Stair climb ------------------#
	#stair movement must happen after gravity so it can override in air status
	stair_move()

func crouch_update(delta):
	var direct_state = character_node.get_world_3d().direct_space_state
	var ray_info : PhysicsRayQueryParameters3D = PhysicsRayQueryParameters3D.new()
	ray_info.exclude = [RID(collision_shape_ref)]
	
	ray_info.from = collision_shape_ref.global_transform.origin + Vector3(0,collision_shape_ref.shape.height/2,0)
	ray_info.to = ray_info.from + Vector3(0, 0.2, 0)
	var collision = direct_state.intersect_ray(ray_info)
	if collision:
		head_bonked = true
	else:
		head_bonked = false
	
	ground_check.position.y = -(collision_shape_ref.shape.height/2)+collision_shape_ref.position.y + 0.2#Just a small margin
	
	if stance == Global.STANCE.CROUCHING:
		collision_shape_ref.shape.height -= crouch_switch_speed * delta /2
		mesh_ref.transform.origin.y += crouch_switch_speed * delta /1.5
	elif stance == Global.STANCE.STANDING and not head_bonked:
		collision_shape_ref.shape.height += crouch_switch_speed * delta /2
		mesh_ref.transform.origin.y -= crouch_switch_speed * delta /1.5
	elif head_bonked:
		pass
	mesh_ref.transform.origin.y = clamp(mesh_ref.transform.origin.y,0.0,0.5)
	collision_shape_ref.shape.height = clamp(collision_shape_ref.shape.height,crouch_height,default_height)


func stair_move():
	var direct_state = character_node.get_world_3d().direct_space_state
	var obs_ray_info : PhysicsRayQueryParameters3D = PhysicsRayQueryParameters3D.new()
	obs_ray_info.exclude = [RID(character_node)]
	obs_ray_info.from = mesh_ref.global_transform.origin
	if movement_direction:
		obs_ray_info.to = obs_ray_info.from + Vector3(0, 0, max_close_stair_distance).rotated(Vector3.UP,movement_direction)
	
	#this is used to know if there is obstacle 
	var first_collision = direct_state.intersect_ray(obs_ray_info)
	if first_collision and input_is_moving:
		var climb_ray_info : PhysicsRayQueryParameters3D = PhysicsRayQueryParameters3D.new()
		climb_ray_info.exclude = [RID(character_node)]
		climb_ray_info.from = first_collision.collider.global_position + Vector3(0, max_stair_climb_height, 0)
		climb_ray_info.to = first_collision.collider.global_position
		var stair_top_collision = direct_state.intersect_ray(climb_ray_info)
		if stair_top_collision:
			if stair_top_collision.position.y - character_node.global_position.y > 0 and stair_top_collision.position.y - character_node.global_position.y < 0.15:
				movement_state = Global.MOVEMENT_STATE.GROUNDED
				is_moving_on_stair = true
				character_node.position.y += stair_top_collision.position.y - character_node.global_position.y
				character_node.global_position += Vector3(0, 0, 0.01).rotated(Vector3.UP,movement_direction)
			else:
				await get_tree().create_timer(0.4).timeout
				is_moving_on_stair = false
		else:
			await get_tree().create_timer(0.4).timeout
			is_moving_on_stair = false
	else:
		await get_tree().create_timer(0.4).timeout
		is_moving_on_stair = false



func smooth_character_rotation(Target:Vector3,nodelerpspeed,delta):
	mesh_ref.rotation.y = lerp_angle(mesh_ref.rotation.y, atan2(Target.x,Target.z) , delta * nodelerpspeed)


func set_bone_x_rotation(skeleton,bone_name, x_rot, _CharacterRootNode):
	var bone = skeleton.find_bone(bone_name)
	var bone_transform : Transform3D = skeleton.global_pose_to_local_pose(bone,skeleton.get_bone_global_pose_no_override(bone))
	var rotate_amount = x_rot
	bone_transform = bone_transform.rotated(Vector3(1,0,0), rotate_amount)
	skeleton.set_bone_local_pose_override(bone, bone_transform,1.0,true)
	

var prev :Transform3D 
var current :Transform3D
var anim_speed
func animation_stride_warping(): #this is currently being worked on and tested, so I don't reccomend using it.
	add_sibling(test_sphere)
	add_sibling(test_sphere1)
	
	skeleton_ref.clear_bones_local_pose_override()
	var distance_in_each_frame = (actual_velocity*Vector3(1,0,1)).rotated(Vector3.UP,mesh_ref.transform.basis.get_euler().y).length() 
	var hips = skeleton_ref.find_bone("Hips")
	var hips_transform = skeleton_ref.get_bone_pose(hips)
	var Feet : Array = ["RightFoot","LeftFoot"]
	var Thighs : Array = ["RightUpLeg","LeftUpLeg"]
	
	#var hips_distance_to_ground
	var stride_scale : float = 1.0
	for Foot in Feet:
		#Get Bones
		var bone = skeleton_ref.find_bone(Foot)
		var bone_transform = skeleton_ref.get_bone_global_pose_no_override(bone)
		
		var thigh_bone = skeleton_ref.find_bone(Thighs[Feet.find(Foot)])
		var thigh_transform = skeleton_ref.get_bone_global_pose_no_override(thigh_bone)
		#var thigh_angle = thigh_transform.basis.get_euler().x
		
		#Calculate
		var stride_direction : Vector3 = Vector3.FORWARD # important to use in orientation warping
		var stride_warping_plane_origin = Plane(character_node.get_floor_normal(),bone_transform.origin).intersects_ray(thigh_transform.origin,Vector3.DOWN)
#		print(stride_warping_plane_origin)
		if stride_warping_plane_origin == null:
			return #Failed to get a plane origin/ we are probably in air

		var scale_origin = Plane(stride_direction,stride_warping_plane_origin).project(bone_transform.origin)
		var anim_speed_ = pow(hips_transform.origin.distance_to(bone_transform.origin),2) - pow(hips_transform.origin.y,2) 
		anim_speed_ = sqrt(abs(anim_speed_))
		stride_scale = clampf(distance_in_each_frame/anim_speed_,0.0,2.0)
#		print(test_sphere.global_position)
		var foot_warped_location : Vector3 = scale_origin + (bone_transform.origin - scale_origin) * stride_scale

		# Apply
		
		#test
		test_sphere.position = foot_warped_location.rotated(Vector3.UP,movement_direction)
		test_sphere1.position = bone_transform.origin.rotated(Vector3.UP,movement_direction)
		#I should replace this with leg IK system, and its target position is the foot_warped_location
		

func calc_grounded_rotation_rate():
	if input_is_moving == true:
		match gait:
			Global.GAIT.WALKING:
				return lerp(current_movement_data.idle_rotation_rate,current_movement_data.walk_rotation_rate, Global.map_range_clamped((actual_velocity * Vector3(1.0,0.0,1.0)).length(),0.0,current_movement_data.walk_speed,0.0,1.0)) * clamp(aim_rate_h,1.0,3.0)
			Global.GAIT.RUNNING:
				return lerp(current_movement_data.walk_rotation_rate,current_movement_data.run_rotation_rate, Global.map_range_clamped((actual_velocity * Vector3(1.0,0.0,1.0)).length(),current_movement_data.walk_speed,current_movement_data.run_speed,1.0,2.0)) * clamp(aim_rate_h,1.0,3.0)
			Global.GAIT.SPRINTING:
				return lerp(current_movement_data.run_rotation_rate,current_movement_data.sprint_rotation_rate,  Global.map_range_clamped((actual_velocity * Vector3(1.0,0.0,1.0)).length(),current_movement_data.run_speed,current_movement_data.sprint_speed,2.0,3.0)) * clamp(aim_rate_h,1.0,2.5)
	else:
		return current_movement_data.idle_rotation_rate * clamp(aim_rate_h,1.0,3.0)



func rotate_in_place_check():
	is_rotating_in_place = false
	if !input_is_moving:
		
		var CameraAngle = Quaternion(Vector3(0,1,0),camera_root.HObject.rotation.y) 
		var MeshAngle = Quaternion(Vector3(0,1,0),mesh_ref.rotation.y) 
		
		rotation_difference_camera_mesh = rad_to_deg(MeshAngle.angle_to(CameraAngle) - PI)
		if (CameraAngle.dot(MeshAngle)) > 0:
			rotation_difference_camera_mesh *= -1
		if floor(abs(rotation_difference_camera_mesh)) > rotation_in_place_min_angle:
			is_rotating_in_place = true
			smooth_character_rotation(-camera_root.HObject.transform.basis.z,calc_grounded_rotation_rate(),get_physics_process_delta_time()) 
	

func ik_look_at(position: Vector3):
	if look_at_object:
		look_at_object.position = position


var PrevVelocity :Vector3

## Adds input to move the character, should be called when Idle too, to execute deacceleration for CharacterBody3D or reset velocity for RigidBody3D.
## when Idle speed and direction should be passed as 0, and deacceleration passed, or leave them empty.
func add_movement_input(direction: Vector3 = Vector3.ZERO, Speed: float = 0, Acceleration: float = deacceleration if character_node is CharacterBody3D else 0.0) -> void:
	var max_speed : float = Speed
	input_direction = direction
	
	if character_node is RigidBody3D:
		if is_flying == false:
			velocity.x = direction.x * Acceleration * character_node.mass * get_physics_process_delta_time()
			velocity.z = direction.z * Acceleration * character_node.mass * get_physics_process_delta_time()
		else:
			velocity = direction * Acceleration * character_node.mass * get_physics_process_delta_time()
		
		if is_inf(character_node.linear_velocity.length()):
			character_node.linear_velocity = velocity
		if character_node.linear_velocity.length() > max_speed:
			velocity = direction
		character_node.apply_central_impulse(velocity)

	if character_node is CharacterBody3D:
		if is_flying == false:
			character_node.velocity.x = lerp(character_node.velocity.x,(direction*max_speed).x,Acceleration/(max_speed if max_speed != 0 else (abs(character_node.velocity.x) if character_node.velocity.x != 0 else 1.0))*get_physics_process_delta_time())
			character_node.velocity.z = lerp(character_node.velocity.z,(direction*max_speed).z,Acceleration/(max_speed if max_speed != 0 else (abs(character_node.velocity.z) if character_node.velocity.z != 0 else 1.0))*get_physics_process_delta_time())
		else:
			character_node.velocity = character_node.velocity.lerp((direction*max_speed),Acceleration/(max_speed if max_speed != 0 else character_node.velocity.x if character_node.velocity.x != 0 else 1.0)*get_physics_process_delta_time())
			character_node.move_and_slide()
	# Get the velocity from the character node
	var character_node_velocity = character_node.velocity if character_node is CharacterBody3D else character_node.linear_velocity
	
	input_velocity = direction*max_speed if character_node is CharacterBody3D else velocity 
	movement_direction = atan2(input_velocity.x,input_velocity.z)
	input_is_moving = input_velocity.length() > 0.0
	input_acceleration = Acceleration * direction * (1 if max_speed != 0 else -1)
	#
	
	actual_acceleration = (character_node_velocity - PrevVelocity)  / (get_physics_process_delta_time())
	PrevVelocity = character_node_velocity
	#
	actual_velocity = character_node_velocity
	#tiltCharacterMesh
	if tilt == true:
		var MovementDirectionRelativeToCamera = input_velocity.normalized().rotated(Vector3.UP,-camera_root.HObject.transform.basis.get_euler().y)
		var IsMovingBackwardRelativeToCamera = false if input_velocity.rotated(Vector3.UP,-camera_root.HObject.transform.basis.get_euler().y).z >= -0.1 else true
		if IsMovingBackwardRelativeToCamera:
			MovementDirectionRelativeToCamera.x = MovementDirectionRelativeToCamera.x * -1

		tiltVector = (MovementDirectionRelativeToCamera).rotated(Vector3.UP,-PI/2) / (8.0/tilt_power)
		mesh_ref.rotation.x = lerp(mesh_ref.rotation.x,tiltVector.x,Acceleration * get_physics_process_delta_time())
		mesh_ref.rotation.z = lerp(mesh_ref.rotation.z,tiltVector.z,Acceleration * get_physics_process_delta_time())
	#


func calc_animation_data(): # it is used to modify the animation data to get the wanted animation result
	animation_is_moving_backward_relative_to_camera = false if -actual_velocity.rotated(Vector3.UP,-camera_root.HObject.transform.basis.get_euler().y).z >= -0.1 else true
	animation_velocity = actual_velocity
#	a method to make the character' anim walk backward when moving left
#	if is_equal_approx(input_velocity.normalized().rotated(Vector3.UP,-$CameraRoot.HObject.transform.basis.get_euler().y).x,-1.0):
#		animation_velocity = velocity * -1
#		animation_is_moving_backward_relative_to_camera = true
	

func mantle_check():
	pass

func jump() -> void:
	if ground_check.is_colliding() and not head_bonked:
		if character_node is RigidBody3D:
			character_node.apply_impulse(Vector3.UP * jump_magnitude * character_node.mass)
		else:
			vertical_velocity = Vector3.UP * jump_magnitude
			start_jump.emit(vertical_velocity)