Load Stream Level (by Name)
GameplayStatics
0
Что это
Latent-функция для асинхронной загрузки стримингового подуровня по его имени. После завершения загрузки (успешно или с ошибкой) вызывает соответствующий exec-выход. Позволяет управлять видимостью уровня сразу после загрузки и блокировкой выполнения до полной загрузки.
Пины
Exec-входы:
- execute (exec) — запуск загрузки уровня
Exec-выходы:
- On Loaded (exec) — срабатывает после успешной загрузки уровня
- On Failed (exec) — срабатывает при ошибке загрузки (например, уровень не найден)
Входы (данные):
- World Context Object (Object) — контекст мира (обычно self или GameInstance)
- Level Name (Name) — имя загружаемого подуровня (без пути, только имя ассета)
- bMake Visible After Load (bool) — сделать уровень видимым сразу после загрузки (true) или оставить скрытым (false)
- bShould Block on Load (bool) — блокировать выполнение графа до полной загрузки уровня (true) или продолжить асинхронно (false)
Выходы (данные):
- нет (void)
Когда используется
- Загрузка открытых миров по частям (open world) для оптимизации памяти.
- Подгрузка дополнительных локаций (подземелья, интерьеры) при подходе игрока.
- Динамическое добавление/удаление уровней в рантайме (например, для процедурной генерации).
Типичные проблемы
- Опечатка в имени уровня — функция не найдёт ассет и вызовет On Failed. Имя должно точно совпадать с именем ассета в Content Browser.
- Забытый bMake Visible After Load — уровень загрузится, но останется невидимым (если не включить флаг). Придётся дополнительно вызывать
Set Level Visibility. - Блокировка при bShould Block on Load = true — если уровень большой, игра может «зависнуть» на кадр или дольше. Рекомендуется использовать false и обрабатывать загрузку асинхронно через On Loaded.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.