Get Game State
GameplayStaticsЧто это
Pure-функция, возвращающая текущий объект Game State (обычно AGameStateBase) из мира, связанного с переданным контекстным объектом. Не изменяет состояние, не имеет exec-пинов. Позволяет получить глобальные данные игрового режима: счёт, время раунда, состояние матча.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- World Context Object (Object) — любой объект, находящийся в том мире, Game State которого нужно получить. Обычно подключается Self (владелец графа).
Выходы (данные):
- Return Value (Game State Object) — указатель на текущий Game State. Может быть None, если Game State ещё не инициализирован.
Когда используется
- Получение счётчика очков, текущего раунда, таймера матча из Game State.
- Синхронизация игровых данных на всех клиентах через реплицированные переменные Game State.
- Проверка состояния игры (например, идёт матч или пауза).
Типичные проблемы
- Вызов до того, как Game State создан (например, в BeginPlay, если мир ещё не полностью загружен) → возвращает None. Всегда проверяйте выход через Branch или IsValid.
- Передача неправильного World Context Object, принадлежащего другому миру (при использовании нескольких миров) → получение неверного Game State.
- Игнорирование того, что Game State может быть переопределён подклассом — при приведении типа (Cast To) убедитесь в совместимости.