Скопируй граф в Blueprint (Ctrl+A, Ctrl+C) и вставь сюда
Ноды
Что делает функция
Функция получает контроллер игрока (PlayerController) из текущего объекта (скорее всего, из Pawn или Character). Она берёт контроллер, связанный с этим объектом (через GetController), и пытается привести его к типу PlayerController. Если приведение успешно — возвращает его, иначе возвращает nullptr. Функция не меняет состояние игры, а только возвращает ссылку на существующий объект.
Зачем нужна
Это типовой паттерн для получения контроллера игрока из любого места, где есть ссылка на Pawn (например, из AI-контроллера или из самого персонажа). В Unreal Engine часто нужно получить доступ к PlayerController, чтобы управлять вводом, HUD, камерой или вызывать клиентские RPC. Функция используется в системах движения, Enhanced Input, GAS (GameplayAbilitySystem) и мультиплеере — везде, где нужно отличить игрока от AI.
Как читать (ключевые блоки)
- Вход в функцию — стандартная точка входа. Никаких входных параметров нет (entry без пинов).
- Получение контроллера — вызывается
GetControllerна объекте, который, вероятно, является Pawn (но это не гарантировано). Результат —Controller(базовый класс). - Приведение к PlayerController — DynamicCast проверяет, является ли полученный контроллер именно
PlayerController. Если да — идёт поthen, если нет — поCastFailed(который не подключён, то есть при неудаче ничего не происходит). - Возврат результата — по успешному пути возвращается приведённый объект. Если приведение не удалось, возвращается
nullptr(по умолчанию для ссылочного типа).
Особенности и подозрительные места
- CastFailed не подключён — это нормально, если функция должна возвращать
nullptrпри неудаче. Но если бы требовалась обработка ошибки (например, лог), то этот выход следовало бы использовать. - Нет проверки на
IsValid— еслиGetControllerвернулnullptr, DynamicCast всё равно выполнится, но приведётnullptrкPlayerController(что дастnullptr). Это корректно, но может скрыть баг, если объект не является Pawn. - Функция не принимает аргументов — она работает с
this(контекст вызова). Если вызвать её не на Pawn,GetControllerможет вернуть не то, что ожидается. - Нет предупреждений в дампе — значит, компилятор не нашёл проблем с типами или связями.
Кому и когда это пригодится
Разработчикам, которые пишут кастомные функции для получения PlayerController из любого Pawn (например, в AI-поведении или в системах ввода). Полезно для понимания, как безопасно приводить типы в Blueprint без риска краша.
Что делает функция
Функция «Get Trace Points» вычисляет две точки в трёхмерном пространстве — Start и End, — лежащие на луче, направленном строго вперёд от камеры игрока (PlayerCamera). Точка Start находится на расстоянии Offset от камеры, точка End — на расстоянии Distance. Таким образом, функция возвращает отрезок прямой, который начинается со смещением Offset и заканчивается на дистанции Distance, ориентированный по текущему взгляду камеры.
Зачем нужна
Это типичный вспомогательный инструмент для трассировки лучей, прицеливания, визуализации или отладки. В контексте Unreal Engine 5 такой паттерн часто встречается в системах оружия (линейная трассировка пули), в системах взаимодействия (луч для телекинеза или захвата объектов), в AI (линия взгляда юнита) или просто для отладки через DrawDebugLine. Функция может использоваться как часть кастомной утилиты для получения точек, куда смотрит игрок, без привязки к конкретной механике.
Как читать (ключевые блоки)
Получение данных камеры. Функция берёт текущую позицию камеры через GetCameraLocation и её поворот через GetCameraRotation. Оба вызова используют один и тот же объект PlayerCameraManager, переданный на вход.
Вычисление направления. Из поворота камеры получается единичный вектор направления «вперёд» с помощью GetForwardVector. Этот вектор задаёт ось, вдоль которой будут откладываться точки.
Построение точек. Вектор Forward умножается на Distance и на Offset (две операции Multiply_VectorVector). Полученные векторы смещения прибавляются к позиции камеры:Start = CameraPos + Forward * OffsetEnd = CameraPos + Forward * Distance.
Возврат. Обе точки возвращаются как структуры (вероятно, Vector3) через выходные пины Start и End.
Особенности и подозрительные места
- Функция не имеет exec-потока между вызовами
GetCameraLocationиGetCameraRotation— они оба используют один и тот жеself, но порядок их выполнения не гарантирован. В данном случае это неважно, так как они не зависят друг от друга, но в более сложных сценариях стоило бы добавить явную последовательность. - Если
Offsetокажется большеDistance, точкаStartбудет дальшеEnd, что может быть нелогично для некоторых применений (например, для отображения отрезка). Это не баг, а особенность использования — функция просто возвращает две точки, а не отрезок с гарантированным порядком. - Нет проверок на нулевой вектор направления или отрицательные значения
Offset/Distance. При нулевомForward(например, камера смотрит строго вверх) обе точки совпадут с позицией камеры, что может быть неожиданно. - Предупреждений (WARNINGS) в дампе нет, поэтому дополнительных проблем с гомоглифами или неподключёнными пинами не обнаружено.
Кому и когда это пригодится
Разработчикам, реализующим механику прицеливания, стрельбы, взаимодействия с объектами по лучу, или отлаживающим визуализацию направления камеры. Функция проста и может быть расширена для более сложных трассировок (например, с учётом препятствий через LineTrace).
Что делает функция
Функция Get Interact Target выполняет сферическую трассировку от камеры игрока вперёд на заданную дистанцию, возвращая результат попадания (OutHit). Она определяет, на какой объект смотрит игрок в радиусе взаимодействия.
Зачем нужна
Это типовой паттерн для систем взаимодействия (пикап предметов, открытие дверей, диалоги). Используется в Single Player или локальном мультиплеере. В UE5 такой подход часто применяется в Custom Character Blueprint с Enhanced Input и Line/Sweep Trace.
Как читать (ключевые блоки)
- Получение контроллера —
GetPlayerControllerберёт контроллер текущего игрока. - Проверка валидности — макрос
IsValidпроверяет, что контроллер существует. Если нет — трассировка не запускается (выходIs Not Validне подключён, функция молча завершится). - Расчёт точек трассировки —
GetTracePoints(кастомная функция) вычисляетStartиEndна основе позиции камеры, смещения (Offset) и дистанции (Distance). - Сферическая трассировка —
Sphere Trace By Channelпускает сферу заданного радиуса отStartдоEndпо каналуTraceTypeQuery1. - Возврат результата — структура
OutHitпередаётся на выход функции.
Особенности и подозрительные места
- Не подключён
WorldContextObject— вSphere Trace By Channelэто может привести к ошибке выполнения, если функция ожидает контекст. Обычно сюда подаютSelfилиPlayerController. - Не подключён
ActorsToIgnore— трассировка не игнорирует самого игрока, что может давать ложное попадание в его собственную модель (если она есть). - Не подключён
DrawDebugType— отладка не включена, что нормально для продакшена, но усложняет отладку. bIgnoreSelf = true— частично решает проблему игнорирования себя, но только если актёр, вызвавший функцию, совпадает с владельцем контроллера.ReturnValue(bool) не подключён — результат успешности трассировки не используется, что может быть намеренно (если важен толькоOutHit).- Предупреждений в дампе нет, но потенциально
GetTracePointsможет вернуть некорректные точки, если камера не инициализирована.
Кому и когда это пригодится
Разработчикам, создающим систему взаимодействия от первого или третьего лица. Полезна как шаблон для быстрой реализации «луча взаимодействия» с возможностью кастомизации радиуса и смещения.