CharacterBody3D

public bool FloorBlockOnWall { get; set; }

Если true, тело сможет двигаться только по полу. Эта опция исключает возможность ходить по стенам, однако позволяет скользить по ним.

public bool FloorConstantSpeed { get; set; }

Если false (по умолчанию), тело будет двигаться быстрее на спусках и медленнее на подъемах. Если true, тело всегда будет двигаться с одинаковой скоростью на земле, независимо от уклона. Обратите внимание, что вам нужно использовать CharacterBody3D.FloorSnapLength, чтобы придерживаться спуска с постоянной скоростью.

public float FloorMaxAngle { get; set; }

Предельный угол классификации поверхности как пола/потолка относительно UpDirection, в радианах. Для 45 градусов используйте Mathf.DegToRad(45).

public float FloorSnapLength { get; set; }

Устанавливает расстояние привязки. Если установлено значение, отличное от 0.0, тело остается прикрепленным к склонам при вызове CharacterBody3D.MoveAndSlide. Вектор привязки определяется заданным расстоянием вдоль противоположного направления CharacterBody3D.UpDirection. Пока вектор привязки находится в контакте с землей и тело движется против CharacterBody3D.UpDirection, тело будет оставаться прикрепленным к поверхности. Привязка не применяется, если тело движется вдоль CharacterBody3D.UpDirection, то есть оно содержит вертикальную скорость подъема, поэтому оно сможет оторваться от земли при прыжке или когда тело что-то толкает вверх. Если вы хотите применить привязку без учета скорости, используйте CharacterBody3D.ApplyFloorSnap.

public bool FloorStopOnSlope { get; set; }

Если true, тело не будет скользить по склонам при вызове CharacterBody3D.MoveAndSlide, когда тело стоит на месте. Если false, тело будет скользить по склонам пола, когда CharacterBody3D.Velocity прикладывает направленную вниз силу.

public int MaxSlides { get; set; }

Максимальное количество раз, которое тело может изменить направление, прежде чем оно остановится при вызове CharacterBody3D.MoveAndSlide. Должно быть больше нуля.

public CharacterBody3D.MotionModeEnum MotionMode { get; set; }

Устанавливает режим движения, который определяет поведение CharacterBody3D.MoveAndSlide.

public uint PlatformFloorLayers { get; set; }

Слои столкновений, которые будут включены для обнаружения тел пола, которые будут действовать как движущиеся платформы, за которыми будет следовать CharacterBody3D. По умолчанию все тела пола обнаруживаются и распространяют свою скорость.

public CharacterBody3D.PlatformOnLeaveEnum PlatformOnLeave { get; set; }

Устанавливает поведение, применяемое при покидании движущейся платформы. По умолчанию, для физической точности, при покидании применяется последняя скорость платформы.

public uint PlatformWallLayers { get; set; }

Слои столкновений, которые будут включены для обнаружения тел стен, которые будут действовать как движущиеся платформы, за которыми будет следовать CharacterBody3D. По умолчанию все тела стен игнорируются.

public float SafeMargin { get; set; }

Дополнительный запас используется для восстановления столкновений при вызове CharacterBody3D.MoveAndSlide. Если тело находится как минимум на таком расстоянии от другого тела, оно будет считать их сталкивающимися и будет оттолкнуто перед выполнением фактического движения. Более высокое значение означает большую гибкость для обнаружения столкновений, что помогает последовательно обнаруживать стены и полы. Более низкое значение заставляет алгоритм столкновений использовать более точное обнаружение, поэтому его можно использовать в случаях, когда требуется особая точность, например, в очень низком масштабе, чтобы избежать видимого дрожания, или для стабильности со стопкой тел персонажей.

public bool SlideOnCeiling { get; set; }

Если true, то при прыжке у потолка тело будет скользить, если false — остановится и упадет вертикально.

public Vector3 UpDirection { get; set; }

Вектор, направленный вверх, используется для определения того, что является стеной, а что полом (или потолком) при вызове CharacterBody3D.MoveAndSlide. По умолчанию Vector3.Up. Поскольку вектор будет нормализован, он не может быть равен Vector3.Zero, если вы хотите, чтобы все столкновения были зарегистрированы как стены, рассмотрите возможность использования CharacterBody3D.MotionModeEnum.Floating в качестве CharacterBody3D.MotionMode.

public Vector3 Velocity { get; set; }

Скорость тела в единицах в секунду для MoveAndSlide. Не умножайте её на delta перед вызовом: движение интегрирует шаг само. MoveAndSlide может изменить скорость при столкновениях.

public float WallMinSlideAngle { get; set; }

Минимальный угол (в радианах), под которым тело может скользить при столкновении со стеной. Значение по умолчанию равно 15 градусам. Когда CharacterBody3D.MotionMode равно CharacterBody3D.MotionModeEnum.Grounded, это влияет на движение только в том случае, если CharacterBody3D.FloorBlockOnWall равно true.

public void ApplyFloorSnap();

Позволяет вручную применить привязку к полу независимо от скорости тела. Эта функция ничего не делает, когда CharacterBody3D.IsOnFloor возвращает true.

public float GetFloorAngle(Vector3? upDirection = default);

Возвращает угол столкновения пола в последней точке столкновения в соответствии с CharacterBody3D.UpDirection, который по умолчанию равен Vector3.Up. Это значение всегда положительно и действительно только после вызова CharacterBody3D.MoveAndSlide и когда CharacterBody3D.IsOnFloor возвращает true.

public Vector3 GetFloorNormal();

Возвращает нормаль столкновения пола в последней точке столкновения. Действительно только после вызова CharacterBody3D.MoveAndSlide и когда CharacterBody3D.IsOnFloor возвращает true. Предупреждение: Нормаль столкновения не всегда совпадает с нормалью поверхности.

public Vector3 GetLastMotion();

Возвращает последнее движение, примененное к CharacterBody3D во время последнего вызова CharacterBody3D.MoveAndSlide. Движение может быть разделено на несколько движений, когда происходит скольжение, и этот метод возвращает последнее, что полезно для получения текущего направления движения.

public KinematicCollision3D GetLastSlideCollision();

Возвращает KinematicCollision3D, если произошло столкновение. Возвращаемое значение содержит информацию о последнем столкновении, произошедшем во время последнего вызова метода CharacterBody3D.MoveAndSlide. Возвращает null, если столкновения не произошло. См. также CharacterBody3D.GetSlideCollision.

public Vector3 GetPlatformAngularVelocity();

Возвращает угловую скорость платформы в последней точке столкновения. Действует только после вызова CharacterBody3D.MoveAndSlide.

public Vector3 GetPlatformVelocity();

Возвращает линейную скорость платформы в последней точке столкновения. Действительно только после вызова CharacterBody3D.MoveAndSlide.

public Vector3 GetPositionDelta();

Возвращает перемещение (дельту положения), произошедшее во время последнего вызова CharacterBody3D.MoveAndSlide.

public Vector3 GetRealVelocity();

Возвращает текущую реальную скорость с момента последнего вызова CharacterBody3D.MoveAndSlide. Например, когда вы поднимаетесь по склону, вы будете двигаться по диагонали, даже если скорость горизонтальная. Этот метод возвращает диагональное движение, в отличие от CharacterBody3D.Velocity, который возвращает запрошенную скорость.

public KinematicCollision3D GetSlideCollision(int slideIdx);

Возвращает KinematicCollision3D, содержащий информацию о столкновении, произошедшем во время последнего вызова метода CharacterBody3D.MoveAndSlide. Поскольку тело может столкнуться несколько раз за один вызов CharacterBody3D.MoveAndSlide, необходимо указать индекс столкновения в диапазоне от 0 до (CharacterBody3D.GetSlideCollisionCount - 1). См. также CharacterBody3D.GetLastSlideCollision.

public int GetSlideCollisionCount();

Число slide-контактов последнего MoveAndSlide. Не является количеством всех соседних тел; результаты MoveAndCollide читаются из возвращённого им объекта.

public Vector3 GetWallNormal();

Возвращает нормаль столкновения стены в последней точке столкновения. Действительно только после вызова CharacterBody3D.MoveAndSlide и когда CharacterBody3D.IsOnWall возвращает true. Предупреждение: Нормаль столкновения не всегда совпадает с нормалью поверхности.

public bool IsOnCeiling();

Возвращает true, если тело столкнулось с потолком при последнем вызове CharacterBody3D.MoveAndSlide. В противном случае возвращает false. CharacterBody3D.UpDirection и CharacterBody3D.FloorMaxAngle используются для определения того, является ли поверхность «потолком» или нет.

public bool IsOnCeilingOnly();

Возвращает true, если тело столкнулось только с потолком при последнем вызове CharacterBody3D.MoveAndSlide. В противном случае возвращает false. CharacterBody3D.UpDirection и CharacterBody3D.FloorMaxAngle используются для определения того, является ли поверхность «потолком» или нет.

public bool IsOnFloor();

Читает состояние контакта с полом, полученное обработкой движения. Используйте после физического шага, а не как проверку наличия NavigationMesh.

public bool IsOnFloorOnly();

Возвращает true, если тело столкнулось только с полом при последнем вызове CharacterBody3D.MoveAndSlide. В противном случае возвращает false. CharacterBody3D.UpDirection и CharacterBody3D.FloorMaxAngle используются для определения того, является ли поверхность «полом» или нет.

public bool IsOnWall();

Returns (Возврат) true если тело столкнулось со стеной по последнему призыву CharacterBody3D.MoveAndSlide. В противном случае возвращение false. . . . . CharacterBody3D.UpDirection и CharacterBody3D.FloorMaxAngle используются для определения того, является ли поверхность "стеной" или нет.

public bool IsOnWallOnly();

Returns (Возврат) true если тело столкнулось только со стеной по последнему призыву CharacterBody3D.MoveAndSlide. В противном случае возвращение false. . . . . CharacterBody3D.UpDirection и CharacterBody3D.FloorMaxAngle используются для определения того, является ли поверхность "стеной" или нет.

public bool MoveAndSlide();

Двигает тело с заданной Velocity и обработкой столкновений. Использует шаг движка; код сам задаёт скорость и ускорение гравитации. Не ищет навигационный путь и не доказывает достижение цели.