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

1.3 KiB

<게임 한국어 이름> (<game-id>)

마일스톤: M? · 인원: 최소 N ~ 최대 M명 · 예상 시간: 약 N분 · 난이도: 쉬움/보통/어려움

1. 개요

  • 한 줄 설명, 한국에서의 인지도/플레이 맥락
  • 인원 근거(원작/전통 규칙의 최소·최대 인원)

2. 모드와 옵션

옵션 키 설명 선택지 기본값

3. 구성물

4. 준비(셋업)

5. 진행 규칙

  • 턴 구조, 가능한 행동, 각 행동의 합법 조건을 빠짐없이

6. 승패와 점수 계산

  • 정확한 계산식과 예시, 동점 처리

7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)

8. 엔진 설계

8.1 상태(State)

// 서버만 보는 전체 상태

8.2 액션

type payload 누가 / 언제 검증 조건

8.3 공개/비공개 정보 (view)

8.4 랜덤 요소 (시드 RNG 사용 지점)

8.5 타이머·시간 초과·연결 끊김 시 자동 행동

8.6 종료 조건과 결과(GameResult)

9. UI/UX

  • 화면 배치(PC 기준 — 판 + 오른쪽 패널, 좁은 화면 접힘), 조작 방법, 합법 수 하이라이트, 애니메이션, 초보자 도움말

10. 테스트 체크리스트

  • 구체적인 시나리오

11. 참고 자료

12. 메모 (상표·법적 주의 등)