🔖 목차

📌 프로젝트 개요

📺 게임 영상

https://www.youtube.com/watch?v=1by5lFuz6O8

한눈에 구조 요약

• 상속 축
  • Player , Enemy : Character , AI_PATORL , AI_ RANGE : AIController
• 필수 컴포넌트
  • Animator, Rigidbody, StateComponent, HealthPointComponent, WeaponComponent
  • 플레이어 전용 : PlayerInput, PlayerMovingComponent
• 핵심 책임 분배
  • Character : 공통 바디(애니메이터/리짓바디 참조, 루트모션 적용, 일시정지 등록)
  • Player : 인풋 액션 → 무기 모드 전환/액션 트리거 바인딩
  • PlayerMovingComponent : 이동/카메라 회전, 달리기/회피, 상태 변화 대응
  • StateComponent : Idle/Equip/Action/Evade/Damaged/Dead 상태머신 + 이벤트
  • WeaponComponent : 무기 테이블 생성/장착/행동, 애니메이터 파라미터 동기화
  • HealthPointComponent : HP, 플레이어/적 UI 바인딩

🗂️ 시스템 구조도

classDiagram
direction LR

%% ===== Core Classes =====
class Character {
  <<abstract>>
  +Animator animator
  +Rigidbody rigidbody
  +StateComponent state
  +HealthPointComponent healthPoint
  +WeaponComponent weapon
  +Start_FrameDelay()
  +OnAnimatorMove()
}

class Player {
  +PlayerInput input
  +PlayerMovingComponent moving
}

class Enemy {
  +AIController aiController
  +OnDamage(attacker, causer, hitPoint, data)
}

class StateComponent {
  +SetIdleMode()
  +SetEquipMode()
  +SetActionMode()
  +SetEvadeMode()
  +SetDamagedMode()
  +SetDeadMode()
  +OnStateTypeChanged
}

class HealthPointComponent {
  -maxHealthPoint : float
  -currHealthPoint : float
  +Damage(amount : float)
  +Dead : bool
}

class PlayerMovingComponent {
  +Move()
  +Stop()
  +Evade
  +SpeedX
  +SpeedY
}

class IDamagable {
  <<interface>>
  +OnDamage(attacker, causer, hitPoint, data)
}

%% forward declarations so relations don't error
class Animator
class Rigidbody
class PlayerInput
class AIController
class WeaponComponent

%% ===== Inheritance =====
Character <|-- Player
Character <|-- Enemy
IDamagable <|.. Enemy

%% ===== Composition / Associations =====
Character *-- Animator : require
Character *-- Rigidbody : require
Character *-- StateComponent : require
Character *-- HealthPointComponent : require
Character *-- WeaponComponent : require

Player o-- PlayerInput : association
Player *-- PlayerMovingComponent : composition
Enemy *-- AIController : composition

무기 (Weapon) 구조도

classDiagram
direction LR

%% ===== Base Weapon =====
class Weapon {
  <<abstract>>
  +WeaponType type
  +DoActionData[] doActionDatas
  +Equip()
  +UnEquip()
  +DoAction()
  +Begin_DoAction()
  +End_DoAction()
  +Play_Particle()
}

class Melee {
  +Begin_Combo()
  +End_Combo()
  +Begin_Collision(e)
  +End_Collision()
  +Play_Impulse()
}

class Fist
class Sword
class Hammer
class FireBall
class Warp

class DoActionData {
  +bCanMove : bool
  +Power : float
  +Distance : float
  +StopFrame : int
  +Particle : GameObject
  +ImpulseDirection : Vector3
  +HitImpactIndex : int
  +HitParticle : GameObject
}

class Projectile {
  +OnProjectileHit
}

class IDamagable {
  <<interface>>
  +OnDamage(attacker, causer, hitPoint, data)
}

%% ===== Inheritance =====
Weapon <|-- Melee
Melee <|-- Fist
Melee <|-- Sword
Melee <|-- Hammer
Weapon <|-- FireBall
Weapon <|-- Warp

%% ===== Associations =====
Weapon *-- DoActionData
FireBall *-- Projectile
Melee --> IDamagable : attack target

적(AI) 시스템 구조도