NPC / 거점 시스템
v1.0 | 2026-03-31 | Phase 2 설계
상위 설계:
docs/game/core/phase2-design.md§8 (아카이브) 사당 데이터 SSOT:game/data/shrine.json(Phase 2 구현 예정)
1. 개요
거점 "무당집"은 판 사이의 메타 진행 허브이다. 4명의 NPC와 상호작용하여 장비 관리, 영구 업그레이드, 도감 열람, 힌트 수집 등 인게임 밖의 성장 활동을 수행한다.
1-1. 설계 원칙
| 원칙 | 설명 |
|---|---|
| 빠른 순환 | 거점 체류 시간 최소화 — NPC 접근 1~2클릭으로 기능 접근 |
| 선택적 방문 | 빠른 시작으로 거점 스킵 가능 |
| NPC 캐릭터성 | 각 NPC에 고유 대사와 배경 → 세계관 몰입 |
| 점진적 해금 | 구미호 NPC: 도감 100% 해금 → 장기 목표 |
| 경제 싱크 | 엽전/혼백의 주요 소비처 = 거점 NPC |
2. 거점 구조
2-1. 무당집 레이아웃
┌─────────────────────────────────────────┐
│ 무당집 (거점) │
│ │
│ NPC 영역 (상단) │
│ [할멈] [대장장이] [저승사자] [사당] │
│ │
│ [구미호] (히든, 도감 100%) │
│ │
│ ── 메뉴 영역 (하단) ── │
│ [빠른시작] [커스텀] [영혼관리] [인벤토리] │
│ │
│ 상태바: 엽전 / 혼백 / 현재 영혼 │
└─────────────────────────────────────────┘
2-2. NPC 배치
- NPC는 상단 가로 배치 (16×24px 스프라이트, Idle 4f 애니메이션)
- 각 NPC 위에 이름 라벨 표시
- 클릭/호버 시 대화 프레임 표시 + 기능 UI 진입
- 구미호는 도감 100% 달성 전까지 비어있음 (또는 ??? 실루엣)
3. NPC 상세
3-1. 할멈 — 힌트 + 문화 대사
| 항목 | 값 |
|---|---|
| 역할 | 튜토리얼 힌트, 스테이지 정보, 한국 문화 설명 |
| 대사 트리거 | 거점 첫 방문 시 자동 (10~15초, 스킵 가능) |
| 대사 풀 | 스테이지별 20개 + 이벤트 10개 + 범용 30개 ≈ 100개 |
| 힌트 시스템 | 직전 판 행동 분석 → 관련 힌트 자동 표시 |
행동 분석 → 힌트 매칭:
| 플레이어 행동 | 트리거 조건 | 힌트 |
|---|---|---|
| 극양만 유지 | 양 70%+ 시간 > 60% | "양만 밀면 몸이 상한다. 음양의 조화를 생각해 보거라." |
| 보스에서 사망 | 보스전 사망 | "귀왕은 소환수가 문제야. 먼저 잡귀를 치워야 해." |
| 포획 0건 | 10판+ & 포획 0 | "봉인 부 적을 챙기면 요괴를 잡을 수 있단다." |
| 공명 미발동 | 5판+ & 공명 0 | "영혼과 호흡을 맞춰야 공명이 일어나. 적을 많이 쓰러뜨려봐." |
| 음 무기 미사용 | 양 무기만 사용 | "음의 기운도 쓸모가 있다. 방울이나 해금을 한번 써보렴." |
문화 대사 예시:
- "옛날 한양 거리엔 포졸들이 밤마다 순찰을 돌았다. 그래도 귀신은 나타나더라."
- "구미호는 천 년을 살면 사람이 된다고 하지. 글쎄, 정말일까."
3-2. 대장장이 — 제작 / 강화 / 재련
| 기능 | 설명 | 비용 |
|---|---|---|
| 장비 제작 | 엽전 + 분해 재료 → 랜덤 장비 생성 | 등급별 상이 |
| 장비 강화 | 같은 장비 2개 합성 → 상위 등급 | 아래 표 참조 |
| 재련 | 부옵션 1개 리롤 | 50 엽전/회 |
| 세트 확인 | 보유 세트 장비 목록 + 부족 부위 하이라이트 | 무료 |
강화 비용표:
| 합성 | 재료 | 엽전 비용 | 결과 |
|---|---|---|---|
| 일반→마법 | 일반 장비 ×2 | 50 | 마법 등급 장비 |
| 마법→희귀 | 마법 장비 ×2 | 200 | 희귀 등급 장비 |
| 희귀→전설 | 희귀 장비 ×2 + 혼백 5 | 500 | 전설 등급 장비 |
대장장이 UI 탭 구성:
- 제작 탭: 재료 목록 + 제작 버튼
- 강화 탭: 좌측 장비 + 우측 장비 = 결과 미리보기
- 재련 탭: 장비 선택 → 부옵션 하이라이트 → 리롤 대상 선택
- 세트 탭: 세트 목록 (3세트/5세트 효과) + 보유/미보유 표시
3-3. 저승사자 — 도감 / 로어
| 기능 | 설명 |
|---|---|
| 요괴 도감 | 포획한 요괴 목록 + 스프라이트 + 소환수 효과 확인 |
| 달성률 보상 | 30%/50%/80%/100% 달성 보상 표시 + 수령 |
| 로어 감상 | 각 요괴의 배경 이야기 (한국 괴담 기반) |
도감 UI: 23칸 그리드, 포획 완료 항목은 스프라이트+이름, 미포획은 "??" 실루엣
3-4. 사당 — 영구 업그레이드
엽전을 소모하여 영구적 스탯 강화. 모든 캐릭터에 적용.
| # | 업그레이드 | 최대 | 단계당 효과 | 비용 (단계당) |
|---|---|---|---|---|
| 1 | 체력 | 10 | +5 HP | 20 × 현재Lv |
| 2 | 공격력 | 10 | +3% | 25 × 현재Lv |
| 3 | 이동속도 | 10 | +2% | 20 × 현재Lv |
| 4 | 쿨다운 | 10 | -2% | 30 × 현재Lv |
| 5 | 경험치 | 10 | +5% | 15 × 현재Lv |
| 6 | 엽전 획득 | 10 | +5% | 20 × 현재Lv |
| 7 | 부활 | 3 | +1회 | 100 × 현재Lv |
| 8 | 시작 무기 추가 | 1 | +1 슬롯 | 500 |
| 9 | 포획 용량 | 5 | +1 소환수 슬롯 | 50 × 현재Lv |
| 10 | 음양 안정 | 5 | 자연 회귀 -0.1/초 | 40 × 현재Lv |
| 11 | 포획 강화 | 5 | 포획 확률 +5% | 60 × 현재Lv |
총 비용: 전체 MAX 시 약 10,500 엽전 (1판 평균 200 기준 ~53판)
사당 UI: 세로 리스트. 각 항목에 프로그레스 바 + 현재 효과 + 다음 단계 비용 표시. MAX 도달 시 회색 처리.
3-5. 구미호 (히든 NPC)
| 항목 | 값 |
|---|---|
| 해금 조건 | 도감 100% 달성 (23종 전부 포획) |
| 기능 1 | 히든 스테이지 "저승" 입장권 판매 (혼백 50) |
| 기능 2 | 퀘스트 "구미호의 부탁" → 특수 조건 클리어 시 히든 캐릭터 해금 |
| 대사 | "사람이 되고 싶었는데… 덕분에 조금은 가까워진 것 같아." |
4. 거점 진입 플로우
4-1. 판 종료 → 거점
- 클리어/사망 → 정산 화면
- 정산 화면에서 "거점으로" 선택
- 페이드 아웃(흑, 0.8초) → 거점 로드 → 페이드 인
- 할멈 자동 대사 (첫 방문 시, 스킵 가능)
- NPC/메뉴 자유 이용
- "빠른 시작" 또는 "커스텀 시작" → 인게임 진입
4-2. 타이틀 → 거점
- "계속하기" 선택 시 마지막 세이브 로드 → 거점 직접 진입
5. 판 종료 정산 (Phase 2 확장)
5-1. 정산 항목
| 항목 | 설명 |
|---|---|
| 생존 시간 | MM:SS |
| 처치 수 | 카운트 업 애니메이션 |
| 최고 레벨 | 도달 레벨 |
| 획득 XP | 영혼 XP |
| 음양 최대치 | 양/음 최대 % |
| 공명 발동 | 횟수 |
| 획득 엽전 | 기본 + 저주 배율 보너스 |
| 획득 혼백 | 기본 + 저주 배율 |
| 포획 결과 | 신규 포획 몬스터 표시 |
5-2. 장비 일괄 처리
판 종료 시 획득 장비를 한꺼번에 정리:
- "전부 수령" / "일괄 분해" / "개별 확인" 선택
- 분해 시 재료 획득 (대장장이 제작용)
6. 엽전 경제
6-1. 엽전 수입원
| 출처 | 판당 평균 |
|---|---|
| 적 처치 드롭 | ~120 |
| 보스 처치 보너스 | ~30 |
| 클리어 보너스 | +50 |
| 사당 엽전 획득 업그레이드 | +5%/단계 |
| 합계 (사당 MAX 전) | ~200 |
6-2. 엽전 지출처
| 용도 | 비용 범위 |
|---|---|
| 사당 업그레이드 | 20~500/회 |
| 장비 강화 | 50~500/회 |
| 장비 재련 | 50/회 |
| 장비 제작 | 100~300/회 |
7. 관련 문서
| 문서 | 비고 |
|---|---|
| Phase 2 설계서 §8 | NPC/거점 원본 설계 |
| 포획 시스템 | 도감, 소환수 상세 |
| 진행 시스템 | 엽전/혼백 경제 |
| UI/UX 설계 §3-7~3-9 | 거점/대장장이/사당 UI |
변경 이력
| 날짜 | 버전 | 변경 내용 |
|---|---|---|
| 2026-04-02 | v1.1 | 도감 그리드 12칸→23칸 (capture_codex.json total_entries 기준 SSOT 동기화) |
| 2026-04-02 | v2.1 | SSOT 동기화: 사당 총 비용 12,500→10,500 엽전, 구미호 해금 조건 12종→23종 |