Construction Script
ActorЧто это
Construction Script (UserConstructionScript) — специальная функция-событие, выполняемая в редакторе при каждом изменении актора (перемещение, изменение параметров, загрузка уровня). Позволяет процедурно настраивать компоненты, генерировать меши, размещать спавнеры и т.п. Тип: exec (не pure, не async/latent — асинхронные ноды в ней не работают).
Пины
Exec-входы:
- execute (exec) — запуск скрипта при построении актора в редакторе.
Exec-выходы:
- then (exec) — продолжение выполнения после завершения скрипта.
Входы (данные):
- нет (функция не имеет входных параметров данных).
Выходы (данные):
- нет (void).
Когда используется
- Процедурная генерация статической геометрии (например, размещение столбов вдоль кривой).
- Настройка материалов, сокетов, коллизий на основе публичных переменных.
- Создание вспомогательных компонентов (сплайны, декорации) в редакторе без ручного размещения.
Типичные проблемы
- Использование асинхронных нод (Delay, Timeline, Async Task) — они не выполняются в Construction Script, граф просто игнорирует их или выдаёт ошибку.
- Тяжёлые вычисления без кэширования — скрипт запускается при каждом изменении параметра, что может вызывать тормоза в редакторе. Рекомендуется использовать флаги «Is Construction Script» или кэшировать результат в переменные.
- Изменение трансформации корневого компонента — Construction Script не должен перемещать сам актор (Root Component), это может привести к непредсказуемому поведению при повторном построении.