본문으로 건너뛰기

Phase 3: Meta Systems — 상세 설계서

v1.0 | 2026-03-31 | Planner

마일스톤: MS-003 | 목표일: 2026-06-15 그래픽 정책: placeholder(텍스트 라벨 + _draw() 기본도형). 실제 픽셀아트 에셋은 Phase 4에서 교체. 선행 조건: Phase 2 전 시스템 구현 완료

목차​

  1. 사당 영구 업그레이드 (11종)
  2. 요괴 도감 + 도감 보상
  3. 혼백 상점 (히든 콘텐츠)
  4. 언락 캐릭터 4종 해금 조건
  5. 저승길/경복궁 스테이지
  6. FTUE 점진적 해금 시퀀스
  7. 업적 시스템
  8. 구현 작업 분해

1. 사당 영구 업그레이드​

데이터 SSOT: game/data/shrine.json (Phase 2에서 스키마 정의, Phase 3에서 UI+로직 완성)

1-1. 업그레이드 11종​

Phase 2 설계(progression.md)에서 정의한 11종을 거점 사당 NPC에서 완전 구현.

#업그레이드최대단계당 효과비용 공식총 비용
1체력10+5 HP20 × Lv1,100
2공격력10+3%25 × Lv1,375
3이동속도10+2%20 × Lv1,100
4쿨다운10-2%30 × Lv1,650
5경험치10+5%15 × Lv825
6엽전 획득10+5%20 × Lv1,100
7부활3+1회100 × Lv600
8시작 무기 추가1+1 슬롯500 고정500
9포획 용량5+1 소환수 슬롯50 × Lv750
10음양 안정5자연 회귀 -0.1/초40 × Lv600
11포획 강화5포획 확률 +5%60 × Lv900

총 엽전: ~10,500 | 판수 환산: ~53판 (판당 200 엽전 기준)

1-2. 사당 UI 설계​

┌─────────────────────────────────────────────────────────┐
│                  ═══ 사당 ═══                              │
│                                                          │
│  보유 엽전: 1,250                                         │
│                                                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │ 체력          ████████░░  8/10  +5HP  [160 엽전] │    │
│  │ 공격력        ██████░░░░  6/10  +3%  [175 엽전] │    │
│  │ 이동속도      ████░░░░░░  4/10  +2%  [100 엽전] │    │
│  │ 쿨다운        ██░░░░░░░░  2/10  -2%  [90 엽전]  │    │
│  │ 경험치        ██████████ 10/10  MAX              │    │
│  │ 엽전 획득     █░░░░░░░░░  1/10  +5%  [40 엽전]  │    │
│  │ 부활          ░░░        0/3   +1회  [100 엽전]  │    │
│  │ 시작 무기     ░          0/1   +1    [500 엽전]  │    │
│  │ 포획 용량     ███░░      3/5   +1    [200 엽전]  │    │
│  │ 음양 안정     ██░░░      2/5  -0.1/s [120 엽전]  │    │
│  │ 포획 강화     █░░░░      1/5   +5%   [120 엽전]  │    │
│  └─────────────────────────────────────────────────┘    │
│                                                          │
│  총 효과 요약:                                            │
│  HP +40 | ATK +18% | SPD +8% | CD -4% | XP +50%         │
│                                                          │
│                        [뒤로]                             │
└─────────────────────────────────────────────────────────┘

인터랙션:

  1. 항목 클릭 → 업그레이드 확인 팝업 ("체력 Lv.8→9 (160 엽전)?")
  2. 확인 → 엽전 차감 + 레벨 증가 + 효과 즉시 적용
  3. MAX 도달 → 회색 처리 + "MAX" 표시
  4. 엽전 부족 → 빨간 테두리 + "엽전 부족" 텍스트

1-3. 데이터 연동​

  • shrine.json에 각 업그레이드별 current_level 저장
  • 인게임 시작 시 ShrineManager.get_bonus("health") → 현재 레벨 × 단계당 효과 반환
  • 모든 업그레이드는 모든 캐릭터에 공통 적용

2. 요괴 도감 + 도감 보상​

포획 데이터 SSOT: game/data/capture_codex.json

2-1. 도감 구성​

12종 요괴 (일반 9 + 보스 3). Phase 2에서 포획 시스템이 구현되면, Phase 3에서 도감 열람 UI + 달성 보상 완전 구현.

2-2. 도감 UI 설계​

┌────────────────────────────────────────────────────────────────┐
│                    ═══ 요괴 도감 ═══                              │
│                                                                │
│  달성률: 7/12 (58%)  ████████████░░░░░░░░░                       │
│                                                                │
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│  │ 잡귀   │ │도깨비불│ │달걀귀신│ │처녀귀신│ │  해골  │ │ 강시   │
│  │  ✅    │ │  ✅    │ │  ✅    │ │  ✅    │ │  ??   │ │  ✅    │
│  │ [F]    │ │ [F]    │ │ [E]    │ │ [D]    │ │ [D]   │ │ [C]    │
│  └────────┘ └────────┘ └────────┘ └────────┘ └────────┘ └────────┘
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│  │저승사자│ │ 구미호 │ │ 대귀   │ │ 귀왕   │ │천년여우│ │저승문지│
│  │  ✅    │ │  ??   │ │  ✅    │ │  ??   │ │  ??   │ │  ??   │
│  │ [B]    │ │ [A]   │ │ [A]    │ │ [S]   │ │ [S]   │ │ [S]   │
│  └────────┘ └────────┘ └────────┘ └────────┘ └────────┘ └────────┘
│                                                                │
│  ── 선택: 대귀 ──                                               │
│  등급: A | 소환수: 화면 DMG 50 (2초)                              │
│  "한양의 가장 깊은 곳에서 태어난 거대한 귀신.                       │
│   그 울음소리는 산을 뒤흔든다."                                    │
│                                                                │
│  ── 달성 보상 ──                                                │
│  [✅ 수령됨] 30%: 포획 확률 +5%                                  │
│  [✅ 수령됨] 50%: 소환수 지속 +3초                                │
│  [  달성 필요] 80%: 소환수 효과 1.5배                             │
│  [  달성 필요] 100%: 구미호 NPC 해금                              │
│                                                                │
│                        [뒤로]                                   │
└────────────────────────────────────────────────────────────────┘

인터랙션:

  1. 요괴 카드 클릭 → 하단에 로어 + 소환수 효과 표시
  2. 미포획 → "??" 실루엣, 클릭 시 "아직 봉인하지 못한 요괴입니다" 표시
  3. 달성 보상 → 달성 시 "수령" 버튼 활성화 → 클릭 시 보상 적용 + 골드 이펙트

2-3. 도감 달성 보상 (반복)​

달성률기준보상구현
30%4/12종포획 확률 +5% (전체)CaptureSystem.codex_bonus 가산
50%6/12종소환수 지속시간 +3초SummonSystem.duration_bonus
80%10/12종소환수 효과 강화 (수치 1.5배)SummonSystem.power_multiplier
100%12/12종구미호 NPC 해금 + 히든 퀘스트NpcManager.unlock_gumiho()

3. 혼백 상점​

3-1. 개요​

구미호 NPC 해금(도감 100%) 후 접근 가능한 히든 콘텐츠 상점. 혼백(저주 보상 화폐)을 소모하여 특수 아이템/콘텐츠 구매.

3-2. 상점 아이템​

#아이템비용효과재구매
1저승 입장권50 혼백히든 스테이지 "저승" 1회 입장무한
2천상의 부적함30 혼백랜덤 전설 장비 1개 생성무한
3영혼의 서20 혼백선택 영혼 XP +500무한
4구미호의 여의주100 혼백구미호 캐릭터 해금1회
5도깨비 모자15 혼백(코스메틱) 캐릭터 머리 장식1회
6저승사자의 낫80 혼백히든 장비 — 특수 슬롯, ATK+30%, 처치 시 HP 회복 11회

3-3. 상점 UI 설계​

┌────────────────────────────────────────────────────────────────┐
│                    ═══ 구미호의 가게 ═══                          │
│                                                                │
│  "사람이 되려면... 돈이 필요한 법이지."        보유 혼백: 125     │
│                                                                │
│  ┌─────────────────────┐  ┌─────────────────────┐              │
│  │ 저승 입장권          │  │ 천상의 부적함         │              │
│  │ 50 혼백              │  │ 30 혼백              │              │
│  │ 히든 스테이지 1회    │  │ 랜덤 전설 장비 1개   │              │
│  │       [구매]         │  │       [구매]         │              │
│  └─────────────────────┘  └─────────────────────┘              │
│  ┌─────────────────────┐  ┌─────────────────────┐              │
│  │ 영혼의 서            │  │ 구미호의 여의주       │              │
│  │ 20 혼백              │  │ 100 혼백             │              │
│  │ 영혼 XP +500         │  │ 구미호 캐릭터 해금   │              │
│  │       [구매]         │  │       [구매]         │              │
│  └─────────────────────┘  └─────────────────────┘              │
│  ┌─────────────────────┐  ┌─────────────────────┐              │
│  │ 도깨비 모자          │  │ 저승사자의 낫         │              │
│  │ 15 혼백              │  │ 80 혼백              │              │
│  │ 코스메틱             │  │ 히든 장비            │              │
│  │       [구매]         │  │       [구매]         │              │
│  └─────────────────────┘  └─────────────────────┘              │
│                                                                │
│                        [뒤로]                                   │
└────────────────────────────────────────────────────────────────┘

4. 언락 캐릭터 4종 해금 조건​

기본 캐릭터 4종(퇴마사/무당/포졸/선비)에 추가로 4종을 해금 가능하게 한다.

4-1. 해금 캐릭터 스펙​

캐릭터해금 조건HP이속시작 무기고유 패시브설계 의도
도깨비도깨비불 적 100마리 처치90110도깨비불장난: 적 드롭 아이템 2배, 대신 적도 2배 빠름하이리스크 파밍 특화
강시강시 적 30회 포획16060쌍칼불사: HP 0 도달 시 5초간 불사 + ATK 2배 (1판 1회)극한 탱커/보스 킬러
구미호혼백 상점 100 혼백 지불80130해금변신: 공명 시 적으로 위장 5초(무적) + 주변 적 매혹생존/CC 특화
암행어사전 저주 해금 + 3개 동시 클리어100100쇠뇌어명: 저주 배율 2배 + 저주 효과 50% 감소저주 특화 히든 캐릭터

4-2. 음양 성향​

캐릭터음양 성향근거
도깨비양 경향도깨비불 양+1/접촉
강시양 경향쌍칼 양+2/타격
구미호음 경향해금 음+5/발 → 극음 특화
암행어사중립쇠뇌 양+4이지만 어명 패시브로 균형

4-3. 해금 진행 추적​

  • game/data/unlocks.json에 각 캐릭터 해금 조건 진행 상태 저장
  • 캐릭터 선택 화면에서 미해금 캐릭터는 실루엣 + 해금 조건 표시
  • 해금 달성 시 거점에서 팝업 알림 + 캐릭터 선택 화면에 추가

4-4. 밸런스 참고​

캐릭터예상 파워 레벨위험도주요 시너지
도깨비중상 (파밍 효율 최고)높음임꺽정(엽전 폭발) + 도깨비불 궤도
강시중 (보스전 특화)보통극양 + 쌍칼 + 포졸 세트
구미호중상 (생존 최고)낮음황진이(매혹) + 극음 빌드
암행어사상 (저주 빌드 최강)중원혼 저주 + 광역 빌드

5. 저승길 / 경복궁 스테이지​

5-1. 저승길 (Stage 4)​

항목값
이름저승길
시간25분
지형물
유리 영혼이순신 (범위 2배)
불리 영혼임꺽정 (DMG -30%)
iLv4
해금폐사찰 클리어

지형 특성:

  • 바닥 물 텍스처 (절차적 물결 쉐이더)
  • 갈림길 구조: 좌/우 분기 → 합류 → 보스
  • 장애물: 징검다리, 삼도천, 죽은 나무, 돌부처
  • 특수: 삼도천 영역에서 이속 -20% 디버프 (징검다리 위에서만 해제)

웨이브 특성:

  • 물 속성 적 위주: 수귀(물귀신, 신규), 물도깨비(도깨비불 변형)
  • 13분 보스: 삼도천 주인 (체력 높은 장기전 보스)
  • 20분 보스: 염라대왕 (Phase 5 최종 보스, 판정 패턴)
  • 24분 보스: 저승의 문 (문 열리기 전에 처치 필요 — 시간제한 DPS 체크)

신규 적:

적타입HPDMG특수
수귀일반206물 위 이속 증가, 수면 아래서 기습
물도깨비일반3510물결 넉백 공격
삼도천 주인보스500015물살 패턴 + 소용돌이 흡인
염라대왕보스800020재판 (랜덤 3개 중 1개 선택, 틀리면 즉사 장판)
저승의 문보스120000문 열림 카운트다운 — 시간 내 파괴

5-2. 경복궁 (Stage 5)​

항목값
이름경복궁
시간30분
지형평야 (궁궐)
유리 영혼(Post-Launch: 척준경, 강감찬)
불리 영혼전우치 (분신 -1)
iLv5
해금저승길 클리어 + 도감 50%

지형 특성:

  • 경복궁 중심부 구조: 근정전 마당이 메인 전투 영역
  • 벽/기둥으로 구분된 방 구조 (절차적이 아닌 고정 맵)
  • 장애물: 근정전 기둥, 담장, 석조, 월대 계단
  • 특수: 기둥 뒤에 숨으면 원거리 공격 차단 (전략적 위치잡기)

웨이브 특성:

  • 궁궐 요괴 위주: 궁녀귀신(신규), 내시귀신(신규), 갑옷 해골(해골 강화)
  • 10분 보스: 왕의 그림자 (분신 패턴)
  • 20분 보스: 폐왕 (광역 저주 부여 패턴)
  • 28분 보스: 용 (최종 — 화면 전체 활용, 다단 Phase)

신규 적:

적타입HPDMG특수
궁녀귀신일반258비명 — 주변 아군 강화 오라
내시귀신일반4012독침 투척 (DoT 3초)
갑옷 해골엘리트8015방패 보유 (전방 피격 -50%)
왕의 그림자보스600018분신 3체 + 본체 판별 필요
폐왕보스1000022저주 장판 (밟으면 랜덤 디버프)
용보스20000304Phase: 비행→착지→화염→폭주

5-3. 히든 스테이지: 저승​

항목값
이름저승
시간무한 (층 단위)
지형전부
유리 영혼없음 (히든)
iLv6+ (층당 +0.5)
해금구미호 상점 "저승 입장권" (50 혼백)

구조:

  • 5분 단위 "층" 진행, 층마다 iLv 증가
  • 적 구성은 이전 스테이지 몬스터 랜덤 믹스
  • 5층마다 랜덤 보스 (기존 보스 강화 버전)
  • 사망 시 즉시 종료 — 도달 층 수 기록

6. FTUE 점진적 해금 시퀀스​

참조: docs/game/core/vision.md §6

6-1. 해금 타임라인​

판 수해금 요소설계 근거
1판이동 + 자동 공격 + 레벨업VS 코어만 체험
1판 클리어음양 게이지 표시전투 익숙 후 리스크 레이어
3판영혼 동행 (이순신 고정)동행 시스템 학습, 선택 없음
5판영혼 선택 (4종) + 거점 NPC 활성화빌드 다양성 시작
7판장비 드롭 + 인벤토리파밍 루프 추가
10판혈월/귀안 저주 해금 + 본캐 장비 풀 5슬롯리스크-리워드
15판봉인/역행 저주 + 영혼 장비(레벨 기반)장비 확장
20판무상 저주 + 포획 도감수집 루프 완성
25판사당 영구 업그레이드 완전 개방메타 진행
30판+히든 콘텐츠 (혼백 상점, 저승)엔드 콘텐츠

6-2. 구현 방식​

  • game/data/ftue.json에 해금 조건과 대상 시스템 매핑
  • 첫 해금 시 할멈 NPC 튜토리얼 대사 자동 표시
  • 해금 전 시스템은 UI에서 비활성(회색) 또는 숨김 처리
  • FTUEManager Autoload가 판 수/조건 추적 + 해금 이벤트 발행

6-3. 튜토리얼 오버레이​

시점오버레이 내용자동 해제
1판 시작"방향키로 이동! 공격은 자동!"첫 적 처치
첫 레벨업"카드를 선택하여 무기를 강화하세요"카드 선택
음양 해금"음양 게이지가 나타났습니다 — 극단은 위험!"5초
영혼 해금"이순신이 함께합니다! 영혼이 자동으로 싸웁니다"영혼 첫 스킬
장비 해금"장비를 획득하면 자동으로 수집됩니다. I키로 확인!"첫 장비 획득
저주 해금"저주를 걸면 더 어렵지만, 혼백을 더 많이 얻습니다"5초

7. 업적 시스템​

7-1. 개요​

플레이 기록 기반 업적. 각 업적 달성 시 엽전/혼백/코스메틱 보상.

7-2. 업적 목록 (총 40종)​

전투 업적 (10종)​

#업적조건보상
1첫 걸음첫 판 클리어50 엽전
2백귀살누적 1,000 처치100 엽전
3만귀살누적 10,000 처치500 엽전
4무적피격 0회로 클리어200 엽전 + 10 혼백
5사경HP 1 상태에서 클리어100 엽전
6속전속결10분 이내 클리어300 엽전
7극양 마스터극양 상태로 5분 유지100 엽전
8극음 마스터극음 상태로 5분 유지100 엽전
9조화의 달인조화 상태로 전 판 유지200 엽전
10공명 폭풍1판에서 공명 5회 발동200 엽전

수집 업적 (10종)​

#업적조건보상
11수집가요괴 도감 30%100 엽전
12학자요괴 도감 50%200 엽전
13대학자요괴 도감 80%500 엽전
14완벽주의자요괴 도감 100%1000 엽전 + 50 혼백
15부자엽전 5,000 보유100 엽전
16갑부엽전 10,000 보유500 엽전
17전설 사냥꾼전설 장비 10개 획득300 엽전
18세트 완성아무 세트 풀세트 달성200 엽전
19무기 마스터진화 무기 4종 달성300 엽전
20영혼 각성아무 영혼 Lv.20 달성500 엽전 + 20 혼백

도전 업적 (10종)​

#업적조건보상
21저주 입문저주 1개로 클리어50 엽전
22저주 달인저주 2개로 클리어200 엽전
23저주 제왕저주 3개로 클리어500 엽전 + 30 혼백
24귀왕 처치귀왕 보스 10회 처치100 엽전
25구미호 사냥천년 구미호 10회 처치200 엽전
26문지기 정복저승문지기 10회 처치300 엽전
27모든 캐릭터4종 기본 캐릭터로 각 1회 클리어200 엽전
28히든 전사히든 캐릭터로 클리어300 엽전
29저승 탐험저승 5층 도달500 엽전
30저승 정복저승 10층 도달1000 엽전 + 50 혼백

스테이지 업적 (10종)​

#업적조건보상
31한양 정복한양 거리 10회 클리어100 엽전
32대나무 탐험대나무 숲 첫 클리어100 엽전
33대나무 정복대나무 숲 10회 클리어200 엽전
34사찰 탐험폐사찰 첫 클리어100 엽전
35사찰 정복폐사찰 10회 클리어300 엽전
36저승 탐험저승길 첫 클리어200 엽전
37저승 정복저승길 10회 클리어400 엽전
38궁궐 탐험경복궁 첫 클리어300 엽전
39궁궐 정복경복궁 10회 클리어500 엽전
40조선 통일전 스테이지 1회 이상 클리어1000 엽전 + 100 혼백

7-3. 업적 데이터​

  • game/data/achievements.json — 업적 정의 (id, 조건, 보상)
  • AchievementManager Autoload — 달성 추적 + 알림 발행
  • 세이브 파일에 달성 상태 저장

7-4. 업적 UI​

  • 거점에서 별도 탭 또는 일시정지 메뉴에서 접근
  • 카테고리별 탭 (전투/수집/도전/스테이지)
  • 달성 시 HUD 상단에 토스트 알림 (황색 배경, 2초)

8. 구현 작업 분해​

#태스크담당종속
P3-01shrine.json 데이터 + ShrineManager AutoloadCoderPhase 2 완료
P3-02사당 UI (거점 내)CoderP3-01
P3-03요괴 도감 UI + 달성 보상 로직CoderPhase 2 포획 시스템
P3-04혼백 상점 UI + 구매 로직CoderP3-03 (구미호 NPC)
P3-05언락 캐릭터 4종 데이터 + 해금 시스템Planner+CoderP3-01
P3-06언락 캐릭터 스프라이트 placeholderCoderP3-05
P3-07저승길 스테이지 웨이브+맵+적CoderPhase 2 스테이지
P3-08경복궁 스테이지 웨이브+맵+적CoderP3-07
P3-09FTUE 시스템 (ftue.json + FTUEManager)CoderP3-01
P3-10업적 시스템 (achievements.json + AchievementManager)CoderP3-01
P3-11저승 히든 스테이지 (무한 모드)CoderP3-07, P3-04
P3-12밸런스 테스트 (사당+업적+해금 경제)PlannerP3-01~P3-10

9. 관련 문서​

문서비고
진행 시스템사당/엽전 경제 기존 설계
포획 시스템도감 기반 데이터
저주 시스템혼백 경제
NPC/거점 시스템거점 UI/NPC
캐릭터기본 4종 스펙
스테이지기존 스테이지
Phase 4 설계폴리시 & 릴리즈

밸런스 수치 SSOT: game/data/*.json