Files
2nd/10_Wiki/Topics/Modular-Weapon-Evolution-and-Skill-Trees.md
T

2.7 KiB

Modular Weapon Evolution and Skill Trees

Skybound의 무기 시스템은 단순한 수치 강화를 넘어, 모듈의 조합과 진화(Evolution)를 통해 기체의 특성을 정의합니다. ModularWeaponSystem은 이러한 무기 상태의 변화와 트리 형태의 진화 로직을 관리합니다.

1. Evolution Logic (진화 메커니즘)

무기는 특정 레벨에 도달하거나 보너스 아이템을 획득했을 때 Evolution 단계로 진입할 수 있습니다. evolutions.tsEVOLUTION_RECIPES 테이블에 정의된 규칙에 따라 작동합니다.

  • Prerequisite Check: 진화를 위해서는 베이스 무기와 보조 모듈(Passive Module)의 조화가 필요합니다.
  • Dynamic Max Level: 모든 무기가 Lv.5에서 진화하는 것은 아닙니다. SKILL_MAX_LEVEL 테이블을 통해 무기별 최적화된 진화 지점을 정의합니다.
    • 예: aoe_nova는 Lv.3에서 즉시 NOVA_GUARDIAN으로 진화 가능.
  • State Transition: 진화 시 기존의 무기 발사 로직은 폐기되고, 완전히 새로운 AttackPattern으로 교체됩니다.

2. Core Skill Categories

2.1 Active Weapons (Primary)

직접적인 공격을 담당하는 모듈로, FireRate, Damage, Piercing 속성을 가집니다.

  • Gatling Gun: 빠른 연사력의 기본 화기.
  • Missile Pod: 적을 추적하는 호밍 미사일.
  • Nova Burst (aoe_nova): 기체 주변에 강력한 충격파를 발생시켜 적을 밀쳐내고 데미지를 입힙니다. (Max Lv.3)

2.2 Passive Modules (Stats/Utility)

Active Weapon의 성능을 간접적으로 강화하거나 진화의 트리거 역할을 수행합니다.

  • Energy Shield: 기체 주변을 보호하는 플라즈마 배리어. (NOVA_GUARDIAN의 진화 재료)
  • Engine Overclock (speed_boost): 이동 속도를 증가시킵니다.

2.3 Evolved Skills (EVO)

  • HYPER_SONIC_VULCAN: Gatling Gun + Fire Rate. 관통 빔 공격.
  • DIMENSION_SLAYER: Missile Pod + Magnet. 차원 붕괴 소용돌이 미사일.
  • NOVA_GUARDIAN: Nova Burst + Energy Shield. 황금빛 충격파와 함께 발동 시 1.5초 무적 효과를 제공하는 공방 일체형 진화.

4. Implementation Details

  • src/features/game/systems/ProgressionSystem.ts: 전체 업그레이드 로직 및 EVO 스탯 적용 (applyEvoStats).
  • src/features/game/config/evolutions.ts: 무기 레지스트리 및 진화 레시피(EVOLUTION_RECIPES) 정의.
  • src/features/game/systems/ModularWeaponSystem.ts: 진화된 무기의 실제 인게임 발사 패턴 및 로직 구현.

Status: Managed by Skybound Protocol Context: Progression System / Weapon Engineering

🔗 Knowledge Connections