<aside> 📌 Этот воркфлоу описывает процесс интеграции и настройки компонента вашего кастомного UShootingComponent в ваш класс от начала до конца.

</aside>

ШАГ 1: Инициализация и настройка компонента

<aside> ⚠️ Назначение ShootingComponent компонент, отвечающий за логику стрельбы в игровом мире. Он позволяет акторам (например, персонажам, оружию) генерировать выстрелы, управлять ими и обрабатывать их последствия.

</aside>

<aside> ✏️ Реализация

1. Создайте новый класс, наследуемый от UShootingComponent (например, UMyShootingComponent).
2. Добавьте свои необходимые свойства, функции, делегаты.
3. Переопределите виртуальные функции для определения своего кастомного поведения:
   • StartFire(): Позволяет выполнить дополнительную логику когда стрельба была успешно запущена, но логика выстрела еще не была произведена.
   • FinishFire(): Позволяет выполнить дополнительную логику когда стрельба была завершена.
   • Fire(): Позволяет выполнить дополнительную логика выстрела.
   • CanFire(): Определите может ли компонент сгенерировать выстрел.
   • GetFireLocation() : Определите мировую позицию откуда будет произведен спавн выстрела.
   • GetFireDirection(): Определите направление выстрела.
   • CalculateSpread(): Позволяет написать кастомную логику определнеия разброса.
   • HandleCalculateDamage(): Позволяет написать кастомную логику расчета урона.
   • HandleApplyDamage(): Позволяет написать кастомную логику нанесения урона.
4. Для сброса состояния активной стрельбы используйте FinishFire(). </aside>

<aside> ❗ Важные моменты

• Компонент по умолчанию поддерживает спавн эффектов и звуков при выстреле, для этого не забудьте через функцию SetMesh() указать SkeletalMeshСomponent оружия. И укажите название сокета ствола в свойство MuzzleSocketName.
• В свойстве AvailableFireModes задайте доступные режимы стрельбы и в свойстве FireMode установите текущий.
• Тип стрельбы прожектайлами может быть доступен при условии когда в UShootingComponent через функцию SetProjectilePoolManager() ,был задан компонент ObjectPoolComponent содержащий заранее подготовленый пулл снарядов. Так-же не забудьте указать какой класс снарядов будет использоваться в параметре ProjectileActorClass .

</aside>

ШАГ 2: Создание актора-стрелка (пример).

<aside> Создайте новый Blueprint Actor

<aside>

• В Content Browser нажмите правую кнопку мыши -> Blueprint Class.
• Выберите Actor в качестве родительского класса (или другой подходящий класс, если требуется специфическая функциональность).
• Назовите его, например, BP_MyShooter. </aside>

Добавление компонента ShootingComponent

<aside>

• Откройте Blueprint BP_MyShooter.
• В панели Components нажмите Add Component.
• Найдите и добавьте ваш MyShootingComponent. </aside>

Настройте свойства компонента

<aside>

• Выберите добавленный ShootingComponent в панели Components.
• В панели Details настройте свойства компонента:
  • AvailableFireModes: доступные режимы стрельбы.
  • FireMode: текущий режим стрельбы.
  • FireType: текущий тип стрельбы (лайн-трейс или проджектайл).
  • FireRate: скорострельность.
  • Ammo: информация о патронах.
  • SpreadConfig: конфиг разброса.
  • DamageConfig: конфиг урона.
  • (Другие специфичные свойства ShootingComponent). </aside>

Добавьте визуальное представление

<aside>

• Добавьте Skeletal Mesh Component оружия вашему стрелку.
• Передайте мешь оружия компоненту стрельбы через функцию SetMesh(). </aside>

</aside>

ШАГ 3: Управление стрельбой.

<aside> 🔥

Запуск стрельбы  Запуск стрельбы активируется с помощью функции StartFire(), функция автоматически проверяет условия для стрельбы, и если они соответсвуют то запускает дальнейший процесс воспроизведения выстрела.

</aside>

<aside> 🎯

Обработка результата выстрела  Вы можете обработать результат попадания выстрела несколькими способами, первый способ подходит как для типа стрельбы лайнтрейсом и проджектайлом, это подписатся на делегат OnTargetHit() компонента, и второй способ использовать тоже делегат либо евент OnFire() в котором через функцию GetLastHitResult() можно получить последний результат трасировки, метод больше подходит только для типа стрельбы лайнтрейсом.

</aside>

<aside>

Медиа

</aside>

<aside> ❗ Следуя этим шагам, вы сможете создавать и настраивать логику стрельбы для любого актора-стрелка отвечающему вашим запросам.

</aside>