Set World Location
SceneComponentЧто это
Exec-функция компонента SceneComponent, которая устанавливает позицию компонента в мировых координатах. Поддерживает опции swept-перемещения (с проверкой коллизий) и телепортации (без вызова события Hit). Не является pure или async.
Пины
Exec-входы:
- execute (exec) — запуск установки позиции
Exec-выходы:
- then (exec) — продолжение выполнения после установки
Входы (данные):
- Target (SceneComponent Object Reference) — целевой компонент (по умолчанию self)
- New Location (Vector) — новый мировой вектор позиции
- bSweep (bool) — включить swept-перемещение (false по умолчанию)
- bTeleport (bool) — включить телепортацию (false по умолчанию; при true не генерирует события проскальзывания)
Выходы (данные):
- Sweep Hit Result (Hit Result) — результат swept‑проверки, если
bSweep = true; иначе содержит невалидный хит
Когда используется
Когда нужно программно переместить компонент (или актор через его корневой компонент) в определённую точку мира. Полезно для телепортации персонажа, движения объектов с учётом физики (sweep) или корректировки позиции без триггера коллизии.
Типичные проблемы
- Забытый
bSweep— если включить sweep, но не обрабатыватьSweep Hit Result, объект может застрять в геометрии или получить нежелательное смещение. - Передача локальных координат вместо мировых — функция ожидает мировые координаты; передача относительных (
RelativeLocation) приведёт к двойному преобразованию. - Игнорирование
bTeleportпри sweep — приbTeleport = falseswept-перемещение может вызывать побочные эффекты (например, событиеHitна всех задетых объектах).