Завершение рефакторинга, фикс бага с запросом слайда

Теперь всё поделено по логическим классам, чтобы было помодульно, а также если выполняется запрос на слайд в момент, когда слайд не может быть выполнен, запрос отменяется
2025-10-27 21:26:09 +03:00
1 parent e6879076a3
commit 5bf468673f
@@ -0,0 +1,213 @@
+using Code.Gameplay.Character.Controller.Abilities;
+using Code.Gameplay.Character.Controller.Input;
+using Code.Gameplay.Character.Controller.Movement;
+using Code.Gameplay.Character.Core;
+using KinematicCharacterController;
+using UnityEngine;
+
+namespace Code.Gameplay.Character.Controller
+{
+    /*
+     * Скрипт, отвечающий за передвижение персонажа
+     * Реализует физическое движение персонажа с использованием Kinematic Character Controller
+     * Обрабатывает ввод пользователя, применяет движение и вращение с учетом поверхности
+     *
+     * Источник: Tvtig, https://www.youtube.com/watch?v=9ibpY64wBYM
+     */
+    public class CustomCharacterController : MonoBehaviour, ICharacterController
+    {
+        [SerializeField]
+        private KinematicCharacterMotor motor; // Движок физического перемещения персонажа
+
+        [SerializeField]
+        private float 
+            maxStableMoveSpeed = 8f,           // Максимальная скорость движения по устойчивой поверхности
+            sprintMoveSpeed = 12f,             // Максимальная скорость спринта
+            slideSpeed = 20f,                  // Скорость слайда
+            slideDuration = 0.8f,              // Длительность слайда в секундах
+            slideCooldown = 1.5f,              // Время перезарядки слайда
+            stableMovementSharpness = 15f,     // Резкость изменения скорости движения (чем выше - тем резче)
+            orientationSharpness = 10f,        // Резкость изменения вращения персонажа (чем выше - тем резче)
+            jumpSpeed = 10f,                   // Скорость прыжка
+            wallClimbSpeedFactor = 0.8f,       // Коэффициент преобразования горизонтальной скорости в вертикальную при залазании на стену
+            minWallClimbSpeed = 9f;            // Минимальная горизонтальная скорость для начала залазания на стену
+
+        [SerializeField]
+        private Vector3 gravity = new(0, -30f, 0); // Вектор, отвечающий за применение гравитации
+        
+        // Подсистемы
+        private readonly CharacterInputHandler _inputHandler;
+        private readonly SlideMechanic _slideMechanic;
+        private readonly WallClimbMechanic _wallClimbMechanic;
+        private readonly GroundMovementSystem _groundMovement;
+        private readonly AirMovementSystem _airMovement;
+        
+        // Конструктор без параметров, инициализирующий контроллер
+        public CustomCharacterController()
+        {
+            _inputHandler = new CharacterInputHandler();
+            _slideMechanic = new SlideMechanic(slideSpeed, slideDuration, slideCooldown);
+            _wallClimbMechanic = new WallClimbMechanic(wallClimbSpeedFactor, minWallClimbSpeed);
+            _groundMovement = new GroundMovementSystem(maxStableMoveSpeed, sprintMoveSpeed, stableMovementSharpness, jumpSpeed);
+            _airMovement = new AirMovementSystem(gravity);
+        }
+        
+        // Текущий режим камеры для адаптации поведения
+        private CameraMode _currentCameraMode = CameraMode.ThirdPerson;
+
+        // Инициализация контроллера
+        private void Start()
+        {
+            motor.CharacterController = this; // Регистрация этого контроллера в движке
+            _inputHandler.FirstPersonCameraRotation = motor.Transform.rotation; // Начальное вращение совпадает с персонажем
+        }
+
+        // Обработка и преобразование входных данных от персонажа
+        public void SetInputs(ref CharacterInputs inputs)
+        {
+            // Обновляем таймер перезарядки слайда
+            _slideMechanic.TickCooldown(Time.deltaTime);
+    
+            // Если активен слайд - игнорируем весь остальной ввод
+            if (_slideMechanic.IsSliding)
+            {
+                // Во время слайда не обрабатываем движение, прыжки и спринт
+                _inputHandler.MoveInputVector = Vector3.zero;
+                _inputHandler.LookInputVector = Vector3.one;
+                _inputHandler.IsSprinting = false;
+                _groundMovement.CancelJumpRequest();
+                return;
+            }
+    
+            // Сохраняем текущий режим камеры
+            _currentCameraMode = inputs.CameraMode;
+    
+            // Обработка слайда
+            _slideMechanic.RequestSlide(inputs.SlidePressed);
+
+            // Обработка остального ввода
+            _inputHandler.ProcessInputs(ref inputs, motor);
+    
+            // Передаём запрос прыжка напрямую в систему движения по земле
+            _groundMovement.RequestJump(inputs.JumpPressed);
+        }
+
+        // Обновление вращения персонажа на основе входных данных
+        public void UpdateRotation(ref Quaternion currentRotation, float deltaTime)
+        {
+            // ВО ВРЕМЯ СЛАЙДА НЕ ОБНОВЛЯЕМ ВРАЩЕНИЕ - ПЕРСОНАЖ СМОТРИТ ПРЯМО
+            if (_slideMechanic.IsSliding) return;
+
+            switch (_currentCameraMode)
+            {
+                // В FirstPerson режиме применяем вращение камеры напрямую к персонажу (только горизонталь)
+                case CameraMode.FirstPerson when _inputHandler.ShouldApplyCameraRotation:
+                    // Немедленно применяем горизонтальное вращение камеры к персонажу
+                    currentRotation = _inputHandler.FirstPersonCameraRotation;
+                    break;
+                // В ThirdPerson режиме плавно поворачиваем персонаж в направлении движения
+                case CameraMode.ThirdPerson:
+                {
+                    // Вращение применяется только если есть направление движения и разрешена резкость вращения
+                    if (_inputHandler.LookInputVector.sqrMagnitude > 0 && orientationSharpness > 0)
+                    {
+                        // Плавная интерполяция текущего направления к целевому с экспоненциальным сглаживанием
+                        var smoothedLookInputDirection = Vector3.Slerp(
+                            motor.CharacterForward, 
+                            _inputHandler.LookInputVector, 
+                            1f - Mathf.Exp(-orientationSharpness * deltaTime)
+                        ).normalized;
+
+                        // Установка нового вращения смотря в сглаженном направлении
+                        currentRotation = Quaternion.LookRotation(smoothedLookInputDirection, motor.CharacterUp);
+                    }
+
+                    break;
+                }
+                // Заготовка на будущее (если понадобится)
+                case CameraMode.Static:
+                case CameraMode.Cinematic:
+                default:
+                    break;
+            }
+        }
+
+        // Обновление скорости движения персонажа
+        public void UpdateVelocity(ref Vector3 currentVelocity, float deltaTime)
+        {
+            // Проверяем запрос слайда и запускаем его если можно
+            if (!_slideMechanic.IsSliding)
+            {
+                _slideMechanic.TryStartSlide(motor, _currentCameraMode, _inputHandler.FirstPersonCameraRotation, _inputHandler.LookInputVector);
+            }
+            // Если активен слайд - обрабатываем отдельно
+            else
+            {
+                _slideMechanic.HandleSlide(ref currentVelocity, deltaTime, motor);
+                return;
+            }
+            
+            // Если персонаж находится на земле
+            if (motor.GroundingStatus.IsStableOnGround)
+            {
+                _groundMovement.UpdateVelocity(ref currentVelocity, _inputHandler, motor, deltaTime);
+            }
+            // Если персонаж не находится на земле
+            else
+            {
+                _airMovement.UpdateVelocity(ref currentVelocity, deltaTime);
+                // Отменяем прыжок (фикс проблемы с двойным прыжком после приземления)
+                _groundMovement.CancelJumpRequest();
+            }
+        }
+
+        // Метод вызывается перед обновлением персонажа (можно использовать для подготовки)
+        public void BeforeCharacterUpdate(float deltaTime)
+        {
+        }
+
+        // Метод вызывается после обработки столкновения с землей
+        public void PostGroundingUpdate(float deltaTime)
+        {
+            // Если во время слайда персонаж оторвался от земли - заканчиваем слайд
+            if (_slideMechanic.IsSliding && !motor.GroundingStatus.IsStableOnGround)
+            {
+                _slideMechanic.EndSlide();
+            }
+        }
+
+        // Метод вызывается после обновления персонажа (можно использовать для пост-обработки)
+        public void AfterCharacterUpdate(float deltaTime)
+        {
+        }
+
+        // Проверка валидности коллайдера для обработки столкновений
+        public bool IsColliderValidForCollisions(Collider coll)
+        {
+            return true; // Все коллайдеры считаются валидными для столкновений
+        }
+
+        // Обработка столкновения с землей (вызывается при приземлении)
+        public void OnGroundHit(Collider hitCollider, Vector3 hitNormal, Vector3 hitPoint, ref HitStabilityReport hitStabilityReport)
+        {
+        }
+
+        // Обработка столкновения при движении (вызывается при ударе о препятствие)
+        public void OnMovementHit(Collider hitCollider, Vector3 hitNormal, Vector3 hitPoint,
+            ref HitStabilityReport hitStabilityReport)
+        {
+            _wallClimbMechanic.OnMovementHit(motor, hitNormal);
+        }
+
+        // Обработка отчета о стабильности столкновения
+        public void ProcessHitStabilityReport(Collider hitCollider, Vector3 hitNormal, Vector3 hitPoint, Vector3 atCharacterPosition,
+            Quaternion atCharacterRotation, ref HitStabilityReport hitStabilityReport)
+        {
+        }
+
+        // Обработка дискретных столкновений (для триггеров и специальных коллайдеров)
+        public void OnDiscreteCollisionDetected(Collider hitCollider)
+        {
+        }
+    }
+}