CharacterBody2D

public bool FloorBlockOnWall { get; set; }

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

public bool FloorConstantSpeed { get; set; }

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

public float FloorMaxAngle { get; set; }

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

public float FloorSnapLength { get; set; }

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

public bool FloorStopOnSlope { get; set; }

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

public int MaxSlides { get; set; }

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

public CharacterBody2D.MotionModeEnum MotionMode { get; set; }

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

public uint PlatformFloorLayers { get; set; }

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

public CharacterBody2D.PlatformOnLeaveEnum PlatformOnLeave { get; set; }

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

public uint PlatformWallLayers { get; set; }

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

public float SafeMargin { get; set; }

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

public bool SlideOnCeiling { get; set; }

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

public Vector2 UpDirection { get; set; }

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

public Vector2 Velocity { get; set; }

Запрошенная/скорректированная движением скорость в единицах за секунду. MoveAndSlide интегрирует её по времени; это не точное мировое перемещение последнего кадра или полная скорость платформы.

public float WallMinSlideAngle { get; set; }

Минимальный угол (в радианах), под которым тело может скользить при столкновении со стеной. Значение по умолчанию равно 15 градусам. Это свойство влияет на движение только тогда, когда CharacterBody2D.MotionMode равно CharacterBody2D.MotionModeEnum.Floating.

public void ApplyFloorSnap();

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

public float GetFloorAngle(Vector2? upDirection = default);

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

public Vector2 GetFloorNormal();

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

public Vector2 GetLastMotion();

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

public KinematicCollision2D GetLastSlideCollision();

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

public Vector2 GetPlatformVelocity();

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

public Vector2 GetPositionDelta();

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

public Vector2 GetRealVelocity();

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

public KinematicCollision2D GetSlideCollision(int slideIdx);

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

for (int i = 0; i < GetSlideCollisionCount(); i++)
{
    KinematicCollision2D collision = GetSlideCollision(i);
    ReckfellApi.Print("Collided with: ", (collision.GetCollider() as Entity).Name);
}

public int GetSlideCollisionCount();

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

public Vector2 GetWallNormal();

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

public bool IsOnCeiling();

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

public bool IsOnCeilingOnly();

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

public bool IsOnFloor();

Состояние пола после последнего MoveAndSlide относительно UpDirection/FloorMaxAngle. До первого движения или после телепорта старое состояние нельзя считать новой проверкой опоры.

public bool IsOnFloorOnly();

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

public bool IsOnWall();

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

public bool IsOnWallOnly();

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

public bool MoveAndSlide();

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