Debug Capsule Sweep
CheatManagerЧто это
Отладочная exec-функция CheatManager, выполняющая трассировку капсулы (Capsule Sweep) и отображающая её визуально в окне вьюпорта. Позволяет в реальном времени проверить геометрию коллизии, не останавливая игру. Результат (было ли попадание) и данные о нём возвращаются для дальнейшей обработки.
Пины
Exec-входы:
- execute (exec) — запуск функции.
Exec-выходы:
- then (exec) — выполняется после завершения трассировки и отрисовки.
Входы (данные):
- Start (Vector) — начальная точка трассировки.
- End (Vector) — конечная точка.
- Radius (float) — радиус капсулы.
- HalfHeight (float) — половина высоты капсулы (без учёта радиуса).
- TraceChannel (TEnumAsByte<ETraceTypeQuery>) — канал трассировки (например, Visibility, Pawn).
- bTraceComplex (bool) — учитывать сложную коллизию (Collision Enabled) или простую.
- ActorsToIgnore (Array of Actor) — актёры, которые не должны участвовать в трассировке.
Пины отладки: TraceColor (LinearColor), TraceHitColor (LinearColor), DrawTime (float).
Выходы (данные):
- OutHit (bool) — было ли хотя бы одно попадание.
- OutHitResult (Hit Result) — детальная информация о первом попадании (точка, нормаль, актёр и т.д.).
Когда используется
- Проверка коллизий персонажа (примерка капсулы) перед движением, прыжком или приседаниями.
- Отладка кастомных систем обнаружения препятствий, линий видимости или физического взаимодействия.
- Визуальная верификация настроек капсулы (радиус, высота) прямо в игровом процессе.
Типичные проблемы
- Неправильные размеры капсулы – путают радиус и полную высоту: HalfHeight – это расстояние от центра до верхушки без учёта радиуса, а не полный размер.
- Забытая обработка результата – OutHit может быть false, но код продолжает использовать OutHitResult без проверки, что вызывает чтение некорректных данных (все поля хита обнулены).
- TraceChannel не совпадает с ожидаемой коллизией – если объекты имеют игнорируемый канал, трассировка не будет их видеть, хотя визуально они есть; проверяйте настройки Collision Profiles.