Load Level Instance (by Object Reference)
LevelStreamingDynamic
0
Что это
Exec-функция для динамической загрузки и создания экземпляра подуровня (Level Instance) по ссылке на мягкий объект (Soft Object Reference). Позволяет загрузить подуровень во время выполнения, указав его местоположение и поворот. Возвращает ссылку на созданный экземпляр.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
- On Success (exec) — вызывается при успешной загрузке
- On Failure (exec) — вызывается при ошибке загрузки
Входы (данные):
- World Context Object (Object Reference) — контекст мира, обычно Self
- Level (Soft Object Path) — ссылка на ассет подуровня (Level)
- Location (Vector) — позиция для размещения экземпляра
- Rotation (Rotator) — поворот экземпляра
Выходы (данные):
- Out Level Instance (Level Streaming Object Reference) — ссылка на созданный экземпляр подуровня
Когда используется
- Динамическая загрузка подуровней в открытом мире (например, зоны интереса, подземелья).
- Спавн процедурно генерируемых локаций без предварительной загрузки.
- Оптимизация памяти: загрузка крупных уровней только при необходимости.
Типичные проблемы
- Некорректная ссылка Level — если Soft Object Path указывает на несуществующий или неправильный ассет, функция завершится с On Failure.
- Конфликт Location/Rotation — при размещении экземпляра в том же месте, что и уже существующий, может произойти наложение или ошибка загрузки.
- Забытая проверка On Failure — если не обрабатывать ошибку, проект может зависнуть или работать некорректно при неудачной загрузке.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.