음양 시스템

v3.0 | 2026-04-01 | Korean Neon Folklore 리팩토링

수치 SSOT: game/data/yinyang.json — 문서 내 수치는 참고용이며 JSON이 항상 우선

1. 개요

음양 게이지는 플레이어의 전투 스타일에 따라 실시간 변동하는 리스크-리워드 시스템. 무기 선택과 전투 행동이 음양 상태를 결정하며, 극단적 상태는 강력한 버프와 함께 디버프를 동반하여 의미 있는 트레이드오프를 만든다.

1-1. 설계 목표

목표	설명
Meaningful Choice	무기 선택이 단순 DPS가 아닌 음양 방향성에도 영향
Dynamic Tension	안전한 조화 vs 위험한 극단 = 매 순간 긴장감
Build Identity	양 빌드(포졸), 음 빌드(무당), 조화 빌드(퇴마사) 차별화
공명 연동	조화의 공명 2x vs 극단의 전투 버프 = 핵심 트레이드오프

2. 게이지 구조

범위: -100(극음) ~ 0(조화) ~ +100(극양)

단일축 모델 (0~100 내부 표현, 50 = 조화)
매초 중앙(0)으로 1씩 자연 회귀 (비전투 시 중립 복귀)
상태 변경 시 히스테리시스 없음 (즉시 전이)

3. 증감 트리거

무기별 게이지 수치 SSOT: game/data/weapons.json의 yin_yang_gauge 필드. 양수 = 양, 음수 = 음.

트리거	변동	방향	비고
부적 발사	+2	양	기본 공격형
방울 발사	+3	음	방어/유틸
육모방망이 발사	+5	양	강양, 고위력
붓 발사	+1	음	약음, 보조형
횃불 발사	+3	양	화염 공격형
쇠뇌 발사	+2	양	원거리 공격형
풍각 발사	+2	음	유틸형
산삼 발사	+4	음	강음
도깨비불 발사	+1	양	약양
쌍칼 발사	+4	양	강양 근접
해금 발사	+3	음	CC형
돌팔매 발사	+1	양	약양
적 처치	+1	양	전투 보상
피격	+2	음	피격 페널티
자연 회귀	1/초	0 방향	상시

4. 5단계 상태 효과

상태	내부 범위	게이지 표시	버프	디버프	영혼 스킬 보정	공명 충전
조화	-10~+10	중앙 골드(`#ECAB11`) 글로우	전 스탯 +5%, XP +20%	없음	공명 충전 2.0x	2.0x
중립전이	±11~±29	기본	없음	없음	기본	1.0x
양	+30~+69	우측 오렌지(`#EF6E10`) 편향	ATK +10%	없음	DMG +15%	1.0x
음	-30~-69	좌측 시안(`#5EE9E9`) 편향	CD -15%	없음	CD -10%	1.0x
극양	+70~+100	우측 핫핑크(`#F94E6D`) 펄스	ATK +25%, DMG +30%	피격 DMG +15%, HP 회복 -50%	공명 충전 1.5x	1.5x
극음	-70~-100	좌측 인디고(`#1831A7`) 펄스	CD -30%, 범위 +20%	이속 -10%	공명 충전 1.5x	1.5x

4-1. 상태 전이 다이어그램

극음 ←── 음 ←── 중립전이 ←── 조화 ──→ 중립전이 ──→ 양 ──→ 극양
-100  -70  -69  -30  -29  -11  -10  +10  +11  +29  +30  +69  +70  +100

4-2. 버프 캡 규칙

스탯	단일 소스 최대	합산 캡	비고
쿨다운 감소	-30% (극음)	-50%	무당 -20% + 극음 -30% = -50%(캡)
공격력 증가	+25% (극양)	캡 없음	장비와 합산
피격 데미지 증가	+15% (극양)	캡 없음	리스크 의도

5. 공명 시스템 연동

음양 상태	공명 충전 속도	전략적 의미
조화	2.0x (최고)	공명 빈도 극대화, 전투 버프 없음
극양/극음	1.5x	전투 버프 + 적당한 공명
양/음/중립전이	1.0x (기본)	안정적이나 특색 없음

핵심 트레이드오프: 조화의 공명 2배속 vs 극단의 전투 버프. 빈번한 공명 버스트(10초 스킬 연사)를 원하면 조화, 꾸준한 딜 증폭을 원하면 극양.

6. 캐릭터별 음양 성향

캐릭터	시작 무기	자연 성향	빌드 방향	설계 의도
퇴마사	부적(양+2)	중립	조화 유지 ↔ 상황별 극단	입문 캐릭, 유연한 빌드
무당	방울(음+3)	음 경향	극음 특화, 쿨다운 빌드	조화 유지하려면 양 무기 혼합 필요 → 공속 장점 희석 = 트레이드오프
포졸	육모(양+5)	양 경향	극양 특화, 파워 빌드	HP 140으로 피격 디버프 상쇄
선비	붓(음+1)	약음	조화 쉬움, 범위 빌드	양 무기 1개만 추가하면 조화 유지

7. UI 표현

7-1. 게이지 레이아웃

    음(Cyan) ◄──────●──────► 양(Orange)
    [#5EE9E9████░░░│░░░████#EF6E10]
                    ↑
             중앙 마커 (조화 시 골드 글로우)

속성	값
크기	60x12px (480x270 해상도)
위치	하단 중앙 (210, 254)
좌측 색상	시안 `#5EE9E9` (음)
우측 색상	오렌지 `#EF6E10` (양)
조화 발광	골드 `#ECAB11`, 중앙 마커 네온 글로우
극양 발광	핫핑크 `#F94E6D`, 테두리 네온 펄스 + 화면 가장자리 웜 비네팅
극음 발광	인디고 `#1831A7`, 테두리 네온 펄스 + 화면 가장자리 쿨 비네팅

7-2. 상태 전환 피드백

전환	시각	사운드
→ 조화 진입	게이지 골드(`#ECAB11`) 글로우 + 화면 미세 골드 플래시	맑은 종 "띵"
→ 극양 진입	게이지 핫핑크(`#F94E6D`) 펄스 + 화면 테두리 오렌지 비네팅	북 "둥"
→ 극음 진입	게이지 인디고(`#1831A7`) 펄스 + 화면 테두리 시안 비네팅	풍경 소리
극단 → 이탈	네온 페이드아웃 (0.5초)	—

8. OP 감시 항목

밸런스 시뮬레이션 결과 기반. 상세: .claude/agent-memory/planner/balance_yinyang_v1.md

조합	위험도	이유	대응책
무당 + 조화 유지 + 공명 +20%	🔴 높음	공명 빈도 과다 가능	방울 시작으로 조화 유지 어렵게 설계
포졸 + 극양 + 장군갑 4세트	🟡 중간	ATK+25% + 5초 무적 동시	무적 중 DMG 감소 적용 검토
극음 + 쿨다운 장비 스택	🟡 중간	쿨다운 무한 감소	CD 캡 -50% 적용
조화 유지 + 문관복 4세트	🟡 중간	XP +20% + 선택지 4개 = 빠른 풀빌드	조화 유지 난이도로 자연 밸런스

9. 구현 참조

파일	역할
`game/src/systems/yin_yang_system.gd`	음양 게이지 로직
`game/data/yinyang.json`	상태별 수치 데이터
`game/data/weapons.json` (`yin_yang_gauge`)	무기별 음양 게이지 변동량
`game/src/autoloads/event_bus.gd`	`yin_yang_changed`, `yin_yang_state_changed` 시그널
`game/src/ui/hud.gd`	게이지 UI 렌더링

밸런스 변경이력: ops/changelog.json. 시뮬레이션: /balance-sim 스킬.

변경 이력

날짜	버전	변경 내용
2026-04-01	v3.0	Korean Neon Folklore 리팩토링
2026-04-02	v3.1	극양 디버프에 HP 회복 -50% 추가 (yinyang.json SSOT 동기화)

1. 개요​

1-1. 설계 목표​

2. 게이지 구조​

3. 증감 트리거​

4. 5단계 상태 효과​

4-1. 상태 전이 다이어그램​

4-2. 버프 캡 규칙​

5. 공명 시스템 연동​

6. 캐릭터별 음양 성향​

7. UI 표현​

7-1. 게이지 레이아웃​

7-2. 상태 전환 피드백​

8. OP 감시 항목​

9. 구현 참조​

변경 이력​