Open Level (by Object Reference)
GameplayStatics
0
Что это
Функция Open Level (by Object Reference) загружает и открывает уровень, указанный через Soft Object Reference (TSoftObjectPtr<UWorld>). Это асинхронная (latent) операция, завершающаяся после загрузки. Относится к exec-функциям (запуск через execute, продолжение по then).
Пины
Exec-входы:
- execute (exec) — запуск открытия уровня
Exec-выходы:
- then (exec) — выполняется после завершения загрузки уровня
Входы (данные):
- World Context Object (Object) — объект из текущего мира (чаще всего self)
- Level (Soft Object Reference) — ссылка на загружаемый уровень (TSoftObjectPtr<UWorld>)
- Absolute (bool) — если true, открывает уровень по абсолютному пути; если false — относительно текущего уровня
- Options (string) — дополнительные опции открытия (например, "?Game=MyGameMode")
Выходы (данные):
- нет (void)
Когда используется
- Переход между уровнями по ссылке, полученной из ассетов или переменных Soft Reference.
- Открытие потоковых уровней или сцен в режиме Standalone/Editor.
- Загрузка уровня с передачей пользовательских параметров через Options.
Типичные проблемы
- Некорректный Absolute****: если не поставить флаг, уровень может открыться с неверным путём (например, когда текущий уровень находится в подпапке).
- Ошибка в пути Level****: Soft Object Reference должен указывать именно на мир, а не на карту другого типа (например, Level Streaming или World Composition).
- Синтаксис Options****: передача параметров без символа «?» в начале или с лишними пробелами приводит к игнорированию опций.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.