무기시스템 | Notion

데이터 기반(Data-Driven) 설계와 상속 기반(Inheritance-Based) 설계를 혼합하여, 각 객체의 역할을 명확히 하고 유기적인 상호작용을 구현하였음

무기 시스템의 전체적인 흐름(Flow Chart)

Untitled diagram _ Mermaid Chart-2025-08-18-105757.png

흐름 요약
- 입력은 인터페이스를 통해 추상적인 명령을 내림
- 실제 무기(AWeaponBase의 자식들)은 명령을 받아 데이터 테이블에서 자신의 스펙을 읽어옴
- 발사, 반동, 이펙트 등 관련 행동을 스스로 책임지고 실행
- 발사체의 종류는 데이터 테이블에 지정된 클래스에 따라 결정

각 클래스별 담당 역할

클래스	역할 (책임)	상세 설명
WeaponData.h	데이터 명세서	무기의 모든 스펙(대미지, 연사속도, 반동, 스폰할 프로젝타일 클래스, 애니메이션, 이펙트 등)을 담고 있는 순수 데이터 구조체.
IWeaponInterface.h	행동 계약서	PrimaryFire, StopFire, Reload 등 무기가 수행해야 할 '행동'을 정의. 제어부와 구현부를 완벽하게 분리.
WeaponBase.h	무기 원형	모든 무기가 공유하는 핵심 로직(데이터 로드, 발사 조건 판단, 반동, 이펙트 재생, 히트스캔/프로젝타일 발사)을 구현한 부모 클래스.
**Weapon_Pistol.h
Weapon_Pulse.h**	단발 무기	AWeaponBase를 상속받아, 클릭 시 FireAction을 호출하는 단발 발사 로직을 구현.
**Weapon_SMG.h
Weapon_Rifle.h**	자동 연사 무기	AWeaponBase를 상속받아, 타이머를 이용해 FireAction을 반복 호출하는 자동 연사 로직을 구현.
BaseProjectile.h	투사체 원형	모든 투사체의 공통 기능(움직임, 충돌, 수명, 기본 OnHit 로직)을 담당하는 추상 부모 클래스.
RifleProjectile.h	라이플 총알	ABaseProjectile을 상속받아, 빠른 속도와 포인트 대미지를 주는 OnHit 로직을 구현.
PulseProjectile.h	펄스 에너지탄	ABaseProjectile을 상속받아, 충돌 시 ApplyRadialDamage를 호출하여 범위 피해를 주는 OnHit 로직을 구현.
InventoryComponent.h	장비 관리자	최대 2개의 무기를 '소지'하고, Destroy와 Spawn을 통해 무기를 교체하는 '가상 인벤토리' 시스템을 관리.
Pickup_Weapon.h	상호작용 아이템	월드에 배치되어 플레이어와의 상호작용(E키)을 통해 InventoryComponent에 무기를 추가/교체하는 역할을 수행.

핵심 기능 및 설계 패턴

데이터 기반 설계 (Data-Driven Design):
- 무기의 모든 핵심 스펙을 C++ 코드가 아닌 데이터 테이블(DT_WeaponData)에서 관리.
- 효과: 프로그래머의 개입 없이 기획자가 직접 밸런싱 및 콘텐츠 추가 가능. 확장성과 유지보수성 극대화.
상속을 통한 기능 확장 (Inheritance-Based Extension):
- AWeaponBase와 ABaseProjectile이라는 안정적인 부모 클래스를 기반으로, 자식 클래스(Weapon_Rifle, PulseProjectile 등)를 만들어 각각의 고유한 동작을 재정의(Override)하는 방식을 사용.
- 효과: 공통 코드는 부모 클래스에서 재사용하고, 자식 클래스는 자신만의 차별점만 구현하면 되므로 코드의 중복이 최소화됨.
인터페이스를 통한 의존성 역전 (Dependency Inversion via Interface):
- 상위 모듈(ControlComponent)이 하위 모듈(Weapon_Rifle 등)을 직접 알지 못하고, 오직 추상적인 IWeaponInterface에만 의존.
- 효과: 새로운 무기 클래스를 추가해도 상위 모듈의 코드를 전혀 수정할 필요가 없는 유연한 구조 완성.
하이브리드 반동 시스템:
- 영구적인 에임 이동은 APlayerController::AddInput을 통해 구현하여, 플레이어의 '반동 제어' 실력을 요구.
- 순간적인 충격과 떨림은 UCameraShakeBase를 사용하여 강렬한 시각적 피드백 제공.
- 효과: 플레이어에게 도전 과제(반동 제어)와 보상(타격감)을 동시에 제공하는 전문적인 FPS 슈팅 경험 구현.

트러블 슈팅

문제 1: 연사 시 애니메이션/이펙트 비동기화
- 현상: 마우스를 누르고 있으면 총알은 계속 발사되지만, 발사 애니메이션과 이펙트는 첫 발에만 재생되거나 불규칙하게 동작.
- 원인: 제어부(ControlComponent)와 실행부(WeaponBase) 간의 책임이 불분명하여, ControlComponent가 무기의 내부 상태(연사 딜레이)를 알지 못한 채 애니메이션을 재생시켰기 때문.
- 해결: 발사와 관련된 모든 책임(조건 판단, 애니메이션, 이펙트, 사운드, 실제 발사)을 AWeaponBase의 FireAction 함수로 완전히 위임하여, 발사의 성공 여부와 모든 부수 효과가 완벽하게 동기화되도록 리팩토링.