🧠 클래스의 목적

CharacterStat 클래스는 이름 그대로 캐릭터의 스탯, 즉 능력치 전반을 담당하는 클래스입니다.

공격력, 방어력, 체력, 마력, 이동속도, 공격속도, 속성 저항력까지 다양한 값을 관리하고 있으며, 이러한 스탯은 장비나 버프, 혹은 스크립터블 오브젝트 기반의 테이블 데이터를 통해 실시간으로 변동될 수 있습니다.

🔧 기본 구성

CharacterStat 클래스는 MonoBehaviour를 상속받아 Unity 컴포넌트로 작동하며, 내부적으로는 다음과 같은 멤버들을 포함하고 있습니다.

1. 기본 스탯 (Base Values)

   BaseAtk, BaseHp, BaseMoveSpeed 등, 테이블에서 받아오는 고정값들이며, 캐릭터의 기본 능력치를 의미합니다.

2. 최종 스탯 (Total Values)

   BehaviorSubject<long> 타입의 변수로, Reactive 방식으로 UI나 다른 시스템과 연동됩니다. 이 Reactive 처리를 위해 R3 패키지를 사용하였으며, 자세한 설명은 링크를 참고 부탁드립니다.

   예를 들어, TotalHp가 바뀌면 체력 UI가 자동으로 업데이트되도록 구성되어 있습니다.

3. 버프 및 아이템 효과 처리

   장비를 장착하거나 특정 버프를 받을 때, 능력치에 직접적인 영향을 주게 되는데요.

   이 클래스는 플랫(Flat) 보너스와 퍼센트(%) 보너스를 구분하여 저장하고 계산합니다.

📐 핵심 메서드

다음은 자주 사용되는 주요 메서드입니다:

• SetBaseInfos()

  → 테이블에서 받은 기본 스탯을 설정합니다.

• UpdateStatCache()

  → 장착 중인 아이템 정보를 기반으로 스탯을 다시 계산합니다.

• RecalculateStats()

  → 현재의 모든 보너스를 적용한 최종 스탯을 계산합니다.

• ApplyStatModifiers() / RemoveStatModifiers()

  → 특정 버프나 디버프에 따른 능력치 변경을 적용하거나 제거합니다.

• GetCurrentMoveSpeed()

  → 이동속도를 float 값으로 반환하여 캐릭터 컨트롤러 등에서 활용할 수 있게 합니다.

이처럼 CharacterStat 클래스는 캐릭터 능력치의 기반이 되는 핵심 컴포넌트이며, 게임 밸런싱, UI 업데이트, 전투 시스템 등 다양한 기능과 밀접하게 연관되어 있습니다.