Unload Stream Level (by Object Reference)
GameplayStatics
0
Что это
Exec-функция для выгрузки стриминг-уровня, заданного мягкой ссылкой (Soft Object Reference). Используется в проектах с процедурной генерацией, открытым миром или Level Streaming. Не pure, не латентная (без дополнительных exec-выходов).
Пины
Exec-входы:
- execute (exec) — запуск выгрузки.
Exec-выходы:
- then (exec) — продолжение выполнения (сама выгрузка может произойти позже, если уровень не блокирующий).
Входы (данные):
- World Context Object (Object) — контекст, обычно self или GameInstance.
- Level (Soft Object Reference) — ссылка на загружаемый подуровень (TSoftObjectPtr<UWorld>).
Выходы (данные):
- нет (void).
Когда используется
- Выгрузка зон, покинутых игроком, для экономии памяти.
- Динамическая замена уровней (выгрузить старый, загрузить новый).
- Сброс состояния уровня при рестарте без полной перезагрузки.
Типичные проблемы
- Попытка выгрузить уровень, который ещё не был загружен, или уже выгружен (операция может проигнорироваться, но отследить сложно).
- Выгрузка уровня, на который всё ещё есть активные ссылки (например, актёры из этого уровня всё ещё участвуют в коллизиях или логике), может привести к крашам.
- Отсутствие проверки, что уровень действительно загружен перед вызовом (можно использовать
IsLevelLoaded).
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.