Init
GameInstanceЧто это
Событие Init в классе GameInstance — точка входа, вызываемая движком при инициализации экземпляра игры (например, при старте уровня или загрузке проекта). Это exec-событие (не pure, не async), которое срабатывает автоматически и не требует внешнего вызова. Используется для настройки глобальных данных, инициализации подсистем, загрузки конфигураций.
Пины
Exec-входы:
нет (событие вызывается движком, execute-пин отсутствует)
Exec-выходы:
- then (exec) — продолжение выполнения после завершения логики события
Входы (данные):
нет (событие не принимает параметров)
Выходы (данные):
нет (void)
Когда используется
- Инициализация глобальных переменных, менеджеров (например, сохранений, звука, аналитики) на уровне игры.
- Подписка на системные события (например,
OnGameInstanceReady), загрузка таблиц данных. - Настройка параметров, которые должны быть доступны до начала любого уровня.
Типичные проблемы
- Забытый вызов родительского Init — если
GameInstanceнаследуется от C++-класса с собственной реализациейInit, в Blueprint необходимо явно вызватьCall Parent Function→Init, иначе родительская логика не выполнится. - Тяжёлые операции в Init — синхронная загрузка больших ассетов, длительные вычисления или сетевые запросы могут заблокировать поток и замедлить старт. Рекомендуется отложить такие задачи на
Async Taskили использоватьDelay(с осторожностью, так какDelayвInitможет не сработать корректно до начала тика). - Предположение о порядке вызова —
Initможет вызываться до полной инициализации некоторых подсистем (например,GameplayStatics). Не стоит полагаться на объекты, которые ещё не созданы.