Switch Level
PlayerControllerЧто это
Exec-функция класса PlayerController. Загружает новый уровень по имени, сохраняя текущего игрока (клиента) в игре. Используется для перехода между уровнями (например, из меню в игру или между игровыми локациями). Не является pure или latent — выполнение продолжается сразу после вызова.
Пины
Exec-входы:
- execute (exec) — запуск переключения уровня
Exec-выходы:
- then (exec) — выполняется сразу после вызова (не дожидаясь загрузки уровня)
Входы (данные):
- Target (PlayerController) — контроллер игрока, который инициирует переход
- Level Name (String) — имя целевого уровня (без расширения .umap)
Выходы (данные):
- нет (void)
Когда используется
- Переход из главного меню в игровой уровень.
- Смена локации в мультиплеере (перемещение всех игроков на новую карту).
- Рестарт уровня с сохранением подключения игрока.
Типичные проблемы
- Неправильное имя уровня — если строка не соответствует имени существующего уровня в папке Maps, загрузка не произойдёт (игрок останется на текущем уровне).
- Забытый Target — если нода вызывается без указания конкретного PlayerController (например, в событии самого контроллера), она может не сработать, так как Target обязателен.
- Отсутствие проверки на готовность — после вызова Switch Level выполнение продолжается немедленно, но уровень ещё не загружен. Если сразу после Switch Level попытаться получить доступ к объектам нового уровня, они могут быть недоступны. Рекомендуется использовать события загрузки уровня (например, On Level Loaded) для синхронизации.