← 자료실/designsLOW

전투 시스템 핵심 자산 인벤토리 v1

designs/combat_system_core_assets_inventory_v1_2026-05-05.md

전투 시스템 핵심 자산 인벤토리 v1

작성: 정현우 (code-lead) 일자: 2026-05-05 원천: Program/Client/Assets/Scripts/ (read-only) APPROVED: 정현우 자율

1. 매트릭스 표기

2. Entity 본체 (3 파일)

파일LOC역할의존난이도손맛
EodEntity.cs~3000 추정god 노드, 모든 컴포넌트 owner모든 컴포넌트3-
EodEntityComponent.cs~200 추정컴포넌트 baseEodEntity / EodEntityEventManager2-
EodEntityBuilder.cs~500 추정컴포넌트 조립 팩토리다수3-

3. 전투 핵심 컴포넌트 (8 파일)

파일LOC역할의존난이도손맛
EodEntityCombatComponent.cs2499전투 매니저 (god 클래스)EodAbilityStatus / EodMatrixTrail × 2 / EodHUDDamage / EodCamera44
EodEntitySkillComponent.cs1794스킬 보유·발동·관리 (god 클래스)List<Skill> / EodEntityCharacterInfo / EodUIGameButtons44
EodEntityComboHitComponent.cs95콤보 UI 연결EodUIComboHit / EodUIManager (Addressable)34
EodEntityShakeCameraComponent.cs51카메라 흔들림 수신EodCamera / EodGameDatascriptManager14
EodEntityMatrixEffectComponent.cs188잔상 복제 (모션 블러)EodEntityAnimationComponent / EodEntityModelComponent23
EodEntityActionComponent.cs~500 추정일반 액션 매니저 (Skill 과 중복)List<EodAction>33
EodEntityAnimationComponent.cs~400 추정Animator 래퍼UnityEngine.Animator23
EodEntityMoveComponent.cs~600 추정이동 처리UnityEngine.Transform23

4. Skill 시스템 (15 파일)

파일LOC역할난이도손맛
EodSkill.cs517Skill 클래스 (TimeEvent 컨테이너)34
EodSkillEventBuilder.cs17813 SkillEvent 팩토리23
EodSkillEventCreateProjectile.cs~150 추정투사체 생성34
EodSkillEventShakeCamera.cs55카메라 흔들림14
EodSkillEventMoveFoward.cs~80 추정직선 이동22
EodSkillEventMoveDirection.cs~80 추정입력 방향 이동22
EodSkillEventMoveToNearestTarget.cs~100 추정최근접 타겟 돌진23
EodSkillEventMoveDirectAutoToNearTarget.cs~120 추정소용돌이 (이동 컨트롤)22
EodSkillEventTeleportFoward.cs~80 추정순간이동 전방23
EodSkillEventTeleportBack.cs~80 추정순간이동 후방 (백스텝)23
EodSkillEventRotate.cs~50 추정즉시 회전21
EodSkillEventRotateDirection.cs~60 추정입력 방향 회전21
EodSkillEventRotateToNearestTarget.cs~80 추정최근접 타겟 자동 회전22
EodSkillEventCreateMonster.cs~150 추정적 몬스터 소환31
EodSkillEventAllyCreateMonster.cs~150 추정아군 (펫) 소환32

5. Action 시스템 (5 파일, Skill 과 중복)

파일LOC역할난이도손맛
EodAction.cs188Action 클래스 (Skill 와 유사, refactoring 대상)22
EodActionEventBuilder.cs~80 추정3 ActionEvent 팩토리22
EodActionEventPlayEffect.cs~100 추정VFX 재생34
EodActionEventPlaySound.cs~100 추정사운드 재생34
EodActionEventShakeCamera.cs~50 추정카메라 흔들림 (중복)14

6. Projectile 시스템 (12 파일)

파일LOC역할난이도손맛
EodProjectile.cs~800 추정투사체 본체34
EodProjectileEventBuilder.cs~150 추정11 ProjectileEvent 팩토리23
EodProjectileEventActivateDetection.cs~80충돌 활성화23
EodProjectileEventAttPowDetection.cs~120공격력 검출 (적 충돌)34
EodProjectileEventDefPowDetection.cs~120방어력 검출 (아군 충돌)33
EodProjectileEventQuickDetection.cs~100즉시 검출23
EodProjectileEventDamageIgnoreDetection.cs~80데미지 무시 검출21
EodProjectileEventHealDetection.cs~100회복 검출22
EodProjectileEventCreateProjectile.cs~150투사체에서 투사체 생성 (분열)34
EodProjectileEventPlayEffect.cs~100VFX 재생34
EodProjectileEventPlaySound.cs~100사운드 재생33
EodProjectileEventShakeCamera.cs~50카메라 흔들림14
EodProjectileLightning.cs~200 추정번개 투사체 특수34

7. Event 시스템 (5 파일)

파일LOC역할난이도손맛
EodEntityEvent.cs103535 EventBase 클래스 정의23
EodEntityEventManager.cs~300 추정발행-구독 매니저2-
EodEntityEventPool.cs~200 추정오브젝트 풀 (GC 최소화)2-
EodEntityEventType.cs14534 eType enum1-
EodEventPushMove.cs150넉백 이동 (등속 → 감속)23

8. 손맛 핵심 (4 파일)

파일LOC역할의존난이도손맛
EodMatrixTrail.cs204무기 궤적 트레일 (좌/우)Xft.XWeaponTrail (외부)54
EodCamera.cs~1500 추정카메라 매니저 + ShakeEodGameDatascriptManager.CameraShakeTable34
EodHUDDamageManager.cs~500 추정데미지 텍스트 + 회피 텍스트UI Pool33
EodSceneManager.cs~2000 추정씬 관리 + GameMode 분기다수4-

9. UI (12 파일)

파일LOC역할난이도손맛
EodUIComboHit.cs~300 추정콤보 UI33
EodUIGameButtons.cs~600 추정스킬 버튼 (메인/서브)33
EodUISkillButton.cs~400 추정단일 스킬 버튼 + 쿨타임32
Skill UI 9건~2000 추정 (총합)스킬 트리 / 슬롯 / 팝업31

10. 데이터 테이블 (9 파일)

파일역할난이도비고
EodDataTableSkill스킬 본체2FlatBuffer 마이그레이션 대상
EodDataTableSkillEvent스킬 이벤트 unitList2param1/2/3 string parsing
EodDataTableSkillType스킬 타입 (Normal/Active/Passive)1enum 매핑
EodDataTableSkillLevelup레벨별 스킬 코드2
EodDataTableSkillLevelUseData레벨별 쿨타임 / 사용 데이터2
EodDataTablePassiveSkill패시브 스킬2
EodDataTableSuccessionSkill계승 스킬 (장비)2
EodDataTableOccupationtSkillSetting직업별 스킬 셋2typo: Occupationt
EodDataTableGuildSkill길드 스킬 (멀티 잔재)5삭제 권고

11. SCSV 로더 (9 파일)

GameDatascript/Loader/SCSV/ 동일 9건 — FlatBuffer 마이그레이션 시 Loader 삭제 + Importer 1건으로 대체.

12. 외부 의존 (4건)

라이브러리사용처Unity 6처리
Xft.XWeaponTrailEodMatrixTrail미보증자체 구현 또는 Asset Store 대체
AddressablesUI 비동기 로드 (다수)2.x 호환콜백 → async/await 점진
EasyMovieTexture컷씬 (3rdParty)미보증Phase 4 시점 평가
FacebookSDK / GooglePlayGames멀티 잔재 (3rdParty)사용 X삭제

13. 우선순위 매트릭스 (포팅 순서 권고)

Tier 1 — 손맛 4중 메커니즘 (1주)

  1. EodCamera.cs (Shake 본체)
  2. EodEntityShakeCameraComponent.cs (51줄, 즉시)
  3. EodEntityComboHitComponent.cs (95줄, 즉시)
  4. EodMatrixTrail.cs + Xft 대체 (25h)
  5. EodEntityMatrixEffectComponent.cs (디버그 코드 제거 + 188줄)

Tier 2 — Skill 시스템 (2주)

  1. EodEntityEvent.cs (1035줄, 35 EventBase)
  2. EodEntityEventManager.cs / EventPool.cs / EventType.cs
  3. EodSkill.cs (517줄)
  4. EodSkillEventBuilder.cs + 13 SkillEvent (15 파일)

Tier 3 — 전투 + 투사체 (2주)

  1. EodEntityCombatComponent.cs (2499줄, 분할 권고)
  2. EodEntitySkillComponent.cs (1794줄, 분할 권고)
  3. EodProjectile.cs + 11 ProjectileEvent

Tier 4 — Action + Move + Animation (1주)

  1. EodAction.cs + 3 ActionEvent
  2. EodEntityActionComponent.cs
  3. EodEntityMoveComponent.cs
  4. EodEntityAnimationComponent.cs
  5. EodEventPushMove.cs

Tier 5 — UI (1주)

  1. EodUIComboHit.cs / EodUIGameButtons.cs / 12 Skill UI

Tier 6 — 데이터 (50h, FlatBuffer 50h 흡수)

  1. 9 데이터 테이블 + 9 SCSV 로더 → FlatBuffer 변환

Tier 7 — Unit Test (지속)

  1. 80% 커버리지 — Tier 1~6 동시 진행

14. 통계

15. 다음 세션 첫 액션

연계: