![](https://habrastorage.org/getpro/habr/upload_files/677/7de/017/6777de017c9488885c70212dcfbc7517.jpeg)
Весь цикл статей
Всем привет, сегодня мы настроим управление нашим персонажем, а также управление камерой.
Для начала нам нужно создать несколько С++ классов - Character, Player Controller и GameMode.
В Content Browser перейдем в папку "С++ Classes"
![](https://habrastorage.org/getpro/habr/upload_files/464/559/aff/464559aff46072fdc749cf286e724f3e.png)
Если этой папки нет, то ее отображение можно включить нажав на View Options и поставить галочку на Show C++ Classes.
![](https://habrastorage.org/getpro/habr/upload_files/260/468/51c/26046851c5c9a5f501ac1011f58e0455.png)
Перейдя в папку с С++ классами, щелкаем ПКМ в окне Content Browser и выбираем New C++ Classes
![](https://habrastorage.org/getpro/habr/upload_files/c1d/e5e/70a/c1de5e70aadcbbbd0fe4b5fbcead1f86.png)
Появится окно с классами от которых мы можем наследоваться.
Создадим класс для нашего персонажа, поэтому в качестве родительского класса выбираем Character и щелкаем Next
![](https://habrastorage.org/getpro/habr/upload_files/115/2be/ec7/1152beec72cca8b724d7c0476c36e673.png)
В следующем окне нужно указать имя класса и его расположение. Для всех классов в проекте мы будем делать приписку SH(Survival Horror)
![](https://habrastorage.org/getpro/habr/upload_files/98f/b3d/102/98fb3d1027c2e9feaae5413927e8b62d.png)
Также нажмем на Public, чтобы заголовочные файлы(*.h) находились в папке Public, а *.cpp файлы в папке Private.
![](https://habrastorage.org/getpro/habr/upload_files/b2f/870/749/b2f870749960aaef3ba871fe71b25150.png)
В пути файла допишу Player. Таким образом создастся папка с аналогичным названием и туда поместится наш класс. Потом нажимаем Create Class.
![](https://habrastorage.org/getpro/habr/upload_files/d1c/ed9/f03/d1ced9f03519e5b478e1f3b42674152f.png)
После компиляции в редакторе кода можно увидеть созданные файлы
![](https://habrastorage.org/getpro/habr/upload_files/aee/ff8/1ac/aeeff81acc21067c7febc94b43593ede.png)
Аналогичным образом создадим Player Controller с именем SHPlayerController и также поместим его в папку Player
![](https://habrastorage.org/getpro/habr/upload_files/b4b/a36/986/b4ba369866d322a113068b94ea23919f.png)
И создадим последний класс GameModeBase с именем SHGameModeBase
![](https://habrastorage.org/getpro/habr/upload_files/adc/ba2/09f/adcba209fff8dcf4bc7e79bd81b6bec0.png)
Он будет лежать просто в папке Public и Private
![](https://habrastorage.org/getpro/habr/upload_files/de6/bdc/ae8/de6bdcae8558dfb313c13243afbe3edb.png)
В папке Content создадим новую папку и назовем ее Blueprints. И уже внутри нее создадим папку Player.
![](https://habrastorage.org/getpro/habr/upload_files/e47/e7e/728/e47e7e7285877f0be6f585738dbfbbde.png)
Теперь из наших C++ классов нужно сделать Blueprint классы.
Переходим в папку с С++ классами персонажа и щелкаем ПКМ по классу SHCharacter, в появившемся меню выбираем Create Blueprint class based on SHCharacter.
![](https://habrastorage.org/getpro/habr/upload_files/774/775/663/774775663d4a06e7e2b2143bb9a04f32.png)
Появится окно. Здесь указываем имя класса. Blueprint классы принято начинать с префикса BP_. Также нужно указать папку, где необходимо его создать, в нашем случае Player. Нажимаем Create Blueprint Class.
Как именовать файлы в Unreal Engine можно узнать из этого репозитория на GitHub - https://github.com/ShadowPKx/ue4-style-guide-rus
![](https://habrastorage.org/getpro/habr/upload_files/2eb/276/87d/2eb27687d5fddfff9f9c6798bdfb789d.png)
Откроется окно с редактором Blueprint класса, его пока можно закрыть. Сначала создадим еще два класса.
Аналогично создаем класс для Player Controller.
![](https://habrastorage.org/getpro/habr/upload_files/9b5/81e/145/9b581e1457f2bd91c7c0cb2edfb3199d.png)
И для нашего SHGameModeBase, только расположение выбираем просто папку Blueprints.
![](https://habrastorage.org/getpro/habr/upload_files/2be/998/f2c/2be998f2cfc1ea22b5ac9190dd3b95e8.png)
Теперь перейдем в BP_GameModeBase
![](https://habrastorage.org/getpro/habr/upload_files/16c/630/82a/16c63082a312d4895b8b314bd288263d.png)
Здесь в Player Controller Class необходимо выбрать наш Player Controller
![](https://habrastorage.org/getpro/habr/upload_files/ba8/5a5/764/ba85a57646f16df7dd7aa2223ce03510.png)
И тоже самое проделать с Default Pawn Class
![](https://habrastorage.org/getpro/habr/upload_files/586/94f/f50/58694ff50b3bbf7919a40623611f363d.png)
Дальше перейдем в настройки проекта Edit->Project Settings. Дальше в категорию Maps&Modes. И в Default GameMode выберем наш класс.
![](https://habrastorage.org/getpro/habr/upload_files/19f/5da/4db/19f5da4db925fdab579ed9d1f3938fff.png)
Теперь откроем Blueprint класс BP_SHCharacter и установим для него Skeletal Mesh манекена.
![](https://habrastorage.org/getpro/habr/upload_files/7bb/4c9/852/7bb4c9852929bde63fc6997eb222eca5.png)
В компонентах находим Mesh
![](https://habrastorage.org/getpro/habr/upload_files/362/667/a30/362667a300ed10a28d1dfa6b39b448d8.png)
После этого в Details ищем Skeletal Mesh и выбираем для него необходимый Mesh
![](https://habrastorage.org/getpro/habr/upload_files/389/73c/26e/38973c26ead64f5fe21d5cf097f2b5c9.png)
Перейдем во Viewport и увидим, что Mesh нужно опустить и повернуть
![](https://habrastorage.org/getpro/habr/upload_files/8de/ba6/a3a/8deba6a3ad54da53645af2da0973dde9.png)
По оси Z опускаем его на -88 и поворачиваем на -90 градусов
![](https://habrastorage.org/getpro/habr/upload_files/041/cb6/25c/041cb625c2cc9e820a39a10b45d063a0.png)
Теперь он подходит под компонент капсулы и смотрит в нужную сторону, об этом нам "говорит" компонент стрелка.
![](https://habrastorage.org/getpro/habr/upload_files/bae/956/574/bae956574144c9deca3dfb988bd24064.png)
Теперь приступим к написанию кода для управления персонажем и камерой.
Сначала перейдем в Edit->Project Settings. Потом в категорию Input. Здесь нам нужно назначить mappings, т.е. клавиши, мышь, кнопки геймпада и т.д., которые будут отвечать за какое-либо действие в игре.
Есть два типа mapping Action и Axis.
Action - подходят для каких то разовый действий, например, нажать на кнопку действия и начать разговоров с НПС.
Axis - необходимы когда нам нужно получаться отклик в каждом кадре. Например, для перемещения персонажа, когда зажата клавиша движения вперед.
В данный момент нам нужен Axis.
Если его сейчас развернуть, то там уже есть созданные mappings. Потому что мы добавляли шаблон от третьего лица. Удалим их, нажав на крестик напротив каждого из них. Тоже самое можно сразу проделать с Action.
![](https://habrastorage.org/getpro/habr/upload_files/3f2/a2f/a35/3f2a2fa35e9e8a9e8b0ca02c0ce447d0.png)
Теперь создадим новый нажав на "+" и дадим ему имя MoveForward. Он будет отвечать за движение вперед и назад
![](https://habrastorage.org/getpro/habr/upload_files/6de/2ee/e85/6de2eee85362d62d9c76de2f293787f1.png)
Напротив него нажмем на "+", чтобы создать еще одно поле для клавиши
![](https://habrastorage.org/getpro/habr/upload_files/6bc/b68/c28/6bcb68c284ca9f4939d43de3ebc61aae.png)
Теперь щелкаем по первому полю None и через поиск ищем клавишу W, он будет отвечать за движение вперед. Scale оставляем равным 1.
![](https://habrastorage.org/getpro/habr/upload_files/dd3/6dc/181/dd36dc181ae853cf5382209435d24bed.png)
Для второго поля выбираем клавишу S, а Scale изменяем на -1.
![](https://habrastorage.org/getpro/habr/upload_files/bed/d1a/273/bedd1a273c3035f7d767b94ae81f0da2.png)
Этот Scale будет принимать значение от -1 до 1, в зависимости от нажатой клавиши.
Аналогично создаем новый mapping с именем MoveRight, которые будет отвечать за движение в стороны.
![](https://habrastorage.org/getpro/habr/upload_files/384/b97/620/384b976200f5c73719b4601567611130.png)
Третий mapping с именем LookUp будет отвечать за управление камерой по вертикали. Scale ставим -1, чтобы не было инверсии.
![](https://habrastorage.org/getpro/habr/upload_files/f65/261/0c6/f652610c682b6fe55ad0c92fd8034abf.png)
И последний mapping с именем Turn отвечает за управление камерой по горизонтали
![](https://habrastorage.org/getpro/habr/upload_files/7ae/71d/ea8/7ae71dea8f471782b79f9231587667cb.png)
Теперь переходим в редактор кода. Нам понадобится открыть наш класс SHCharacter.h и SHCharacter.cpp.
Сначала создадим два компонента - CameraComponent и SpringArmComponet. Т.е. камера будет висеть на этом компоненте и как бы летать по орбите вокруг персонажа.
Чтобы создать новые компоненты, для начала в заголовочном файле SHCharacter.h в секции protected объявим два указателя на UCameraComponent и USpringArmComponent c именами CameraComponent и SpringArmComponent.
![](https://habrastorage.org/getpro/habr/upload_files/b60/e8e/239/b60e8e239491c8c4b2cb61362386c717.png)
Для каждого указателя используем макрос UPROPERTY со следующими спецификаторами (VisibleAnywhere, BlueprintReadWritem, Category = "Components").
Про них подробнее можно почитать в офф документации по ссылке - https://docs.unrealengine.com/4.26/en-US/ProgrammingAndScripting/GameplayArchitecture/Properties/Specifiers/
Сейчас указатели подсвечиваются красным(указывает на ошибку). Связано с тем, что не подключены заголовочные файлы для этих компонентов. Заголовочные файлы мы будем подключать в SHCharacter.cpp.
Чтобы сейчас избавиться от этой ошибки, нам нужно сообщить компилятору, чтобы он "не переживал" и эти файлы будут подключены.
Для этого после всех include и перед макросом UCLASS() необходимо добавить следующие строки.
![](https://habrastorage.org/getpro/habr/upload_files/7c3/eb1/0a6/7c3eb10a6c31f9e11656db821ffec878.png)
Теперь переходим в SHCharacter.cpp. В данный момент мы только объявили указатели для этих компонентов, но еще их не создали.
Сначала мы подключим заголовочные файлы для них.
![](https://habrastorage.org/getpro/habr/upload_files/5b1/96f/196/5b196f19693574115b51a2d0e061c809.png)
Теперь в конструкторе класса будем их создавать.
![](https://habrastorage.org/getpro/habr/upload_files/994/ad9/46c/994ad946c3e3a77816500c07b43b4996.png)
Чтобы создать новый компонент необходимо воспользоваться шаблонной функцией CreateDefaultSuboject. Т.е. мы указываем какой класс действительно хотим создать(USpringArmComponent), а в качестве входного параметра передаем строку с именем компонента.
![](https://habrastorage.org/getpro/habr/upload_files/8fa/3bb/2c0/8fa3bb2c0c0408bb91b4bf49c072489e.png)
Теперь вызовем функцию SetupAttachment у SpringArmComponent, чтобы присоединить его к корневому компоненту(RootComponent).
Функция GetRootComponent как раз возвращает указатель на корневой компонент.
![](https://habrastorage.org/getpro/habr/upload_files/2cb/fb9/ecb/2cbfb9ecbdbe0e15d42a82cbcc319126.png)
Также у SpringArmComponent есть параметр bUsePawnControlRotation, его мы изменим на true, чтобы этот компонент использовал вращение контролера и мы могли поворачивать персонажа с помощью мыши.
![](https://habrastorage.org/getpro/habr/upload_files/880/2c9/00d/8802c900d3a964885fd2a57ed9d9e538.png)
Аналогичным образом создаем компонент камеры.
![](https://habrastorage.org/getpro/habr/upload_files/761/59b/d85/76159bd85a3c0c7fea357598b35feb92.png)
Но теперь присоединяем ее к нашему SpringArmComponent
![](https://habrastorage.org/getpro/habr/upload_files/213/d86/292/213d8629251337b009319a6bc1fcf19e.png)
Полностью код в конструкторе выглядит следующим образом
![](https://habrastorage.org/getpro/habr/upload_files/24c/f09/abc/24cf09abcaa10b48a58d31a8a31c25e6.png)
Теперь скомпилируем проект и перейдем в BP_SHCharacter.
У нас появились два наших компонента
![](https://habrastorage.org/getpro/habr/upload_files/2ba/850/cbb/2ba850cbb484173ad638296f9d9da634.png)
И также видим камеру, которая висит на краю SpringArmComponent
![](https://habrastorage.org/getpro/habr/upload_files/6dd/20b/3fa/6dd20b3fa19d2c3bdcffba4e47dc6de5.png)
Выберем SpringArmComponent и изменим его положение. Я выставлю следующие
![](https://habrastorage.org/getpro/habr/upload_files/5f5/edb/3d3/5f5edb3d32760e549a225c9adb64a3f6.png)
Камера у меня висит как бы из-за плеча
![](https://habrastorage.org/getpro/habr/upload_files/a52/7e5/0fd/a527e50fd13a974d58dcb54d1649df96.png)
Возвращаемся в редактор кода в файл SHCharacter.h
Создаем приватную секцию. В ней объявим две функции MoveForward и MoveRight с одним параметром типа float. В этих функциях будет логика перемещения персонажа.
![](https://habrastorage.org/getpro/habr/upload_files/a11/09e/d77/a1109ed77beea2664e83d54cc8115c14.png)
Теперь перейдем в SHCharacter.cpp и создадим тело для наших функций.
![](https://habrastorage.org/getpro/habr/upload_files/48e/ee8/9ac/48eee89ac2d5e1fc336b83af27b43d86.png)
Также здесь есть функция, в которой мы получаем указатель на PlayerInputComponent, в этой функции мы будет "биндить" наши mapping с функциями MoveForward и MoveRight
![](https://habrastorage.org/getpro/habr/upload_files/f1c/367/a43/f1c367a43172f2dce4d5a65ac5940f69.png)
У PlayerInputComponent есть функция BindAxis. В качестве первого параметра необходимо указать имя mapping, которые мы создавали ранее. Второй параметр - это указатель на объект, функция которого будет вызываться и третий параметр это ссылка на саму функцию.
![](https://habrastorage.org/getpro/habr/upload_files/854/8ff/db1/8548ffdb11bd37080f3f2dacc491b53d.png)
Аналогично проделываем с MoveRight
![](https://habrastorage.org/getpro/habr/upload_files/a2b/609/6e6/a2b6096e6df8fd6fdfed20ce716d7902.png)
Перейдем в тело функции MoveForward и воспользуемся там функцией AddMovementInput, которая и будет перемещать персонажа. Для нее нужно указать несколько параметров.
Первый, направление движения. Воспользуемся другой функцией(GetActorForwardVector), которая возвращает вектор куда смотрит Actor.
Второй, это наш Scale mapping'a от -1 до 1. На это число будет умножаться вектор направления, тем самым двигать персонажа в нужную сторону в зависимости от знака.
![](https://habrastorage.org/getpro/habr/upload_files/c95/84b/fdb/c9584bfdbbd4c2ad9b3a0eb0d1d12e48.png)
Тоже самое проделываем и с MoveRight. Только используем GetActorRightVector.
![](https://habrastorage.org/getpro/habr/upload_files/29c/458/274/29c4582740a27ae927fa8226cc38fbff.png)
Осталось добавить управление камерой.
Для этого у PlayerInputComponent вызываем функции BindAxis для mapping'ов LookUp и Turn. В Unreal Engine есть встроенные функция для управления камерой, поэтому мы указываем ссылки на них.
Для LookUp - AddControllerPitchInput
Для Turn - AddControllerYawInput
![](https://habrastorage.org/getpro/habr/upload_files/813/3be/5a4/8133be5a430102fea60d366371219236.png)
На этом я заканчиваю. Если вам понравился контент, то буду рад вашей подписке, лайку или комменту:)
Тоже самое, только в видео
Подпишись: