새 게임 젝스님트: 숫자 카드를 동시에 몰래 내고 작은 수부터 줄 끝에 붙이기, 여섯 번째 카드면 앞의 다섯 장(소머리 = 벌점)을 가져가는 2~10명 카드 게임
- 엔진 packages/games/src/six-nimmt/(options·rules·types·index·bot): 104장 소머리(합 171), 규칙 1~4, 동시에 몰래 고르기(모두 고르기 전엔 바꾸기 가능, 마지막 사람이 고르면 공개), 작은 카드 줄 고르기·양쪽 끝 같은 차이 자리 고르기에서 멈춤, 라운드 합산·66점(또는 라운드 수) 종료·20라운드 안전장치 - 옵션 전부: 카드 구성(104장/인원×10+4 섞기/펼쳐 골라 가기 프로 2~6명), 양쪽 끝 붙이기, 작은 카드 자동, 30주년판 특별 카드 4종(짝홀·산 오르기·점프하는 소 연쇄·숫자 뒤집기), 끝 점수/라운드 수, 나온 카드 표, 제한 시간 - 시간 초과·나가기: 지금 줄 기준 가장 안전한 카드·소머리 적은 줄, 3번이면 자리 비움(5초), 나간 사람은 바로 자동, 1명 남으면 끝 - 컴퓨터: 카드마다 상대 카드를 흉내 내어 가져갈 소머리 평균(1단계 4번 → 60단계 48번), humanBest 실수, 41단계 이상 숫자 뒤집기·대기 카드 보고 줄 고르기 - 화면 apps/web/src/games/six-nimmt/: 소머리 색 카드, 줄 4개 + 빨간 6번째 칸, 공개 카드 줄과 한 장씩 놓이는 재생(줄 빛남·흔들림·"+🐮" 배너·음매 소리), 손패 미리 보기("2번 줄 3번째"/"⚠ 가져감"/"⬇ 너무 작음"), 뒤집기 토글, 줄 고르기 버튼(추천), 프로 뽑기, 라운드 결과 창, 최종 표, 점수표·나온 카드 표·기록, 휴대폰 320px, 도움말·30초 요약 - 등록: GAMES·BOT_STRATEGIES·BOT_GAMES·CATALOG·GAME_UI·GAME_ICON·카드·패 탭, docs/games/README.md, 설계 문서에 정한 것 기록 - 테스트: 규칙 46개(문서 §10 예시 전부, 무작위 대국 옵션 7종 JSON 왕복·결정성·정보 누출·카드 총수·onTimeout 합법), 컴퓨터 25개(옵션 7종 × 2·5·10명, 60단계 대 1단계), 도움말 2개, 방 통합 4개, E2E six-nimmt·six-nimmt-pro Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -47,6 +47,7 @@
|
||||
| `liar` | 라이어 게임 | 3~10 | 2026-10 새 게임 |
|
||||
| `magical-athlete` | 야단법석 달리기 | 2~6 | 2026-10 새 게임 |
|
||||
| `blackjack` | 블랙잭 | 1~7 | 2026-10 새 게임 |
|
||||
| `six-nimmt` | 젝스님트 | 2~10 | 2026-10 새 게임 |
|
||||
|
||||
인원은 각 게임 문서에서 원작 기준으로 최종 확정한다(이 표와 다르면 게임 문서가 우선).
|
||||
|
||||
|
||||
@@ -20,6 +20,9 @@
|
||||
- 작은 카드로 줄을 고르는 일은 그 카드를 놓을 차례에 바로 한다(뒤 카드는 기다림). 원작 순서 그대로이고, 순서상 고르는 일은 보통 그 차례의 가장 작은 카드에만 생긴다(§5.3).
|
||||
- 숫자 뒤집기에서 한 자리 숫자(1~9)는 "0X"로 보고 X0이 된다(7 → 70). 원작은 31 → 13, 90 → 09 예만 있다.
|
||||
- 66점 모드에서도 20라운드가 지나면 끝낸다(2명 판이 너무 길어지지 않게 하는 안전장치).
|
||||
- 나간 사람의 차례(고르기·줄 고르기·자리 고르기·뽑아 가기)는 1.2초를 기다리지 않고 그 자리에서 바로 자동으로 처리한다(§8.5 기본값과 같은 수). 고르기만 남은 사람이 모두 "자리 비움"이면 그 순간 마감을 5초로 줄인다.
|
||||
- 숫자 뒤집기를 쓴 카드도 공개 순서는 뒤집은 수로 정하고, 놓인 뒤에는 원래 숫자가 그 줄의 끝 카드가 된다(그래서 그 뒤 카드는 원래 숫자 기준으로 줄을 찾는다. §10 예: 13(뒤집기 31)이 30 다음에 놓이면 그 줄 끝은 13이라 진짜 31은 다른 줄로 감).
|
||||
- 게임이 끝난 뒤 화면의 "이번 라운드 소머리"는 0으로 보인다(마지막 라운드 점수는 점수표에 들어감).
|
||||
|
||||
## 2. 모드와 옵션
|
||||
| 옵션 키 | 설명 | 선택지 | 기본값 |
|
||||
@@ -34,6 +37,8 @@
|
||||
| `cardTracker` | 이번 라운드에 나온 카드 표 보여 주기(프로 변형이면 각자 골라 간 카드도) | `true` / `false`(원작처럼 기억으로) | `true` |
|
||||
| `turnSeconds` | 카드 고르기·줄 고르기·카드 뽑아 가기 제한 시간 | 15 / 20 / 30 / 45 / 60 / 무제한(`null`) | 30 |
|
||||
|
||||
구현(2026-10-15): 위 옵션을 모두 방 설정으로 넣었다(나중으로 미룬 옵션 없음). `fanCard`와 `placement = both`를 함께 고르면 옵션 검증(`superRefine`)이 거부하고, 대기실 화면은 `both`를 고르면 특별 카드를 `none`으로 돌려놓고 흐리게 한다.
|
||||
|
||||
zod 메타 예(`.meta({ title, labels })`, 09 §2):
|
||||
|
||||
```ts
|
||||
@@ -233,6 +238,7 @@ interface SixNimmtState {
|
||||
deadlineAt: number | null;
|
||||
}
|
||||
```
|
||||
- 구현 메모: 위 필드 말고도 `picked`(프로: 이번 라운드에 각자 골라 간 카드), `reveal`(마지막으로 공개된 차례: 공개 카드, 놓기 전 줄 모양, 놓을 때마다의 줄 모양 `steps` — 화면이 이것으로 한 장씩 다시 그린다), `lastRound`, `bestTake`, `clockMs`/`clockExtra`(타이머 고리·라운드 결과 5초), `endReason`이 있다. 고른 카드는 공개될 때까지 손패에 그대로 있다(그래서 불변식에 `selections`를 따로 세지 않는다).
|
||||
- `stateVersion` 1. 덱의 카드 총수 보존 불변식: `hands + rows(숫자만) + taken + queue + selections(공개 전) + aside + draft.pool = deckMax`.
|
||||
|
||||
### 8.2 액션
|
||||
@@ -319,6 +325,7 @@ interface SixNimmtView {
|
||||
- 실수: `humanBest`(`bots/policy.ts`)를 그대로 쓴다. 이 게임 기준 `small` = 소머리 0.5개, `critical` = 없음(꼭 둬야 할 수 개념이 약함).
|
||||
- 1~20단계는 위험 항을 쓰지 않는다(눈앞만 봄). 41단계 이상은 `queue`를 보는 줄 고르기와 숫자 뒤집기 시점 계산(가장 큰 위험을 피할 때 쓰기)을 한다.
|
||||
- 속도: 카드 10장 × `K` 48 × 한 차례 흉내(카드 10장 놓기) = 수천 번 비교라 수 ms 안. 생각 시간은 06 §12대로 사람처럼 1~3초.
|
||||
- 구현 메모: 위험 항은 "내 카드가 5번째로 줄 끝에 남으면 덤(+0.3)"만 쓴다(6번째 바로 앞에 남기는 손해는 한 차례 흉내 안에 이미 들어 있음). 숫자 뒤집기는 41단계 이상만, 안 뒤집은 가장 좋은 수보다 소머리 2개 이상 아낄 때(라운드 마지막 카드면 조금이라도 나을 때) 쓴다. 5인 판 1라운드 100판에서 60단계 1명의 평균 벌점이 1단계 4명 평균의 85% 미만인지 `six-nimmt/bot.test.ts`가 확인한다(200판 실측 약 10.0 대 14.6).
|
||||
- 테스트(`bots/bots.test.ts`): 2·5·10명, 옵션 조합(기본, `pro`, `both`, 팬 카드 4종)마다 컴퓨터끼리 끝까지 두어 모든 수가 합법이고 멈추지 않는지. 60단계 대 1단계 5인 판 100판 평균 벌점이 뚜렷하게 낮은지.
|
||||
|
||||
## 9. UI/UX
|
||||
@@ -345,24 +352,24 @@ interface SixNimmtView {
|
||||
- 소리: 합성음만(사이트 음량). 카드 내기 "톡", 공개 "착", 놓기 "탁", 가져가기 "음매"(소머리 많을수록 낮고 길게), 내 차례가 열릴 때 짧은 알림.
|
||||
|
||||
## 10. 테스트 체크리스트
|
||||
- [ ] 소머리: 55 → 7, 11·22·…·99 → 5, 10·20·…·100 → 3, 5·15·…·95(55 빼고) → 2, 나머지 → 1. 104장 합 171.
|
||||
- [ ] 셋업: `all` 4명 → 손패 10장씩, 줄 4장, `aside` 60장, 카드 총수 104. `tactics` 3명 → 1~34만, `aside` 0장. 같은 시드면 같은 분배.
|
||||
- [ ] `pro` 3명: 1~34를 펼치고 시작 자리부터 돌아가며 30번 고른 뒤 남은 4장이 작은 수부터 줄 시작. 7명 이상은 옵션 검증에서 거부(`playersFor`).
|
||||
- [ ] §5.4 예시를 그대로: 2차례에 C가 12·14·15·21·26(소머리 6)을 가져가고 1번 줄이 [30 36]. 3차례에 A만 `choose`로 멈추고, A가 2번 줄을 고르면 [3 9]와 4번 줄 [58 61 68 83].
|
||||
- [ ] 함정: 끝 카드 41, 42에서 45는 42 다음. 그 줄이 5장이면 가져감.
|
||||
- [ ] 규칙 4가 아닌 카드(같은 차례의 두 번째 이후)는 `choose`로 멈추지 않는다(기본 규칙).
|
||||
- [ ] `lowCard = fewest`: 소머리가 같은 두 줄이면 끝 카드가 큰 줄을 자동으로 가져간다.
|
||||
- [ ] 고르기: 모두 고르기 전에는 다시 `SELECT`로 바꿀 수 있고, 마지막 사람이 고르는 순간 공개된다. 공개 뒤 `SELECT`는 거부.
|
||||
- [ ] `both`: 끝 40(2번 줄), 첫 카드 46(3번 줄), 낸 카드 43 → `place` 대기, 두 자리 중 하나만 허용. 첫 카드보다 작으면 왼쪽에 붙는다. 5장 줄 왼쪽에 붙이면 5장을 가져간다.
|
||||
- [ ] `evenOdd`: "홀" 표시 줄(끝 85)에는 짝수가 못 간다(원작 예: 90이 85 다음 대신 52 다음 → 6번째라 가져감). 가져간 뒤 짝홀 카드가 나머지 세 줄(끝 31, 90, 92) 중 끝 카드가 가장 작은 31 줄로 옮겨지고 면은 "홀".
|
||||
- [ ] `mountain`: 표시 줄은 끝 카드보다 작은 수만, 차이가 같으면 표시 줄. 줄을 가져갈 때마다 한 줄씩, 1번·4번 줄에서 방향이 바뀐다(원작 예: 21이 12 다음 대신 산 오르기 줄의 26 다음(내림차순)으로 → 6번째라 가져감).
|
||||
- [ ] `jumpingCow`: 숫자 4장 + 소 줄에 놓으면 숫자 4장만 가져가고 소는 끝 카드가 가장 작은 다른 줄로 뛴다(원작 예: 43, 다른 줄 끝 78·104·53 → 53 줄). 뛰어간 줄이 6칸이 되면 같은 사람이 가장 큰 카드 1장을 남기고 4장을 가져가고 소가 또 뛴다.
|
||||
- [ ] `flipDigits`: 24 + 뒤집기 → 42로 놓을 줄을 정하고 놓인 뒤에는 24, 소머리 1. 13(뒤집기 → 31)과 31(그대로)이 함께 나오면 뒤집은 사람이 먼저. 7 → 70. 100 이상 뒤집기 거부. 라운드에 한 번만.
|
||||
- [ ] 라운드 끝 점수 합산, 66 이상이면 그 라운드 끝에 종료(도중에 넘어도 라운드는 끝까지). 공동 1등 처리. `endMode = rounds` 3이면 정확히 3라운드. 20라운드 안전장치.
|
||||
- [ ] 시간 초과: 고르기 = 지금 줄 기준 가져갈 소머리가 가장 적은 카드(같으면 차이 작은 것, 작은 숫자), 줄 고르기 = 가장 적은 소머리 줄, 뽑아 가기 = 소머리 적고 작은 숫자. 모든 상태에서 `onTimeout`이 합법.
|
||||
- [ ] 연결 끊김·나감: 나간 사람 카드는 `select`가 열리자마자 자동으로 나가 다른 사람을 기다리게 하지 않는다. 결과에서는 맨 뒤. 남은 사람 1명이면 종료.
|
||||
- [ ] 정보 유출: 공개 전 고른 카드, 남의 손패, `aside`가 다른 사람·관전자 view에 없다(`secretsOf`). `cardTracker = false`면 `seen`·`draft.picked`가 view에 없다.
|
||||
- [ ] 무작위 대국 1,000판(인원 2~10, 옵션 조합): 예외 없음, 카드 총수 보존, 줄은 언제나 숫자 5장 이하(소 포함 5칸 이하), 직렬화 왕복·결정성.
|
||||
- [x] 소머리: 55 → 7, 11·22·…·99 → 5, 10·20·…·100 → 3, 5·15·…·95(55 빼고) → 2, 나머지 → 1. 104장 합 171.
|
||||
- [x] 셋업: `all` 4명 → 손패 10장씩, 줄 4장, `aside` 60장, 카드 총수 104. `tactics` 3명 → 1~34만, `aside` 0장. 같은 시드면 같은 분배.
|
||||
- [x] `pro` 3명: 1~34를 펼치고 시작 자리부터 돌아가며 30번 고른 뒤 남은 4장이 작은 수부터 줄 시작. 7명 이상은 옵션 검증에서 거부(`playersFor`).
|
||||
- [x] §5.4 예시를 그대로: 2차례에 C가 12·14·15·21·26(소머리 6)을 가져가고 1번 줄이 [30 36]. 3차례에 A만 `choose`로 멈추고, A가 2번 줄을 고르면 [3 9]와 4번 줄 [58 61 68 83].
|
||||
- [x] 함정: 끝 카드 41, 42에서 45는 42 다음. 그 줄이 5장이면 가져감.
|
||||
- [x] 규칙 4가 아닌 카드(같은 차례의 두 번째 이후)는 `choose`로 멈추지 않는다(기본 규칙).
|
||||
- [x] `lowCard = fewest`: 소머리가 같은 두 줄이면 끝 카드가 큰 줄을 자동으로 가져간다.
|
||||
- [x] 고르기: 모두 고르기 전에는 다시 `SELECT`로 바꿀 수 있고, 마지막 사람이 고르는 순간 공개된다. 공개 뒤 `SELECT`는 거부.
|
||||
- [x] `both`: 끝 40(2번 줄), 첫 카드 46(3번 줄), 낸 카드 43 → `place` 대기, 두 자리 중 하나만 허용. 첫 카드보다 작으면 왼쪽에 붙는다. 5장 줄 왼쪽에 붙이면 5장을 가져간다.
|
||||
- [x] `evenOdd`: "홀" 표시 줄(끝 85)에는 짝수가 못 간다(원작 예: 90이 85 다음 대신 52 다음 → 6번째라 가져감). 가져간 뒤 짝홀 카드가 나머지 세 줄(끝 31, 90, 92) 중 끝 카드가 가장 작은 31 줄로 옮겨지고 면은 "홀".
|
||||
- [x] `mountain`: 표시 줄은 끝 카드보다 작은 수만, 차이가 같으면 표시 줄. 줄을 가져갈 때마다 한 줄씩, 1번·4번 줄에서 방향이 바뀐다(원작 예: 21이 12 다음 대신 산 오르기 줄의 26 다음(내림차순)으로 → 6번째라 가져감).
|
||||
- [x] `jumpingCow`: 숫자 4장 + 소 줄에 놓으면 숫자 4장만 가져가고 소는 끝 카드가 가장 작은 다른 줄로 뛴다(원작 예: 43, 다른 줄 끝 78·104·53 → 53 줄). 뛰어간 줄이 6칸이 되면 같은 사람이 가장 큰 카드 1장을 남기고 4장을 가져가고 소가 또 뛴다.
|
||||
- [x] `flipDigits`: 24 + 뒤집기 → 42로 놓을 줄을 정하고 놓인 뒤에는 24, 소머리 1. 13(뒤집기 → 31)과 31(그대로)이 함께 나오면 뒤집은 사람이 먼저. 7 → 70. 100 이상 뒤집기 거부. 라운드에 한 번만.
|
||||
- [x] 라운드 끝 점수 합산, 66 이상이면 그 라운드 끝에 종료(도중에 넘어도 라운드는 끝까지). 공동 1등 처리. `endMode = rounds` 3이면 정확히 3라운드. 20라운드 안전장치.
|
||||
- [x] 시간 초과: 고르기 = 지금 줄 기준 가져갈 소머리가 가장 적은 카드(같으면 차이 작은 것, 작은 숫자), 줄 고르기 = 가장 적은 소머리 줄, 뽑아 가기 = 소머리 적고 작은 숫자. 모든 상태에서 `onTimeout`이 합법.
|
||||
- [x] 연결 끊김·나감: 나간 사람 카드는 `select`가 열리자마자 자동으로 나가 다른 사람을 기다리게 하지 않는다. 결과에서는 맨 뒤. 남은 사람 1명이면 종료.
|
||||
- [x] 정보 유출: 공개 전 고른 카드, 남의 손패, `aside`가 다른 사람·관전자 view에 없다(`secretsOf`). `cardTracker = false`면 `seen`·`draft.picked`가 view에 없다.
|
||||
- [x] 무작위 대국 1,000판(인원 2~10, 옵션 조합): 예외 없음, 카드 총수 보존, 줄은 언제나 숫자 5장 이하(소 포함 5칸 이하), 직렬화 왕복·결정성.
|
||||
|
||||
## 11. 참고 자료
|
||||
- AMIGO 30주년판 영문 규칙서(2024, 기본 규칙·프로 변형·팬 카드 4종·협력 변형 "버펄로를 이겨라"): https://blog.amigo-spiele.de/content/ap/rule/02401-GB-AmigoRule.pdf
|
||||
|
||||
Reference in New Issue
Block a user