OnSetMatchState
GameModeЧто это
Событие, вызываемое на GameMode при изменении состояния матча (Match State). Позволяет выполнить пользовательскую логику при переходе между фазами игры: ожидание, старт, игровой процесс, завершение и т.д. Является BlueprintImplementableEvent — может быть переопределён в Blueprint-наследнике GameMode.
Пины
Exec-входы:
- execute (exec) — запуск функции (при вызове из другого Blueprint). Для переопределения события вход отсутствует — событие вызывается движком.
Exec-выходы:
- then (exec) — продолжение выполнения после обработки события.
Входы (данные):
- NewState (FName) — имя нового состояния матча. Стандартные значения:
"EnteringMap","WaitingToStart","InProgress","WaitingPostMatch","LeavingMap".
Выходы (данные):
- нет (void)
Когда используется
Переопределяется в GameMode Blueprint для реализации кастомной логики при смене фаз игры: запуск таймеров, спавн игроков, активация зон, завершение матча. Также может вызываться из других Blueprint для принудительной смены состояния (через SetMatchState).
Типичные проблемы
- Попытка изменить MatchState внутри этого события (например, вызов
SetMatchState) может привести к рекурсивному вызову и зависанию. - Событие выполняется только на сервере. Клиентский код не получит этот вызов напрямую; для реакции на смену состояния на клиенте необходимо использовать реплицированные переменные или RPC.
- Не все строковые значения NewState валидны: движок использует предопределённый набор. Передача произвольной строки может быть проигнорирована или вызвать ошибку.