docs(rpg): add command requirements to plan

This commit is contained in:
안명현 2026-04-10 11:44:06 +09:00
parent 6acf0774c3
commit 5614a2999d
1 changed files with 134 additions and 8 deletions

View File

@ -638,30 +638,84 @@ resource/data/rpg/
## 권장 구현 순서
### 1단계
### Phase 1. 데이터 기반 구축
목표:
- 플레이어 저장 구조와 JSON 기반 게임 데이터 구조를 먼저 고정
진행 내용:
- RPG 프로필, 스킬, 인벤토리용 DB 스키마 설계
- 레벨, 경험치, 능력치, 재화 구조 확정
- JSON 파일 구조 및 스타터 데이터 정의
- JSON 로더 및 검증기 구현
### 2단계
산출물:
- Prisma 스키마 초안
- `resource/data/rpg/` 하위 JSON 파일 초안
- 로더 및 유효성 검사 유틸
### Phase 2. 던전 진입 및 전투 세션 구현
목표:
- 음성 채널 입장만으로 전투가 시작되는 기본 루프 구성
진행 내용:
- 음성 채널 Prefix 파싱 구현
- 던전 진입 감지 구현
- 단일 적 기준 전투 세션 생성 및 자동 전투 루프 구현
- 전투 세션 생성 로직 구현
- 단일 적 기준 자동 전투 루프 구현
- 장착 스킬 4개 중 랜덤 1개 사용 규칙 반영
### 3단계
산출물:
- 전투 보상 지급
- 던전 진입 감지 서비스
- 전투 세션 메모리 관리 구조
- 1:1 PvE 자동 전투 동작
### Phase 3. 보상 및 전투 후 흐름 구현
목표:
- 전투 완료 후 보상 지급과 반복 플레이 흐름 연결
진행 내용:
- 골드, 경험치, 아이템 보상 지급
- 드랍 테이블 적용
- 전투 종료 후 다음 행동 선택 UI 구현
- 휴식 및 상점 로직 구현
- 휴식 로직 구현
- 상점 기본 로직 구현
### 4단계
산출물:
- 장비 옵션 확장
- 전투 결과 메시지
- 보상 지급 처리
- 다음 전투, 휴식, 상점 선택 흐름
### Phase 4. 성장 확장 및 콘텐츠 확장
목표:
- 기본 전투 시스템 위에 성장성과 콘텐츠 깊이 추가
진행 내용:
- 장비 옵션 및 장착 시스템 확장
- 상태이상, 패시브, 버프/디버프 확장
- 던전 종류 및 몬스터 풀 확장
- 파티 플레이 또는 협동 던전 확장 여부 검토
산출물:
- 확장형 전투 규칙
- 장비/스킬 성장 시스템 강화
- 중장기 콘텐츠 확장 기반
## 추가 확인이 필요한 사항
- RPG 프로필을 서버 공용으로 할지, 길드별로 분리할지
@ -684,3 +738,75 @@ resource/data/rpg/
- 골드, 경험치, 아이템 보상 우선 적용
초기 범위를 좁게 잡으면 시스템 구조를 빠르게 안정화할 수 있고, 이후 콘텐츠 확장도 훨씬 수월해집니다.
## 필요한 명령어 목록
### 플레이어 정보
- `/rpg profile`
- `/rpg stats`
설명:
- 플레이어의 레벨, 경험치, 능력치, 재화, 현재 상태를 확인하는 기본 명령어가 필요합니다.
- `profile`은 전체 요약, `stats`는 능력치 상세 확인용으로 분리하는 구성이 적절합니다.
### 스킬 관련
- `/rpg skill list`
- `/rpg skill info`
- `/rpg skill equip`
- `/rpg skill unequip`
- `/rpg skill preset`
설명:
- 스킬이 존재한다면 최소한 보유 스킬 조회와 장착/해제 명령은 반드시 필요합니다.
- 장착 슬롯이 4개로 고정되어 있으므로 `equip`, `unequip` 기준의 명령 흐름이 필요합니다.
- 추후 여러 세팅을 저장하려면 `preset` 명령도 고려할 수 있습니다.
### 인벤토리 및 아이템 관련
- `/rpg inventory`
- `/rpg item info`
- `/rpg item use`
- `/rpg equipment`
설명:
- 아이템 데이터가 존재한다면 인벤토리 조회 명령은 필수입니다.
- 소비 아이템 사용, 아이템 상세 확인, 현재 장비 상태 확인까지 연결되어야 실제 플레이가 가능합니다.
### 던전 관련
- `/rpg dungeon info`
- `/rpg dungeon leave`
- `/rpg battle log`
설명:
- 전투는 음성 채널 입장으로 자동 시작되더라도, 현재 던전 정보 확인과 전투 이탈용 명령은 필요합니다.
- 전투 결과를 놓친 사용자를 위해 최근 전투 로그 조회 명령도 유용합니다.
### 상점 관련
- `/rpg shop`
- `/rpg shop buy`
- `/rpg shop sell`
설명:
- 상점 기능이 있다면 목록 조회, 구매, 판매 명령은 기본 세트로 필요합니다.
- 초기 버전은 던전 종료 후 버튼 선택으로 상점에 진입하더라도, 슬래시 명령 기반 접근도 열어두는 것이 관리에 유리합니다.
### 운영 및 확장용 후보 명령어
- `/rpg help`
- `/rpg tutorial`
- `/rpg leaderboard`
- `/rpg reset`
설명:
- 초반 온보딩을 위해 도움말과 튜토리얼 명령이 있으면 좋습니다.
- 장기적으로는 랭킹, 테스트용 초기화, 운영자용 디버그 명령도 고려할 수 있습니다.