Files
joke-app/docs/games/_TEMPLATE.md

44 lines
1.3 KiB
Markdown

# <게임 한국어 이름> (`<game-id>`)
> 마일스톤: M? · 인원: 최소 N ~ 최대 M명 · 예상 시간: 약 N분 · 난이도: 쉬움/보통/어려움
## 1. 개요
- 한 줄 설명, 한국에서의 인지도/플레이 맥락
- 인원 근거(원작/전통 규칙의 최소·최대 인원)
## 2. 모드와 옵션
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
## 3. 구성물
## 4. 준비(셋업)
## 5. 진행 규칙
- 턴 구조, 가능한 행동, 각 행동의 합법 조건을 빠짐없이
## 6. 승패와 점수 계산
- 정확한 계산식과 예시, 동점 처리
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
## 8. 엔진 설계
### 8.1 상태(State)
```ts
// 서버만 보는 전체 상태
```
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
### 8.3 공개/비공개 정보 (view)
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
### 8.6 종료 조건과 결과(GameResult)
## 9. UI/UX
- 화면 배치(PC 기준 — 판 + 오른쪽 패널, 좁은 화면 접힘), 조작 방법, 합법 수 하이라이트, 애니메이션, 초보자 도움말
## 10. 테스트 체크리스트
- [ ] 구체적인 시나리오
## 11. 참고 자료
## 12. 메모 (상표·법적 주의 등)