Get Player Character
GameplayStaticsЧто это
Pure-функция, возвращающая ссылку на персонажа (ACharacter), управляемого игроком с заданным индексом. Вызывается в контексте текущего мира (World Context подставляется автоматически). Позволяет получить главного игрока (индекс 0) для дальнейшей работы с его компонентами, переменными или вызова методов.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Player Index (int) — индекс игрока (0 — первый, 1 — второй и т.д., если поддерживается мультиплеер). По умолчанию 0.
Выходы (данные):
- Return Value (ACharacter) — ссылка на персонажа игрока. Может быть null, если игрок с указанным индексом отсутствует.
Когда используется
- Получение контролируемого персонажа для вызова его методов (например, нанесение урона, установка здоровья, управление инвентарём).
- Передача ссылки на игрока в пользовательские функции или макросы.
- Проверка существования игрока перед работой с ним.
Типичные проблемы
- Не проверено на null — если игрок ещё не появился (на старте уровня) или индекс выходит за пределы, Return Value будет null. Дальнейшее использование такой ссылки вызовет ошибку выполнения.
- Путаница с Get Player Pawn — Get Player Pawn возвращает APawn (базовый класс), а Get Player Character — ACharacter (с расширенным функционалом, например, CharacterMovement). Если нужны методы ACharacter, следует использовать именно эту ноду.
- Игнорирование индекса в мультиплеере — в сетевой игре индекс 0 соответствует первому локальному игроку. Для получения других игроков нужно передавать их индекс, иначе вы будете работать только с одним.