도둑잡기(old-maid): 규칙·화면·컴퓨터 상대·테스트·문서·E2E
- 규칙 모듈 packages/games/src/old-maid: 2~8명, 트럼프 52장 + 조커 1장을 첫 사람(무작위)부터 한 장씩 나누고 같은 숫자 짝은 자동으로 버림. 차례에는 다음 자리(왼쪽)의 카드 있는 사람 손패에서 자리(index)로 한 장 뽑기(from 함께 보내 대상이 바뀌면 거절), 짝이 없으면 내 손패 무작위 자리에 숨김. 다 턴 순서대로 순위, 마지막 조커를 든 사람이 도둑(꼴찌). 결과 scoreText 에 "🃏 도둑"/"다 털었어요"/"나감" 표시. - 내 손패 섞기: 남은 사람 누구나 언제든, 차례마다 3번까지, 시계는 그대로. 남에게 보이는 자리는 실제 손패 순서이고, view 에는 남의 손패 장수만(뽑은 카드는 뽑은 사람에게만). - 시간 초과는 무작위 한 장 뽑기(3번 연속이면 5초), 카드를 든 채 나가면 그 카드를 섞어 다음 자리부터 한 장씩 나눠 주고 짝을 버림, 나간 사람은 맨 아래. 둘만 남았을 때 나가면 도둑 없이 끝. - 컴퓨터 상대(BOT_GAMES): 단계와 관계없이 무작위로 뽑고 가끔(15%) 자기 손패를 먼저 섞음. - 화면 apps/web/src/games/old-maid: 뽑힐 사람의 뒷면 카드를 펼쳐 고르기(tapConfirm 이면 두 번 눌러 확인, PC 한 번, 키보드 방향키+Enter), 섞으면 흔들림, 지난 뽑기·버린 짝, 내 손패(조커 표시)와 [🔀 섞기], 조커를 넘기면 알림. 30초 요약, 지금 할 수 있는 것, 규칙. - 등록(GAMES, 카탈로그, BOT_GAMES·전략, 화면 레지스트리, 아이콘·카드 탭), 도움말 테스트 게임 수 27, 문서 docs/games/old-maid.md, E2E 계획(PC 1 + 휴대폰 2, 끝까지). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -42,6 +42,7 @@
|
||||
| `apple` | 사과 게임(합 10 만들기, 같은 판 경주) | 1~8 | M9 |
|
||||
| `clue` | 클루 | 3~6 | M9 |
|
||||
| `connect-four` | 커넥트 포(사목) | 2 | M9 |
|
||||
| `old-maid` | 도둑잡기 | 2~8 | M9 |
|
||||
|
||||
인원은 각 게임 문서에서 원작 기준으로 최종 확정한다(이 표와 다르면 게임 문서가 우선).
|
||||
|
||||
|
||||
116
docs/games/old-maid.md
Normal file
116
docs/games/old-maid.md
Normal file
@@ -0,0 +1,116 @@
|
||||
# 도둑잡기 (`old-maid`)
|
||||
|
||||
> 마일스톤: M9 · 인원: 최소 2 ~ 최대 8명 · 예상 시간: 약 5~10분 · 난이도: 쉬움
|
||||
|
||||
## 1. 개요
|
||||
- 트럼프 52장에 조커 1장을 넣어 나누고, 옆 사람 손패에서 한 장씩 몰래 뽑아 같은 숫자 짝을 버리다가 마지막에 조커를 든 사람이 지는(도둑) 가족 카드놀이. 집에서 한 번쯤 해 본 놀이라 설명이 거의 필요 없다.
|
||||
- 비슷한 놀이: 영국의 올드 메이드(1882년 기록, 퀸 한 장을 빼는 방식), 독일의 블랙 피터, 일본의 바바누키. 우리 사이트는 한국에서 흔한 "조커 한 장" 방식만 쓴다.
|
||||
- 인원 근거: 2명부터 가능하고, 53장을 나누면 8명일 때 한 사람 6~7장이라 그 이상은 짝 버리기 뒤 손패가 너무 적다. 2~8명.
|
||||
- 실력 요소가 거의 없는 운 게임이라, 사람 사이의 재미(조커 넘기기, 섞기 "손장난", 채팅)가 중심이다.
|
||||
|
||||
## 2. 모드와 옵션
|
||||
| 옵션 키 | 설명 | 선택지 | 기본값 |
|
||||
|---|---|---|---|
|
||||
| `turnSeconds` | 한 번 뽑는 제한 시간 | 10 / 20 / 30 / 60초 | 20초 |
|
||||
|
||||
일부러 넣지 않은 것: 짝 직접 버리기(항상 자동), 퀸 빼기(올드 메이드) 방식, 상대가 고르는 카드를 실시간으로 보여 주는 표시, "한 장 살짝 올려 보이기" 손장난. 규칙을 단순하게 두려고 뺐다. 손장난은 [섞기] 하나로 대신한다.
|
||||
|
||||
## 3. 구성물
|
||||
- 트럼프 52장(♠♥◆♣ × 2~10·J·Q·K·A) + 조커 1장 = 53장. 카드 id는 엔진 공통 형식(`7H`, `TD`, 조커 `X1`).
|
||||
- 짝은 숫자(랭크)만 본다. 무늬·색은 상관없다. 조커는 짝이 없다.
|
||||
|
||||
## 4. 준비(셋업)
|
||||
1. 53장을 시드 RNG로 섞는다.
|
||||
2. 첫 사람을 무작위로 정하고, 그 사람부터 자리 순서대로 한 장씩 나눈다(53장이라 앞자리 몇 명이 한 장 더 받는다).
|
||||
3. 모두 손에서 같은 숫자 두 장을 짝으로 버린다(자동). 같은 숫자가 세 장이면 두 장만 버리고 한 장은 남는다. 버린 짝은 공개 정보다.
|
||||
4. 이때 손패가 0장이 된 사람은 바로 빠지고(같은 순간이라 공동 순위), 첫 사람이 빠졌으면 다음 자리부터 시작한다. 드물게 이것만으로 한 사람만 남으면 그 자리에서 끝난다.
|
||||
|
||||
## 5. 진행 규칙
|
||||
- 차례인 사람은 **다음 자리(왼쪽)에서 아직 카드가 있는 사람**의 손패에서 뒷면 카드 한 장을 고른다. 뽑는 사람에게 보이는 것은 그 사람 카드의 **장수와 자리(왼쪽부터 몇 번째)** 뿐이다. 자리는 그 사람이 실제로 들고 있는 순서 그대로다.
|
||||
- 뽑은 카드와 같은 숫자가 내 손에 있으면 두 장을 바로 버린다(자동, 공개). 없으면 뽑은 카드를 내 손패 **무작위 자리**에 넣는다(2명일 때 뺏긴 사람이 그 카드 자리를 알 수 없게).
|
||||
- 손패가 0장이 된 사람은 빠진다(먼저 턴 순서대로 1등, 2등…). 한 번에 두 사람이 빠지면(뽑힌 사람이 마지막 카드를 뺏기고 뽑은 사람도 그 짝으로 다 털 때) 뽑힌 사람이 먼저다.
|
||||
- 다음 차례는 내가 뽑은 사람(그 사람이 빠졌으면 그다음 자리에서 카드가 있는 사람)이다. 즉 A가 B에게서, B가 C에게서 … 뽑으며 돈다.
|
||||
- **섞기**: 게임에 남아 카드가 2장 이상인 사람은 언제든(내 차례가 아니어도) 내 손패 순서를 섞을 수 있다. 섞기는 서버 시드 RNG로 하고, 한 사람이 한 차례 동안 3번까지 할 수 있다(연타 방지). 섞어도 차례 시계는 그대로다.
|
||||
|
||||
### 5.1 예시(3명 A·B·C)
|
||||
A [♥2, ♥3], B [♠2, 조커], C [♠3]. A 차례: B의 첫 카드(♠2)를 뽑아 ♥2와 짝 → 버림. B [조커]. B 차례: C의 ♠3을 뽑았지만 짝이 없어 손에 넣음 → C는 0장이라 1등. 다음은 A(C가 빠짐) 차례: B의 두 장 중 ♠3을 뽑아 ♥3과 짝 → A 2등. B는 조커만 들고 도둑.
|
||||
|
||||
## 6. 승패와 점수 계산
|
||||
- 짝이 모두 버려지면 조커 한 장만 남고, 그 사람이 **도둑(꼴찌)** 이다.
|
||||
- 순위: 손패를 먼저 다 턴 순서대로 위, 도둑이 그 아래, 게임 중에 나간 사람이 맨 아래(같은 그룹 공동).
|
||||
- 점수는 없다. 결과 화면의 점수 칸(`scoreText`)에 도둑은 "🃏 도둑", 다 턴 사람은 "다 털었어요", 나간 사람은 "나감"으로 적어 **누가 도둑인지** 이름 옆에 보인다(엔진 문구에는 닉네임을 넣을 수 없어서). `summary`는 "조커를 끝까지 들고 있던 꼴찌가 🃏 도둑이에요! …".
|
||||
|
||||
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
|
||||
- 없음. 원작 변형(퀸 빼기, 짝 직접 버리기, 뽑는 방향 바꾸기)은 규칙을 단순하게 두려고 넣지 않았다.
|
||||
|
||||
## 8. 엔진 설계
|
||||
### 8.1 상태(State)
|
||||
```ts
|
||||
interface OldMaidState {
|
||||
options: { turnSeconds: 10 | 20 | 30 | 60 };
|
||||
order: PlayerId[];
|
||||
hands: Record<PlayerId, string[]>; // 들고 있는 순서 그대로(왼쪽부터)
|
||||
discards: Record<PlayerId, string[]>; // 버린 짝(공개)
|
||||
out: PlayerId[][]; // 다 턴 순서(같은 순간은 한 그룹)
|
||||
left: PlayerId[]; // 카드를 든 채 나간 사람
|
||||
turn: PlayerId | null; turnNo: number;
|
||||
shuffles / shufflesThisTurn: Record<PlayerId, number>;
|
||||
lastDraw: { no, drawer, from, index, card, pair, auto } | null;
|
||||
log: LogEntry[]; logCount: number; // 공개 기록(최근 30개)
|
||||
timeoutsInRow, away, turnStartedAt, seq, final;
|
||||
}
|
||||
```
|
||||
### 8.2 액션
|
||||
| type | payload | 누가 / 언제 | 검증 조건 |
|
||||
|---|---|---|---|
|
||||
| `draw` | `from`, `index` | 차례인 사람 | `from`이 지금 뽑을 사람(다음 자리의 카드 있는 사람)과 같고, `0 ≤ index < 그 사람 장수`. `from`을 함께 보내 그사이 누가 나가 대상이 바뀌면 거절된다 |
|
||||
| `shuffle` | 없음 | 남아 있는 사람 누구나, 언제든 | 카드 2장 이상, 이번 차례에 3번 미만 |
|
||||
| `timeout` | (시스템) | 차례인 사람 | 무작위 자리 한 장 뽑기 |
|
||||
| `leave` | (시스템) | 카드를 든 사람 | 8.5 참고 |
|
||||
|
||||
### 8.3 공개/비공개 정보 (view)
|
||||
- 내 손패만 카드 id로, 다른 사람은 **장수만**(`handCounts`). 관전자는 아무 손패도 받지 않는다.
|
||||
- 뽑기 기록(`log`, `lastDraw`)은 누가 누구의 몇 번째 카드를 뽑았는지와 버린 짝만 공개. 짝이 안 난 카드는 **뽑은 사람의 view에만** `lastDraw.card`로 들어간다. 뺏긴 사람은 자기 손패가 바뀐 것으로 알 수 있다(화면이 "조커를 넘겼어요!"를 알려 준다).
|
||||
- 조커가 누구에게 있는지는 끝날 때까지 어디에도 없다. 끝나면 `revealed`로 남은 손패(도둑의 조커)를 공개한다.
|
||||
- 이벤트(`draw`, `shuffle`, `out`, `left`, `timeout`, `gameEnded`)에도 손에 남은 카드 id는 넣지 않는다(테스트로 확인).
|
||||
- `secretsOf` = 그 사람 손패. 엔진 공통 유출 검사를 매 상태 통과한다.
|
||||
|
||||
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
|
||||
- 덱 섞기, 첫 사람, 뽑은 카드를 넣을 자리, 섞기, 시간 초과 때 뽑을 자리, 나간 사람 카드 섞기와 넣을 자리. 모두 `ctx.rng`.
|
||||
|
||||
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
|
||||
- 차례마다 `turnSeconds`. 넘기면 지금 뽑을 사람의 **무작위 자리 한 장**을 뽑는다(자동 짝 버리기 포함). 3번 연속이면 "자리 비움"으로 제한 시간 5초, 직접 뽑으면 풀린다.
|
||||
- 섞기는 차례 시계를 다시 시작하지 않는다.
|
||||
- **나가기(공정 처리)**: 카드를 든 사람이 나가면 그 카드를 섞어, 남아 있는 사람들에게 **나간 사람의 다음 자리부터 한 장씩 돌아가며** 나눠 준다(각자 손패 무작위 자리에). 받은 사람은 짝을 자동으로 버리고, 그걸로 0장이 되면 빠진다. 조커가 있었다면 누구에게 갈지 무작위라 특정 사람만 손해 보지 않는다. 나간 사람은 맨 아래 순위. 그 결과 카드 든 사람이 한 명 이하가 되면 **도둑 없이** 끝난다(`reason: resign`, 남은 사람이 나간 사람보다 위). 나간 사람이 차례였으면 다음 자리로 넘어간다.
|
||||
- 이미 다 턴 사람이 나가면 아무 변화도 없다(`onLeave` = null, 순위 유지).
|
||||
|
||||
### 8.6 종료 조건과 결과(GameResult)
|
||||
- 카드를 든 사람이 1명 이하가 되는 순간 끝. `ranking` = 다 턴 그룹들 + [도둑] + [나간 사람들]. `scoreText`는 6절. `reason`은 보통 `normal`, 나가서 끝나면 `resign`.
|
||||
|
||||
## 9. UI/UX
|
||||
- 위: 다른 사람 자리 카드(내 다음 자리부터, 즉 내가 뽑을 사람이 맨 앞). 장수(작은 뒷면 묶음), 버린 짝 수, "뽑는 중"/"뽑히는 중"/"🎉 N등"/"🃏 도둑" 배지, 섞으면 "🔀 섞었어요" 말풍선.
|
||||
- 가운데 초록 테이블: "A ← B의 카드 N장"과 뽑힐 사람의 뒷면 카드를 펼쳐 보여 준다(자리 번호 표시, 많으면 작게 여러 줄). 내 차례면 카드가 버튼이 된다. 터치 기기에서 "두 번 눌러 확인"(설정 `tapConfirm`)이 켜져 있으면 첫 탭은 고르기(카드가 위로), 두 번째 탭에 뽑는다. PC 마우스는 한 번에 뽑는다. 키보드는 좌우 방향키로 고르고 Enter. 뽑힐 사람이 섞으면 펼친 카드가 흔들리고 고른 것이 풀린다.
|
||||
- 지난 뽑기: 누가 누구의 몇 번째를 뽑았는지, 짝이 나면 두 장을 앞면으로. 내가 뽑은 카드는 나에게만 앞면으로("뽑은 카드 ♠9 · 짝이 없어서 손에 넣었어요", "앗, 조커를 뽑았어요!"). 최근 버린 짝 6쌍.
|
||||
- 아래 내 자리: 내 손패(앞면, 실제 순서), 조커는 빨간 테두리, 방금 들어온 카드는 반짝. [🔀 섞기 (남은 횟수/3)] 버튼. "다른 사람에게는 이 순서 그대로 뒷면으로 보여요" 안내. 조커를 넘기면 "조커를 넘겼어요! 😆" 알림.
|
||||
- 오른쪽(휴대폰은 아래): 차례·타이머, 참가자(장수/등수), 최근 기록, 결과(등수와 도둑), 도움말.
|
||||
- 휴대폰 320px~: 자리 카드 2열, 카드 폭 44~50px(터치 44px 이상). 다크 모드는 공통 색 변수, 화면 읽기 프로그램용 aria-label과 aria-live 안내.
|
||||
- 컴퓨터 상대: 단계와 관계없이 무작위로 한 장 뽑고, 가끔(15%, 차례마다 한 번까지) 자기 손패를 먼저 섞는다. 생각 시간은 방의 공통 "사람 같은 지연".
|
||||
|
||||
## 10. 테스트 체크리스트
|
||||
- [x] 2~8명 셋업: 53장 고르게, 짝 모두 버림, 조커 한 사람, 첫 사람이 한 장 더
|
||||
- [x] 처음부터 0장인 사람은 바로 빠지고 차례 넘김
|
||||
- [x] 고른 자리 카드 뽑기, 짝 자동 버리기, 짝 없으면 무작위 자리, 다음 차례, 빠진 사람 건너뛰기
|
||||
- [x] 한 번에 두 사람 빠짐(뽑힌 사람 먼저), 도둑·순위·`scoreText`·요약
|
||||
- [x] 검증: 차례, 대상(`from`), 자리 범위
|
||||
- [x] 섞기: 차례 아니어도 가능, 차례마다 3번, 시계 유지, 섞은 뒤 같은 자리를 뽑으면 섞인 순서의 카드
|
||||
- [x] 시간 초과 무작위 뽑기, 자리 비움(5초), 모두 시간 초과만 해도 끝
|
||||
- [x] 나가기: 다음 자리부터 나눠 주기·짝 버리기·차례 넘김, 2명이면 도둑 없이 끝, 다 턴 사람은 null
|
||||
- [x] view/이벤트 유출 없음(뽑은 카드는 뽑은 사람만), 엔진 randomPlayout(2~8명) + 결정성, 같은 기록 재생
|
||||
- [x] 컴퓨터: 무작위 자리, 가끔 섞기(차례마다 한 번), 2·5·8명 끝까지, 방 연습 게임 끝까지
|
||||
- [x] 웹 도움말(차례/뽑히는 사람/구경/끝), E2E(PC + 휴대폰 2명, 끝까지)
|
||||
|
||||
## 11. 참고 자료
|
||||
- 위키백과 "Old maid (card game)", 한국어 "도둑잡기" 항목. 기획 메모 `notes/new-game-descriptions-20261012.md` 15절.
|
||||
|
||||
## 12. 메모 (상표·법적 주의 등)
|
||||
- 민속 놀이라 상표 문제가 없다. 카드 그림은 사이트 공통 SVG 트럼프 카드(`apps/web/src/components/cards/PlayingCard.tsx`)를 쓴다.
|
||||
Reference in New Issue
Block a user