Server Move Dual Hybrid Root Motion
CharacterЧто это
Серверная RPC-функция для Character, обрабатывающая комбинированное движение с гибридной анимацией Root Motion. Вызывается клиентом для синхронизации перемещения персонажа на сервере, когда используется смешанный режим Root Motion (часть движения от анимации, часть — от физики). Это exec-функция (не pure, не async).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (Character) — персонаж, для которого выполняется серверное перемещение
- ClientTimeStamp (float) — временная метка клиента для синхронизации
- InAccel (Vector) — ускорение (входной вектор движения)
- ClientLocation (Vector) — позиция клиента на момент отправки
- ClientVelocity (Vector) — скорость клиента на момент отправки
- ClientBase (PrimitiveComponent) — компонент, на котором стоит клиент
- ClientBaseBoneName (Name) — имя кости базы (если Base — скелетная)
- ClientMovementBase (byte) — тип базы движения
- ClientMovementMode (byte) — режим движения клиента
- ClientYaw (byte) — поворот клиента (сжатый)
- ClientPitch (byte) — тангаж клиента (сжатый)
- ClientRoll (byte) — крен клиента (сжатый)
- bClientHasRootMotion (bool) — есть ли у клиента Root Motion
- RootMotion (FRootMotionMovementParams) — параметры Root Motion от клиента
- bClientHasAnimRootMotion (bool) — есть ли у клиента анимационный Root Motion
- AnimRootMotionVelocity (Vector) — скорость от анимационного Root Motion
- AnimRootMotionTranslationScale (float) — масштаб трансляции анимационного Root Motion
- AnimRootMotionRotation (Rotator) — поворот от анимационного Root Motion
- AnimRootMotion (FRootMotionMovementParams) — полные параметры анимационного Root Motion
- bClientHasNetworkSmoothCorrection (bool) — есть ли сглаживающая коррекция сети
- NetworkSmoothCorrectionLocation (Vector) — позиция для сетевого сглаживания
- NetworkSmoothCorrectionRotation (Rotator) — поворот для сетевого сглаживания
- NetworkSmoothCorrectionTime (float) — время для сетевого сглаживания
- bClientHasNetworkSmoothCorrectionMode (bool) — есть ли режим сглаживания
- NetworkSmoothCorrectionMode (byte) — режим сетевого сглаживания
- bClientHasNetworkSmoothCorrectionLocation (bool) — есть ли позиция сглаживания
- bClientHasNetworkSmoothCorrectionRotation (bool) — есть ли поворот сглаживания
- bClientHasNetworkSmoothCorrectionTime (bool) — есть ли время сглаживания
Выходы (данные):
- нет (void)
Когда используется
В проектах с многопользовательской игрой (dedicated server / listen server) для Character, когда клиент использует гибридный Root Motion (например, анимация подката + физическое смещение). Вызывается из клиентского кода (обычно в Tick или в обработчике движения) для отправки серверу полной информации о перемещении.
Типичные проблемы
- Избыточность данных: функция имеет множество входных параметров — легко ошибиться в порядке или типе при передаче из клиентского кода. Рекомендуется использовать структуру FCharacterNetworkMoveData для упрощения.
- Несоответствие Root Motion: если клиент и сервер используют разные анимации Root Motion (разные Montage или разные Blend Spaces), синхронизация сломается — персонаж будет «телепортироваться» или «застревать».
- Игнорирование Network Smooth Correction: если не передавать корректные данные сглаживания (NetworkSmoothCorrection*), персонаж будет дёргаться при сетевой задержке.