새 게임 6개 설계 문서: 티츄·핫스트릭·버건디의 성·사건 파일(디텍티브 대신 새로 만든 협력 추리, 사건 3개)·젝스님트·젬블로

- 게임마다 _TEMPLATE.md 12개 절: 공식 규칙, 방 설정으로 넣을 변형 규칙(기본값은 원작), 엔진 설계, 화면, 테스트, 출처
- 사건 파일은 원작 사건 글을 쓰지 않고 진행 방식만 빌림. 사건 3개 전체 글은 case-file-cases.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-15 18:53:41 +09:00
parent 57351fd9d6
commit 8620c82ca8
7 changed files with 3255 additions and 0 deletions

View File

@@ -0,0 +1,877 @@
# 사건 파일 — 사건 내용 (`case-file` 사건 데이터)
> 규칙과 엔진은 `case-file.md`. 이 문서는 **사건 세 개의 전체 글**(의뢰, 장소, 인물, 단서 본문, 보고서 문제, 정답과 풀이, 앞뒤 맞추기 점검표)이다.
> 코드에서는 사건마다 `packages/games/src/case-file/cases/<사건 id>.ts` 하나로 옮긴다. 문서의 id·시간·여는 단서가 데이터와 한 글자도 다르면 안 된다(테스트가 이 문서 표와 데이터를 비교하지는 않지만, 데이터 검사 테스트가 같은 규칙을 확인한다 — `case-file.md` 10절).
> **스포일러 주의**: 이 문서에는 정답이 있다. 게임할 사람은 읽지 말 것.
모든 사건·인물·장소·글은 이 사이트를 위해 새로 지었다. 실제 사람·가게·상표와 관계없다. 동네 이름(망원동·북촌 등)은 배경으로만 쓴다.
## 0. 데이터 모양(요약)
```ts
interface CaseData {
id: 'c1' | 'c2' | 'c3';
title: string; level: '쉬움' | '보통' | '어려움';
days: number; // 수사할 수 있는 날 수
briefing: string; // 의뢰(처음부터 모두에게 공개)
zones: { id: string; name: string }[];
travel: Record<string, Record<string, number>>; // 구역 사이 이동 시간(같은 구역 0)
places: { id: string; name: string; zone: string }[];
people: { id: string; name: string; line: string; from: string[] }[]; // 자료실 인물 카드, from = 처음 알려 주는 단서(빈 배열이면 의뢰에서)
leads: {
id: string; place: string; title: string; hours: 1 | 2;
from: string[]; // 이 중 하나라도 읽으면 열림(빈 배열 = 처음부터 열림)
text: string; // 읽어야만 보이는 본문(서버에만)
deep?: string; // 돋보기로만 보이는 본문(서버에만)
deepOpens?: string[]; // 깊이 보기로 여는 단서
}[];
news: { day: number; text: string }[]; // 아침 소식(그날 아침 공짜로 공개)
hints: string[]; // 조언 3개(차례대로)
questions: { id: string; text: string; points: number; choices: string[]; answer: number; culprit?: true; evidence: string[] }[]; // evidence: 정답 근거 단서(테스트용, 9절 풀이의 괄호 속 단서)
pass: number; gradeS: number; gradeA: number;
solution: string; // 끝난 뒤 보여 주는 풀이
}
```
공통 규칙(사건마다 같음): 수사는 매일 **09시 사무소**에서 시작한다. 다른 구역으로 가면 이동 시간이 든다. 시간 예산(하루 10·8·6시간)은 옵션이다.
---
## 사건 1. 달빛제과의 사라진 레시피 노트 (`c1`)
> 난이도 쉬움 · 2일 · 단서 18개(합계 20시간) · 문제 5개 · 만점 28점 · 해결 기준 16점(범인 문제 정답 필수) · S 26점 / A 21점
### 1.1 의뢰 (briefing)
화요일 아침 9시. 해오름 탐정사무소로 전화가 왔다. 망원동 골목에서 40년째 빵을 굽는 '달빛제과'의 오순자 할머니다.
"어제 아침에 우리 레시피 노트가 없어졌어요. 쑥색 천 표지에 손으로 쓴 공책인데, 우리 집 쑥 단팥빵 만드는 법이 다 들어 있어요. 이번 토요일 '마포 동네빵 한마당'에 내려고 새로 고친 분량도 거기에만 적어 놨는데…."
경찰에 알리면 일이 커질까 걱정이라는 할머니. 대회 레시피 접수 마감은 목요일 정오다. 오늘과 내일, 이틀 안에 노트를 찾아야 한다.
- 알려진 것: 노트는 월요일 아침, 가게 문을 열기 전후에 주방에서 사라졌다. 주방에는 할머니, 손자, 아르바이트생이 일한다.
### 1.2 구역·장소·이동
| 구역 | 장소(id) |
|---|---|
| 사무소 `office` | 해오름 탐정사무소 `office` |
| 망원동 골목 `mangwon` | 달빛제과 `bakery`, 공영주차장 `parking`, 보리밭 베이커리 `boribat`, 미란 세탁소 `laundry` |
| 성산동 `seongsan` | 문태식 밀가루 창고 `warehouse` |
이동 시간: 서로 다른 구역 사이는 모두 1시간. 같은 구역 안은 0시간.
### 1.3 인물 (자료실 카드)
| id | 이름 | 한 줄 | 처음 알려 주는 단서 |
|---|---|---|---|
| `oh` | 오순자 (72) | 달빛제과 주인. 40년째 쑥 단팥빵을 굽는다. 무릎이 아파 2층엔 잘 안 올라간다 | 의뢰 |
| `minjae` | 강민재 (31) | 할머니의 손자. 3년째 함께 일하며 가게를 물려받을 예정. 하얀 경차를 탄다 | 의뢰 |
| `hana` | 윤하나 (24) | 새벽 아르바이트생. 제빵학교 학생. 새벽 6시 출근 | 의뢰 |
| `moon` | 문태식 (56) | 밀가루 납품업자. 파란 1톤 트럭, 매일 아침 7시 배달 | `c1-01`, `c1-03` |
| `baek` | 백승호 (41) | 길 건너 '보리밭 베이커리' 사장. 한 달 전 개업 | `c1-01` |
| `miran` | 정미란 (60) | 보리밭 옆 세탁소 사장. 아침마다 가게 앞을 쓴다 | `c1-06` |
| `seo` | 서지원 | 구청 '마포 동네빵 한마당' 담당 주무관 | `c1-16` |
### 1.4 단서 목록
| id | 장소 | 제목 | 시간 | 열리는 조건 |
|---|---|---|---|---|
| `c1-01` | 달빛제과 | 오순자 할머니 이야기 듣기 | 1 | 처음부터 |
| `c1-02` | 달빛제과 | 주방 작업대 살펴보기 | 1 | 처음부터 |
| `c1-03` | 달빛제과 | 아르바이트생 윤하나 이야기 듣기 | 1 | 처음부터 |
| `c1-04` | 달빛제과 | 손자 강민재 이야기 듣기 | 1 | 처음부터 |
| `c1-05` | 문태식 창고 | 납품업자 문태식 만나기 | 1 | `c1-01` 또는 `c1-03` |
| `c1-06` | 달빛제과 | 가게 앞 CCTV 보기 | 1 | `c1-01` |
| `c1-07` | 공영주차장 | 관리실 입출차 기록 보기 | 1 | `c1-04` |
| `c1-08` | 보리밭 베이커리 | 백승호 사장 만나기 | 1 | `c1-01` |
| `c1-09` | 달빛제과 | 뒷문과 종 살펴보기 | 1 | `c1-03` |
| `c1-10` | 사무소 | 문태식의 다음 배달처에 전화하기 | 1 | `c1-05` |
| `c1-11` | 달빛제과 | 2층 창고 둘러보기 | 1 | `c1-03` 또는 `c1-12` |
| `c1-12` | 달빛제과 | 계단의 초록 발자국 살펴보기 | 1 | `c1-02` |
| `c1-13` | 미란 세탁소 | 세탁소 정미란 사장 이야기 듣기 | 1 | `c1-06` |
| `c1-14` | 보리밭 베이커리 | 보리밭 가게 CCTV 보기 | 2 | `c1-08` |
| `c1-15` | 사무소 | 보리밭 베이커리 SNS 글 찾아보기 | 1 | `c1-08` |
| `c1-16` | 사무소 | 구청 대회 담당자에게 전화하기 | 1 | 처음부터 |
| `c1-17` | 달빛제과 | 할머니에게 지난주 일 묻기 | 1 | `c1-16` 또는 `c1-03` |
| `c1-18` | 문태식 창고 | 트럭 블랙박스 영상 보기 | 2 | `c1-05` |
돋보기(깊이 보기)가 있는 단서: `c1-02`, `c1-04`, `c1-18`.
### 1.5 단서 본문
#### `c1-01` 오순자 할머니 이야기 듣기
할머니는 밀가루 묻은 앞치마를 털며 어제 아침을 차근차근 떠올렸다.
"나는 늘 새벽 5시 반에 나와요. 서랍에서 노트를 꺼내 작업대에 펴 놓고 반죽을 하지. 6시엔 하나가 오고, 7시엔 문 사장이 밀가루를 들여 줘요. 7시 20분쯤 쑥 반죽 분량을 노트로 한 번 더 확인하고, 하나랑 같이 가게 앞에 빵을 진열하러 나갔어요. 그땐 분명히 작업대 위에 있었어."
"8시에 문 열고 정신없이 팔다가, 8시 반에 주방에 들어가 보니 노트가 없더라고요. 다 같이 주방을 뒤졌는데 안 나왔어요."
할머니는 목소리를 낮췄다. "길 건너에 한 달 전에 생긴 보리밭 베이커리 있잖아요. 거기서 쑥빵을 새로 낸다는 소문이 있어요. 설마 하는 마음이에요." 가게 앞에는 작은 CCTV가 하나 달려 있다고 한다.
#### `c1-02` 주방 작업대 살펴보기
스테인리스 작업대는 깨끗이 닦여 있다. 할머니가 늘 노트를 펴 두던 자리는 저울 옆이다. 바닥 타일 틈에 초록 가루가 조금 남아 있다. 쑥가루다. 하나 말로는 어제 7시 20분쯤 할머니가 쑥가루 통을 엎어서 대충 쓸어 놓고 진열하러 나갔다고 한다.
작업대 바로 옆에는 2층 창고로 올라가는 좁은 나무 계단이 있고, 맞은편 끝에는 뒷문이 있다. 앞쪽 가게로 통하는 문에는 구슬 발이 걸려 있어서, 가게에 있으면 주방 안이 잘 보이지 않는다.
- **깊이 보기**: 작업대 밑 휴지통에 꼭꼭 뭉친 종이 한 장이 있다. 펴 보니 구청 '우리 동네 빵 레시피북' 수록 동의서다. 신청자 칸에 '달빛제과 / 담당 강민재'. 서명란은 비어 있다.
#### `c1-03` 아르바이트생 윤하나 이야기 듣기
하나는 앞치마 끈을 만지작거리며 말했다. "저는 6시에 뒷문으로 들어와요. 번호 키를 알거든요. 7시에 문태식 사장님이 밀가루 열 포대를 들여 주셨고, 7시 15분쯤 '수고하셨습니다' 하고 보내 드렸어요. 사장님은 늘 들고 다니는 파란 공책에 뭘 적으시더라고요."
"7시 20분부터 40분까지는 할머니랑 가게 앞에서 진열했어요. 그때 뒷문 종이 '딸랑' 하고 한 번 울렸어요. 25분쯤이요. 근데 아무도 인사를 안 해서 바람인가 했죠. 민재 오빠는 35분쯤에야 주방에서 '늦어서 죄송해요!' 하고 나왔어요."
"노트가 없어진 걸 알고 다 같이 찾을 때, 민재 오빠가 '2층은 내가 볼게' 하고 올라갔다가 없다고 했어요."
잠깐 머뭇거리던 하나가 덧붙였다. "지난주에 민재 오빠랑 할머니가 대회 일로 크게 다퉜어요. 무슨 얘긴지는 잘 몰라요."
#### `c1-04` 손자 강민재 이야기 듣기
민재는 팔짱을 끼고 말했다. "어제 늦잠을 잤어요. 7시 반쯤 공영주차장에 차를 대고 바로 뒷문으로 들어왔죠. 노트요? 할머니가 어디 두고 깜빡하셨을 거예요. 요즘 자주 깜빡하시거든요."
보리밭 얘기를 꺼내자 민재는 고개를 끄덕였다. "거기 사장님이 어제 아침에도 우리 가게 앞을 기웃거렸다던데요. 냄새가 나요."
대회에 대해 묻자 잠깐 말이 끊겼다. "신청은 제가 했어요. 할머니가 나가고 싶어 하셔서요. …근데 꼭 쑥 단팥빵이어야 하나 싶긴 해요."
- **깊이 보기**: 민재의 운동화 바닥은 굵은 지그재그 무늬다. 홈 사이에 초록 가루가 아주 조금 끼어 있다. "빵집에서 일하면 가루야 늘 묻죠." 민재가 발을 뒤로 뺐다.
#### `c1-05` 납품업자 문태식 만나기
밀가루 포대가 천장까지 쌓인 창고. 문태식 사장은 파란 공책을 펼쳐 보였다. 배달 장부다.
"어제도 7시 정각에 달빛제과에 열 포대 넣었어요. 뒷문으로 들어가서 창고 칸에 쌓고, 7시 15분 전에 나왔어요. 다음이 성산동 떡집이라 바빠요. 노트요? 작업대 위에 뭐가 있었던 것 같긴 한데, 남의 물건엔 손 안 대요. 트럭에 블랙박스가 있으니 보고 싶으면 보세요."
장부의 월요일 칸에는 '달빛 밀가루 10포 07:00', '고소한떡집 쌀가루 6포 07:25'라고 적혀 있다.
#### `c1-06` 가게 앞 CCTV 보기
가게 앞 CCTV는 정문과 진열대 쪽만 비춘다. 뒷문은 보이지 않는다.
- 05:28 할머니가 정문 셔터를 반쯤 올리고 들어간다. 정문은 다시 안에서 잠긴다.
- 07:21 할머니와 하나가 진열대에 빵을 놓기 시작한다. 둘은 7시 40분까지 화면에서 거의 벗어나지 않는다.
- 07:39~07:42 회색 점퍼를 입은 남자가 길 건너에서 와서 메뉴판을 한참 보다가 길 건너로 돌아간다. 문에는 손을 대지 않는다.
- 08:00 정문이 열리고 손님들이 들어온다.
8시 전에 정문으로 들어간 사람은 할머니 말고는 없다.
#### `c1-07` 관리실 입출차 기록 보기
공영주차장은 달빛제과 뒷골목과 바로 붙어 있다. 관리인 노병철 씨가 모니터를 돌려 보여 주었다.
"번호판 찍히는 기계라 정확해요. 그 하얀 경차 말이죠? 월요일 06시 50분 입차, 그날 밤 21시 10분 출차."
노 씨가 덧붙였다. "그 청년, 들어와서 한참 차에 앉아 있더라고요. 7시 20분 넘어서야 내려서 빵집 쪽으로 갔어요. 매일 보는 얼굴이라 기억나요."
#### `c1-08` 백승호 사장 만나기
보리밭 베이커리는 달빛제과 맞은편이다. 회색 점퍼 차림의 백승호 사장이 반죽을 치대다 손을 닦았다.
"네, 어제 아침 7시 40분쯤 달빛제과 앞에 갔어요. 메뉴판 보러요. 솔직히 배우고 싶어서요. 40년 된 가게잖아요."
"쑥빵 흉내요? 저희 쑥 크림빵은 2주 전에 이미 예고했어요. 가게 SNS 보시면 있어요. 크림을 넣은 빵이라 단팥빵이랑은 전혀 달라요. 저는 메뉴판만 보고 바로 돌아왔어요. 우리 가게 CCTV에 다 찍혀 있을 거예요."
#### `c1-09` 뒷문과 종 살펴보기
뒷문은 공영주차장 쪽 골목으로 나 있다. 문 위에 작은 놋쇠 종이 달려 있어서, 문을 열면 '딸랑' 하고 한 번 울린다. 닫힐 때는 소리가 나지 않는다.
문은 안에서는 그냥 열리고, 밖에서는 번호 키로 연다. 번호를 아는 사람은 할머니, 민재, 하나 셋뿐이다. 문태식 사장이 올 때는 하나가 안에서 열어 준다.
뒷문에서 2층 계단까지는 다섯 걸음이다.
#### `c1-10` 문태식의 다음 배달처에 전화하기
성산동 '고소한 떡집'에 전화를 걸었다. 사장님이 장부를 찾아 읽어 주었다.
"월요일 7시 25분에 쌀가루 여섯 포대 받았어요. 문 사장님은 늘 그 시간이에요. 받았다고 사인도 했고요."
달빛제과에서 떡집까지는 차로 10분쯤 걸린다.
#### `c1-11` 2층 창고 둘러보기
2층 창고에는 설탕 포대와 포장 상자가 쌓여 있다. 하나 말로는 할머니는 무릎이 아파서 2층에 거의 올라오지 않는다.
구석에 새 상자 묶음이 있다. 옆면에 '마포 동네빵 한마당 · 대회용 리본 상자'. 맨 위 상자의 송장 받는 사람은 '강민재'다.
리본 상자 하나를 열어 보니, 리본 뭉치 밑에 쑥색 천 표지 공책이 숨겨져 있다. 레시피 노트다! 마지막 장에는 할머니 글씨로 '쑥 단팥빵 개량 — 쑥 12g→15g, 앙금 단맛 줄이기' 같은 메모가 있고, 모서리에 초록 가루가 묻어 있다.
#### `c1-12` 계단의 초록 발자국 살펴보기
나무 계단 첫째·둘째 칸에 초록 쑥가루가 묻은 신발 자국이 희미하게 남아 있다. 발끝이 위를 향한다. 누군가 쏟아진 쑥가루를 밟고 2층으로 올라갔다는 뜻이다.
자국 바닥 무늬는 굵은 지그재그 줄이다. 할머니는 고무 장화(바닥이 매끈한 동그라미 무늬), 하나는 주방용 고무 슬리퍼(작은 점무늬)를 신는다. 둘 다 지그재그는 아니다.
쑥가루가 쏟아진 건 7시 20분쯤. 그러니 이 자국은 그 뒤에 생겼다.
#### `c1-13` 세탁소 정미란 사장 이야기 듣기
보리밭 베이커리 바로 옆 모퉁이 세탁소. 정미란 사장은 아침마다 가게 앞을 쓸며 골목을 본다. 여기서는 달빛제과 정문과 뒷골목 어귀가 함께 보인다.
"회색 점퍼? 보리밭 사장님이죠. 어제 아침 달빛 앞에 가서 메뉴판만 보고 금방 돌아오던데. 길만 건넜다 왔어요. 뒷골목 쪽으로는 안 갔어."
"참, 그보다 조금 전에 달빛 손자 청년이 주차장 쪽에서 뒷골목으로 들어가는 걸 봤어요. 휴대폰만 보면서요. 7시 20분은 넘었을 거야. 보리밭 사장님 오기 전이었으니까."
#### `c1-14` 보리밭 가게 CCTV 보기
보리밭 베이커리 안팎 CCTV를 같이 보았다.
- 07:38 백승호 사장이 가게 문을 나선다.
- 07:43 가게로 돌아온다. 손에는 아무것도 없다.
- 07:43~09:00 계속 주방에서 반죽하고 굽는다. 밖으로 나가지 않는다.
주방 벽 칠판에는 '쑥 크림빵: 쑥 페이스트 + 생크림'이라는 메모가 보인다.
#### `c1-15` 보리밭 베이커리 SNS 글 찾아보기
보리밭 베이커리 SNS를 찾아보았다. 2주 전 글: "가을 신메뉴 예고! 국산 쑥 페이스트와 생크림을 듬뿍 넣은 쑥 크림빵, 다음 달 나옵니다." 사진 속 빵은 크림이 흘러나오는 폭신한 빵이다.
월요일 뒤로 새 글은 없다. "달빛제과 쑥 단팥빵이랑 비슷한가요?"라는 댓글에 사장이 "전혀 다른 빵이에요. 달빛제과 빵은 저도 팬입니다"라고 답해 두었다.
#### `c1-16` 구청 대회 담당자에게 전화하기
'마포 동네빵 한마당' 담당 서지원 주무관이 친절하게 알려 주었다.
"본선 메뉴는 목요일 정오까지 레시피를 내셔야 해요. 본선에 오른 빵 레시피는 구청 '우리 동네 빵 레시피북'에 실려서 누구나 볼 수 있게 돼요. 동네 빵을 나누자는 뜻이거든요."
"달빛제과요? 신청 담당자는 강민재 씨예요. 아, 그분이 지난 금요일에 전화하셨어요. 레시피는 안 내고 참가만 할 수는 없냐고요. 안 된다고 말씀드렸죠."
#### `c1-17` 할머니에게 지난주 일 묻기
할머니는 한숨을 쉬었다. "지난주에 민재가 '그 레시피는 우리 집 보물인데 왜 책에 실어서 남한테 다 줘요' 하더라고요. 나는 '좋은 빵은 나눌수록 더 맛있어진다'고 했지. 그 뒤로 둘이 말을 잘 안 했어요."
"새로 고친 분량은 노트에만 있어요. 노트가 없으면 목요일까지 레시피를 못 내니, 대회는 못 나가는 거죠."
할머니는 잠시 말이 없다가 물었다. "설마… 우리 민재가?"
#### `c1-18` 트럭 블랙박스 영상 보기
문태식 사장 트럭의 블랙박스 영상. 트럭은 공영주차장 옆 골목에 서 있었다.
- 06:58 달빛제과 뒷골목 도착.
- 07:00~07:13 밀가루를 나르는 모습이 앞 유리 너머로 보인다.
- 07:14 출발. 07:24 고소한 떡집 앞 도착.
- **깊이 보기**: 07:05 화면을 크게 키우니, 주차장 안쪽에 하얀 경차 한 대가 서 있다. 운전석에 누군가 앉아 휴대폰 불빛을 보고 있다.
### 1.6 아침 소식
- 2일째(수요일) 아침: 하나에게서 문자가 왔다. "어제 저녁에 민재 오빠가 할머니한테 '노트 없으면 그냥 대회 나가지 말자'고 했대요. 할머니가 많이 서운해하세요."
### 1.7 조언 (쓸 때마다 −2점)
1. 노트는 7시 20분까지 작업대 위에 있었어요. 그 뒤에 주방에 들어갈 수 있었던 사람을 따져 보세요.
2. 뒷문 종은 문을 열 때만 울려요. 밖에서 뒷문을 열 수 있는 사람은 셋뿐이에요.
3. 주차장 기록과 본인 말을 비교해 보세요. 그리고 2층 창고를 확인해 보세요.
### 1.8 보고서 문제
| id | 문제 | 보기 | 정답 | 점수 |
|---|---|---|---|---|
| `q1` (범인) | 레시피 노트를 가져간 사람은? | ① 강민재 ② 윤하나 ③ 문태식 ④ 백승호 ⑤ 아무도 안 가져갔다(할머니가 잃어버렸다) | ① | 10 |
| `q2` | 노트는 지금 어디에 있나? | ① 민재의 차 ② 2층 창고의 대회용 리본 상자 ③ 보리밭 베이커리 ④ 문태식의 트럭 ⑤ 주방 휴지통 | ② | 6 |
| `q3` | 왜 가져갔나? | ① 경쟁 빵집에 팔려고 ② 자기 이름으로 대회에 내려고 ③ 레시피가 책에 실려 공개되는 것을 막으려고 ④ 할머니를 골탕 먹이려고 | ③ | 6 |
| `q4` | 민재의 차가 실제로 주차장에 들어온 시각은? | ① 06:50 ② 07:25 ③ 07:30 ④ 07:35 | ① | 3 |
| `q5` | 문태식 사장이 범인이 아닌 가장 확실한 까닭은? | ① 파란 공책을 들고 있었다 ② 7시 14분에 떠났는데 노트는 7시 20분에도 작업대에 있었다 ③ 정문 CCTV에 찍히지 않았다 ④ 보리밭 사장과 사이가 나쁘다 | ② | 3 |
### 1.9 정답과 풀이 (끝난 뒤 공개)
범인은 손자 **강민재**. 노트는 **2층 창고의 대회용 리본 상자** 안에 있다.
- 노트는 7시 20분에 작업대 위에 있었다(`c1-01`). 7시 20분부터 40분까지 할머니와 하나는 가게 앞에서 진열했고 CCTV에 계속 찍혔다(`c1-06`). 그동안 주방은 비어 있었다.
- 7시 25분쯤 뒷문 종이 한 번 울렸다(`c1-03`). 종은 문을 열 때만 울리고, 밖에서 뒷문을 열 수 있는 사람은 할머니·민재·하나뿐이다(`c1-09`). 할머니와 하나는 가게 앞에 있었으니 남는 사람은 민재다.
- 민재는 "7시 반쯤 주차하고 바로 들어왔다"고 했지만(`c1-04`) 차는 6시 50분에 들어왔고, 7시 20분 넘어서야 차에서 내려 뒷골목으로 갔다(`c1-07`, `c1-13`, `c1-18` 깊이 보기). 종이 울린 뒤 10분이 지나서야 인사했다.
- 쑥가루는 7시 20분에 쏟아졌는데, 그 뒤 누군가 그 가루를 밟고 2층으로 올라갔다. 자국은 지그재그 무늬로 할머니·하나의 신발이 아니고(`c1-12`) 민재의 운동화와 같다(`c1-04` 깊이 보기). 노트를 찾을 때 "2층은 내가 볼게" 한 사람도 민재다(`c1-03`).
- 노트가 숨겨진 리본 상자는 민재 이름으로 온 대회용 상자다(`c1-11`).
- 까닭: 대회 본선 레시피는 구청 책에 실려 공개된다(`c1-16`). 민재는 "우리 집 보물"을 공개하기 싫었고(`c1-17`), 구청에 "레시피 없이 참가만" 되는지 물었다가 거절당했다. 새로 고친 분량은 노트에만 있으니, 노트가 없으면 할머니가 목요일까지 레시피를 못 낸다. 그래서 노트를 숨겼다.
- 헛다리 ①: 백승호 사장은 정문 앞 메뉴판만 보고 5분 만에 돌아갔다. 정문은 8시 전까지 잠겨 있었고 뒷골목으로 가지 않았다(`c1-06`, `c1-13`, `c1-14`). 쑥 크림빵은 2주 전에 예고된 다른 빵이다(`c1-15`).
- 헛다리 ②: 문태식 사장의 파란 공책은 배달 장부다. 7시 14분에 떠나 7시 24~25분에 떡집에 있었다(`c1-05`, `c1-10`, `c1-18`). 노트는 그 뒤인 7시 20분에도 작업대에 있었다.
- 마무리: 민재는 노트를 할머니께 돌려드리고 사과했다. 할머니는 "레시피는 책에 실려도 달빛제과 빵 맛은 우리 손에 있다"며 민재와 함께 대회에 나가기로 했다.
### 1.10 앞뒤 맞추기 점검표
| 시각(월요일) | 일 | 근거 단서 |
|---|---|---|
| 05:28~05:30 | 할머니 정문으로 들어와 다시 잠금, 노트를 작업대에 폄 | 01, 06 |
| 06:00 | 하나 뒷문으로 출근(번호 키) | 03, 09 |
| 06:50 | 민재 차 주차장 입차, 차 안에 앉아 있음 | 07, 18 깊이 |
| 06:58~07:14 | 문태식 트럭 도착·배달·출발 | 05, 18 |
| 07:15 | 하나가 문태식을 배웅 | 03 |
| 07:20 | 할머니 노트 확인, 쑥가루 쏟음, 진열하러 나감 | 01, 02 |
| 07:20 넘어 | 민재 차에서 내려 뒷골목으로 | 07, 13 |
| 07:21~07:40 | 할머니·하나 가게 앞 진열(CCTV) | 06 |
| 07:24~07:25 | 문태식 떡집 도착·사인 | 10, 18 |
| 07:25 | 뒷문 종 한 번(민재 들어옴) → 노트 들고 2층, 리본 상자에 숨김 | 03, 09, 11, 12 |
| 07:35 | 민재 주방에서 "늦어서 죄송해요" | 03 |
| 07:38~07:43 | 백승호 나갔다 돌아옴(메뉴판 07:39~07:42) | 06, 14 |
| 08:00 | 개점 | 06 |
| 08:30 | 노트 없어진 것 발견, 민재 "2층은 내가 볼게" | 01, 03 |
- [x] 하나는 7:20~7:40 CCTV에 있고 2층 자국은 하나 슬리퍼가 아님 → 하나 제외.
- [x] 할머니 자작극 제외: 2층에 거의 안 올라가고, 자국이 할머니 장화가 아님, 노트는 민재 상자 속.
- [x] 7:40~8:30 사이에 누군가 가져갔을 가능성: 쑥가루 자국(7:20 이후, 위로 향함)과 숨긴 곳이 민재로 이어지고, 7:25 종소리와 거짓 도착 시각이 함께 가리킨다. 다른 사람은 이 셋을 설명하지 못한다.
- [x] 정답에 꼭 필요한 단서가 모두 처음 단서에서 닿는다: 03 → 09·11, 04 → 07, 02 → 12, 16 → 17.
- [x] 빠듯하게(하루 6시간)로도 가능한 길: 1일 이동1 + 03·04·07·09·11(5) = 6, 2일 사무소 16(1) + 이동1 + 17(1) + 02(1) = 4.
---
## 사건 2. 한별고 과학 축제, 멈춰 버린 다람이 (`c2`)
> 난이도 보통 · 2일 · 단서 20개(합계 22시간) · 문제 6개 · 만점 30점 · 해결 기준 18점(범인 문제 정답 필수) · S 27점 / A 23점
### 2.1 의뢰 (briefing)
토요일 아침 9시. 한별고등학교 로봇부 지도교사 한지성 선생님에게서 다급한 전화가 왔다.
"과학 축제 로봇 축구 교내 선발전 결승이 내일 오후 2시예요. 다람이 팀 로봇이 오늘 아침 점검 때 꼼짝도 안 해요. 열어 보니 모터 제어 보드가 타 버린 다른 보드로 바뀌어 있어요. 누가 일부러 바꿔치기한 것 같아요. 결승 전까지 진짜 보드를 찾아 주세요."
- 알려진 것: 다람이는 어제(금요일) 저녁까지 잘 움직였다. 로봇부실은 3층에 있고 출입 카드로만 열린다.
### 2.2 구역·장소·이동
| 구역 | 장소(id) |
|---|---|
| 사무소 `office` | 해오름 탐정사무소 `office` |
| 한별고 `school` | 3층 로봇부실 `lab`, 경비실 `guard`, 강당 `hall` |
| 전자 부품 상가 `market` | 별빛 부품 가게 `shop` |
이동 시간: 사무소–한별고 1, 사무소–부품 상가 1, 한별고–부품 상가 2. 같은 구역 안은 0.
### 2.3 인물
| id | 이름 | 한 줄 | 처음 알려 주는 단서 |
|---|---|---|---|
| `han` | 한지성 (39) | 과학 선생님, 로봇부 지도교사 | 의뢰 |
| `serin` | 오세린 (3학년) | 다람이 팀장, 제어 담당. 키가 크다. 올해 조종수 | 의뢰 |
| `dohyun` | 권도현 (2학년) | 다람이 팀 기계 담당. 농구 선수처럼 키가 크다. 작년 조종수 | `c2-03`, `c2-04` |
| `sua` | 이수아 (1학년) | 다람이 팀 막내. 단발머리, 키가 작은 편. 아직 출입 카드가 없다 | `c2-03` |
| `chan` | 남궁찬 (3학년) | 철벽 팀장. 키가 훤칠하다 | `c2-01`, `c2-04` |
| `jihye` | 문지혜 (2학년) | 철벽 팀 부품 담당, 축제 소품 도우미. 체구가 작고 긴 머리를 하나로 묶는다 | `c2-06` |
| `park` | 박만수 (63) | 야간 경비원. 키가 큰 어르신, 형광 조끼 | `c2-04` |
| `daeun` | 염다은 (3학년) | 학생회장, 축제 준비 총괄 | `c2-06` |
### 2.4 단서 목록
| id | 장소 | 제목 | 시간 | 열리는 조건 |
|---|---|---|---|---|
| `c2-01` | 로봇부실 | 한지성 선생님 이야기 듣기 | 1 | 처음부터 |
| `c2-02` | 로봇부실 | 멈춘 다람이와 타 버린 보드 살펴보기 | 1 | 처음부터 |
| `c2-03` | 로봇부실 | 팀장 오세린 이야기 듣기 | 1 | 처음부터 |
| `c2-04` | 경비실 | 로봇부실 출입 카드 기록 뽑기 | 1 | 처음부터 |
| `c2-05` | 로봇부실 | 권도현 이야기 듣기 | 1 | `c2-03` 또는 `c2-04` |
| `c2-06` | 강당 | 철벽 팀장 남궁찬 이야기 듣기 | 1 | `c2-01` 또는 `c2-04` |
| `c2-07` | 경비실 | 경비원 박만수 이야기 듣기 | 1 | `c2-04` |
| `c2-08` | 경비실 | 3층 복도 CCTV 보기 | 2 | `c2-04` 또는 `c2-07` |
| `c2-09` | 사무소 | 세린의 시험 영상 파일 분석하기 | 1 | `c2-03` |
| `c2-10` | 로봇부실 | 부품 관리 장부 보기 | 1 | `c2-02` |
| `c2-11` | 강당 | 학생회장 염다은 이야기 듣기 | 1 | `c2-06` |
| `c2-12` | 강당 | 축제 준비 단체 사진 보기 | 1 | `c2-11` |
| `c2-13` | 로봇부실 | 막내 이수아 이야기 듣기 | 1 | `c2-03` 또는 `c2-11` |
| `c2-14` | 강당 | 철벽 팀 문지혜 이야기 듣기 | 1 | `c2-06` 또는 `c2-10` 또는 `c2-12` |
| `c2-15` | 경비실 | 정문 배달 확인증 보기 | 1 | `c2-07` |
| `c2-16` | 부품 상가 | 도현이 들른 부품 가게 찾아가기 | 2 | `c2-05` |
| `c2-17` | 강당 | 무대 뒤 소품 상자 살펴보기 | 1 | `c2-11` 또는 `c2-12` 또는 `c2-14` (또는 `c2-13` 깊이 보기) |
| `c2-18` | 경비실 | 마스터 카드 서랍 살펴보기 | 1 | `c2-07` |
| `c2-19` | 로봇부실 | 보드 바꾸는 데 걸리는 시간 재 보기 | 1 | `c2-01` 또는 `c2-02` |
| `c2-20` | 사무소 | 전국 대회 규정 찾아보기 | 1 | `c2-01` |
돋보기가 있는 단서: `c2-02`, `c2-08`, `c2-13`.
### 2.5 단서 본문
#### `c2-01` 한지성 선생님 이야기 듣기
한지성 선생님은 다람이를 내려다보며 말했다. "어제 저녁 7시에 제가 먼저 퇴근했어요. 그때 다람이 팀은 마지막 점검 중이었고, 철벽 팀은 6시 반에 연습을 끝내고 강당으로 축제 준비를 도우러 갔어요."
"로봇부실 문은 출입 카드로만 열려요. 밖에서 들어갈 땐 카드를 대야 하고, 나갈 땐 버튼만 누르면 돼요. 닫히면 저절로 잠기고요. 기록은 경비실 컴퓨터에 남아요."
"오늘 아침 7시 반에 와서 켜 보니 다람이가 꿈쩍도 안 했어요. 열어 보니 모터 제어 보드가 타 버린 걸로 바뀌어 있었어요. 결승은 다람이 대 철벽이에요. 이기는 팀이 학교 대표로 전국 대회에 나가요."
#### `c2-02` 멈춘 다람이와 타 버린 보드 살펴보기
다람이는 바퀴 넷 달린 축구 로봇이다. 덮개를 열자 탄 냄새가 났다. 가운데 꽂힌 모터 제어 보드(MC-2)는 전원 단자 옆이 까맣게 그을려 있다.
세린이 말했다. "우리 보드엔 제가 붙인 '다람이♥' 스티커가 있어요. 이건 없어요. 뒷면 일련번호도 끝이 47이에요. 우리 건 03이고요."
보드를 고정하는 나사 8개는 모두 단단히 조여 있고, 전선 커넥터 12개도 빈틈없이 꽂혀 있다. 서두른 솜씨가 아니다.
- **깊이 보기**: 보드 모서리에 매직으로 쓴 글씨를 지운 자국이 있다. 알아볼 수 있는 건 '철'로 시작하는 첫 글자뿐이다.
#### `c2-03` 팀장 오세린 이야기 듣기
키가 큰 세린은 눈이 빨갰다. "어제 7시 31분에 마지막 시험 영상을 찍었어요. 다람이가 공을 차서 골대에 넣는 것까지 완벽했어요. 7시 40분에 도현이, 수아랑 같이 나왔고 문이 잠기는 것도 봤어요."
"저는 8시부터 10시까지 학원에 있었어요. 도현이는요… 솔직히 올해 조종수를 제가 맡게 돼서 서운해했어요. 그래도 그럴 애는 아니에요."
"수아는 1학년이라 아직 출입 카드가 안 나왔어요. 늘 저희랑 같이 들어가요."
#### `c2-04` 로봇부실 출입 카드 기록 뽑기
경비실 컴퓨터에서 로봇부실 출입 기록을 뽑았다. 밖에서 카드를 대고 들어간 기록만 남는다.
| 때 | 카드 |
|---|---|
| 금 18:02 | 한지성 |
| 금 19:52 | 권도현 |
| 금 20:15 | 남궁찬 |
| 금 21:40 | 마스터 카드(경비실) |
| 토 07:30 | 한지성 |
마스터 카드는 경비실에 한 장뿐이고, 학교의 모든 문을 열 수 있다.
#### `c2-05` 권도현 이야기 듣기
농구 선수처럼 키가 큰 도현은 퉁명스러웠다. "7시 52분에 들어간 건 지갑 때문이에요. 책상에 두고 나왔거든요. 들어가서 집어 들고 바로 나왔어요. 3분도 안 걸렸어요."
"조종수 얘기 들으셨죠? 서운한 건 맞아요. 그래도 다람이는 제가 바퀴 하나하나 깎아서 만든 로봇이에요. 그걸 망가뜨릴 리가 없잖아요."
"어제 오후엔 선생님 심부름으로 부품 상가에 가서 예비 보드를 하나 사 왔어요. 아직 뜯지도 않았어요."
#### `c2-06` 철벽 팀장 남궁찬 이야기 듣기
철벽 팀장 남궁찬은 키가 훤칠하고 말이 빨랐다. "저 의심하시는 거 알아요. 8시 15분에 들어간 건 맞아요. 배터리 충전기를 두고 와서요. 가방에 넣고 바로 나왔어요."
"그다음엔 계속 강당에서 축제 무대를 꾸몄어요. 학생회장 다은이한테 물어보세요. 사진도 찍었어요."
"우리 팀 부품은 지혜가 관리해요. 지혜도 강당에서 소품 일을 도왔어요. 부품 담당이라 철벽 사물함 열쇠도 지혜한테 있고요."
#### `c2-07` 경비원 박만수 이야기 듣기
키가 큰 박만수 경비원은 형광 조끼를 입고 있다. "마스터 카드요? 그건 경비실 책상 서랍에 둬요. 나는 밤 10시 반이랑 새벽 1시에 3층을 돌아요. 9시 40분엔 3층에 간 적이 없어요."
"그 시간엔 정문에 있었어. 축제 물품 배달이 늦게 와서 기사님이랑 상자를 같이 날랐지. 경비실은 금방 올 거라 안 잠갔고."
"저녁 8시쯤엔 축제 도우미 학생이 떡을 갖다 줬어요. 키가 조그만 2학년 여학생이었는데, 이름은 모르겠네. 그때 내가 마스터 카드를 서랍에 넣는 걸 봤을 거요."
#### `c2-08` 3층 복도 CCTV 보기
3층 복도 끝 CCTV. 화질은 흐리지만 로봇부실 문과 소화기함(높이 150cm)이 보인다.
- 19:40 세 사람(큰 키 둘, 작은 키 하나)이 함께 나간다.
- 19:52 키 큰 남학생이 들어간다 → 19:55 나온다.
- 20:15 키 큰 남학생이 들어간다 → 20:22 나온다. 손에 검은 충전기.
- 21:40 회색 후드를 쓴 사람이 들어간다. 머리가 소화기함 위로 조금 나올 만큼 키가 작다 → 21:58 나온다. 손에 은색 봉투.
- 22:31 형광 조끼를 입은 키 큰 어른이 문손잡이를 흔들어 보고 지나간다.
- **깊이 보기**: 21:58 장면을 한 장씩 넘기니, 후드 아래로 하나로 묶은 긴 머리가 살짝 보인다. 봉투는 손바닥 두 개만 하고 반짝이는 은색이다. 전자 부품을 넣는 정전기 방지 봉투처럼 보인다.
#### `c2-09` 세린의 시험 영상 파일 분석하기
세린이 보내 준 영상 파일을 사무소에서 살펴보았다. 파일 기록: 금요일 19:31 촬영. 영상 속 다람이는 공을 몰고 가 골대에 넣는다.
덮개가 열린 채 찍힌 장면에서 보드에 붙은 '다람이♥' 스티커와 초록 불빛이 또렷이 보인다. 이때까지는 진짜 보드가 들어 있었다.
#### `c2-10` 부품 관리 장부 보기
로봇부 부품 장부는 공책 한 권이다. 끝 47번 보드를 찾으니 이렇게 적혀 있다.
'10월 2일 · 철벽 · MC-2 (일련번호 …47) · 연습 중 과열로 고장 · 철벽 팀 사물함에 보관 · 담당 문지혜'
다람이 팀 칸에는 '…03 다람이 사용 중', 그리고 어제 날짜로 '예비 MC-2 1개 구입(권도현, 선생님 확인)'.
철벽 팀 사물함은 로봇부실 안에 있고 자물쇠로 잠겨 있다. 열쇠는 부품 담당이 갖고 다닌다.
#### `c2-11` 학생회장 염다은 이야기 듣기
학생회장 다은은 축제 준비 명단을 보여 주었다. "어제 강당에는 학생회 셋(저 포함), 남궁찬, 문지혜, 이수아, 이렇게 여섯이 있었어요. 찬이는 8시 반쯤 와서 10시까지 무대 장식만 했어요. 제가 옆에서 같이 했으니 확실해요."
"9시 45분에 축제 홍보용으로 단체 사진을 찍었어요. 원본 보여 드릴까요?"
"지혜는 소품 담당이라 무대 뒤 소품 상자를 정리하느라 10시 넘어서까지 남았어요."
#### `c2-12` 축제 준비 단체 사진 보기
사진 파일 정보: 금요일 21:45. 무대 앞에 다섯 명이 브이를 하고 있다. 학생회장 다은과 학생회 두 명, 키가 큰 남궁찬, 단발머리의 작은 이수아.
명단의 여섯 명 가운데 문지혜만 없다.
사진 구석 의자에 가방 하나가 걸쳐 있다. 다은 말로는 지혜 가방이다.
#### `c2-13` 막내 이수아 이야기 듣기
단발머리의 수아는 작은 목소리로 말했다. "저는 7시 40분에 언니 오빠들이랑 나온 뒤로 계속 강당에서 도왔어요. 사진에도 있어요."
"지혜 언니는 9시 반쯤 '화장실 다녀올게' 하고 회색 후드를 쓰고 나갔어요. 10시 다 돼서 돌아왔는데 숨이 차 보였어요. 화장실은 강당 바로 옆인데…."
"지혜 언니가 작년 선발전에서 다람이한테 지고 엄청 울었던 게 생각나요."
- **깊이 보기**: 수아가 망설이다 덧붙였다. "돌아온 언니가 반짝이는 은색 봉투 같은 걸 무대 뒤 소품 상자에 넣는 걸 봤어요."
#### `c2-14` 철벽 팀 문지혜 이야기 듣기
체구가 작고 긴 머리를 하나로 묶은 지혜는 소품 목록을 끌어안고 있었다. "저는 어제 계속 강당에 있었어요. 화장실 잠깐 다녀온 것 말고는요."
"전국 대회요? …가고 싶죠. 그게 꿈이에요. 작년엔 다람이한테 져서 못 갔어요."
같이 철벽 사물함을 열어 보았다. 장부에 적힌 고장 보드(…47)는 없다. 지혜는 "어… 분명히 여기 있었는데요" 하며 얼굴이 하얘졌다.
#### `c2-15` 정문 배달 확인증 보기
경비실에 남은 배달 확인증. '축제 물품 12상자 · 금요일 21:38 수령 · 서명 박만수'.
확인증 아래 배달 기사가 남긴 메모: '경비 아저씨가 끝까지 같이 날라 주심. 21:57 출발.'
정문에서 3층 로봇부실까지는 걸어서 4분쯤 걸린다.
#### `c2-16` 도현이 들른 부품 가게 찾아가기
부품 가게 사장님이 장부를 넘겼다. "금요일 오후 4시, 한별고 학생이 MC-2 보드 하나 사 갔어요. 학교 이름으로 영수증을 끊어 달래서, 선생님께 전화로 확인까지 했어요. 그 보드 일련번호는 끝이 81이에요."
한지성 선생님께 전화로 물으니, 끝이 81인 보드는 로봇부실 예비 부품 상자에 봉인 스티커가 붙은 채 그대로 있다고 한다.
#### `c2-17` 무대 뒤 소품 상자 살펴보기
강당 무대 뒤, '소품 · 담당 문지혜'라고 적힌 큰 상자. 종이꽃과 리본 사이에서 손바닥 두 개만 한 은색 정전기 방지 봉투가 나왔다.
봉투 안에는 MC-2 보드 한 장. '다람이♥' 스티커가 붙어 있고, 뒷면 일련번호 끝은 03이다. 다람이의 진짜 보드다! 타거나 망가진 데는 없다.
세린이 보드를 꼭 쥐었다. "이거면 내일 결승에 나갈 수 있어요."
#### `c2-18` 마스터 카드 서랍 살펴보기
경비실 책상 서랍에는 잠금장치가 없다. 마스터 카드는 목걸이 줄에 달린 하얀 카드다.
박만수 씨가 말했다. "10시 25분에 순찰 가려고 꺼내는데, 카드가 줄째로 거꾸로 들어 있더라고. 나는 늘 줄을 위로 해서 넣는데, 이상하다 했지."
경비실 창문으로는 정문이 보이지만, 정문에서는 경비실 안이 잘 보이지 않는다.
#### `c2-19` 보드 바꾸는 데 걸리는 시간 재 보기
선생님과 세린이 똑같은 연습용 로봇으로 보드를 바꿔 보았다. 나사 8개를 풀고, 커넥터 12개를 뽑아 새 보드로 옮기고, 다시 조인다.
가장 빠른 세린도 14분 40초가 걸렸다. 선생님은 "아무리 빨라도 15분 안팎은 걸려요. 커넥터 자리를 하나라도 틀리면 바퀴가 거꾸로 돌거든요"라고 했다.
다람이 안의 커넥터는 모두 바른 자리에 꽂혀 있었다. 로봇을 잘 아는 사람이 차분히 바꿨다는 뜻이다.
#### `c2-20` 전국 대회 규정 찾아보기
청소년 로봇 축구 전국 대회 규정을 찾아보았다. '참가 신청은 학교당 1팀. 교내 선발전 우승 팀을 학교 대표로 한다.'
한별고 선발전 결승은 다람이 대 철벽. 다람이가 못 나가면 철벽이 기권승으로 대표가 된다.
### 2.6 아침 소식
- 2일째(일요일) 아침: 남궁찬에게서 문자가 왔다. "생각해 보니 이상해서요. 지혜가 금요일 저녁 8시쯤 경비실에 떡을 갖다 드리고 왔다고 했어요. 그게 무슨 상관인지는 모르겠지만요."
### 2.7 조언 (쓸 때마다 −2점)
1. 보드를 바꾸려면 시간이 얼마나 걸리는지 먼저 알아보세요.
2. 21시 40분의 마스터 카드는 정말 경비원 손에 있었을까요?
3. 그 시간에 강당에 없던 사람과, 타 버린 보드의 일련번호를 맞춰 보세요.
### 2.8 보고서 문제
| id | 문제 | 보기 | 정답 | 점수 |
|---|---|---|---|---|
| `q1` (범인) | 보드를 바꿔치기한 사람은? | ① 남궁찬 ② 권도현 ③ 박만수 ④ 문지혜 ⑤ 이수아 ⑥ 오세린 | ④ | 10 |
| `q2` | 바꿔치기한 때는? | ① 19:52 ② 20:15 ③ 21:40 ④ 토요일 07:30 | ③ | 5 |
| `q3` | 로봇부실 문을 어떻게 열었나? | ① 경비실에서 몰래 가져간 마스터 카드 ② 남궁찬에게 빌린 카드 ③ 문이 고장 나 있었다 ④ 선생님 카드 | ① | 5 |
| `q4` | 다람이의 진짜 보드는 지금 어디에 있나? | ① 철벽 로봇 안 ② 강당 무대 뒤 소품 상자 ③ 부품 가게 ④ 도현의 가방 | ② | 5 |
| `q5` | 다람이에 들어 있던 타 버린 보드는 어디서 왔나? | ① 도현이 산 새 보드 ② 다람이 팀 예비 부품 ③ 철벽 사물함에 있던 고장 보드(…47) ④ 인터넷에서 산 보드 | ③ | 3 |
| `q6` | 20시 15분에 들어간 남궁찬이 그때 보드를 바꿀 수 없었던 까닭은? | ① 철벽 팀장이라서 ② 7분 만에 나왔는데 바꾸는 데 15분은 걸린다 ③ 충전기를 들고 나왔다 ④ 키가 커서 | ② | 2 |
### 2.9 정답과 풀이
범인은 철벽 팀 **문지혜**. 금요일 **21시 40분**, 경비실 서랍의 **마스터 카드**로 들어가 철벽 사물함의 고장 보드(…47)와 다람이 보드를 바꿨고, 진짜 보드는 **강당 무대 뒤 소품 상자**에 숨겼다.
- 다람이는 19시 31분까지 진짜 보드로 움직였다(`c2-03`, `c2-09`). 그 뒤 들어간 기록은 19:52, 20:15, 21:40, 토 07:30뿐이다(`c2-04`).
- 보드를 바꾸는 데는 15분 안팎이 걸린다(`c2-19`). 도현은 3분(19:52~19:55), 남궁찬은 7분(20:15~20:22) 있었다(`c2-05`, `c2-06`, `c2-08`). 둘 다 시간이 모자란다. 18분 있었던 21:40뿐이다(`c2-08`).
- 21:40의 마스터 카드는 박만수 경비원 손에 없었다. 그는 21:38부터 21:57까지 정문에서 배달 상자를 날랐다(`c2-07`, `c2-15`). CCTV 속 사람도 키 큰 경비원이 아니라 키가 작고 회색 후드를 썼다(`c2-08`). 카드는 거꾸로 서랍에 돌아와 있었다(`c2-18`). 저녁 8시에 떡을 가져온 키 작은 2학년 여학생이 카드 둔 곳을 봤다(`c2-07`, 아침 소식).
- 키가 작은 사람은 지혜와 수아다. 21:45 사진에 수아는 있고 지혜만 없다(`c2-12`). 지혜는 9시 반쯤 회색 후드를 쓰고 나가 10시 다 돼서 돌아왔다(`c2-13`). 긴 머리를 하나로 묶은 것도 맞는다(`c2-08` 깊이 보기, `c2-14`).
- 타 버린 보드는 끝이 47인 철벽 고장 보드로, 지혜가 열쇠를 가진 철벽 사물함에 있던 것이다(`c2-02`, `c2-10`). 사물함에서 사라졌다(`c2-14`).
- 진짜 보드는 은색 봉투에 담겨 지혜 담당인 소품 상자에 있었다(`c2-17`, `c2-13` 깊이 보기).
- 까닭: 전국 대회는 학교당 한 팀이고, 다람이가 못 나가면 철벽이 대표가 된다(`c2-20`). 지혜는 작년에 다람이에게 져서 전국 대회에 못 갔다(`c2-13`, `c2-14`).
- 헛다리: 남궁찬(라이벌 팀장, 20:15 출입) — 7분뿐이었고 21:45 사진에도 있다. 권도현(조종수 일로 서운함, 금요일에 새 보드 구입) — 3분뿐이었고, 산 보드(…81)는 봉인된 채 예비 상자에 있다(`c2-16`). 박만수(마스터 카드) — 정문에 있었다.
- 마무리: 다람이는 진짜 보드를 되찾아 결승에 나갔다. 지혜는 선생님과 세린에게 사과했고, 로봇부는 내년부터 두 팀이 함께 전국 대회 연습을 하기로 했다.
### 2.10 앞뒤 맞추기 점검표
| 시각(금요일) | 일 | 근거 |
|---|---|---|
| 18:02 | 선생님 입장 | 04 |
| 18:30 | 철벽 팀 강당으로 | 01 |
| 19:00 | 선생님 퇴근 | 01 |
| 19:31 | 시험 영상(진짜 보드) | 03, 09 |
| 19:40 | 세린·도현·수아 함께 나감 | 03, 08 |
| 19:52~19:55 | 도현 지갑 | 04, 05, 08 |
| 20:00쯤 | 지혜 경비실에 떡, 카드 둔 곳 봄 | 07, 아침 소식 |
| 20:15~20:22 | 남궁찬 충전기 | 04, 06, 08 |
| 20:30~22:00 | 남궁찬 강당 무대 장식 | 06, 11 |
| 21:30 | 지혜 회색 후드 쓰고 강당을 나감 | 13 |
| 21:35쯤 | 지혜 빈 경비실에서 마스터 카드 가져감 | 07, 18 |
| 21:38~21:57 | 박만수 정문 배달 | 15 |
| 21:40~21:58 | 마스터 카드로 입장, 보드 바꿈(18분) | 04, 08 |
| 21:45 | 강당 단체 사진(지혜 없음) | 12 |
| 22:00쯤 | 지혜 강당 복귀(가는 길에 카드 서랍에 거꾸로 넣음), 은색 봉투를 소품 상자에 | 13 깊이, 17, 18 |
| 22:25 | 박만수 카드 꺼냄, 거꾸로 들어 있음 | 18 |
| 22:31 | 박만수 3층 순찰 | 08 |
| 토 07:30 | 선생님 점검, 고장 발견 | 01, 04 |
- [x] 세린: 키가 크고 학원(20~22시), 자기 팀 로봇. 수아: 사진에 있음, 단발. 도현·남궁찬: 시간 모자람, 키 큼. 박만수: 정문. 남는 사람은 지혜 하나.
- [x] 선생님(토 07:30)은 보기에 없다. 그래도 고장 보드가 철벽 사물함에서 나왔고 진짜 보드가 지혜의 소품 상자에 있으니 풀이와 어긋나지 않는다.
- [x] 정답에 꼭 필요한 단서는 처음 단서에서 닿는다: 04 → 07 → 15·18, 01 → 19·06 → 11 → 12·13 → 14·17, 02 → 10.
- [x] 빠듯하게(하루 6시간): 1일 이동1 + 04·07·15·19·11 = 6, 2일 이동1 + 12·13·14·17·02 = 6(…47 보드는 02와 14로 알 수 있다).
---
## 사건 3. 솔바람채의 바뀐 달항아리 (`c3`)
> 난이도 어려움 · 3일 · 단서 24개(합계 25시간) · 문제 7개 · 만점 34점 · 해결 기준 22점(범인 문제 정답 필수) · S 31점 / A 26점
### 3.1 의뢰 (briefing)
목요일 오후. 북촌 한옥 게스트하우스 '솔바람채'의 주인 차영숙 씨가 사무소를 찾아왔다.
돌아가신 남편, 도예가 지석현이 1998년에 빚은 달항아리 '보름'. 다음 주 구립 미술관 '서울의 달' 전시에 빌려주기로 했는데, 오늘 오전 학예사가 살펴보더니 "이건 진짜가 아니에요"라고 했다.
"언제 바뀌었는지도 모르겠어요. 2주 전 일요일에 닦을 때는 분명히 우리 그이 항아리였는데…."
전시 준비는 다음 주 월요일에 끝난다. 금·토·일 사흘 안에 진짜 '보름'을 찾아야 한다.
### 3.2 구역·장소·이동
| 구역 | 장소(id) |
|---|---|
| 사무소 `office` | 해오름 탐정사무소 `office` |
| 북촌 `bukchon` | 솔바람채 `inn`, 구립 도서관 `library` |
| 인사동 `insadong` | 구립 미술관 `museum`, 고운 화랑 `gallery` |
| 이천 `icheon` | 흙빛 공방 `studio` |
| 판교 `pangyo` | 은호의 회사 `office2` |
| 이동 시간 | 사무소 | 북촌 | 인사동 | 이천 | 판교 |
|---|---|---|---|---|---|
| 사무소 | – | 1 | 1 | 2 | 2 |
| 북촌 | 1 | – | 1 | 2 | 2 |
| 인사동 | 1 | 1 | – | 2 | 2 |
| 이천 | 2 | 2 | 2 | – | 1 |
| 판교 | 2 | 2 | 2 | 1 | – |
### 3.3 인물
| id | 이름 | 한 줄 | 처음 알려 주는 단서 |
|---|---|---|---|
| `cha` | 차영숙 (68) | 솔바람채 주인. 도예가 지석현의 아내 | 의뢰 |
| `jee` | 지석현 (돌아가심) | 도예가. 모든 작품 바닥에 '석' 자 도장을 찍었다 | 의뢰 |
| `eunho` | 지은호 (41) | 영숙의 아들. 판교 회사원. 항아리를 팔자고 했다 | `c3-01` |
| `haneul` | 마하늘 (29) | 솔바람채 매니저. 도자기 전공, 주말마다 이천 공방 수업 | 의뢰 |
| `jungwoo` | 한정우 (52) | 별채 3호 장기 투숙객(3주째). 자칭 여행 작가. 왼손에 붕대 | `c3-01`, `c3-04` |
| `yukyung` | 유경 (46) | 이천 '흙빛 공방' 대표 | `c3-03`, `c3-04` |
| `eunseo` | 백은서 (35) | 구립 미술관 학예사 | 의뢰 |
| `yeom` | 염태호 (50) | 수요일 정전 공사를 맡은 전기 기사 | `c3-08` |
| `seojm` | 서정민 (58) | 인사동 고운 화랑 대표 | `c3-18` |
| `moonch` | 문 회장 | 은호가 소개받은 수집가 | `c3-01` |
### 3.4 단서 목록
| id | 장소 | 제목 | 시간 | 열리는 조건 |
|---|---|---|---|---|
| `c3-01` | 솔바람채 | 차영숙 이야기 듣기 | 1 | 처음부터 |
| `c3-02` | 솔바람채 | 사랑채 진열장과 가짜 항아리 살펴보기 | 1 | 처음부터 |
| `c3-03` | 구립 미술관 | 학예사 백은서의 감정 메모 듣기 | 1 | 처음부터 |
| `c3-04` | 솔바람채 | 매니저 마하늘 이야기 듣기 | 1 | 처음부터 |
| `c3-05` | 솔바람채 | 투숙객 한정우 이야기 듣기 | 1 | `c3-01` 또는 `c3-04` |
| `c3-06` | 은호의 회사 | 아들 지은호 만나기 | 1 | `c3-01` |
| `c3-07` | 솔바람채 | 마당 CCTV 기록 보기 | 2 | `c3-01` 또는 `c3-04` |
| `c3-08` | 솔바람채 | 정전 공사 안내문 보기 | 1 | `c3-04` 또는 `c3-07` |
| `c3-09` | 사무소 | 전기 기사 염태호와 통화하기 | 1 | `c3-08` |
| `c3-10` | 흙빛 공방 | 공방 대표 유경 만나기 | 1 | `c3-03` 또는 `c3-04` |
| `c3-11` | 흙빛 공방 | 주문 장부와 의뢰 사진 보기 | 1 | `c3-10` |
| `c3-12` | 솔바람채 | 숙박 장부 보기 | 1 | `c3-05` 또는 `c3-11` |
| `c3-13` | 구립 도서관 | 도서관 출입 기록 보기 | 1 | `c3-05` |
| `c3-14` | 솔바람채 | 하늘의 은행·우체국 영수증 보기 | 1 | `c3-04` |
| `c3-15` | 은호의 회사 | 회사 출입 기록과 회의록 보기 | 1 | `c3-06` |
| `c3-16` | 솔바람채 | 리셉션 서랍과 진열장 열쇠 보기 | 1 | `c3-02` 또는 `c3-04` |
| `c3-17` | 솔바람채 | 별채 3호 앞 살펴보기 | 1 | `c3-05` 또는 `c3-07` |
| `c3-18` | 솔바람채 | 퀵서비스 영수증 보기 | 1 | `c3-07` |
| `c3-19` | 고운 화랑 | 화랑 대표 서정민 만나기 | 1 | `c3-18` |
| `c3-20` | 고운 화랑 | 화랑 보관실의 항아리 확인하기 | 1 | `c3-19` |
| `c3-21` | 사무소 | 수집가 문 회장과 통화하기 | 1 | `c3-06` |
| `c3-22` | 솔바람채 | 영숙에게 수요일 일정과 보험 묻기 | 1 | `c3-03` |
| `c3-23` | 솔바람채 | '석' 도장을 아는 사람 묻기 | 1 | `c3-02` 또는 `c3-03` |
| `c3-24` | 사무소 | '한정우'라는 이름 찾아보기 | 1 | `c3-05` |
돋보기가 있는 단서: `c3-02`, `c3-07`, `c3-11`, `c3-17`.
### 3.5 단서 본문
#### `c3-01` 차영숙 이야기 듣기
영숙 씨는 사랑채 마루에 앉아 진열장을 바라보았다. "보름은 사랑채 유리 진열장에 늘 있어요. 진열장 열쇠는 리셉션 서랍에 있고, 저랑 하늘이가 써요."
"2주 전 일요일에 꺼내서 닦았어요. 그때 바닥을 만져 봤지. 그이가 늘 찍던 '석' 자 도장이 있었어요."
"아들 은호는 팔자고 졸랐어요. 문 회장이라는 수집가가 큰돈을 주겠다고 했대요. 나는 절대 안 판다고 했고요. 화요일 밤에도 와서 한바탕 했어요."
"지금 손님은 별채 3호의 한정우 선생 한 분이에요. 3주째 묵고 계신 여행 작가래요."
#### `c3-02` 사랑채 진열장과 가짜 항아리 살펴보기
유리 진열장은 사람 키만 하다. 옆에 작은 안내판이 있다. '달항아리 보름 · 지석현 · 1998 · 높이 41.5cm, 몸통 지름 40cm'.
진열장 안의 항아리는 얼핏 보면 똑같다. 둥글고 넉넉한 몸, 우윳빛 유약. 진열장 바닥은 나무 받침이라 유리 너머로는 항아리 밑이 보이지 않는다.
자물쇠에는 억지로 연 흔적이 없다. 열쇠로 열었다는 뜻이다.
- **깊이 보기**: 진열장 유리 바깥쪽에 카메라 렌즈를 바짝 댄 듯한 동그란 자국이 여러 개 남아 있다. 높이도 방향도 제각각이다. 누군가 유리 너머로 항아리를 여러 각도에서 찍었다.
#### `c3-03` 학예사 백은서의 감정 메모 듣기
백은서 학예사는 감정 메모를 펼쳤다. "첫째, 바닥 굽 안쪽에 지석현 선생의 '석' 도장이 없어요. 선생은 모든 작품에 찍었어요. 둘째, 유약이 너무 고르게 발렸어요. 셋째, 진품 기록보다 1.2kg 가벼워요."
"굽 옆에 아주 작게 '흙' 자가 새겨져 있었어요. 공방에서 자기네가 만들었다고 남기는 표시예요. 이천에서 '흙' 자를 쓰는 곳은 흙빛 공방이에요. 숨길 생각이 없는 정직한 표시죠. 만든 사람은 이게 바꿔치기에 쓰일 줄 몰랐을 거예요."
"아, 대여 보험은 감정이 끝나야 시작돼요. 지금 없어져도 보험금은 한 푼도 안 나와요."
#### `c3-04` 매니저 마하늘 이야기 듣기
매니저 하늘은 리셉션 정리를 하다 말고 앉았다. "저는 대학에서 도자기를 전공했어요. 그래서 저부터 의심하실 줄 알았어요." 손톱 밑에 흙이 조금 끼어 있다.
"주말마다 이천 흙빛 공방에서 수업을 들어요. 리셉션에 공방 안내지도 놓아 뒀어요. 한 선생님도 하나 가져가셨고요."
"보름은 한 달에 한 번 제가 닦아요. 바닥 '석' 도장도 알아요. 진열장 열쇠는 리셉션 서랍에 있는데, 제가 서랍을 잘 안 잠가요. 이제 보니 큰일이네요."
"수요일요? 2시부터 4시까지 전기 공사로 정전이라 CCTV도 꺼졌어요. 저는 그 틈에 은행이랑 우체국 일을 보러 나갔어요. 사장님은 병원에 가셨고요."
#### `c3-05` 투숙객 한정우 이야기 듣기
별채 3호의 한정우는 단정한 셔츠 차림에 왼손에 붕대를 감고 있다. "찻주전자에 데었어요. 별거 아닙니다."
"저는 여행 작가예요. 북촌 한옥 이야기를 쓰고 있죠. 보름이요? 아름다운 항아리죠. 글에 넣으려고 유리 너머로 사진 몇 장 찍긴 했어요."
"수요일 오후요? 정전이라 일을 못 해서 1시부터 5시 반까지 구립 도서관에 있었어요. 자료 찾느라고요."
은색 가방에 대해 묻자 그는 웃었다. "카메라 장비 가방이에요."
#### `c3-06` 아들 지은호 만나기
판교 회사 로비에서 만난 은호는 지쳐 보였다. "네, 팔자고 했어요. 문 회장님이 좋은 값을 쳐주겠다고 했고, 어머니 혼자 그 큰 집을 돌보시는 게 힘들어 보여서요."
"그런데 월요일에 문 회장님께 '없던 일로 해 주세요'라고 문자를 보냈어요. 어머니가 아버지 얘길 하시며 우셔서요. 화요일 밤엔 그 얘길 하러 갔다가 또 말다툼만 했지만요."
"수요일엔 하루 종일 회사에 있었어요. 2시부터 3시 반까지 제가 발표하는 회의도 있었고요. 그리고 저는 '석' 도장을 알아요. 어릴 때 아버지 무릎에 앉아 그 도장 찍는 걸 봤거든요."
그는 휴대폰을 내밀어 월요일 문자를 보여 주었다.
#### `c3-07` 마당 CCTV 기록 보기
마당 CCTV는 대문과 사랑채 문을 함께 비춘다. 화요일부터 목요일 오전까지 훑었다.
- 화 19:20 한정우, 은색 하드 케이스를 끌고 들어와 별채로.
- 화 21:00 은호 들어옴 → 22:00 빈손으로 나감.
- 수 11:00 별채 1호 대학생 두 명 체크아웃.
- 수 12:50 차영숙 나감. 13:50 하늘 나감.
- 수 14:00~16:00 녹화 없음(정전).
- 수 16:05 하늘 들어옴. 16:20 한정우 빈손으로 나감. 16:30 차영숙 들어옴.
- 수 17:30 퀵서비스 기사가 리셉션에서 큰 상자 하나를 들고 나감.
- 수 18:10 한정우 들어옴.
- 목 10:00 백은서 학예사 들어옴.
녹화된 시간에는 아무도 큰 가방이나 상자를 들고 사랑채에 들어가지 않았다.
- **깊이 보기**: 화 19:20 장면을 크게 보면, 은색 케이스가 문턱에 걸리자 한정우가 두 손으로 조심스레 들어 올린다. 카메라 가방치고는 너무 크다. 무릎 위까지 오는 높이다.
#### `c3-08` 정전 공사 안내문 보기
리셉션 게시판에 붙은 안내문. "알림: 다음 주 수요일 오후 2시~4시, 전기 설비 공사로 정전됩니다. 이 시간에는 CCTV가 작동하지 않습니다. 양해 부탁드립니다. — 솔바람채"
지난주 금요일에 붙였고, 투숙객에게 문자로도 보냈다고 한다. 공사 업체는 '바른전기', 담당 기사는 염태호.
#### `c3-09` 전기 기사 염태호와 통화하기
"수요일 2시 정각에 차단기를 내렸어요. 그 10분 전쯤 매니저 아가씨가 '은행 다녀올게요' 하고 나갔고요. 4시 정각에 다시 올렸고, 5분 뒤에 아가씨가 돌아왔어요."
"공사하는 동안 저는 마당 구석 계량기 앞에 있었는데, 2시 40분쯤 그 붕대 감은 손님이 은색 큰 가방을 끌고 사랑채로 들어가더라고요. '공사 수고하세요' 하고 인사도 했어요. 3시 조금 전에 다시 나와서 별채로 갔는데, 그때는 가방을 두 손으로 들고 끙끙대더라고요. 들어갈 때보다 무거워 보였어요."
"그 두 시간 동안 그 집엔 저랑 그 손님 말고는 아무도 없었어요."
#### `c3-10` 공방 대표 유경 만나기
흙빛 공방 유경 대표는 가마 앞에서 손을 털었다. "'흙' 자는 우리 공방 표시 맞아요. 지난주 월요일에 '한 선생'이라는 분이 오셨어요. 드라마 소품으로 쓸 달항아리를 똑같이 만들어 달라고요. 사진이랑 치수를 주셨고, 돈은 현금으로 냈어요."
"이번 주 화요일 오후 3시에 찾아가셨어요. 은색 하드 케이스를 가져와서 거기에 담아 가셨죠."
"하늘 씨요? 우리 수강생이에요. 그런데 이 주문은 평일에 받아서 하늘 씨는 몰라요. 손님이 비밀로 해 달라고 하셨거든요. 세상에, 그게 그런 데 쓰였을 줄은…."
#### `c3-11` 주문 장부와 의뢰 사진 보기
주문 장부: '지난주 월 · 한 선생 · 달항아리 재현(소품) · 높이 41.5 / 지름 40 · 현금 · 화 15시 찾아감 · 연락처 010-○○○○-4417'.
의뢰인이 맡긴 사진 20장을 넘겨 보았다. 모두 유리 너머로 찍어서 반사가 비친다. 앞, 옆, 위에서 비스듬히…. 바닥을 찍은 사진은 한 장도 없다. 치수는 진열장 안내판 사진에서 가져왔다.
유경 대표: "바닥은 어떻게 하냐고 물었더니, 그냥 매끈하게 하라고 하셨어요."
- **깊이 보기**: 유경 대표가 기억을 더듬었다. "그분이 왼손에 붕대를 감고 계셨어요. 오른손으로만 돈을 세셨죠."
#### `c3-12` 숙박 장부 보기
솔바람채 숙박 장부. '별채 3호 · 한정우 · 4주 예약(일요일 체크아웃) · 연락처 010-○○○○-4417 · 들어올 때 짐: 배낭 1'.
하늘이 덧붙였다. "처음엔 배낭 하나셨어요. 은색 큰 가방은 이번 주에 생겼어요."
#### `c3-13` 도서관 출입 기록 보기
구립 도서관 열람실은 회원증을 찍고 들어간다. 사서가 기록을 보여 주었다.
'한정우 회원 · 수요일 16:41 입실 · 17:28 퇴실.'
수요일 오후 1시부터 4시 40분까지는 기록이 없다. 도서관은 솔바람채에서 걸어서 15분 거리다.
#### `c3-14` 하늘의 은행·우체국 영수증 보기
하늘이 지갑에서 종이를 꺼냈다. 은행 번호표 '수 14:12', 은행 거래 확인증 '14:58', 우체국 등기 영수증 '15:31', 동네 카페 영수증 '15:44 아이스티'.
은행과 우체국은 솔바람채에서 걸어서 20분 거리다. 하늘은 공사가 끝날 때까지 카페에서 기다렸다고 한다.
#### `c3-15` 회사 출입 기록과 회의록 보기
은호 회사의 출입 기록: '수 13:10 들어옴 · 18:40 나감', 중간에 나간 기록 없음. 회의록: '14:00~15:30 3분기 계획 발표 — 발표자 지은호'. 참석자 열두 명의 이름이 적혀 있다.
판교에서 북촌까지는 차로 한 시간이 넘는다.
#### `c3-16` 리셉션 서랍과 진열장 열쇠 보기
리셉션 책상 첫째 서랍. 잠금장치는 있지만 열쇠가 늘 꽂혀 있다. 안에 진열장 열쇠가 있다. 열쇠에는 '사랑채'라고 쓴 노란 꼬리표가 달려 있다.
하늘: "바쁘다 보니 손님 앞에서도 서랍을 열고 열쇠를 꺼내 써요. 오래 묵으신 분은 다 보셨을 거예요."
#### `c3-17` 별채 3호 앞 살펴보기
하늘이 청소하러 문을 열어 둔 사이, 툇마루에서 방 안을 들여다보았다(안에 들어가지는 않았다).
방 한쪽에 은색 하드 케이스가 열린 채 비어 있다. 안쪽은 둥글게 파인 스펀지로 채워져 있다. 카메라 가방이라기엔 홈이 둥근 항아리 모양이다.
책상 위에는 노트북과 두꺼운 책 몇 권. 맨 위 책 표지에 '옛 그릇 경매 도록'이라고 적혀 있다.
- **깊이 보기**: 툇마루 틈에 하얀 솜 부스러기와 함께 빨간 '파손 주의' 포장 테이프 조각이 떨어져 있다.
#### `c3-18` 퀵서비스 영수증 보기
리셉션에 남은 퀵서비스 영수증. '수 17:30 · 보내는 곳: 솔바람채 별채 3호 · 받는 곳: 인사동 고운 화랑 · 물품: 도자기(파손 주의) · 크기 50×50×50cm'.
하늘: "한 선생님이 4시 15분쯤 큰 상자를 맡기시면서, 자료 책이라 무거우니 퀵 기사님께 전해 달라고 하셨어요. 빨간 '파손 주의' 테이프가 감겨 있었어요."
#### `c3-19` 화랑 대표 서정민 만나기
인사동 고운 화랑의 서정민 대표가 손님 장부를 확인했다. "한 선생이라는 분이 수요일 저녁에 퀵으로 도자기를 보내셨어요. '조선 후기 달항아리'라면서 감정과 보관을 맡기셨죠. 다음 주에 개인 수집가에게 보여 주겠다고요."
"우리는 맡은 물건을 보관만 해요. 보시겠어요? 보관실에 있어요."
#### `c3-20` 화랑 보관실의 항아리 확인하기
보관실 선반 위, 빨간 '파손 주의' 테이프가 감긴 상자를 열었다. 우윳빛 달항아리가 나왔다. 조심스럽게 기울여 굽 안쪽을 보니 또렷하게 찍힌 '석' 자 도장.
조선 후기 유물이 아니라 지석현의 '보름'이다! 서 대표의 얼굴이 하얘졌다. "바로 경찰과 주인께 연락하겠습니다. 이 물건은 한 발짝도 안 나갑니다."
#### `c3-21` 수집가 문 회장과 통화하기
"은호 씨가 월요일에 없던 일로 하자고 문자를 보냈어요. 아쉽지만 알겠다고 했죠."
"그런데 이상한 일이 있었어요. 어제 '한 선생'이라는 중개인이 전화해서, 지석현 달항아리 진품을 구해 줄 수 있다더군요. 은호 씨 쪽 사람인 줄 알았는데 아니라더라고요. 거절했어요."
#### `c3-22` 영숙에게 수요일 일정과 보험 묻기
영숙 씨가 병원 영수증을 보여 주었다. '수 13:20 접수 · 16:05 수납'. 정기 검진이라 오래 걸렸다고 한다.
"보험요? 그런 거 든 적 없어요. 미술관에 빌려주는 것도 그이 작품을 사람들이 보게 하고 싶어서예요. 돈 한 푼 안 받아요."
#### `c3-23` '석' 도장을 아는 사람 묻기
영숙: "우리 식구, 그러니까 나랑 은호, 그리고 닦는 하늘이. 그 말고는 몰라요."
하늘: "진열장 바닥이 나무 받침이라 밖에서는 굽이 절대 안 보여요. 손님이 꺼내 본 적도 없고요."
도장을 아는 사람이 가짜를 맞췄다면, 바닥 도장부터 똑같이 해 달라고 했을 것이다.
#### `c3-24` '한정우'라는 이름 찾아보기
'한정우'라는 이름으로 여행 책을 찾아보았다. 그런 작가가 쓴 책은 없다.
대신 옛 그릇 경매 사이트의 후기 게시판에 '한정우 선생님 중개로 좋은 항아리를 구했다'는 글이 몇 개 있다. 그릇을 사고파는 중개인으로 일하는 사람인 듯하다.
### 3.6 아침 소식
- 2일째(토요일) 아침: 학예사 백은서에게서 문자가 왔다. "가짜 항아리 무게를 다시 재 보니 진품보다 1.2kg 가벼운 게 확실해요. 진품을 들고 나간 사람은 꽤 무거웠을 거예요."
- 3일째(일요일) 아침: 하늘에게서 전화가 왔다. "한 선생님이 오늘 오전에 체크아웃하신대요. 은색 가방은 두고 가신다네요."
### 3.7 조언 (쓸 때마다 −2점)
1. 가짜 항아리가 이 집에 처음 들어올 수 있었던 날은 언제일까요? 공방에서 찾아간 날을 알아보세요.
2. 마당 CCTV가 꺼진 두 시간이 있어요. 그때 집에 남아 있던 사람은 누구일까요?
3. 진짜 항아리가 집을 나간 길을 찾아보세요. 수요일 저녁에 나간 상자가 있어요.
### 3.8 보고서 문제
| id | 문제 | 보기 | 정답 | 점수 |
|---|---|---|---|---|
| `q1` (범인) | 진짜 '보름'을 바꿔치기한 사람은? | ① 마하늘 ② 지은호 ③ 한정우 ④ 차영숙(스스로 꾸민 일) ⑤ 유경 ⑥ 백은서 | ③ | 10 |
| `q2` | 바꿔치기한 때는? | ① 2주 전 일요일 ② 화요일 밤 은호가 다녀간 뒤 ③ 수요일 오후 2~4시 정전 중 ④ 목요일 감정 직전 | ③ | 6 |
| `q3` | 진짜 '보름'은 지금 어디에 있나? | ① 한정우의 은색 가방 ② 이천 흙빛 공방 ③ 은호의 판교 사무실 ④ 인사동 고운 화랑 보관실 ⑤ 이미 외국으로 나갔다 | ④ | 6 |
| `q4` | 가짜 항아리를 만든 곳은? | ① 하늘이 직접 ② 이천 흙빛 공방 ③ 구립 미술관 ④ 인터넷 쇼핑몰 | ② | 4 |
| `q5` | 가짜 항아리 바닥에 '석' 도장이 없는 까닭은? | ① 공방이 깜빡했다 ② 들키라고 일부러 뺐다 ③ 맞춘 사람이 바닥을 본 적이 없어서 ④ 원래 도장이 없는 작품이다 | ③ | 4 |
| `q6` | 한정우가 거짓으로 댄 수요일 오후 행방은? | ① 구립 도서관 ② 인사동 화랑 ③ 이천 공방 ④ 판교 | ① | 2 |
| `q7` | 한정우는 흙빛 공방을 어떻게 알았나? | ① 은호가 소개했다 ② 리셉션에 놓인 하늘의 공방 안내지 ③ 미술관 학예사가 알려 줬다 ④ 문 회장이 알려 줬다 | ② | 2 |
### 3.9 정답과 풀이
범인은 장기 투숙객 **한정우**(여행 작가가 아니라 그릇 중개인). 이천 **흙빛 공방**에 가짜를 맞춰 화요일에 찾아왔고, **수요일 오후 2~4시 정전**으로 CCTV가 꺼진 틈에 진열장을 열어 바꿔치기했다. 진짜는 그날 저녁 퀵으로 **인사동 고운 화랑 보관실**에 보냈다.
- 가짜는 흙빛 공방 표시('흙')가 있다(`c3-03`). 공방은 화요일 15시에 '한 선생'에게 넘겼다(`c3-10`). 그러니 바꿔치기는 화요일 15시 뒤다.
- 화요일 19:20부터 목요일 10:00까지 CCTV가 녹화된 시간에는 아무도 큰 짐을 들고 사랑채에 들어가지 않았다(`c3-07`). 남는 때는 녹화가 없던 수요일 14~16시뿐이다(`c3-08`).
- 그 두 시간 동안 영숙은 병원(`c3-07`, `c3-22`), 하늘은 은행·우체국·카페(`c3-07`, `c3-09`, `c3-14`), 은호는 판교에서 발표 중(`c3-15`), 대학생 손님은 오전에 떠났다(`c3-07`). 집에 남은 사람은 한정우와 전기 기사뿐이고, 기사는 한정우가 은색 가방을 끌고 사랑채에 들어갔다가 더 무거워진 가방을 두 손으로 들고 나오는 것을 봤다(`c3-09`, 아침 소식: 진품이 1.2kg 더 무거움).
- 한정우는 "1시부터 5시 반까지 도서관"이라고 했지만 도서관 기록은 16:41부터다(`c3-05`, `c3-13`). CCTV에도 16:20에 집을 나간다(`c3-07`).
- 가짜를 맞춘 '한 선생'의 연락처 끝 4417은 한정우의 숙박 장부 번호와 같고(`c3-11`, `c3-12`), 왼손 붕대도 같다(`c3-05`, `c3-11` 깊이 보기). 은색 케이스는 화요일에 공방에서 받아 온 그 가방이고(`c3-07`, `c3-10`), 안은 항아리 모양 스펀지다(`c3-17`). 진열장 열쇠는 늘 손님 앞에서 꺼내 쓰는 리셉션 서랍에 있었다(`c3-16`).
- 바닥에 도장이 없는 까닭: 의뢰 사진은 모두 유리 너머로 찍어 바닥이 한 장도 없다(`c3-02` 깊이 보기, `c3-11`). 도장을 아는 영숙·은호·하늘이었다면 바닥부터 똑같이 맞췄을 것이다(`c3-23`). 바닥을 본 적 없는 바깥사람이 맞췄다는 뜻이다.
- 진짜의 행방: 한정우가 16:15쯤 리셉션에 맡긴 상자가 17:30 퀵으로 고운 화랑에 갔다(`c3-18`). 화랑 보관실 항아리 바닥에 '석' 도장이 있다(`c3-19`, `c3-20`). 다음 날 문 회장에게 "진품을 구해 주겠다"고 전화한 '한 선생'도 같은 사람이다(`c3-21`, `c3-24`).
- 공방은 어떻게 알았나: 하늘이 리셉션에 놓아 둔 흙빛 공방 안내지를 한정우도 가져갔다(`c3-04`).
- 헛다리: 마하늘(도자기 전공, 같은 공방 수강생, 열쇠 관리) — 정전 내내 밖에 있었고 도장을 안다. 지은호(팔자고 함, 화요일 밤 다툼) — 수요일엔 판교에서 발표, 월요일에 거래를 그만뒀고 도장을 안다. 차영숙(스스로 꾸민 일) — 병원에 있었고 보험이 없어 얻을 것이 없다. 유경 — 소품인 줄 알고 정직한 표시까지 남겼다.
- 마무리: '보름'은 무사히 솔바람채로 돌아와 '서울의 달' 전시에 걸렸다. 전시 안내판에는 영숙 씨의 부탁으로 한 줄이 더 붙었다. "바닥의 '석' 자를 보여 드릴 수 없어 아쉽습니다."
### 3.10 앞뒤 맞추기 점검표
| 때 | 일 | 근거 |
|---|---|---|
| 3주 전 월 | 한정우 체크인(배낭 하나, 4주 예약) | 12 |
| 2주 전 일 | 영숙이 닦으며 '석' 도장 확인(진품) | 01 |
| 그 무렵 | 한정우 유리 너머 촬영, 리셉션에서 공방 안내지 가져감 | 02 깊이, 04, 05, 11 |
| 지난주 월 | 흙빛 공방에 가짜 주문(4417, 현금, 바닥 사진 없음) | 10, 11 |
| 지난주 금 | 정전 안내문 게시·문자 | 08 |
| 이번 주 월 | 은호가 문 회장에게 "없던 일로" | 06, 21 |
| 화 15:00 | 한정우 공방에서 가짜 수령(은색 케이스) | 10, 11 |
| 화 19:20 | 한정우 은색 케이스 들고 귀가 | 07 |
| 화 21:00~22:00 | 은호 방문·말다툼, 빈손으로 나감 | 01, 06, 07 |
| 수 11:00 | 대학생 손님 체크아웃 | 07 |
| 수 12:50 | 영숙 병원(13:20 접수~16:05 수납) | 07, 22 |
| 수 13:50 | 하늘 외출 | 07, 09 |
| 수 14:00~16:00 | 정전(녹화 없음) | 07, 08, 09 |
| 수 14:12~15:44 | 하늘 은행·우체국·카페 | 14 |
| 수 14:00~15:30 | 은호 판교 발표 | 15 |
| 수 14:40 | 한정우 은색 가방 끌고 사랑채로(가짜 들고), 진열장 열어 바꿔치기 | 09, 16 |
| 수 15:00 조금 전 | 더 무거운 가방 두 손으로 들고 별채로(진짜) | 09, 아침 소식 |
| 수 16:00 / 16:05 | 전기 복구 / 하늘 귀가 | 07, 09 |
| 수 16:15 | 한정우 '파손 주의' 상자를 리셉션에 맡김 | 17 깊이, 18 |
| 수 16:20 | 한정우 빈손으로 외출 | 07 |
| 수 16:30 | 영숙 귀가 | 07 |
| 수 16:41~17:28 | 한정우 도서관(알리바이 만들기) | 13 |
| 수 17:30 | 퀵이 상자를 고운 화랑으로 | 07, 18, 19 |
| 수 18:10 | 한정우 귀가 | 07 |
| 목 10:00 | 학예사 감정, 가짜 발견 | 03, 07 |
| 목 | '한 선생'이 문 회장에게 진품 팔겠다고 전화 | 21 |
- [x] 가짜가 집에 들어온 첫 기회는 화 19:20이고, 그 뒤 녹화 시간엔 사랑채로 큰 짐이 들어가지 않음 → 바꿔치기는 수 14~16시.
- [x] 그 시간 집에 있던 사람: 한정우와 기사뿐. 기사는 보기에 없고, 가짜를 맞춘 사람(4417·붕대)과 집에 들고 온 사람이 한정우.
- [x] 백은서는 목요일에 처음 왔고, 가짜는 그 전부터 진열장에 있었다(공방에서 화요일에 나감).
- [x] 시간: 16:20 집을 나가 15분 걸어 16:41 도서관 입실 — 맞음. 하늘 13:50 나감 → 14:12 은행(20분 거리) — 맞음. 기사 "2시 10분 전 매니저 외출, 4시 5분 귀가" = CCTV 13:50, 16:05 — 맞음.
- [x] 정답에 꼭 필요한 단서는 처음 단서에서 닿는다: 01·04 → 05·07 → 08 → 09, 05 → 13, 07 → 18 → 19 → 20, 03 → 10 → 11 → 12, 02·03 → 23.
- [x] 빠듯하게(하루 6시간): 1일 이동1 + 01·04·05·07(2) = 6, 2일 이동1 + 08·13·18 + 이동1 + 19 = 6, 3일 이동1 + 20·03 + 이동1 + 09 = 5. 범인·때·행방·공방·거짓 행방·안내지 문제를 모두 풀 수 있다(도장 문제는 02 깊이 보기나 23·11이 있으면 확실).

261
docs/games/case-file.md Normal file
View File

@@ -0,0 +1,261 @@
# 사건 파일 (`case-file`)
> 마일스톤: 2026-10 새 게임(직접 만든 게임) · 인원: 최소 1 ~ 최대 5명 · 예상 시간: 사건 하나 약 30~60분 · 난이도: 보통(사건마다 쉬움·보통·어려움)
## 1. 개요
- 탐정 사무소 팀이 되어 사건 하나를 함께 푸는 **협력 추리 게임**. 정해진 날짜와 시간 안에서 어떤 단서를 따라갈지 고르고, 고른 단서의 글을 읽고, 마지막에 객관식 **수사 보고서**를 내서 점수를 받는다. 시간이 모자라 모든 단서를 볼 수는 없다. "무엇을 볼지 고르는 것"이 이 게임의 재미다.
- 영감: 포털 게임즈의 『디텍티브: 모던 크라임 보드게임』(2018). 시간 예산 안에서 단서 카드를 고르고, 다른 장소로 가면 이동 시간이 들고, 데이터베이스 자료는 시간 없이 보고, 마지막에 문제를 풀어 점수를 받는 **진행 방식**만 빌렸다. 원작의 사건·인물·글·이름·용어(앤타레스 등)는 하나도 쓰지 않는다. 사건 세 개는 이 사이트를 위해 새로 지었다(`case-file-cases.md`).
- 설정으로 켜는 규칙은 다른 추리 게임에서 빌렸다: 셜록 홈즈 컨설팅 디텍티브(적은 단서로 풀수록 높은 점수), 크로니클 오브 크라임(시간이 흐르며 들어오는 소식), 방탈출 게임 EXIT·언락(점수를 내고 쓰는 조언), 머더 미스터리 파티(한 사람만 읽고 말로 전하기). 7절.
- 인원 근거: 원작이 1~5인. 혼자 해도 똑같이 재미있는 게임이라 1명부터. 6명 이상이면 고르는 차례가 너무 늦게 돌아온다.
- 우리 사이트의 다른 추리 게임과 다른 점: 클루(`clue`)는 서로 겨루는 소거 추리, 마피아·라이어는 사람 속이기. 이 게임은 **글을 읽고 함께 추리**하는 이야기 게임이다.
- **이름**: 『사건 파일』. 다른 후보: 『수사 일지』, 『탐정 수첩』, 『골목 탐정단』.
## 2. 모드와 옵션
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `caseId` | 사건 | `c1` 달빛제과의 사라진 레시피 노트(쉬움) / `c2` 한별고 과학 축제, 멈춰 버린 다람이(보통) / `c3` 솔바람채의 바뀐 달항아리(어려움) / `random` 아무거나 | `c1` |
| `mode` | 함께 풀기 / 따로 겨루기 | `coop` 함께 풀기(시간·단서 공유) / `race` 따로 겨루기(각자 수사, 점수 경쟁) | `coop` |
| `decision` | 다음 단서를 누가 고르나(함께 풀기) | `rotate` 반장이 돌아가며 / `vote` 다 같이 투표 / `free` 아무나 먼저 누르기 | `rotate` |
| `timeBudget` | 하루 수사 시간 | `relaxed` 넉넉하게(하루 10시간) / `normal` 보통(8시간) / `tight` 빠듯하게(6시간) | `normal` |
| `overtime` | 야근 | on(하루 2시간까지 더, 1시간마다 피로 1 = −1점) / off | on |
| `magnifiers` | 돋보기(깊이 보기) 개수 | 0 / 2 / 3 / 5 | 3 |
| `hints` | 반장님 조언 쓸 수 있는 횟수(1번에 −2점) | 0 / 1 / 3 | 3 |
| `timeBonus` | 남은 시간 보너스 | on(남은 2시간마다 +1점, 최대 +5점) / off | off |
| `morningNews` | 아침 소식 | on / off | on |
| `readMode` | 단서 글 읽기(함께 풀기, 2명 이상) | `all` 모두 읽기 / `reader` 고른 사람만 읽고 말로 전하기 | `all` |
| `turnSeconds` | 다음 단서 고르기 제한 시간 | 60 / 120 / 180 / 300초 / 무제한 | 180 |
| `reportSeconds` | 보고서 쓰기 제한 시간 | 180 / 300 / 600초 / 무제한 | 600 |
| `raceMinutes` | 따로 겨루기 전체 제한 시간 | 30 / 45 / 60 / 90분 / 무제한 | 60 |
| `kidSafeChat` | 고운 말 필터(마피아와 같은 필터) | on / off | on |
- `random`은 서버 시드 난수로 세 사건 중 하나. 대기실에는 "어떤 사건인지 시작하면 알아요"로 보인다.
- 혼자(1명)면 `decision`·`readMode`는 의미가 없어서 화면에서 감춘다. `race`에서는 `decision`·`readMode`·`turnSeconds`가 감춰지고 `raceMinutes`가 보인다(`race`가 아니면 `raceMinutes`를 감춤).
- 모든 옵션에 `.meta({ title, labels })`를 붙인다(09 §2). 사건 제목은 옵션 라벨에만 들어간다(정답은 들어가지 않음).
## 3. 구성물
사건 데이터 파일(`packages/games/src/case-file/cases/c1.ts` …). 모양은 `case-file-cases.md` 0절. 사건마다:
- **의뢰**: 처음에 모두에게 보이는 사건 소개.
- **구역·장소·이동표**: 사무소 + 3~4개 구역. 같은 구역 안은 이동 0시간, 다른 구역은 1~2시간.
- **단서** 18~24개: 장소, 제목, 걸리는 시간(1 또는 2시간), 여는 조건, 본문, (일부) 깊이 보기 본문.
- **자료실**: 인물 카드(이름·나이·한 줄). 단서에서 처음 나오면 열리고, 읽는 데 시간이 들지 않는다(원작의 데이터베이스 역할).
- **아침 소식**: 둘째 날부터 아침마다 공짜로 들어오는 짧은 글.
- **조언** 3개(차례대로 더 구체적).
- **보고서 문제** 5~7개(객관식, 문제마다 점수, 첫 문제는 범인), 해결 기준·등급 점수, **풀이**.
- **토큰**: 돋보기(옵션 개수), 조언(옵션 횟수). 그림은 이모지·CSS로 직접 그린다.
## 4. 준비(셋업)
1. 사건을 정한다(`random`이면 RNG).
2. `coop`: 팀 수사 하나를 만든다. `race`: 사람마다 수사를 하나씩 만든다(모두 같은 사건).
3. 수사마다: 1일째 09:00, 위치 사무소, 돋보기·조언은 옵션 개수, 피로 0, 읽은 단서 없음. 처음부터 열린 단서(여는 조건이 빈 것)만 고를 수 있다.
4. `rotate`면 첫 반장을 RNG로 뽑는다(그다음은 자리 순서). `readMode: reader`의 첫 읽는 사람도 반장과 같다.
5. **의뢰 단계**: 모두에게 의뢰 글을 보여 주고, 모두 [수사 시작]을 누르면(또는 60초 뒤) 수사를 시작한다.
## 5. 진행 규칙
### 5.1 시간
- 하루는 09:00에 **사무소**에서 시작한다. 하루 수사 시간 H = 10·8·6시간(`timeBudget`). 하루 끝 = 09:00 + H.
- 단서 하나를 따라가면 `이동 시간 + 단서 시간`만큼 시계가 간다. 이동 시간 = 지금 구역에서 단서 장소의 구역까지(같은 구역이면 0).
- 하루 끝을 넘기는 단서는 `overtime`이 켜져 있을 때만 고를 수 있다. 하루 끝을 넘긴 1시간마다 **피로 1**(마지막에 −1점). 하루에 넘길 수 있는 시간은 2시간까지.
- [하루 마치기]: 남은 시간을 버리고 다음 날 09:00 사무소로. 남은 시간이 없거나(야근을 다 썼거나, 야근이 꺼져 있고 남은 시간보다 짧은 단서가 없으면) 자동으로 하루를 마친다.
- 마지막 날을 마치면 바로 보고서 단계로 간다.
- 다음 날 아침 소식(`morningNews`)이 있으면 그날 아침 모두에게 공개한다(시간 안 듦).
### 5.2 단서 고르기
- 고를 수 있는 단서 = 열렸고 아직 읽지 않은 단서. **열림**: 여는 조건의 단서 중 하나라도 읽었거나, 깊이 보기로 열었으면.
- 목록에는 단서마다 장소, 제목, "이동 n시간 + 단서 n시간 = 합계", 야근이 필요한지, 고를 수 있는지가 보인다. 본문은 읽기 전엔 서버 밖으로 나가지 않는다(8.3).
- 단서를 고르면: 시계가 가고, 위치가 그 장소로 바뀌고, 본문이 열린다. 그 본문으로 새로 열리는 단서와 자료실 인물이 생긴다("새 단서 2개가 열렸어요").
- 한 번 읽은 단서는 다시 고를 수 없다(수사 기록에서 언제든 다시 읽기는 공짜).
**누가 고르나(`decision`, 함께 풀기)**
- `rotate` 반장이 돌아가며(기본): 지금 반장만 단서 고르기·깊이 보기·조언·하루 마치기·보고서 쓰기를 할 수 있다. 다른 사람은 단서에 **추천 표시**(누구나, 한 사람당 하나, 모두에게 보임)를 하고 채팅으로 의견을 낸다. 단서를 하나 읽으면 반장이 다음 사람으로 넘어간다(깊이 보기·조언은 안 넘어감).
- `vote` 다 같이 투표: 모두가 투표 칸 하나를 고른다. 칸 = 고를 수 있는 단서들 + "돋보기: ○○" + "조언 듣기" + "하루 마치기" + "보고서 쓰기". 나간 사람을 뺀 모두가 투표하면 바로, 아니면 시간이 끝날 때 집계한다. 가장 많은 칸을 실행하고, 동점이면 **이번 판의 결정권자**(투표가 끝날 때마다 자리 순서로 돌아감)가 고른 칸, 그 사람이 동점 칸을 안 골랐으면 동점 칸 중 목록에서 위에 있는 것. 아무도 투표하지 않으면 아무 일도 하지 않는다(8.5).
- `free` 아무나: 누구든 먼저 확정한 사람의 행동이 실행된다. 실수를 막으려고 모든 행동은 [고르기] → [정말 이걸로 해요] 두 번 누르기. 보고서 쓰기만은 **모두 동의**([보고서 쓰자]를 모두 누름)가 필요하다.
### 5.3 깊이 보기(돋보기)
- 읽은 단서 중 깊이 보기가 있는 단서는 [🔍 깊이 보기]가 생긴다. 돋보기 1개를 쓰면 숨은 한 문단이 열린다(시간 안 듦). 읽고 나서 나중에 써도 된다.
- 깊이 보기에는 정답에 도움이 되는 증거가 있지만, **정답에 꼭 필요하지는 않다**(돋보기 0개 옵션으로도 모든 문제를 풀 수 있게 사건을 쓴다 — 데이터 검사 10절).
- 깊이 보기가 있는 단서인지는 읽기 전에도 표시한다(🔍). 원작의 "더 깊이 파기"와 같은 고민(어디에 쓸까)을 준다.
### 5.4 조언
- [반장님 조언 듣기]: 사건의 조언을 1번부터 차례대로 하나 공개한다. 쓸 때마다 −2점. `hints` 횟수까지(사건마다 조언은 3개).
### 5.5 단서 글 읽기(`readMode`, 함께 풀기·2명 이상)
- `all`: 읽으면 모두에게 본문이 열린다.
- `reader` 한 사람만 읽기: 그 단서를 고른 사람(`rotate`는 반장, `vote`는 그 판 결정권자, `free`는 누른 사람)에게만 본문이 보이고, 다른 사람에게는 "○○님이 읽고 있어요"와 제목만 보인다. 읽은 사람이 채팅으로 전해 준다. **보고서 단계가 되면 모두에게 모든 본문이 열린다**(못 들은 사람도 마지막엔 확인할 수 있게). 깊이 보기도 쓴 사람만 본다.
### 5.6 보고서
- 언제든 [보고서 쓰기](5.2의 권한대로)로 수사를 끝낼 수 있다. 마지막 날이 끝나면 자동으로 보고서 단계.
- 보고서 단계에서 처음으로 **문제가 공개된다**(원작처럼 문제를 미리 보면 어디를 볼지 너무 쉽게 안다). 단서 고르기는 더 못 하지만 수사 기록·자료실·채팅은 그대로.
- **각자** 모든 문제에 답을 고르고 [보고서 내기]. 낸 뒤에는 고칠 수 없다. 누가 냈는지만 보이고 무엇을 골랐는지는 끝날 때 공개.
- 함께 풀기의 **팀 답**: 문제마다 가장 많이 고른 보기. 동점이면 동점 보기 중 마지막 반장(`vote`·`free`는 마지막 결정권자)이 고른 것, 그 사람이 동점 보기를 안 골랐으면 자리 순서로 먼저인 사람이 고른 것. 모두 비우면 오답.
- 모두 내거나 `reportSeconds`가 끝나면 채점한다. 시간이 끝날 때 안 낸 사람은 고른 데까지만 낸 것으로 본다.
### 5.7 따로 겨루기(`race`)
- 사람마다 자기 시간·위치·돋보기·조언·읽은 단서가 따로 있다. 차례가 없다. 각자 자기 속도로 단서를 고르고 하루를 마치고 보고서를 낸다(`decision`·`readMode` 무시).
- 다른 사람에 대해서는 "몇 일째 몇 시, 읽은 단서 수, 보고서 냈는지"만 보인다. 무엇을 읽었는지는 안 보인다.
- 게임 채팅은 닫는다(정보를 나눌 수 없게). 보고서를 낸 사람끼리만 "낸 사람 채팅"을 쓸 수 있다.
- `raceMinutes`가 끝나면 아직 수사 중인 사람은 바로 보고서 단계(남은 `reportSeconds`)로 간다. 모두 내면 끝.
- 셜록 홈즈 컨설팅 디텍티브처럼 "적은 시간으로 맞힌 사람"이 이기도록, `race`에서는 동점이면 남은 시간이 많은 사람이 앞선다.
## 6. 승패와 점수 계산
```
점수 = 맞힌 문제 점수 합 − 피로 − 조언 쓴 횟수 × 2 + 남은 시간 보너스
남은 시간 보너스(timeBonus on) = min(5, floor(남은 시간 / 2))
남은 시간 = 보고서를 쓰기로 한 순간 그날 남은 시간 + 남은 날 수 × H (야근 중이면 그날 남은 시간 0)
```
- **해결**: 범인 문제(`culprit`)를 맞히고, 점수 ≥ 사건의 해결 기준. 등급: S(사건의 S 점수 이상) / A / B(해결 기준 이상) / 미해결.
| 사건 | 만점 | 해결 기준 | A | S |
|---|---|---|---|---|
| `c1` | 28 | 16 | 21 | 26 |
| `c2` | 30 | 18 | 23 | 27 |
| `c3` | 34 | 22 | 26 | 31 |
- 예: `c2`를 보통 시간으로 풀어 q1·q2·q3·q4(25점)를 맞히고, 야근 1시간(피로 1), 조언 1번 → 25 − 1 − 2 = 22점, 해결 B.
- 점수가 0보다 작으면 0으로 쓴다.
- **함께 풀기 결과**: 모두 같은 순위 하나(`ranking: [[모두]]`). 해결이든 아니든 함께 이기고 함께 진다. `scoreText`: "팀 22점 · B 해결". 결과 화면에는 **각자 낸 답의 점수**도 재미로 보여 준다("○○님 답이었다면 26점"). 이건 순위에 들어가지 않는다.
- **따로 겨루기 결과**: 자기 점수 순. 동점이면 남은 시간이 많은 쪽, 그래도 같으면 공동. `scoreText`: "24점 · A".
- `summary` 예: "사건 해결! 팀 22점(B). 범인은 문지혜였어요." / "미해결… 팀 12점. 범인은 강민재였어요."
- 끝나면 모두에게 정답·풀이·**못 본 단서 전부**(본문·깊이 보기 포함)를 공개한다. "놓친 단서 보기"가 마무리의 재미.
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
| 옵션 | 무엇 | 영감 |
|---|---|---|
| `timeBudget` | 하루 10·8·6시간. 쉬움/어려움 조절 | 디텍티브(원작은 하루 8시간 + 야근) |
| `overtime` | 하루 2시간까지 더 일하고 시간당 −1점 | 디텍티브의 야근·스트레스 |
| `magnifiers` | 깊이 보기 토큰 수 | 디텍티브의 기술 토큰("더 깊이 파기") |
| `hints` | 점수를 내고 쓰는 조언 | EXIT·언락 방탈출 게임의 힌트 카드 |
| `timeBonus` | 남은 시간만큼 보너스 | 셜록 홈즈 컨설팅 디텍티브(홈즈보다 적은 단서로 풀면 높은 점수) |
| `morningNews` | 아침마다 들어오는 소식 | 크로니클 오브 크라임·디텍티브의 시간에 따라 바뀌는 사건 |
| `readMode: reader` | 한 사람만 읽고 말로 전하기 | 머더 미스터리 파티(각자 다른 정보를 쥐고 말로 나눔) |
| `decision` | 반장 돌아가며 / 투표 / 아무나 | 온라인용으로 새로 만듦(원작은 식탁에서 말로 정함) |
| `mode: race` | 같은 사건을 각자 풀어 점수 경쟁 | 셜록 홈즈 컨설팅 디텍티브의 경쟁 규칙 |
일부러 뺀 것: 원작의 인터넷 검색 과제(바깥 사이트에 의존), 권한 토큰·보고서 쓰기 행동, 탐정마다 다른 특수 능력(사건 세 개로는 균형을 잡기 어려움), 여러 사건이 이어지는 캠페인, 틀린 답 감점(원작은 −1점, 가족용으로 뺌), 단서 본문 음성 읽기.
## 8. 엔진 설계
### 8.1 상태(State)
```ts
interface CaseFileState {
options: CaseFileOptions;
caseId: 'c1' | 'c2' | 'c3'; // random은 setup에서 정해짐
players: { id: PlayerId; left: boolean }[];
phase: 'briefing' | 'investigate' | 'report' | 'ended';
briefingReady: PlayerId[];
investigations: Record<string, Investigation>; // coop: 'team' 하나, race: 플레이어 id마다
decider: number; // rotate 반장 / vote·free 결정권자(자리 번호)
ballot: Record<PlayerId, Choice> | null; // vote 모드
pins: Record<PlayerId, string | null>; // 추천 표시
reportAgree: PlayerId[]; // free 모드 보고서 동의
answers: Record<PlayerId, Record<string, number>>;
submitted: PlayerId[];
chat: { n: number; from: PlayerId; text: string; at: number; channel: 'team' | 'done' }[];
deadlineAt: number | null; raceEndsAt: number | null;
idle: Record<PlayerId, number>; // 연속 시간 초과
seq: number;
final: CaseFileFinal | null;
}
interface Investigation {
day: number; hour: number; // hour: 9 + 쓴 시간(야근이면 하루 끝을 넘김)
zone: string; place: string;
visited: { lead: string; by: PlayerId; day: number; at: number; travel: number }[];
deep: { lead: string; by: PlayerId }[];
opened: string[]; // 깊이 보기로 열린 단서
magnifiers: number; hintsUsed: number; fatigue: number;
newsSeen: number[]; // 공개된 아침 소식(날짜)
reportAt: { day: number; hour: number } | null; // 남은 시간 계산용
}
type Choice = { type: 'lead'; lead: string } | { type: 'deep'; lead: string } | { type: 'hint' } | { type: 'endDay' } | { type: 'report' };
```
- 상태에는 사건 **데이터를 넣지 않는다**(id만). 본문·정답은 엔진 모듈이 사건 파일에서 읽는다. 저장 크기가 작고, 사건 글을 고쳐도 판 상태가 깨지지 않는다(글 고침은 `stateVersion`을 올려 다시 보기만 막는다).
- 열린 단서·남은 시간·고를 수 있는지는 상태에서 매번 계산한다(저장하지 않음).
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `ready` | – | 모두, `briefing` | 아직 안 누름 |
| `pick` | `lead` | `investigate`, 5.2 권한(race는 자기 수사) | 열렸고 안 읽음, 시간 되는지(야근 포함), 보고서 전 |
| `deep` | `lead` | 권한자 | 읽은 단서, 깊이 보기 있음, 아직 안 씀, 돋보기 ≥ 1 |
| `hint` | – | 권한자 | 남은 조언 횟수 ≥ 1, 사건 조언 남음 |
| `endDay` | – | 권한자 | `investigate` |
| `report` | – | 권한자(`free`는 동의 표시) | `investigate` |
| `vote` | `choice` | `vote` 모드, 나간 사람 아님 | `choice`가 지금 할 수 있는 행동 |
| `pin` | `lead \| null` | 함께 풀기, 누구나 | 고를 수 있는 단서 |
| `answer` | `q, choice` | `report`, 아직 안 냄 | 문제·보기 범위 |
| `submit` | – | `report`, 아직 안 냄 | – |
| `chat` | `text` | 함께 풀기: 모두 / race: 낸 사람끼리 | 200자, 고운 말 |
| `timeout` | – | 서버 | 마감 지남 |
| `leave` | – | 서버(나감) | – |
- `timeout`·`leave`는 `actionSchema`에 넣지 않는다(서버만 만든다, 09 §2).
### 8.3 공개/비공개 정보 (view)
- **사건 데이터는 서버 전용**: `cases/*.ts`는 엔진(`packages/games/src/case-file/index.ts`)만 가져온다. 웹은 `import type`만 쓴다. 웹 빌드 결과물에 사건 본문이 없는지 테스트한다(10절, 본문마다 넣은 확인용 문장 조각을 빌드 파일에서 검색).
- view에 들어가는 것: 의뢰, 구역·장소·이동표, 열린 단서 목록(id·제목·장소·시간·🔍 여부·추천 표시), **읽은 단서의 본문**(`readMode: reader`면 읽은 사람에게만, 보고서 단계부터 모두), 쓴 깊이 보기 본문, 공개된 아침 소식·조언, 열린 인물 카드, 시계·돋보기·조언·피로, 투표 현황(누가 투표했는지는 보이고 무엇을 골랐는지는 집계 때), 보고서 단계면 문제와 보기(정답 없이), 내 답.
- view에 없는 것: 안 읽은 단서의 본문·깊이 보기, 안 연 단서의 제목, 정답·점수 배분 중 정답·풀이, 남의 답(끝나기 전), `race`에서 남의 읽은 단서.
- 문제 점수(몇 점짜리인지)는 보고서 단계에 보여 준다. 정답 번호는 `final`에만.
- 끝난 뒤(`final`): 정답, 풀이, 팀 답·각자 답과 점수, 모든 단서 본문.
- `secretsOf(state, p)`: p가 아직 볼 수 없는 단서 본문·깊이 보기 본문 각각의 확인 문장 조각 + (끝나기 전) 풀이 첫 문장과 정답 보기 글. 공통 유출 검사기가 view JSON에서 이것을 찾는다.
### 8.4 랜덤 요소
`random` 사건 고르기, 첫 반장(첫 결정권자). 그 밖에는 난수가 없다(같은 사건, 같은 선택이면 같은 결과).
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- 의뢰 단계 60초(고정). 끝나면 수사 시작.
- `rotate`: 반장에게 `turnSeconds`. 시간이 지나면 **반장만 다음 사람에게 넘긴다**(시계는 그대로, 단서 안 고름). 한 사람이 3번 연속 넘기면 그 사람 차례는 건너뛴다(다시 행동하면 풀림). 모두가 3번 연속이면 보고서 단계로 간다(아무도 안 하는 판이 끝나지 않는 일을 막음).
- `vote`: 투표 시간 `turnSeconds`. 끝나면 투표한 것만 집계. 아무도 안 했으면 아무 일 없이 다음 투표(결정권자는 넘어감), 3번 연속이면 보고서 단계로.
- `free`: 마감이 없다. 모두 연결이 끊긴 채 방의 유예 시간이 지나면 보고서 단계로.
- `turnSeconds` 무제한: 마감이 없고, 연결이 끊긴 채 유예 시간이 지난 반장만 위처럼 넘긴다.
- 보고서: `reportSeconds`가 끝나면 안 낸 사람은 고른 데까지 낸 것으로. 무제한이면 연결이 끊긴 채 유예 시간이 지난 사람만.
- `race`: 각자 마감 없음. `raceMinutes`가 끝나면 모두 보고서 단계, 그다음 `reportSeconds`.
- 나가기(`onLeave`): 함께 풀기는 그 사람을 반장 차례·투표·동의 인원에서 뺀다. 반장이었으면 다음 사람. 남은 사람이 0이면 `abandoned`. 따로 겨루기는 그 사람이 꼴찌(0점).
- `onTimeout`은 늘 합법 행동(`timeout`)을 돌려준다.
### 8.6 종료 조건과 결과(GameResult)
- 모두(나간 사람 빼고) 보고서를 냈거나 보고서 시간이 끝남 → 채점(6절) → `ended`. `reason: 'normal'`.
- 모두 나감 → `abandoned`.
### 8.7 컴퓨터 상대
**넣지 않는다.** 글을 읽고 추리하는 게임이라 컴퓨터가 고르는 단서·답은 재미가 없고(정답을 알면 알려 주는 셈, 모르면 아무렇게나), 혼자서도 완전히 즐길 수 있다(1명부터). 연습 방은 "혼자 하기". 봇 테스트(`bots.test.ts`) 목록에서 빠진다. 나중에 원하면 "조수 탐정"(추천 표시만 하는 컴퓨터)을 검토한다.
## 9. UI/UX
- **PC 배치**: 위 막대(사건 제목, "1일째 13:00 / 17:00까지", 날짜 점, 🔍 돋보기 n, 💡 조언 n, 😪 피로 n, 지금 반장/투표 남은 시간). 왼쪽: 지도(구역 카드, 지금 위치에 탐정 말, 구역 사이에 이동 시간). 가운데: **단서 목록**(장소별로 묶음, 카드마다 제목·"이동 1 + 1시간"·🔍·추천한 사람 얼굴, 못 고르면 흐리게+까닭 "시간이 모자라요"). 오른쪽: 탭 [수사 기록] [자료실] [메모] [채팅].
- **단서 읽기**: 고르면 가운데에 본문 카드가 크게 펼쳐진다(종이 서류 느낌, 장소·시각 도장). 아래에 "새로 열린 단서: …", [🔍 깊이 보기(돋보기 1개)].
- **수사 기록**: 읽은 단서를 시간 순서로(1일째 10:00 달빛제과 — 오순자 할머니 이야기). 누르면 다시 읽기. ★중요 표시(나만, 기기에 저장).
- **자료실**: 인물 카드(이름·나이·한 줄, 처음 나온 단서로 가기). 장소 카드.
- **메모**: 자유 글(기기에만, `localStorage` 키 `bg:case-file:note:<방 코드>:<게임 번호>`). 인물마다 의심 정도(흰색·노랑·빨강) 표시.
- **보고서 화면**: 문제마다 보기 버튼, 몇 점짜리인지, 다른 사람이 냈는지. 수사 기록을 옆에서 볼 수 있다. [보고서 내기]는 두 번 눌러 확정.
- **결과**: 등급 도장 애니메이션(S/A/B/미해결), 문제마다 팀 답·정답·각자 답, 풀이, [놓친 단서 보기].
- **휴대폰(320px~)**: 위 막대는 한 줄로 접혀 붙어 있고(시각·🔍·💡), 아래 탭 [단서] [기록] [자료] [채팅]. 본문 카드는 전체 화면 시트. 단서 카드는 한 줄 두 칸이 아니라 한 칸씩. 글자 크기 최소 16px(긴 글을 읽으니까), 줄 간격 넉넉하게.
- **반장 표시**: "지금 반장: ○○님 · 2:31". 반장이 아닌 사람은 단서 카드에서 [추천]만 누를 수 있다. 투표 모드는 카드 위에 투표 수가 쌓인다.
- 채팅은 게임 자체 채팅(`ownChat`, 고운 말 필터). 방 채팅·빠른 반응은 게임 중 닫힘. 따로 겨루기에서는 채팅이 닫혀 있다는 안내.
- 접근성: 모든 카드·탭이 버튼, 본문은 실제 글(그림 아님), 스크린리더에 "새 단서 2개가 열렸어요"를 aria-live로. 다크 모드는 공통 색 변수. 동작 줄이기 설정이면 도장·카드 펼침 애니메이션 없음.
- 초보자 도움말: 30초 요약 카드 3장("시간 안에 단서를 골라요 / 다른 동네로 가면 이동 시간이 들어요 / 마지막에 보고서 문제를 풀어요"), [?]에 옵션별 설명.
## 10. 테스트 체크리스트
- [ ] **사건 데이터 검사**(사건마다): 단서 id 겹치지 않음, 여는 조건·깊이 보기가 여는 단서가 모두 있는 id, 모든 단서가 처음 단서에서 닿음, 장소·구역·이동표가 맞음(대칭, 같은 구역 0), 단서 시간 1~2, 문제 보기 2~6개·정답 범위, 범인 문제 하나, 만점·기준·등급이 문서 표와 같음, 모든 글이 고운 말 필터 통과.
- [ ] **풀 수 있는지**: 사건마다 적어 둔 "빠듯한 길"(cases 문서 점검표)을 돋보기 0개·조언 0개·야근 끔으로 실제 엔진에서 따라가 시간이 모자라지 않음. 그 길에서 읽은 글에 정답 근거 문장이 모두 있음(사건 파일에 문제마다 `evidence: 단서 id[]`를 두고 그 단서들이 길 안에 있는지 확인).
- [ ] 시간: 이동 시간, 같은 구역 0, 하루 끝, 야근 2시간 한도·피로, 야근 끔이면 넘는 단서 못 고름, 자동 하루 마치기, 마지막 날 → 보고서, 아침 소식 날짜.
- [ ] 단서: 열림 규칙(OR), 깊이 보기로 열림, 다시 고르기 금지, 돋보기 개수, 조언 차례·감점.
- [ ] 결정 방식: `rotate` 반장만·반장 넘김·추천 표시, `vote` 집계·동점·결정권자 돌기·아무도 안 함, `free` 두 번 누르기·보고서 모두 동의.
- [ ] 읽기: `reader`면 읽은 사람만 본문, 보고서 단계에서 모두에게 열림.
- [ ] 보고서: 문제는 보고서 단계에서만 view에 나옴, 팀 답 다수결·동점 처리, 점수 계산(피로·조언·남은 시간 보너스·0 아래), 범인 틀리면 미해결, 등급.
- [ ] 따로 겨루기: 수사가 서로 섞이지 않음, 남의 읽은 단서 안 보임, 채팅 닫힘/낸 사람 채팅, 전체 시간, 동점 → 남은 시간.
- [ ] 시간 초과·나가기: 반장 넘김, 3번 연속 건너뛰기, 모두 자리 비움 → 보고서, 보고서 시간 초과, 반장이 나감, 모두 나감.
- [ ] **비밀**: 무작위 수백 판(1~5명, 옵션 조합)에서 매 단계 view JSON에 `secretsOf` 문장 조각이 없음. 정답 보기 글·풀이는 끝나기 전 어떤 view에도 없음.
- [ ] **웹 빌드에 사건 글 없음**: `apps/web` 빌드 결과물에서 사건 본문 확인 문장 조각을 찾지 못함.
- [ ] 엔진 공통: 무작위 대국(`legalActions`), JSON 왕복, 결정성, 상한 안에 끝남, `onTimeout` 합법.
- [ ] 도움말(`help.test.ts`), E2E(PC 1 + 휴대폰 2: 의뢰 → 반장 돌기 → 단서 읽기 → 깊이 보기 → 하루 마치기 → 보고서 → 결과, `reader` 비밀 유지, 따로 겨루기 한 판).
## 11. 참고 자료
- 영감(진행 방식만): Detective: A Modern Crime Board Game(Portal Games, 2018, 이그나치 트제비치에크·프셰미스와프 리메르·야쿠프 와포트). BGG 평점 약 7.6, 평가 약 1만 1천 개, 무게 2.74/5, 1~5인, 120~180분. 하루 8:00~16:00 + 야근(스트레스), 장소 이동 1시간, 단서 카드 1~4시간, 데이터베이스는 시간 없이, 마지막 객관식 보고서.
- https://boardgamegeek.com/boardgame/223321/detective-a-modern-crime-board-game
- https://ultraboardgames.com/detective-a-modern-crime-board-game/game-rules.php
- 한국어판 상품: https://www.koreaboardgames.com/product/detail?prdCd=PD2026000389CHGR
- 사용 후기: https://www.clien.net/service/board/use/16252330
- 설정 영감: Sherlock Holmes Consulting Detective(1981), Chronicles of Crime(2018), EXIT·Unlock 시리즈, MicroMacro: Crime City(2021 올해의 게임), 머더 미스터리 파티 게임.
- 사건 글: `case-file-cases.md`. 조사 메모: `groups/grp_discord_joke-app/notes/six-games-20261015/case-file.md`.
## 12. 메모 (상표·법적 주의 등)
- 게임 진행 방식(시간 예산, 단서 고르기, 객관식 보고서)은 저작권 대상이 아니지만, 원작의 사건·글·인물·그림·이름은 저작물이라 **쓰지 않는다**. 이름도 '디텍티브'가 아닌 『사건 파일』, 원작의 기관·데이터베이스 이름(앤타레스 등)도 쓰지 않는다. 우리 쪽 이름: 해오름 탐정사무소, 자료실, 돋보기, 반장님 조언.
- 사건 세 개는 모두 새로 지은 이야기. 실제 사람·가게·상표와 관계없다. 동네 이름(망원동·성산동·북촌·인사동·이천·판교)은 배경으로만 쓰고, 가게·학교·화랑 이름은 지어낸 것이다.
- 가족·친구용 사이트라 사건은 다치거나 죽는 일이 없는 도난·바꿔치기로만 만든다. 새 사건도 같은 기준(10절 데이터 검사의 고운 말 필터 + 사람이 읽고 확인).
- 새 사건 추가: `cases/c4.ts` 하나 + `case-file-cases.md`에 같은 형식(의뢰·단서표·본문·문제·풀이·점검표). 데이터 검사 테스트가 자동으로 새 사건도 검사한다.

View File

@@ -0,0 +1,483 @@
# 버건디의 성 (`castles-of-burgundy`)
> 마일스톤: 2026-10 새 게임 · 인원: 최소 1 ~ 최대 4명(기본 2~4명, 1명은 솔로 모드, 4명 팀전 모드) · 예상 시간: 2명 약 60~90분, 4명 약 120분(1명당 약 30분) · 난이도: 어려움
## 1. 개요
- 15세기 프랑스 부르고뉴의 영주가 되어, 매 라운드 주사위 2개를 굴려 나온 눈으로 가운데 판에서 육각 타일을 가져오고, 내 공국(37칸 육각 판)의 같은 색·같은 눈 칸에 놓아 구역을 채우며 점수를 얻는다. 타일 색마다 효과가 다르다(성 = 행동 한 번 더, 배 = 상품 가져오기 + 차례 앞당기기, 건물 = 즉시 효과, 가축 = 바로 점수, 광산 = 페이즈마다 은화, 수도원 = 규칙을 바꾸는 특수 능력). 5페이즈 × 5라운드(1인당 행동 50번)가 끝나면 점수가 가장 높은 사람이 이긴다.
- 원작: Stefan Feld "Die Burgen von Burgund / The Castles of Burgundy"(alea/Ravensburger, 2011). 2019년 20주년판(alea, 1~4명, 확장 8종 동봉)이 나왔고, 코리아보드게임즈가 이 20주년판을 한국어판 "버건디의 성"으로 판다(상품 페이지: 1~4명, 70~120분, 12세+, "1인용 게임·팀전 게임" 표기, 상자 그림이 20주년판의 금색 열쇠 세 개). **이 문서는 2019년판 규칙을 기본으로 한다.** 2023년 스페셜 에디션(Awaken Realms, 포도밭 확장)은 일부 규칙(수도원 6번, 3인 보급소 6번 칸 등)이 다르며 따로 표시한다.
- 인지도: 보드게임긱(BGG) 종합 순위 10위권대를 오래 지킨 대표 유로게임(조사 때 검색 결과 17위·평가 약 5만 8천 건, 나무위키 기재 15위), 2019년판 평점 약 8.45(약 1만 5천 건). BGG 페이지는 직접 열리지 않아(403) 검색 결과 숫자다. 2011년 독일 게임상(Deutscher Spiele Preis) 2위, 올해의 게임(Spiel des Jahres) 추천 목록, 인터내셔널 게이머스 어워드 후보. 보드게임 아레나(BGA)·Yucata에서도 인기 게임이다.
- 인원 근거: 기본 2~4명(BGG 추천 2명). 2019년판에 1인 솔로 규칙과 2:2 팀전 규칙이 들어 있다.
## 2. 모드와 옵션
"원작"은 2019년판 기본 규칙, "변형"은 2019년판 상자 안의 확장·고급 규칙이거나 다른 판·온라인판 규칙이다. 데이터가 아직 없어 바로 못 만드는 것은 **(데이터 필요)**로 표시했다(12장 참고).
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `mode` | 게임 방식 | `standard`(2~4명 개인전, 원작), `team`(4명 2:2 팀전, 2019 확장 9, **데이터 필요: 팀 공국 12a/12b**), `solo`(1명, 2019 확장 10) | `standard` |
| `duchy` | 공국(개인 판) 고르는 법 | `beginner`(모두 1번 공국, 원작 첫 게임 권장), `same-random`(모두 같은 무작위 공국, BGA), `random-each`(각자 무작위, BGA), `choose-of-two`(무작위 2개 중 골라 쓰기, 원작 숙련자 규칙·BGA "클래식") — `beginner` 말고는 **데이터 필요: 공국 2~10번** | `beginner` |
| `castleStart` | 시작 성 놓는 곳 | `center`(가운데 6번 칸, 원작 기본), `choose`(공국의 진초록 칸 중 아무 데나, 차례 순서대로 골라 공개, 원작 숙련자 규칙) | `center` |
| `monasteryRules` | 수도원(노란 타일) 수치 | `2019`(6번 = 7곳 모두에서 은화 2 또는 일꾼 2로 구매, 15번 = 종류당 2점, 26번 = 보너스 1장당 3점), `2011`(6번 = 7곳 모두에서 은화 2로 구매, 15번 = 3점, 26번 = 2점) | `2019` |
| `extraTiles` | 추가 육각 타일 4장(2019 확장 2): 수도원 27 다리, 28 일꾼, 검은 건물 기중기, 검은 가축 거위 | `true`, `false` | `false` |
| `inns` | 여관(2019 확장 6): 페이즈마다 여관 1장이 검은 보급소 옆에 쌓이고, 사서 놓으면 구역 크기 +1 | `true`, `false` | `false` |
| `shields` | 방패(2019 신규 확장): 같은 눈 두 개(더블)가 나오면 두 행동 대신 방패를 가져와 성 위에 올림. 페이즈마다 방패 1개당 은화 1 유지비 | `true`, `false` | `false` |
| `whiteCastles` | 흰 성(2019 확장 5): 놓으면 흰 주사위 눈으로 행동 1번 더(**데이터 필요: 타일 9장 구성**) | `true`, `false` | `false` |
| `tradeRoutes` | 무역로(2019 확장 8): 판 상품을 무역로 칸에 차례로 놓아 색이 맞으면 보너스(**데이터 필요: 무역로 12장 내용**) | `true`, `false` | `false` |
| `borderPosts` | 국경 초소 공국(2019 확장 4, 공국 11a~11f)(**데이터 필요**) | `true`, `false` | `false` |
| `soloTarget` | 솔로 목표 점수 표시기 시작 칸(낮을수록 쉬움) | 45, 48, 50, 52, 55 | 50 |
| `turnSeconds` | 한 차례(주사위 2개 + 구매) 제한 시간 | 60, 90, 120, 180, `null` | 120 |
| `showHints` | 일꾼 몇 개로 어디에 놓을 수 있는지, 다 채우기 직전 구역, 보너스 경쟁 상황 표시 | `true`, `false` | `true` |
- `playersFor`: `standard` 2~4, `team` 정확히 4, `solo` 정확히 1.
- 확장 옵션은 서로 함께 켤 수 있다(원작도 자유 조합). `solo`에서는 `shields`·`tradeRoutes`를 끈다(원작 솔로 규칙에 조합 설명 없음).
- 1차 구현 범위 제안: `standard` + `beginner` + `castleStart` + `monasteryRules` + `extraTiles` + `inns` + `shields` + `solo`(1번 공국으로 대신하는 하우스 규칙, 7장). 나머지는 데이터를 구한 뒤.
## 3. 구성물
2019년판 기본 게임(규칙서 구성물 목록 그대로).
- 육각 타일 164장(뒷면 색으로 더미를 나눔)
- 건물 56장 = 8종 × 7장(베이지 뒷면 40, 검은 뒷면 16 → 종류마다 베이지 5 + 검정 2)
- 가축 28장 = 4종(닭·양·돼지·소) × 7장(연두 뒷면 20, 검정 8). 한 장에 동물 2~4마리
- 수도원 26장 = 서로 다른 26종 각 1장(노랑 뒷면 20, 검정 6)
- 성 16장(진초록 14, 검정 2) — 그중 인원수만큼은 시작 성
- 광산 12장(회색 10, 검정 2)
- 배 26장(파랑 20, 검정 6)
- 상품 타일 42장: 6종 × 7장. 상품마다 주사위 눈 1~6이 하나씩 정해져 있다(같은 종류 = 같은 눈 = 같은 색).
- 은화 24개, 일꾼 26개(둘 다 모자라면 무한으로 친다 — 원작 명시)
- 색 보너스 타일 12장: 6색(성·광산·수도원·건물·가축·배)마다 큰 것 1장 + 작은 것 1장
- 주사위 9개: 플레이어 색 2개씩 + 흰 주사위 1개
- 가운데 판 1장(양면: 4인용 / 2·3인용), 공국 판(1·2번 각 4장, 3~10번 각 1장), 점수 100/200 표시 타일
### 3.1 가운데 판
- 페이즈 칸 A~E(각 칸에 그 페이즈 상품 5장을 뒷면으로 쌓음), 라운드 칸 5개(페이즈 시작 때 상품 5장을 앞면으로 펼침 — 남은 장 수 = 남은 라운드)
- 번호 보급소 1~6: 육각 타일 칸 4개(인원에 따라 2·3·4개 사용) + 상품 놓는 큰 칸 1개
- 가운데 검은 보급소: 육각 칸 8개(2명 4칸, 3명 6칸, 4명 8칸)
- 차례 트랙("다리"), 색 보너스 칸 6개, 점수 트랙 0~100
#### 3.1.1 보급소 칸 색
보급소 칸에는 색이 인쇄되어 있어서 "눈 N으로 가져올 수 있는 색"이 정해져 있다. 4인 칸 24개의 색 합계(건물 8, 배 4, 가축 4, 수도원 4, 성 2, 광산 2)에 5페이즈를 곱하면 원작 타일 수(베이지 40, 파랑 20, 연두 20, 노랑 20, 진초록 14 − 시작 성 4 = 10, 회색 10)와 정확히 맞는다. 2인·3인 칸 구분은 공개 구현체(ultimate271/Castles) 한 곳에서 가져온 값이라 실물 확인이 필요하다.
| 보급소 | 2명부터 쓰는 칸 | 3명부터 더하는 칸 | 4명일 때 더하는 칸 |
|---|---|---|---|
| 1 | 배, 건물 | 수도원 | 가축 |
| 2 | 성, 수도원 | 건물 | 건물 |
| 3 | 가축, 건물 | 배 | 수도원 |
| 4 | 배, 건물 | 가축 | 광산 |
| 5 | 광산, 수도원 | 건물 | 건물 |
| 6 | 가축, 건물 | 성(3명일 때 A·C·E 페이즈는 성, B·D 페이즈는 광산) | 배 |
- 3인 예외(6번 보급소의 반은 초록·반은 회색 칸): A·C·E 페이즈에는 성, B·D 페이즈에는 광산을 놓는다(Yucata 규칙·BGA 설명. 4인에서는 그 칸이 그냥 성 칸).
### 3.2 공국(개인 판)
- 내 판 오른쪽 = 공국 37칸(육각형 모양, 한 변 4칸). 칸마다 색과 주사위 눈 1~6이 인쇄되어 있다. 같은 색이 붙어 있는 덩어리를 **구역**이라 한다(베이지 구역 = 마을, 연두 구역 = 목초지, 파랑 구역 = 강).
- 내 판 아래 = 육각 타일 **보관 칸 3칸**. 위 = **상품 칸 3칸**(같은 종류는 한 칸에 쌓고, 종류는 최대 3가지), 판 상품을 뒷면으로 모아 두는 칸, 은화 칸, 일꾼 칸, 쓴 주사위 놓는 칸.
- 모든 공국은 같은 구성: 성 4칸, 광산 3칸, 수도원 6칸, 건물 12칸, 가축 6칸, 배 6칸(규칙서 "세 번째 광산이나 여섯 번째 수도원을 놓으면" 예, Yucata "공국 1번 마을 크기 1·5·3·3", 무작위 공국 생성기 burgundicer의 타일 수와 일치).
#### 3.2.1 1번 공국 지도 (기본 판)
좌표는 꼭짓점이 위로 향한 육각형의 축 좌표 `(q, r)`. `r`은 위에서 아래로 −3~3, 줄마다 `q`는 `max(−3, −3−r)`부터 `min(3, 3−r)`까지. 이웃 6칸: `(q±1, r)`, `(q, r±1)`, `(q+1, r−1)`, `(q−1, r+1)`.
글자: 목 = 가축(연두), 성 = 성(진초록), 수 = 수도원(노랑), 건 = 건물(베이지), 배 = 배(파랑), 광 = 광산(회색). 숫자 = 주사위 눈. `[성6]` = 시작 성 칸.
```
r=-3: 목6 성5 성4 수3
r=-2: 목2 목1 성6 수5 건4
r=-1: 목5 목4 건3 수1 건2 건3
r= 0: 배6 배1 배2 [성6] 배5 배4 배1
r= 1: 건2 건5 광4 건3 건1 목2
r= 2: 건6 광1 수2 건5 건6
r= 3: 광3 수4 수1 건3
```
| 구역 | 색 | 크기 | 칸 (q, r, 눈) |
|---|---|---|---|
| R1 | 가축 | 5 | (0,−3,6) (−1,−2,2) (0,−2,1) (−2,−1,5) (−1,−1,4) |
| R2 | 성 | 3 | (1,−3,5) (2,−3,4) (1,−2,6) |
| R3 | 수도원 | 3 | (3,−3,3) (2,−2,5) (1,−1,1) |
| R4 | 건물(마을) | 3 | (3,−2,4) (2,−1,2) (3,−1,3) |
| R5 | 건물(마을) | 1 | (0,−1,3) |
| R6 | 배(강) | 3 | (−3,0,6) (−2,0,1) (−1,0,2) |
| R7 | 성(시작) | 1 | (0,0,6) |
| R8 | 배(강) | 3 | (1,0,5) (2,0,4) (3,0,1) |
| R9 | 건물(마을) | 3 | (−3,1,2) (−2,1,5) (−3,2,6) |
| R10 | 광산 | 3 | (−1,1,4) (−2,2,1) (−3,3,3) |
| R11 | 건물(마을) | 5 | (0,1,3) (1,1,1) (0,2,5) (1,2,6) (0,3,3) |
| R12 | 가축 | 1 | (2,1,2) |
| R13 | 수도원 | 3 | (−1,2,2) (−2,3,4) (−1,3,1) |
- 출처와 검증: 두 공개 구현체(ultimate271/Castles의 Haskell `standardSlots`, jackbelyeu/CoB의 `boardOne`)가 색·눈이 완전히 같고, ultraboardgames 규칙 요약의 1번 공국 사진을 확대해 줄마다 눈을 대조해 일치함을 확인했다. 사진 해상도가 낮아 2·3 눈(대각선 점) 몇 칸은 실물로 한 번 더 확인하면 좋다. 다른 구현체(mangorine/Burgundy)는 색은 같고 눈이 달라 쓰지 않았다.
- 2019년판 1번 = 2011년판 1번과 같은 판(BGA 설명: 2019년판은 새 2번 판을 넣고 옛 2번을 10번으로 바꿈).
- 눈 분포(시작 성 제외 36칸): 1이 7칸, 2~5가 6칸씩, 6이 5칸.
- 엔진 데이터: 칸 37개를 `r` → `q` 순서로 0~36번 ID를 붙인다(0 = (0,−3), 18 = 시작 성 (0,0), 36 = (0,3)). 구역은 데이터에 적지 않고 "같은 색 이웃끼리 연결"로 계산하고, 테스트로 위 13개 구역과 같은지 확인한다.
### 3.3 타일 상세
- 건물 8종: 창고, 목공소, 교회, 시장, 하숙집, 은행, 시청, 망루(효과는 5.7).
- 가축: 닭·양·돼지·소. 종류마다 7장(연두 5 + 검정 2로 추정). **2·3·4마리 장 수 분포는 데이터 필요**(규칙서·공개 자료에 표가 없음. 실물 확인 전까지 종류마다 2마리 2장, 3마리 3장, 4마리 2장으로 둔다).
- 수도원 26종: 5.8 표. **어느 6종이 검은 뒷면인지 데이터 필요**. 실물 확인 전까지는 임시 고정 목록(2·3·4·13·24·25번)을 검은 뒷면으로 두고, 확인되면 데이터 파일 한 곳만 고친다.
- 상품 6종: 눈 1~6. 이름은 화면용으로 자체 지정(예: 1 포도주, 2 곡물, 3 비단, 4 도자기, 5 장신구, 6 꿀) — 원작 색·그림과 같을 필요 없음.
## 4. 준비(셋업)
1. 인원에 맞게 가운데 판 칸을 쓴다(2명 = 보급소마다 2칸 + 검은 4칸, 3명 = 3칸 + 검은 6칸, 4명 = 4칸 + 검은 8칸).
2. 육각 타일을 뒷면 색으로 나눠 각각 섞어 뒷면 더미로 둔다(시작 성용 진초록 타일은 인원수만큼 먼저 뺀다).
3. 상품 42장을 섞어 5장씩 5더미를 A~E 페이즈 칸에 뒷면으로 놓는다. 남은 17장에서 각자 3장씩 무작위로 받아 상품 칸에 앞면으로 둔다(같은 종류는 쌓음). 그래도 남은 상품은 게임에서 뺀다.
4. 색 보너스 타일 12장을 제자리에(큰 것이 작은 것 위).
5. 각자: 공국 판(옵션 `duchy`), 시작 성 1장을 시작 칸에(옵션 `castleStart`, 기본 가운데 6번 칸), 주사위 2개, 은화 1개, 점수 0.
6. 시작 플레이어를 무작위로 정한다(원작: 주사위가 가장 높은 사람). 일꾼: 1번째 1개, 2번째 2개, 3번째 3개, 4번째 4개.
7. 차례 트랙 1번 칸에 모두의 말을 쌓는다(시작 플레이어가 맨 위, 마지막 사람이 맨 아래). 시작 플레이어가 흰 주사위를 갖는다.
8. `castleStart='choose'`면 차례 순서대로 성 놓을 칸을 고르고 바로 공개한다(원작 숙련자 규칙은 동시/순서 중 합의 — 우리는 순서대로).
## 5. 진행 규칙
### 5.1 큰 흐름
- 페이즈 A~E 5번, 페이즈마다 라운드 5번 = 모두 25라운드. 라운드마다 각자 차례 1번, 차례마다 주사위 행동 2번 = 1인당 행동 50번.
### 5.2 페이즈 시작
1. (A 페이즈는 건너뜀) 번호 보급소와 검은 보급소에 남은 육각 타일을 모두 게임에서 뺀다. **상품은 그대로 둔다.** 여관(옵션)도 그대로 둔다.
2. 번호 보급소의 쓰는 칸마다 그 칸 색 더미에서 1장씩 뽑아 앞면으로 놓는다(3인 6번 보급소 예외는 3.1.1). 더미가 비면 그 칸은 비워 둔다.
3. 검은 보급소 칸(4/6/8)을 검은 더미에서 채운다.
4. 이번 페이즈 상품 5장을 라운드 칸 5개에 앞면으로 펼친다(다음 5라운드에 나올 상품이 모두에게 보임).
5. 여관 옵션: 여관 1장을 검은 보급소 옆 더미 맨 위에 올린다.
### 5.3 라운드 시작
1. 모두 주사위 2개를 굴리고, 시작 플레이어는 흰 주사위도 굴린다. 모든 눈이 모두에게 보인다(그래서 미리 계획할 수 있다).
2. 시작 플레이어 차례가 시작될 때 라운드 칸의 맨 앞 상품 1장을 흰 주사위 눈과 같은 번호 보급소의 상품 칸에 놓는다. 흰 주사위는 이걸로 끝이다(행동에 못 쓰고, 일꾼으로 바꿀 수도 없다).
3. 차례 순서: 차례 트랙에서 가장 앞(가운데에 가까운) 칸부터, 같은 칸이면 위에 있는 말부터. 라운드 도중 배로 말이 움직여도 이미 차례를 마친 사람만 움직이므로, 라운드 시작 때 정한 순서와 결과가 같다(엔진은 라운드 시작 때 순서를 저장).
### 5.4 내 차례
- 주사위 2개를 하나씩 써서 행동 2번을 한다. 순서·조합 자유, 같은 행동 2번도 된다. 쓴 주사위는 쓴 칸으로.
- 그와 별도로 차례 중 **아무 때나 1번** 검은 보급소에서 타일 1장을 살 수 있다(은화 2개). 행동 전·사이·후, 2019년판은 행동 도중(예: 성 보너스 행동 사이)에도 된다.
- 주사위를 쓰지 않고 차례를 끝낼 수도 있다(원작에 금지 규정 없음. 다만 "일꾼 받기"는 언제나 가능하므로 화면은 남은 주사위가 있으면 한 번 더 묻는다).
- 방패 옵션: 내 주사위 두 개가 같은 눈(일꾼으로 맞춘 것도 됨)이면, 두 행동 대신 그 눈 번호 보급소의 방패를 가져올 수 있다(5.11.3).
### 5.5 일꾼으로 눈 바꾸기
- 일꾼 1개를 내면(공급처로) 주사위 하나의 눈을 ±1 바꾼다. 6↔1도 1칸으로 이어진다(6 다음 1). 여러 개를 써서 여러 칸 바꿀 수 있다. 예: 2 → 6은 일꾼 2개(2→1→6).
- 엔진에서는 주사위를 쓸 때 "원하는 눈"을 고르면 필요한 일꾼 수를 계산해 그때 낸다: 원 눈과 원하는 눈의 원형 거리 `d`(0~3). 수도원 9·10·11·12번의 공짜 ±1이 그 행동에 적용되면 `d − 1`(최소 0). 수도원 8번이 있으면 일꾼 1개가 ±2라서 `ceil(남은 거리 / 2)`개, 없으면 `남은 거리`개.
- 흰 주사위는 바꿀 수 없다(흰 성 확장의 "흰 주사위 눈으로 행동"은 예외 — 그때 쓸 눈을 일꾼으로 바꿀 수 있지만 흰 주사위 자체는 그대로).
### 5.6 주사위 행동 4가지
1. **타일 가져오기**: 주사위 눈 = 보급소 번호. 그 보급소의 육각 타일 1장을 골라 내 보관 칸(3칸)의 빈칸에 놓는다(공국에 바로 놓지 않는다). 보관 칸이 꽉 찼으면 먼저 보관 칸의 타일 1장을 버려(게임에서 뺌) 자리를 만들어야 한다. 검은 보급소에서는 가져올 수 없다.
2. **타일 놓기**: 보관 칸의 타일 1장을 공국의 빈칸에 놓는다. 조건 셋: (가) 칸의 색 = 타일 색, (나) 칸의 눈 = 주사위 눈, (다) 이미 놓인 타일(시작 성 포함)과 한 변 이상 맞닿음. 그래서 첫 타일은 시작 성 주변 6칸 중 하나에만 놓을 수 있다. 놓은 타일은 옮기거나 빼거나 덮을 수 없다. 놓으면 바로 그 타일 효과(5.7)와 구역·색 완성 점수(5.9)가 생긴다.
3. **상품 팔기**: 주사위 눈 = 상품 종류. 내 상품 칸에 그 종류가 있으면 그 종류를 **전부** 판다(일부만 못 판다). 판 상품은 뒷면으로 내 "판 상품" 칸에 모은다. 받는 것: 은화 정확히 1개(몇 장을 팔든) + 판 장수 × (2명 2점, 3명 3점, 4명 4점). 팀전은 4명이므로 4점.
4. **일꾼 받기**: 눈과 상관없이 일꾼 2개.
### 5.7 타일 색별 효과(공국에 놓을 때)
- **성(진초록)**: 바로 행동 1번 더 — 원하는 눈의 가상 주사위 하나를 쓴 것처럼 4가지 행동 중 하나(일꾼 비용 없음). 예: 다른 타일을 바로 놓기, 일꾼 2개 받기.
- **광산(회색)**: 놓을 때 효과 없음. 페이즈가 끝날 때마다 내 공국의 광산 1개당 은화 1개.
- **수도원(노랑)**: 5.8 표의 능력. 지속 효과는 놓은 뒤부터, 점수형은 게임 끝에 계산. 보관 칸에 있는 수도원은 효과가 없다.
- **배(파랑)**: 두 가지가 바로 일어난다. (1) 번호 보급소 아무 곳(주사위 눈과 상관없음)의 상품을 **전부** 가져와 상품 칸에 놓는다. 상품 칸은 종류 3가지까지라서 새 종류를 둘 칸이 없으면 그 상품은 보급소에 남는다(넘칠 때 어느 종류를 가져올지는 내가 고름). 빈 보급소를 골라도 된다. (2) 차례 트랙에서 내 말을 한 칸 앞으로. 그 칸에 말이 있으면 그 위에 올린다. 이로써 다음 라운드 시작 플레이어가 되면 흰 주사위를 받는다.
- **가축(연두)**: 바로 점수 = 새 타일의 동물 수 + 같은 목초지(이어진 연두 구역)에 이미 있는 **같은 종류** 타일의 동물 수 전부. 바로 붙어 있을 필요는 없고, 다른 목초지는 세지 않는다. 예: 양 4 타일이 있는 목초지에 양 3을 놓으면 3+4 = 7점, 같은 곳에 돼지 2를 놓으면 2점.
- **건물(베이지)**: 놓을 때 한 번만 효과(주사위·행동 소모 없음). **한 마을(이어진 베이지 구역)에는 같은 종류 건물을 1개만** 놓을 수 있다(수도원 1번이 있으면 예외). 효과를 쓸 수 없는 상황이어도 놓을 수는 있고 효과는 사라진다.
| 건물 | 효과 |
|---|---|
| 창고 | 내 상품 한 종류를 골라 "상품 팔기"와 똑같이 판다(주사위 없이) |
| 목공소 | 번호 보급소 아무 곳에서 건물(베이지) 타일 1장을 보관 칸으로(검은 보급소 불가) |
| 교회 | 번호 보급소 아무 곳에서 광산·수도원·성 타일 중 1장을 보관 칸으로(검은 보급소 불가) |
| 시장 | 번호 보급소 아무 곳에서 배·가축 타일 중 1장을 보관 칸으로(검은 보급소 불가) |
| 하숙집 | 일꾼 4개 |
| 은행 | 은화 2개 |
| 시청 | 보관 칸의 타일 1장을 더 놓는다. 색은 무엇이든 되고 **주사위 눈 조건은 없다**(색 일치·맞닿음은 지킴). 그 타일 효과도 그대로 일어난다 |
| 망루 | 4점 |
- 목공소·교회·시장으로 가져올 때 보관 칸이 꽉 찼으면 "타일 가져오기"처럼 1장을 버리고 받는다(원작은 가져오기 행동에서만 명시 — 같은 원리로 처리, 12장 확인 목록).
### 5.8 수도원(노란 타일) 26종 + 확장 2종
| 번호 | 짧은 이름 | 효과 | 종류 |
|---|---|---|---|
| 1 | 자유 건축 | 한 마을에 같은 종류 건물 여러 개 허용 | 지속 |
| 2 | 광부 | 페이즈 끝에 광산 1개당 은화 1에 더해 일꾼 1 | 페이즈 끝 |
| 3 | 상인 | 상품을 팔 때(행동·창고 모두) 은화 1 대신 2 | 지속 |
| 4 | 장사 일꾼 | 상품을 팔 때 일꾼 1개 더 | 지속 |
| 5 | 큰 배 | 배를 놓을 때 고른 보급소의 이웃 보급소 상품도 전부 가져옴(보급소는 고리 1–2–3–4–5–6–1로 이웃) | 지속 |
| 6 | 넓은 장터 | 2019: 검은 보급소뿐 아니라 번호 보급소 6곳에서도 살 수 있고, 은화 2 대신 일꾼 2로도 낼 수 있음. 여전히 차례당 1장. 2011: 7곳 모두에서 은화 2로 구매. (스페셜 에디션: 차례당 1번 일꾼 2로 번호 보급소의 건물 1장) | 지속 |
| 7 | 목동 | 가축을 놓아 점수가 날 때 점수 나는 가축 타일 1장마다 +1점. 예: 양 4가 있는 곳에 양 3 → (3+1)+(4+1) = 9점 | 지속 |
| 8 | 힘센 일꾼 | 일꾼 1개로 ±2(±1도 가능) | 지속 |
| 9 | 건축가 | 건물을 놓을 때 주사위 ±1 공짜 | 지속 |
| 10 | 뱃사공·목자 | 배·가축을 놓을 때 ±1 공짜 | 지속 |
| 11 | 성주 | 성·광산·수도원을 놓을 때 ±1 공짜 | 지속 |
| 12 | 수집가 | 보급소에서 타일을 가져올 때 ±1 공짜 | 지속 |
| 13 | 품삯 | "일꾼 받기" 행동 때 은화 1 더(하숙집에는 적용 안 됨) | 지속 |
| 14 | 일꾼 마을 | "일꾼 받기" 행동 때 일꾼 2 대신 4(하숙집에는 적용 안 됨) | 지속 |
| 15 | 다양한 상품 | 게임 끝: 한 번이라도 판 상품 종류 1개당 2점(2011: 3점) | 게임 끝 |
| 16~23 | 건물 장인 8종 | 게임 끝: 각 타일이 가리키는 건물 종류를 내 공국에 놓은 수 × 4점. 8장이 건물 8종에 하나씩. 17 = 망루, 22 = 은행은 규칙서 예시로 확인, 나머지 번호 대응은 실물 확인 필요(엔진은 번호 대신 `K-B-<건물>` ID 사용) | 게임 끝 |
| 24 | 가축 종류 | 게임 끝: 내 공국의 가축 종류 1개당 4점 | 게임 끝 |
| 25 | 무역량 | 게임 끝: 판 상품 1장당 1점 | 게임 끝 |
| 26 | 명예 | 게임 끝: 가진 색 보너스 타일(큰 것·작은 것) 1장당 3점(2011: 2점) | 게임 끝 |
| 27 (확장) | 다리 | 차례 트랙에서 내 말이 다른 말과 같은 칸이면 언제나 맨 위(남이 와도 내가 위) | 지속 |
| 28 (확장) | 일꾼 사기 | 언제든 은화 1로 일꾼 2개를 살 수 있음 | 지속 |
| 29 (흰 성 확장으로 추정) | 건물 장인 | 16~23과 같은 방식(대상 건물 미확인, `whiteCastles`와 함께 데이터 필요) | 게임 끝 |
- 공짜 ±1(9~12번)은 일꾼과 함께 쓸 수 있고, 한 행동에 공짜 ±1은 한 번만 적용한다.
- 게임 끝 점수형 수도원은 공국에 놓인 것만 센다(보관 칸 제외).
### 5.9 구역 완성 점수와 색 보너스
- 타일을 놓아 한 구역의 모든 칸이 채워지면 바로 두 가지 점수:
1. 크기 점수: 1칸 1점, 2칸 3점, 3칸 6점, 4칸 10점, 5칸 15점, 6칸 21점, 7칸 28점, 8칸 36점(여관으로 9칸이면 45점).
2. 페이즈 점수: A 10점, B 8점, C 6점, D 4점, E 2점(크기와 상관없이 구역 하나에).
- 시작 성 칸(1칸 구역)은 셋업 때 채워지므로 점수가 없다.
- **색 보너스**: 공국에서 한 색의 칸을 **모두** 처음 채운 사람이 그 색 큰 보너스 타일(2명 5점, 3명 6점, 4명 7점), 두 번째로 채운 사람이 작은 타일(2명 2점, 3명 3점, 4명 4점). 세 번째부터는 없다. 같은 차례에 두 색을 채우면 둘 다 받는다.
- 점수 트랙은 100점을 넘으면 100 표시, 200점을 넘으면 200 표시(엔진은 그냥 숫자).
### 5.10 페이즈 끝과 게임 끝
- 페이즈 끝(5라운드 뒤): (방패 옵션이면 먼저 방패 유지비) → 각자 광산 1개당 은화 1(수도원 2번이면 일꾼 1도) → 다음 페이즈 시작(5.2).
- E 페이즈가 끝나면 최종 점수(6장).
### 5.11 확장 모듈 규칙
#### 5.11.1 추가 타일 4장(`extraTiles`)
- 수도원 27 다리, 28 일꾼 사기: 노랑 더미에 섞는다(5.8).
- 기중기(검은 건물): 놓을 때 아무 건물 효과 하나를 쓴다(내 공국에 없는 건물이어도). 게임 끝에는 16~23(+29) 수도원 계산에서 원하는 건물 1개로 친다(놓을 때 쓴 효과와 달라도 됨).
- 거위(검은 가축, 거위 2마리): 놓을 때 2점 + 같은 목초지의 다른 가축 한 종류를 골라 그 종류 타일 점수 전부. 그 뒤 같은 목초지에 가축을 놓을 때마다 거위 2점도 더 받는다. 수도원 7·24번에서 거위는 별도 종류.
#### 5.11.2 여관(`inns`)
- 페이즈마다 여관 1장이 검은 보급소 옆 더미 맨 위로(페이즈가 바뀌어도 치우지 않음). 검은 보급소 구매로 맨 위 1장을 살 수 있다(은화 2).
- 공국의 아무 색 빈칸에 놓을 수 있다(눈·맞닿음 규칙은 그대로). 구역마다 여관은 1장까지. 효과는 없고, 그 구역 크기를 1 늘린다(크기 4 구역에 여관 → 크기 5로 15점). 색 보너스 계산에서는 그 칸이 채워진 것으로 본다.
#### 5.11.3 방패(`shields`)
- 셋업: 방패 18장 중 무작위로 2명 보급소마다 1장, 3명 1·3·5번 1장·2·4·6번 2장, 4명 보급소마다 2장을 앞면으로. 가져가도 다시 채우지 않는다.
- 더블이면 두 행동 대신 그 번호 보급소의 방패 1장을 가져와 내 공국의 성 타일(시작 성 포함) 위에 놓는다. 빈 성이 없으면 있는 방패를 바꿔 낀다(옛 방패는 게임에서 뺌).
- 페이즈 끝(광산 은화 받기 전)에 방패 1개당 은화 1. 안 내거나 못 내면 그만큼 방패를 뺀다.
- 방패 18종(2019·스페셜 에디션 규칙서 같음, 괄호는 게임 끝 점수): 1 모든 목초지를 하나로 침(12) / 2 남이 일꾼을 받을 때마다 나도 1개(12) / 3 유지비를 일꾼으로도 냄(12) / 4 보관 칸 무제한(12) / 5 배를 놓을 때 상품 한 종류를 골라 6곳에서 그 종류를 더 가져옴(12) / 6 한 사람을 골라 그 사람 공국의 수도원 효과를 나도 받음(27번 제외)(12) / 7 새로 받는 색 보너스 2배(8) / 8 광산 은화 2배(8) / 9 상품 1장 팔 때마다 은화 1(8) / 10 게임 끝 점수형 수도원 2배(8) / 11 성을 놓을 때 보너스 행동 대신 방패 가져오기 가능(8) / 12 상품 판매 점수 2배(8) / 13 게임 끝 방패 점수 2배(4) / 14 페이즈 끝 번호 보급소 타일 1장을 공국에 바로 놓음(4) / 15 페이즈 끝 검은 보급소 타일 1장을 바로 놓음(4) / 16 차례마다 주사위 1개를 원하는 눈으로(4) / 17 구역 완성 때 한 칸 큰 구역 점수(4) / 18 맞닿지 않은 칸에도 놓기(4).
#### 5.11.4 팀전(`mode='team'`, 데이터 필요)
- 2명씩 두 팀. 팀마다 팀 공국(12a1+12a2 두 반쪽, 숙련자는 12b) 하나, 성은 가운데 진초록 1번 칸(12b는 1번 또는 6번 칸 중 선택). 시작 자원: 팀 A 일꾼 3, 팀 B 일꾼 5, 팀마다 은화 2, 상품 3장(팀 공용).
- 각자 주사위 2개·차례 말·점수 말. 첫 라운드 순서 A1, B1, A2, B2, 그 뒤는 차례 트랙대로.
- 팀 공용 보관 칸 2칸 + 각자 개인 보관 칸 2칸. 일꾼·은화·상품·공용 보관 칸은 함께 쓰고, 남의 주사위와 개인 보관 칸은 못 쓴다. 보관 칸끼리 옮기기 불가. 팀원은 팀 공국 어느 반쪽에도 놓을 수 있다.
- 차례 트랙 끝 칸에서 배를 놓으면 그 칸 더미의 맨 위로 간다.
- 점수는 두 사람 합. 동점이면 공국 빈칸이 더 많은 팀.
#### 5.11.5 솔로(`mode='solo'`)
- 시작: 은화 1, 일꾼 2, 상품 3장(상품 종류 수 제한 없음), 솔로 공국(13A 쉬움 / 13B 어려움, 데이터 필요 — 없으면 1번 공국으로 대신, 7장)의 아무 성 칸에 성. 2인용 가운데 판 칸(보급소마다 2칸 + 검은 4칸).
- 점수 말은 0, 차례 말을 "목표 표시기"로 `soloTarget`(기본 50) 칸에.
- 25라운드. 라운드마다 주사위 3개(흰 포함)를 굴려 (1) 다음 상품을 흰 주사위 번호 보급소에, (2) 그 보급소에서 타일 1장을 게임에서 뺀다(정해진 순서로 첫 타일. 비었으면 시계 방향 다음 보급소), (3) 내 주사위 2개로 행동.
- 바뀌는 점: 다른 구역으로는 **강을 통해서만** 넓힐 수 있다(엔진 해석: 새 구역의 첫 타일은 같은 색 구역이나 강 구역 타일과 맞닿아야 함 — 규칙서 문장이 짧아 해석 표시). 배를 놓으면 상품을 가져온 뒤 다른 모든 보급소의 상품을 게임에서 빼고, 이때만 상품 5장으로 검은 보급소 타일 1장을 뒷면(검은 면)으로 받을 수 있다. 뒷면 타일은 아무 색 칸에 놓을 수 있지만 효과는 없다(구역·색 완성에만 씀). 수도원 점수는 놓자마자 받는다. 색 보너스 대신 검은 보급소 타일 1장을 공국에 바로 놓는다(연쇄 가능).
- 점수를 얻을 때마다 은화 1로 1점씩 더 살 수 있다. 점수가 목표 표시기에 닿으면 점수를 0으로 되돌리고(넘친 점수 버림) 목표를 5 낮추고(최소 5) 원하는 눈으로 행동 1번(성과 같음).
- 25라운드 안에 공국 37칸을 모두 채우면 승리, 아니면 패배.
#### 5.11.6 흰 성·무역로·국경 초소(데이터 필요, 규칙만 기록)
- 흰 성: 9장을 건물·수도원·검은 더미에 섞는다. 놓으면 그 라운드 흰 주사위 눈으로 행동 1번(일꾼으로 바꿀 수 있음).
- 무역로: 각자 무역로 카드(4명 3장, 3명 4장, 2명 5장, 카드마다 3칸)를 무작위 순서로. 상품을 팔 때 판 상품을 왼쪽부터 한 장씩 칸에 놓고, 색이 칸과 맞으면 그 칸 보너스. 칸이 다 차면 평소처럼 판 상품 칸으로.
- 국경 초소(공국 11a~f): 초소 두 곳을 타일로 이으면 현재 페이즈 점수(10/8/6/4/2), 세 곳을 처음 이은 사람 5/6/7점, 두 번째 2/3/4점.
### 5.12 예시
- 2명, B 페이즈. 내 주사위 3과 5, 일꾼 1, 은화 2. 보관 칸에 시장(건물)과 소 3(가축).
1. 주사위 3으로 시장을 1번 공국 R11 마을의 (0,1) 건3 칸에 놓는다(시작 성과 맞닿음). 시장 효과로 4번 보급소의 배 1장을 보관 칸으로.
2. 주사위 5로 방금 받은 배를 (1,0) 배5 칸에 놓는다(시작 성과 맞닿음). 배 효과로 상품이 가장 많은 보급소의 상품을 모두 가져오고 차례 트랙에서 한 칸 앞으로. 만약 배를 (2,0) 배4 칸에 놓고 싶다면 일꾼 1개(5→4)가 들지만, (2,0)은 아직 놓인 타일과 맞닿지 않아 놓을 수 없다.
3. 차례 중 은화 2로 검은 보급소의 광산 1장 구매(남은 은화 0). 소 3은 보관 칸에 남는다.
- 4명, A 페이즈에 3칸 수도원 구역 R3을 다 채움: 6점 + 10점 = 16점. 그 사람이 처음으로 수도원 6칸을 모두 채웠다면 큰 보너스 7점 더.
- 3명, 상품 4장 판매: 은화 1 + 4 × 3 = 12점(수도원 3번이 있으면 은화 2).
## 6. 승패와 점수 계산
- 게임 중 점수: 구역 완성(크기 + 페이즈), 색 보너스, 가축, 망루, 상품 판매, (확장) 방패·초소 등.
- 게임 끝 추가 점수: 팔지 않은 상품 1장당 1점, 은화 1개당 1점, 일꾼 2개당 1점(내림), 공국에 놓인 점수형 수도원(15, 16~23, 24, 25, 26, 확장 29), 방패 점수.
- 최종 점수 = 위의 합. 높은 순.
- 동점: (1) 공국의 **빈칸이 더 많은** 사람이 위(같은 점수를 더 적은 타일로 냄). 영어 규칙서 인쇄본은 "빈칸이 더 적은 사람"이라 적었지만 Yucata와 BGA가 영어 번역 오류로 보고 "더 많은 사람"으로 고쳤고, 2019년판 팀전 규칙도 "빈칸이 더 많은 팀"이다. (2) 그래도 같으면 차례 트랙에서 **더 뒤에 있는** 사람이 위. (3) 그래도 같으면 공동 순위.
- 예: A 182점(빈칸 3), B 182점(빈칸 5) → B 1위.
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
- 공식 숙련자 규칙: 무작위 공국과 앞뒷면 선택(`duchy='choose-of-two'`), 시작 성 위치 고르기(`castleStart='choose'`).
- 온라인판 방식(BGA): 같은 무작위 공국(`same-random`), 각자 무작위(`random-each`). BGA 기본값은 "8번 공국을 뺀 무작위"(8번이 불공평하다는 평이 많음) — 공국 데이터가 생기면 `random-each`에서 8번 제외를 기본으로 하자.
- 판 차이: `monasteryRules='2011'`(옛 판을 해 본 사람용).
- 하우스 룰: 솔로 모드를 1번 공국으로(솔로 공국 13A/B 데이터가 생기기 전 임시). 원작 솔로 규칙 그대로 쓰되 공국만 다르다고 화면에 표시.
- 지원하지 않는 것(기록만): 스페셜 에디션 포도밭 확장·샤토마(Châteauma)·쾌락 정원(5번째 확장, 2019년판에 없음), 카드 게임판, "짧은 판"(페이즈를 줄이면 페이즈 점수 균형이 깨져 넣지 않음).
## 8. 엔진 설계
### 8.1 상태(State)
```ts
type Color = 'castle' | 'mine' | 'monastery' | 'building' | 'livestock' | 'ship';
type Die = 1 | 2 | 3 | 4 | 5 | 6;
type BuildingKind = 'warehouse' | 'carpenter' | 'church' | 'market' | 'boarding' | 'bank' | 'townhall' | 'watchtower' | 'crane';
type Animal = 'chicken' | 'sheep' | 'pig' | 'cow' | 'goose';
interface TileDef { // 상수 테이블(3.3, 5.8), State에는 id만
id: string; // 'B-market-3', 'L-cow-3-a', 'K-07', 'K-B-bank', 'C-05', 'M-02', 'S-11', 'INN-1'
color: Color | 'inn';
back: 'colored' | 'black';
building?: BuildingKind;
animal?: Animal; count?: 2 | 3 | 4;
monastery?: number; // 1~29
}
interface DuchyDef { // 상수: 1번 공국 등(3.2.1)
id: string; // '1', '13A' ...
spaces: { id: number; q: number; r: number; color: Color; die: Die }[]; // 37칸
startSpaces: number[]; // 시작 성 후보(진초록 칸)
}
interface CobPlayer {
duchyId: string;
placed: Record<number, string>; // 칸 id → 타일 id
innRegions: number[]; // 여관이 들어간 구역 대표 칸
storage: (string | null)[]; // 보관 칸 3(방패 4번이면 늘어남), 팀전은 개인 2
goods: { die: Die; count: number }[]; // 상품 칸, 최대 3종(솔로 무제한)
sold: Record<Die, number>; // 판 상품(종류별 장수) — 본인만 내용 봄
silver: number;
workers: number;
vp: number;
dice: [Die, Die];
diceUsed: [boolean, boolean];
boughtThisTurn: boolean;
bonusTiles: { color: Color; size: 'large' | 'small' }[];
shields: Record<number, number>; // 성 칸 id → 방패 번호
bridge: { pos: number; height: number }; // 차례 트랙 칸, 같은 칸 안 높이(클수록 위)
conceded: boolean;
autoStreak: number; // 연속 자동 진행 수(자리 비움)
}
type Pending = // 맨 뒤가 지금 처리할 것(스택)
| { kind: 'bonusAction'; source: 'castle' | 'soloReset' | 'whiteCastle'; fixedDie?: Die }
| { kind: 'shipGoods'; extraAdjacent: boolean }
| { kind: 'takeFromDepot'; colors: Color[]; source: 'market' | 'carpenter' | 'church' }
| { kind: 'warehouseSell' }
| { kind: 'townhallPlace' }
| { kind: 'craneEffect' }
| { kind: 'geeseChoice'; regionSpace: number }
| { kind: 'shieldUpkeep'; player: PlayerId } // 페이즈 끝, 한 명씩
| { kind: 'soloBlackPlace' }; // 솔로 색 완성 보상
interface CobState {
options: CobOptions;
seats: PlayerId[]; // 방장부터 시계 방향
teams?: [PlayerId[], PlayerId[]];
phase: 0 | 1 | 2 | 3 | 4; // A~E
round: 0 | 1 | 2 | 3 | 4;
stage: 'castleChoice' | 'turn' | 'phaseEnd' | 'finished';
roundOrder: PlayerId[]; // 라운드 시작 때 차례 트랙으로 계산
turnIndex: number;
whiteDie: Die;
depots: Record<1|2|3|4|5|6, { slots: (string | null)[]; goods: Die[]; shields: number[] }>;
black: (string | null)[]; // 검은 보급소 4/6/8칸
innStack: string[]; // 맨 뒤가 맨 위
roundGoods: Die[]; // 이번 페이즈에 남은 상품(앞면, 공개)
phaseGoods: Die[][]; // 다음 페이즈 상품(뒷면, 비공개)
piles: Record<'castle'|'mine'|'monastery'|'building'|'livestock'|'ship'|'black', string[]>; // 뒷면 더미(비공개)
bonusLeft: Record<Color, ('large' | 'small')[]>;
players: Record<PlayerId, CobPlayer>;
teamPool?: Record<0 | 1, { silver: number; workers: number; goods: CobPlayer['goods']; storage: (string|null)[] }>;
solo?: { target: number };
pending: Pending[];
turnSeq: number;
deadlineAt: number | null;
log: GameEvent[]; // 최근 사건(화면 애니메이션용, 공개 정보만)
}
```
- 구역·이웃·마을·목초지는 `DuchyDef`에서 계산해 캐시한다(State에 넣지 않음).
- 불변식: 타일 총수(더미 + 보급소 + 보관 칸 + 공국 + 버린 것) = 164(+확장), 상품 총수 = 42.
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `CHOOSE_CASTLE` | `{ spaceId }` | 셋업, `castleStart='choose'`, 순서대로 | 진초록 칸 |
| `USE_DIE` | `{ die: 0\|1, value: Die, act }` | 현재 차례, `pending` 비어 있음, 그 주사위 안 씀 | 일꾼 비용(5.5) ≤ 보유. `act`별 조건 아래 |
| ↳ `act.take` | `{ tileId, discardIndex? }` | | 타일이 `value`번 보급소에 있음. 보관 칸이 꽉 찼으면 `discardIndex` 필수, 아니면 금지 |
| ↳ `act.place` | `{ storageIndex, spaceId }` | | 색 일치, 칸 눈 = `value`, 빈칸, 맞닿음, 건물이면 마을 중복 금지(수도원 1번 예외), 여관은 구역당 1장, 솔로 확장 규칙 |
| ↳ `act.sell` | `{}` | | `value` 종류 상품 보유 |
| ↳ `act.workers` | `{}` | | 항상(일꾼 비용 0으로 계산) |
| `USE_BONUS` | `{ value, act }` | `pending` 맨 뒤가 `bonusAction` | 위와 같되 일꾼 비용 없음(`fixedDie`면 그 눈, 흰 성은 일꾼으로 바꾼 값 허용) |
| `BUY` | `{ from: 'black' \| 1..6 \| 'inn', tileId, pay: 'silver' \| 'workers', discardIndex? }` | 현재 차례, 이번 차례 미구매 | 은화 ≥ 2. 번호 보급소·일꾼 지불은 수도원 6번(2019) 필요(2011은 번호 보급소만 은화로) |
| `SHIP_GOODS` | `{ depot, adjacent?: depot, keep?: Die[] }` | `pending=shipGoods` | 상품 칸 종류 3개 제한. `adjacent`는 수도원 5번 + 이웃 보급소 |
| `TAKE_FROM_DEPOT` | `{ depot, tileId, discardIndex? } \| { skip: true }` | `pending=takeFromDepot` | 색이 허용 목록, 번호 보급소만 |
| `WAREHOUSE_SELL` | `{ die } \| { skip: true }` | `pending=warehouseSell` | 그 종류 보유 |
| `TOWNHALL_PLACE` | `{ storageIndex, spaceId } \| { skip: true }` | `pending=townhallPlace` | 색·맞닿음·마을 중복(눈 조건 없음) |
| `CRANE_EFFECT` | `{ building }` | `pending=craneEffect` | 기중기 제외 건물 8종 |
| `GEESE_CHOICE` | `{ animal \| null }` | `pending=geeseChoice` | 같은 목초지에 있는 종류 |
| `TAKE_SHIELD` | `{ castleSpaceId, replace?: boolean }` | 현재 차례, `shields`, 두 주사위 미사용 | 두 주사위 값(일꾼 반영)이 같고, 그 번호 보급소에 방패 있음, 내 성 칸 |
| `SHIELD_UPKEEP` | `{ keep: number[], payWorkers?: number }` | `pending=shieldUpkeep`의 그 사람 | 은화(방패 3번이면 일꾼 포함) ≥ 남길 방패 수 |
| `BUY_WORKERS` | `{ times }` | 내 차례 아무 때, 수도원 28번 | 은화 ≥ `times` |
| `SOLO_BUY_VP` | `{ amount }` | 솔로, 점수 얻은 직후 | 은화 ≥ `amount` |
| `END_TURN` | 없음 | 현재 차례, `pending` 비어 있음 | 항상(남은 주사위는 버림) |
| `CONCEDE` | 없음 | 참가자 | 이후 차례 건너뜀, 점수 유지·최하위. 남은 사람 1명이면 종료(솔로는 패배) |
- 처리 순서(apply 안): 타일을 놓으면 → 구역 완성 점수 → 색 보너스 → 타일 효과(즉시 점수형은 바로, 선택이 필요하면 `pending`에 넣음). `pending`이 빌 때까지 다른 행동은 막는다(검은 보급소 구매·일꾼 사기는 `bonusAction` 대기 중에는 허용 — 2019 "행동 도중 구매").
- 두 주사위를 다 쓰고 `pending`이 비었고, 살 수 있는 타일이 없거나(은화 부족·이미 구매) 살 게 없으면 자동으로 `END_TURN`. 아니면 "구매하고 끝내기 / 그냥 끝내기"를 묻는다.
- 라운드 끝 → 다음 라운드(주사위 굴림). 5라운드 끝 → 페이즈 끝 처리 → 다음 페이즈 셋업.
- 이벤트: `diceRolled`, `goodsPlaced{depot}`, `tileTaken`, `tileBought`, `tileDiscarded`, `tilePlaced{space, tile}`, `regionDone{space, size, vp}`, `colorBonus{color, size, vp}`, `livestockScored`, `goodsSold{die, count, vp, silver}`, `workersTaken`, `shipped{depot, goods}`, `bridgeMoved`, `buildingEffect`, `phaseEnd{silver}`, `shieldTaken`, `gameOver`.
### 8.3 공개/비공개 정보 (view)
- 공개(모두·관전자): 모든 주사위 눈, 보급소·검은 보급소 타일, 보급소 상품·방패, 이번 페이즈 남은 상품(앞면), 각 공국·보관 칸·상품 칸, 은화·일꾼·점수, 색 보너스, 차례 트랙, 판 상품 **장수**.
- 비공개: 뒷면 더미 순서, 다음 페이즈 상품 더미, 남은 상품 풀, `rng`. 판 상품의 **종류**는 본인만(원작: 판 상품은 뒷면, 본인은 언제든 볼 수 있음 — 수도원 15번 계산에 필요). `secretsOf`는 더미 타일 id·다음 페이즈 상품·남의 `sold` 종류.
- view에 계산 결과를 넣는다: 내 차례면 주사위별 `legal` 목록(가져올 수 있는 타일, 놓을 수 있는 칸과 일꾼 비용, 팔 수 있는 상품), 구역별 남은 칸, 색 보너스까지 남은 칸, 예상 최종 점수(내 것만, `showHints`).
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
- 셋업: 시작 플레이어, 상품 42장 섞기(페이즈 5더미 + 시작 상품), 육각 더미 7개 섞기, `same-random`/`random-each`/`choose-of-two` 공국 뽑기, 방패 배치, 무역로 카드.
- 라운드마다: 각자 주사위 2개 + 흰 주사위 1개(좌석 순서대로 `1 + rng.int(6)`). 솔로는 흰 주사위 포함 3개.
- 페이즈 셋업: 더미 맨 위부터 뽑아 칸 순서대로 채우므로 추가 RNG 없음(더미는 셋업 때 섞음).
- 컴퓨터가 있으면 04 §5.1의 운(후보 시드 고르기)이 주사위·타일 배분에 적용된다.
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- `deadline`: 차례 시작 때 `now + turnSeconds`. 선택 대기(`pending`)가 새로 생기면 남은 시간이 20초보다 적을 때 20초로 늘린다. 방패 유지비는 사람마다 20초. 셋업 성 고르기 30초.
- `onTimeout`은 시스템 전용 `{ type: 'TIMEOUT' }`을 돌려주고, apply가 남은 차례를 결정적으로 끝낸다:
- `pending` 처리: `bonusAction` → 일꾼 받기, `shipGoods` → 담을 수 있는 상품이 가장 많은 보급소(동률이면 번호 작은 것), `takeFromDepot` → 보관 칸에 빈칸이 있으면 번호 작은 보급소의 첫 타일, 없으면 건너뜀, `warehouseSell` → 가장 많은 종류, `townhallPlace`·`geeseChoice` → 건너뜀/첫 후보, `craneEffect` → 은행, `shieldUpkeep` → 낼 수 있는 만큼 번호 작은 방패부터 유지.
- 안 쓴 주사위(작은 번호부터): 일꾼 없이 놓을 수 있는 타일이 있으면 놓는다(구역 완성 > 점수 큰 것 > 보관 칸 앞쪽). 없으면 일꾼 받기. 구매는 하지 않는다(자리 비운 사람 은화를 쓰지 않음). 그 뒤 `END_TURN`.
- 연결 끊긴 사람: 방의 유예 시간 뒤 같은 자동 진행. 3번 연속 자동이면 "자리 비움"으로 표시하고 그 사람 차례는 10초로 줄인다.
### 8.6 종료 조건과 결과(GameResult)
- E 페이즈 5라운드가 끝나고 페이즈 끝 처리 뒤 최종 점수 계산. 솔로는 37칸을 다 채운 순간 승리로 종료, 25라운드가 끝나면 패배.
```ts
interface CobResult extends GameResult {
// ranking: 6장 순위(팀전은 팀원이 같은 순위 묶음), scores: 최종 점수
breakdown: Record<PlayerId, {
inGame: number; goodsLeft: number; silver: number; workers: number;
monasteries: { id: string; vp: number }[]; shields: number; emptySpaces: number;
}>;
// scoreText: "182점", summary: "민수 182점으로 승리(빈칸 5개로 동점 우위)"
}
```
### 8.7 컴퓨터 상대 (`bots/castles-of-burgundy`)
- 입력은 `view` + `legal`만. 후보 수 = (주사위 2개 순서 × 행동) + 구매 여부. 한 차례를 "주사위 A 행동 → 주사위 B 행동 → 구매" 묶음으로 평가(가능한 묶음은 보통 수백 개라 전부 계산 가능).
- 점수 함수: 즉시 점수 + 자원 가치(은화 1 ≈ 1.2점, 일꾼 1 ≈ 0.6점, 보관 칸 타일 ≈ 그 타일을 놓을 수 있는 칸 수와 남은 라운드로 계산) + 구역 진척(남은 칸이 적을수록, 이른 페이즈일수록 가산) + 색 보너스 경쟁(남이 먼저 채울 것 같으면 가산) + 수도원 장기 가치(남은 행동 수 × 효과) + 배로 얻는 차례 앞당김.
- 단계(1~60): 1~20은 위 점수에 큰 잡음과 짧은 시야(이번 행동만), 21~40은 한 차례 묶음 전체, 41~60은 묶음 + 다음 라운드 기대값(다른 사람 주사위는 이미 보이므로 이번 라운드 남은 사람의 가져가기를 간단 예측). 오목류 `humanBest`처럼 단계별로 1등 수 확률을 둔다(`small` ≈ 2점, `critical` = 이번 차례 구역 완성으로 10점 이상 차이).
- 생각 시간은 06 §12를 따르되 묶음 계산이 길면 300ms 안에서 자른다. 테스트: 컴퓨터 4명 판이 끝까지 가고 평균 점수가 1단계 < 30단계 < 60단계.
## 9. UI/UX
- **PC(넓은 화면)**: 가운데 = 가운데 판(보급소 1~6을 고리로, 그 가운데 검은 보급소, 위에 페이즈·라운드 칸과 다음 상품, 옆에 색 보너스·차례 트랙). 오른쪽 = 내 공국(크게, 한 칸 56px 정도) + 보관 칸·상품 칸·은화·일꾼·주사위. 왼쪽 세로 띠 = 다른 사람 요약(점수, 은화, 일꾼, 작은 공국 썸네일 — 누르면 큰 창).
- **휴대폰 세로(최소 320px)**: 화면 아래에 늘 보이는 "내 주사위 줄"(주사위 2개, 일꾼·은화 수, [구매] [차례 끝] 버튼, 높이 64px). 그 위는 탭 3개 — [내 공국] [보급소] [다른 사람].
- 내 공국: 7칸 폭 육각판을 화면 폭에 맞춤(320px에서 한 칸 약 42px, 숫자 눈은 칸 가운데 큰 글씨). 두 손가락 확대와 길게 눌러 칸 정보.
- 보급소: 2열 × 3행 카드(보급소 번호, 타일 4개, 상품), 아래 검은 보급소 가로 스크롤.
- 행동 흐름: 주사위를 누르면 그 눈(과 일꾼으로 갈 수 있는 눈)으로 할 수 있는 일이 하이라이트되고 탭이 자동 전환(가져올 타일이 있으면 보급소, 놓을 곳이 있으면 공국). 일꾼이 드는 곳은 칸에 "일꾼 1" 배지. 칸을 누르면 하단 시트 "이 칸에 시장을 놓을까요? (일꾼 1개 사용) → 효과: 배·가축 1장 가져오기" + [놓기].
- 합법 수 하이라이트: 놓을 수 있는 빈칸은 테두리가 빛나고, 그 수로 구역이 완성되면 "+16점" 미리보기. 같은 마을에 이미 있는 건물은 회색 처리와 이유("이 마을엔 이미 시장이 있어요").
- 연쇄 효과(성·시청·시장 등)는 화면 위 배너 "성 보너스: 원하는 눈으로 행동 1번"과 큰 버튼 목록으로 하나씩.
- 애니메이션·소리(합성음): 주사위 굴림, 상품이 흰 주사위 보급소로 미끄러짐, 타일이 보급소→보관 칸→공국으로 날아감, 구역 완성 때 구역 전체가 반짝이고 점수 팝업, 색 보너스 "👑 첫 완성!" 배너, 배를 놓으면 차례 트랙 말이 한 칸 전진. 처음 들어올 때·다시 보기 건너뛰기에서는 울리지 않는다.
- 초보자 도움말: 첫 판에 "주사위 눈 = 보급소 번호 = 공국 칸 번호 = 상품 번호" 한 장 안내, 타일 색별 효과 표(원작 요약판 역할), 수도원 타일은 누르면 효과 설명. 색약 대비로 타일마다 색 + 그림 기호(성 🏰, 광산 ⛏, 수도원 📜, 건물 🏠, 가축 🐄, 배 ⛵).
## 10. 테스트 체크리스트
- [ ] 1번 공국 데이터: 37칸, 색 개수(성 4·광산 3·수도원 6·건물 12·가축 6·배 6), 계산한 구역이 3.2.1 표의 13개와 같음, 마을 크기 1·3·3·5.
- [ ] 셋업: 2/3/4명 보급소 칸 12/18/24 + 검은 4/6/8, 칸 색이 3.1.1 표와 같음. 3명 B·D 페이즈에 6번 보급소 성 칸이 광산. 시작 일꾼 1/2/3/4, 은화 1, 상품 3장, 페이즈 상품 5×5, 남은 상품은 게임에서 빠짐.
- [ ] 페이즈 셋업: 남은 육각 타일 제거, 상품·여관은 남음.
- [ ] 흰 주사위: 라운드 시작에 상품이 그 보급소로, 흰 주사위로는 행동 불가.
- [ ] 일꾼: 2→6이 2개, 6→1이 1개, 수도원 8번이면 3→6이 2개, 수도원 9번으로 건물 놓기 눈 3→4 공짜, 일꾼 부족이면 거부.
- [ ] 가져오기: 보관 칸 3장일 때 `discardIndex` 없으면 거부, 있으면 버리고 가져옴. 검은 보급소에서 주사위로 가져오기 거부.
- [ ] 놓기: 색 다름·눈 다름·안 맞닿음 각각 거부. 첫 타일은 시작 성 주변 6칸만. 같은 마을 같은 건물 거부, 수도원 1번이면 허용, 다른 마을이면 허용.
- [ ] 구역 완성: A 페이즈 3칸 = 16점, E 페이즈 5칸 = 17점. 시작 성 구역은 0점.
- [ ] 색 보너스: 2명 첫 완성 5점·둘째 2점, 4명 7·4점, 셋째 0점. 한 번에 두 색 완성 둘 다.
- [ ] 가축: 양 4 있는 목초지에 양 3 → 7점, 수도원 7번이면 9점, 다른 목초지의 양은 안 셈.
- [ ] 배: 상품 3종 보유 중 새 종류가 오면 보급소에 남음, 넘칠 때 고르기. 차례 트랙 이동·쌓기·흰 주사위 이동. 수도원 5번 이웃 보급소(6과 1 이웃).
- [ ] 성: 보너스 행동으로 타일 놓기 → 그 타일이 또 성이면 연쇄.
- [ ] 건물 8종 효과 각각, 효과를 못 써도 놓기 가능. 시청: 눈 조건 없이 놓기, 놓은 타일 효과 발동. 창고: 주사위 없이 판매.
- [ ] 판매: 3명 4장 = 은화 1 + 12점, 수도원 3·4번 적용, 일부만 팔기 불가.
- [ ] 일꾼 받기: 2개, 수도원 14번 4개, 13번 은화 +1, 하숙집에는 13·14 미적용.
- [ ] 구매: 차례당 1번, 은화 2, 2019 수도원 6번이면 번호 보급소·일꾼 지불 허용, 2011 옵션이면 일꾼 지불 거부.
- [ ] 페이즈 끝: 광산 1개당 은화 1, 수도원 2번이면 일꾼도.
- [ ] 게임 끝: 상품·은화·일꾼(2개당 1점, 내림)·수도원 15(2019 2점/2011 3점)·16~23·24·25·26(2019 3점/2011 2점) 계산.
- [ ] 동점: 빈칸 많은 사람 승, 그다음 차례 트랙 뒤인 사람 승.
- [ ] 확장: 여관 구역 크기 +1(4칸+여관 = 15점), 구역당 1장. 기중기 효과와 끝 점수 대상 선택. 거위 점수 예시(2+2+3 = 7, 뒤에 돼지 4 → 6). 방패: 더블일 때만, 유지비 못 내면 제거, 방패 17번 한 칸 큰 점수.
- [ ] 솔로: 라운드마다 흰 주사위 보급소 타일 1장 제거(빈 보급소면 다음), 배 놓으면 다른 상품 제거, 목표 도달 시 0으로·목표 −5·보너스 행동, 37칸 다 채우면 승리.
- [ ] 시간 초과: 모든 `pending` 종류에서 `TIMEOUT`이 합법적으로 차례를 끝냄, 은화를 쓰지 않음.
- [ ] 정보 유출: 다른 사람 view·이벤트에 더미 순서, 다음 페이즈 상품, 남의 판 상품 종류, `rng`가 없음.
- [ ] 불변식: 타일 164장(+확장)·상품 42장 보존. 무작위 대국 1,000판 끝까지(1판 행동 수 상한 4명 × 50 + 연쇄).
- [ ] 리플레이 결정성.
## 11. 참고 자료
- 2019년판 영어 규칙서 본문(RulesPal 전사, 구성물·기본 규칙·수도원·확장·팀전·솔로·방패): https://rulespal.com/the-castles-of-burgundy/rulebook
- 코리아보드게임즈 상품 페이지(한국어판, 1~4명·70~120분·솔로/팀전): https://www.koreaboardgames.com/product/detail?prdCd=PD2024002184GTDS
- 나무위키 "버건디의 성"(한국어 용어, 20주년판·스페셜 에디션 소개): https://namu.wiki/w/버건디의%20성
- BGA 도움말(1판·2019판 차이, 공국 고르기 방식, 3인 6번 보급소, 동점 규칙 정정): https://en.doc.boardgamearena.com/Gamehelpcastlesofburgundy
- Yucata 규칙(2011판 전체 규칙, 동점 정정, 3인 예외): https://www.yucata.de/en/Rules/CastlesOfBurgundy
- ultraboardgames 규칙·노란 타일(2011판 문구, 1번 공국 사진): https://www.ultraboardgames.com/castles-of-burgundy/game-rules.php , https://www.ultraboardgames.com/castles-of-burgundy/yellow-tiles.php
- 스페셜 에디션 규칙서 전사(비교용, danweizheng/castles-of-burgundy의 rules/rulebook-text.txt): https://github.com/danweizheng/castles-of-burgundy
- 1번 공국·보급소 칸 데이터 대조용 구현체: https://github.com/ultimate271/Castles (src/builtin.hs), https://github.com/jackbelyeu/CoB (src/game_logic/Game.ts)
- Wikipedia(영어·독일어, 수상 내역): https://en.wikipedia.org/wiki/The_Castles_of_Burgundy , https://de.wikipedia.org/wiki/Die_Burgen_von_Burgund
- BGG(2011판 84876, 2019판 271320): https://boardgamegeek.com/boardgame/84876 , https://boardgamegeek.com/boardgame/271320
## 12. 메모 (상표·법적 주의 등)
- **표시 이름**: 친구끼리 쓰는 사이트라 원래 이름 "버건디의 성"으로 표시한다(`13-decisions.md` 0절). 공개 서비스로 바꿀 때는 "Die Burgen von Burgund/The Castles of Burgundy"가 Ravensburger(alea)의 상표이므로 자체 이름(후보: "부르고뉴 영주", "여섯 색 공국")으로 바꾼다. 원작 그림·아이콘·규칙서 문장은 쓰지 않고 타일 그림은 자체 기호로 그린다.
- **확인이 필요한 데이터**(구현 전에 실물 또는 규칙서 PDF로):
1. 가축 타일 28장의 종류별 2·3·4마리 분포, 검은 뒷면 가축이 어느 것인지.
2. 수도원 26종 중 검은 뒷면 6종이 몇 번인지, 16~23번과 건물의 대응(17 망루·22 은행만 확인).
3. 2인·3인 보급소 칸 색(3.1.1 — 4인 합계는 원작 수와 맞음, 2·3인 구분은 구현체 한 곳 출처).
4. 공국 2~10번, 솔로 13A/13B, 팀 12a/12b, 국경 초소 11a~f 지도. 흰 성 9장, 무역로 12장 내용, 수도원 29번.
5. 1번 공국의 눈 일부(사진 해상도 낮음 — 두 구현체와 일치하므로 큰 위험은 낮음).
6. 규칙 해석: 목공소·교회·시장으로 받을 때 보관 칸이 꽉 찼으면 버리고 받기(가져오기 규칙을 똑같이 적용), 수도원 5번의 "이웃 보급소"가 고리(6–1 이웃)인지, 솔로 "강으로만 넓히기" 해석.
- 돈·포인트를 걸지 않는다. 은화는 게임 안의 자원일 뿐이다.

333
docs/games/gemblo.md Normal file
View File

@@ -0,0 +1,333 @@
# 젬블로 (`gemblo`)
> 마일스톤: 미정(사용자 확인 후 시작) · 인원: 최소 2 ~ 최대 6명 · 예상 시간: 약 20~30분 · 난이도: 쉬움~보통
## 1. 개요
- 육각형 칸 1~5개로 된 보석 블록 18개를 육각형 판에 하나씩 올려놓는 땅따먹기 게임. 같은 색 블록끼리는 절대 닿으면 안 되고, 이미 놓은 내 블록의 꼭짓점에서 "선을 따라 한 칸 떨어진 곳"에만 이어 놓을 수 있다. 남의 블록으로 내 길이 막히기도 하고, 서로 다른 색 블록 두 개가 맞닿은 틈은 뚫고 지나갈 수 있어서 "빈틈 찾기"가 재미의 핵심이다. 더 놓을 수 없으면 끝나고, 못 놓은 블록의 칸 수가 가장 적은 사람이 이긴다.
- 한국 게임: 오준원(Justin Oh) 디자인, 2002년 개발·2003년 출시(박스 "Since 2003"), 젬블로(현 젬블로컴퍼니) 출판, 코리아보드게임즈 유통. 박스에 "국내 판매 1위 추상전략 보드게임"이라고 적혀 있고, 학교·방과후 수업 교구로도 많이 쓰인다. 블로커스(Blokus, 2000)와 비슷하지만 디자이너는 블로커스를 모르고 만들었다고 밝혔다(나무위키, Gough 2017).
- 인원 근거: 원작 2~6명(혼자 하는 퍼즐 모드 포함 1~6명). 인원마다 쓰는 판 범위와 시작점이 정해져 있다(4장). `minPlayers = 2`, `maxPlayers = 6`.
- 완전 정보 게임. view에서 뺄 것은 RNG 상태뿐.
- 원작 규칙서에 없거나 애매한 부분은 "서비스 규칙"이라고 따로 적었다. 원작 그대로인 것은 "원작", 다른 곳에서 가져온 재미 규칙은 "변형"으로 표시한다.
## 2. 모드와 옵션
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `seatOrder` | 자리(시작점)와 순서 | `random` / `joinOrder` | `random` |
| `twoPlayerMode` | 2명일 때 방식 | `twoColors`(원작: 2색씩, 4인 구역) / `threeColors`(원작: 3색씩, 판 전체) / `duo`(변형: 1색씩, 작은 판, 가운데 가까운 시작점) | `twoColors` |
| `threePlayerMode` | 3명일 때 방식 | `oneColor`(원작: 1색씩, 3인 구역) / `twoColors`(변형: 2색씩 판 전체, Gough 2017) | `oneColor` |
| `fivePlayerObstacles` | 5명일 때 남는 1색 블록으로 장애물 놓기 | `auto`(원작 조건대로 자동 배치, 서비스 기본) / `draft`(원작 그대로: 3개씩 골라서 각자 배치) / `none`(변형: 장애물 없음) | `auto` |
| `bridgeRule` | 이음선(4.3)이 막히는 조건 | `official`(원작: 한 블록이 사이 두 칸을 다 덮으면 막힘) / `free`(변형: 안 막힘, 초보용) | `official` |
| `allowFlip` | 블록 뒤집기 허용 | `true` / `false` | `true` (12장 확인 필요 항목) |
| `scoring` | 점수 방식 | `remaining`(원작: 남은 칸 수가 적을수록 좋음) / `blokusBonus`(변형: 남은 칸 −1점씩, 다 놓으면 +15, 마지막이 한 칸 블록이면 +20) | `remaining` |
| `teams` | 팀전 | `off` / `pairs`(4명: 마주 보는 2명씩 2팀, 6명: 마주 보는 2명씩 3팀) / `triples`(6명: 한 칸 건너 3명씩 2팀) | `off` |
| `neutralBlocks` | 시작 전 판 가운데 쪽에 무작위로 깔아 두는 금색 방해 블록 수(변형: 킥스타터판 "골드 조각") | `0` / `3` / `6` | `0` |
| `showHints` | 내가 이을 수 있는 자리(이음점) 점으로 표시 | `true` / `false` | `true` |
| `timeControl.kind` | 시간 방식 | `none` / `perMove` / `fischer` | `perMove` |
| `timeControl.perMoveSec` | 한 번(한 색 차례)당 제한 | 30 / 60 / 90 / 120 | 60 |
| `timeControl.baseSec` / `incSec` | 전체 시간 / 한 번마다 추가 | 5분+5초, 10분+5초 | 10분+5초 |
| `timeoutPolicy` | `perMove` 시간 초과 처리 | `autoPlace`(놓을 수 있는 블록 중 큰 것 자동 배치) / `pass`(이번 차례만 넘김) / `retire`(그 색은 더 안 놓음) | `autoPlace` |
| `autoMoveLimit` | 연속 자동 처리 허용 횟수(넘으면 그 사람의 색 모두 `retire`) | 0~5 | 2 |
| `undo` | 무르기(1인당, 다른 모든 사람 동의) | `off` / `1` / `3` | `off` |
- 모든 항목에 `.meta({ title, labels })`를 붙인다(09 §2). 인원과 맞지 않는 옵션(예: 4명인데 `twoPlayerMode`)은 무시한다. `teams=triples`는 6명, `pairs`는 4·6명일 때만 받고 아니면 setup에서 "팀전은 4명 또는 6명일 때만 돼요"로 거부.
- 연결 끊김 유예는 방 설정(`graceSec`)을 따른다.
## 3. 구성물
### 3.1 블록 (색마다 18개, 72칸)
- 색: 빨강·노랑·초록·파랑·보라·주황(현재 국내판 6색). 방해 블록은 금색.
- 한 색 18개 = 5칸 8개 + 4칸 5개 + 3칸 3개 + 2칸 1개 + 1칸 1개, 합계 72칸, 6색 108개·432칸. 3칸 이하는 가능한 모양을 모두 넣었고, 4칸은 7가지 중 5가지, 5칸은 22가지 중 8가지다.
- 모양은 아래 좌표(3.2의 축 좌표)로 정의한다. 출처: Gough 2017 그림 2(18개 그림)를 칸 단위로 옮기고, 국내 디럭스판 사진·국내 설명서 구성표(5칸 8·4칸 5·3칸 3·2칸 1·1칸 1)로 개수와 모양을 맞춰 봤다.
| id | 이름 | 칸 | 기준 좌표 `(q, r)` | 방향 수(안 뒤집음 / 뒤집기 포함) |
|---|---|---|---|---|
| `p1` | 한 칸 | 1 | (0,0) | 1 / 1 |
| `p2` | 두 칸 | 2 | (0,0) (0,1) | 3 / 3 |
| `i3` | 일자 3 | 3 | (0,0) (0,1) (0,2) | 3 / 3 |
| `a3` | 삼각 3 | 3 | (0,0) (0,1) (1,0) | 2 / 2 |
| `c3` | 꺾인 3 | 3 | (0,0) (0,1) (1,1) | 6 / 6 |
| `i4` | 일자 4 | 4 | (0,0) (0,1) (0,2) (0,3) | 3 / 3 |
| `o4` | 마름모 4 | 4 | (0,0) (0,1) (1,0) (1,1) | 3 / 3 |
| `s4` | S자 4 | 4 | (0,0) (0,1) (1,1) (1,2) | 3 / 6 |
| `u4` | 아치 4 | 4 | (0,0) (0,1) (1,1) (2,0) | 6 / 6 |
| `y4` | 바람개비 4 | 4 | (0,1) (1,1) (1,2) (2,0) | 2 / 2 |
| `i5` | 일자 5 | 5 | (0,0) (0,1) (0,2) (0,3) (0,4) | 3 / 3 |
| `v5` | 좁은 V 5 (두 팔 60°) | 5 | (0,0) (0,1) (0,2) (1,0) (2,0) | 6 / 6 |
| `l5` | 넓은 V 5 (두 팔 120°) | 5 | (0,0) (0,1) (0,2) (1,2) (2,2) | 6 / 6 |
| `j5` | 번개 5 (3칸+2칸 어긋남) | 5 | (0,0) (0,1) (0,2) (1,2) (1,3) | 6 / 12 |
| `f5` | 갈고리 5 | 5 | (0,0) (0,1) (1,1) (1,2) (2,0) | 6 / 12 |
| `w5` | 계단 5 | 5 | (0,0) (0,1) (1,1) (1,2) (2,2) | 6 / 6 |
| `n5` | N자 5 | 5 | (0,0) (0,1) (1,1) (2,1) (2,2) | 3 / 6 |
| `t5` | 긴 Y 5 | 5 | (0,1) (1,1) (1,2) (1,3) (2,0) | 6 / 6 |
- 서로 다른 방향 합계: 안 뒤집으면 74개, 뒤집기 포함 92개(거울상이 다른 블록은 `s4` `j5` `f5` `n5` 넷뿐).
### 3.2 좌표계 (축 좌표, 납작한 육각형)
- 칸은 위·아래가 평평한 육각형(실물 판과 같은 방향). 칸 `(q, r)`의 화면 중심(칸 반지름 `s`, 아래로 갈수록 y 증가): `x = 1.5·s·q`, `y = √3·s·(r + q/2)`.
- 이웃 6방향(변을 맞댐): `(0,-1)` 위, `(1,-1)` 오른쪽 위, `(1,0)` 오른쪽 아래, `(0,1)` 아래, `(-1,1)` 왼쪽 아래, `(-1,0)` 왼쪽 위.
- 회전(화면에서 시계 방향 60°): `R(q, r) = (−r, q + r)`. 좌우 뒤집기: `M(q, r) = (−q, q + r)`.
- 방향 번호 `o`(0~11): `k = o % 6`, `flip = o >= 6`, 변환 `T = R^k ∘ (flip ? M : 그대로)`. 블록 좌표에 `T`를 적용한 뒤 평행 이동해 놓는다(8.2). 대칭인 블록은 서로 다른 `o`가 같은 모양이 된다(문제 없음, 합법 수 목록에서는 중복 제거).
### 3.3 판 (실물과 같은 모양)
- 실물 판은 칸 방향과 30° 어긋난 큰 육각형이라 가장자리가 톱니처럼 들쭉날쭉하다. 한 변에 판 끝선에 닿는 칸이 8개(사이사이 한 칸 들어간 칸 7개)다(Gough 2017 "한 변 8칸"). 엔진 정의:
- 판 전체(6인 판): `max(|2q+r|, |q+2r|, |q−r|) ≤ 21` → **463칸**. 블록 432칸이 판의 93%(디자이너가 "블록 칸 수가 판의 90% 중반일 때 가장 재미있었다"고 한 비율과 맞음, IT동아 2015).
- 3인 구역(원작 빨간 선 안, 작은 육각형): `max(|2q+r|, |q+2r|, |q−r|) ≤ 15` → **241칸**(한 변 6칸, 블록 216칸 = 90%).
- 4인 구역(원작 파란 선 안, 가로로 조금 긴 직사각형): 판 전체 ∩ `|q| ≤ 9` ∩ `|q+2r| ≤ 15` → **295칸**(블록 288칸 = 98%). 2인 `twoColors`도 이 구역.
- `duo`(변형): `max(...) ≤ 12` → 157칸(2색 144칸 = 92%).
- 판의 6꼭짓점 칸(시계 방향, 왼쪽 위부터): `(−7,−7)` 왼쪽 위, `(7,−14)` 오른쪽 위, `(14,−7)` 오른쪽, `(7,7)` 오른쪽 아래, `(−7,14)` 왼쪽 아래, `(−14,7)` 왼쪽.
- 화면에는 판 전체를 그리고, 이번 판에서 안 쓰는 칸은 흐리게 칠한다(놓을 수 없음).
- 주의: 실물 판의 칸 수는 사진·그림으로 잰 값이다(12장).
## 4. 준비(셋업)
1. 인원과 옵션으로 "모드"를 정한다. 색 하나가 시작점 하나를 가진다. 차례는 색 단위로 시계 방향.
| 인원 / 모드 | 판 | 색 배분 | 시작점(차례 순서대로) |
|---|---|---|---|
| 6명 | 판 전체 | 1색씩 | 6꼭짓점: `(−7,−7)` `(7,−14)` `(14,−7)` `(7,7)` `(−7,14)` `(−14,7)` |
| 5명 | 판 전체 + 장애물 15개 | 1색씩(남는 1색은 장애물) | 5인 표시 칸: `(−10,−1)` `(4,−12)` `(14,−7)` `(4,8)` `(−10,11)` |
| 4명 | 4인 구역 | 1색씩 | 4인 구역의 네 모서리: `(−9,−3)` 왼쪽 위, `(9,−12)` 오른쪽 위, `(9,3)` 오른쪽 아래, `(−9,12)` 왼쪽 아래 |
| 3명 `oneColor` | 3인 구역 | 1색씩 | 3인 구역 꼭짓점 하나 건너 셋: `(−5,−5)` 왼쪽 위, `(10,−5)` 오른쪽, `(−5,10)` 왼쪽 아래 |
| 3명 `twoColors`(변형) | 판 전체 | 2색씩 | 6꼭짓점, 1→2→3→1→2→3 (각자 마주 보는 두 꼭짓점) |
| 2명 `twoColors` | 4인 구역 | 2색씩 | 4인 모서리, A(1번)→B(2번)→C(1번)→D(2번) (각자 대각선 두 모서리) |
| 2명 `threeColors` | 판 전체 | 3색씩 | 6꼭짓점, 1→2→1→2→1→2 |
| 2명 `duo`(변형) | 듀오 판 | 1색씩 | `(−4,2)`, `(4,−2)` (판 가운데와 모서리 중간, 블로커스 듀오처럼 일찍 부딪힘) |
- 원작 근거: 6명 판 전체·꼭짓점 시작(규칙서 그림 1의 초록 화살표, Gough), 4명 파란 선·F 표시, 3명 빨간 선·빨간 화살표, 2명 두 방식(규칙서), 5명 장애물(규칙서 그림 2의 "5" 표시). 위 좌표는 그 그림을 엔진 좌표로 옮긴 것이다. 5인 표시 칸은 그림에서 잰 각도(약 0°·72°·140°·209°·289°)에 가장 가까운 바깥 칸이다.
2. `seatOrder=random`이면 RNG로 자리(시작점 묶음)를 정한다. 팀전이면 같은 팀이 4명은 대각선 모서리, 6명 `pairs`는 마주 보는 꼭짓점, `triples`는 한 칸 건너 꼭짓점에 앉도록 자리를 맞춘다.
3. 5명 장애물(`fivePlayerObstacles`):
- 원작: 남는 1색에서 한 칸·두 칸·삼각 3(`p1` `p2` `a3`)을 빼고, 남은 15개를 각자 차례로 3개씩 고른다. 그다음 차례로 하나씩 판에 놓는다. 조건: (가) 맨 바깥 칸에는 못 놓는다, (나) 바깥에서 두 번째 줄 칸을 하나 이상 덮어야 한다, (다) 블록이 판 가운데 쪽으로 뻗어야 한다, (라) 이웃한 두 5인 시작점 사이에 장애물은 3개까지. 장애물을 마지막에 놓은 사람이 게임을 시작한다.
- 엔진 해석(서비스 규칙): "맨 바깥 칸" = 판 밖과 변을 맞댄 칸(84칸). "두 번째 줄" = 맨 바깥 칸과 맞댄 나머지 칸(72칸). (다)는 "블록 칸들의 무게 중심이 덮은 두 번째 줄 칸들의 무게 중심보다 판 가운데에 더 가깝다". (라)의 "사이"는 시작점 각도로 나눈 5구역, 두 번째 줄 칸의 각도로 구역을 정한다(15개 ÷ 5구역 = 구역마다 정확히 3개). 장애물끼리 겹치면 안 되고 닿는 것은 된다.
- `auto`: RNG로 15개를 섞어 구역마다 3개씩, 조건을 지키는 위치·방향 중 무작위(최대 200번 시도, 실패하면 그 블록은 뺌 — 테스트로 실패가 없음을 확인). 시작 플레이어는 RNG.
- `draft`: 8.2의 `pickObstacle` / `placeObstacle` 단계를 거친다(고르기는 자리 순서로 한 바퀴씩 3바퀴).
- `none`: 장애물 없이 판 전체(360칸 / 463칸 = 78%, 넓게 노는 판).
4. `neutralBlocks`(변형): 금색 블록 N개(`p1` `p2` `i3` `a3` `c3` 중 RNG)를 판 가운데에서 거리 7 이내 빈칸에 무작위 방향으로 놓는다. 서로 맞닿지 않게, 시작점에서 거리 6 이상.
5. 첫 차례는 차례 순서의 첫 색(5명 `draft`는 장애물을 마지막에 놓은 사람의 색).
## 5. 진행 규칙
### 5.1 차례
- 차례인 색의 주인은 그 색의 안 쓴 블록 하나를 골라 돌리거나(뒤집기 옵션) 해서 판에 놓는다. 한 차례에 블록 하나. 놓을 수 있으면 반드시 놓아야 한다(스스로 넘기기 없음, 원작 "놓을 수 있는 사람은 계속 놓는다").
- 이미 놓은 블록은 옮기거나 뺄 수 없다.
### 5.2 공통 조건 (모든 블록)
1. 블록의 모든 칸이 이번 판에서 쓰는 구역 안이고 비어 있다(겹쳐 쌓기 금지).
2. 블록의 어느 칸도 **같은 색** 칸과 변을 맞대지 않는다. 다른 색·금색 블록과는 마음대로 닿아도 된다. (육각형은 꼭짓점만 닿는 일이 없으므로 "변을 안 맞댄다" = "안 닿는다".)
### 5.3 첫 블록
- 그 색의 시작점 칸을 덮어야 한다. 이음선 조건은 없다.
- 시작점이 이미 다른 블록에 덮여 있으면(인원·옵션상 일어나지 않게 시작점을 정했지만 만일을 위해) 그 색은 놓을 곳이 없는 것으로 처리한다.
### 5.4 두 번째 블록부터: 이음선
- 새 블록의 칸 B 하나와 이미 놓은 같은 색 칸 A 하나가 아래 "대각 위치"이고, 둘 사이의 이음선이 열려 있어야 한다. 이런 짝이 하나 이상 있으면 된다(여러 개여도 됨).
- 대각 위치 = A의 꼭짓점에서 판의 선을 따라 한 칸 길이만큼 나간 끝에 꼭짓점이 닿는 칸. 축 좌표로 `B − A`가 아래 6가지 중 하나. A와 B 사이에는 두 칸 `m1`, `m2`가 끼어 있고, 이음선은 `m1`과 `m2`가 맞댄 변이다.
| `B − A` | 사이 칸 `m1` (`A +`) | 사이 칸 `m2` (`A +`) | 화면 방향 |
|---|---|---|---|
| (2,−1) | (1,0) | (1,−1) | 오른쪽 |
| (1,−2) | (1,−1) | (0,−1) | 오른쪽 위 |
| (−1,−1) | (0,−1) | (−1,0) | 왼쪽 위 |
| (−2,1) | (−1,0) | (−1,1) | 왼쪽 |
| (−1,2) | (−1,1) | (0,1) | 왼쪽 아래 |
| (1,1) | (0,1) | (1,0) | 오른쪽 아래 |
- 이음선이 막히는 경우(`bridgeRule=official`): `m1`과 `m2`가 **같은 블록 하나**에 함께 덮여 있을 때. 서로 다른 블록 두 개(색이 달라도, 금색 장애물 두 개여도)가 맞댄 틈은 지나갈 수 있다. 한쪽만 덮였거나 둘 다 비었거나 구역 밖이면 열려 있다.
- 근거: 규칙서 "다른 색 블록에 막히지 않았다면", 그림(노란 블록 하나가 두 칸을 덮어 막힘 / 노랑·초록이 한 칸씩이면 통과), 국내 설명 "서로 다른 색의 블록 사이는 뚫고 지나가는 것이 가능", Gough "다른 사람 블록을 가로지를 수는 없지만 두 블록이 맞댄 틈은 지날 수 있다".
- 같은 색 블록끼리는 절대 닿지 않으므로, 1인 1색에서는 "같은 블록" = "같은 색 두 칸"과 같다. 장애물(금색)처럼 서로 닿을 수 있는 블록이 있어서 블록 단위로 판단한다.
- `m1` 또는 `m2`가 내 색이면 B가 내 블록과 닿게 되므로 이미 5.2에서 걸린다.
- `bridgeRule=free`(변형): 사이 칸은 보지 않는다(대각 위치만 맞으면 됨).
- 이음점(hint): "그 색이 지금 블록 한 칸을 놓을 수 있는 칸" = 어떤 같은 색 칸 A의 대각 위치이면서, 이음선이 열려 있고, 비어 있고, 구역 안이고, 같은 색 칸과 맞닿지 않는 칸. 모든 합법 배치는 이음점을 적어도 한 칸 덮는다.
### 5.5 놓을 수 없을 때와 끝
- 차례가 온 색이 놓을 수 있는 배치가 하나도 없으면 그 색은 "끝남"이 되고 이후 차례에서 빠진다(이벤트 `colorOut`). 판은 채워지기만 하므로 한 번 놓을 곳이 없으면 다시 생기지 않는다(그래서 영구 제외가 원작과 같은 결과).
- 18개를 다 놓은 색도 끝남.
- 모든 색이 끝나면 게임 종료.
## 6. 승패와 점수 계산
- `scoring=remaining`(원작): 각 색의 남은 블록 칸 수 합. 여러 색을 가진 사람은 자기 색 합계. 적을수록 높은 순위.
- 예: 2명 `twoColors`, 1번(빨강 남은 6칸 + 노랑 남은 3칸 = 9), 2번(초록 0 + 파랑 11 = 11) → 1번 승.
- `scoring=blokusBonus`(변형, 블로커스 점수 방식): 색마다 `−(남은 칸 수)`, 18개를 다 놓았으면 +15, 그중 마지막으로 놓은 블록이 `p1`이면 +20(+15 대신). 높을수록 높은 순위. 결과 화면에 원작 방식(남은 칸)도 함께 보여 준다.
- 팀전: 팀원 점수 합으로 팀 순위, 팀원은 같은 순위.
- 동점: 같은 순위(공동). 원작 규칙서에 동점 처리 규칙이 따로 있다고 하나(Gough) 내용을 확인하지 못해 서비스 규칙으로 공동 순위를 쓴다(12장).
- 기권·시간패로 빠진 사람: 그 사람의 색은 바로 끝남 처리하고 남은 칸으로 점수는 계산하되, 순위는 끝까지 한 사람들 아래(먼저 빠진 사람이 더 아래). 2명에서 한 명이 기권하면 상대 승.
- `scoreText`: `remaining`은 "남은 7칸"(0칸이면 "모두 놓음"), `blokusBonus`는 "+20점"/"−7점".
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
- 원작에 있는 선택: 2명 `twoColors`/`threeColors`, 5명 장애물. 장애물 고르기·놓기는 시간이 길어 서비스 기본은 `auto`(원작 조건 그대로 자동).
- 변형(다른 자료에서 가져옴, 기본 꺼짐 또는 원작 기본 유지):
- 3명 2색씩 판 전체(`threePlayerMode=twoColors`): Gough 2017이 제안한 3인 대안(쓸 판은 적혀 있지 않아 6색이 다 들어가는 판 전체로 정함).
- 듀오(`twoPlayerMode=duo`): 블로커스 듀오(2인 전용 작은 판, 가운데 가까운 시작점)를 젬블로 판에 옮긴 것. 1색씩이라 규칙이 가장 단순하고 빨리 부딪힌다.
- 블로커스 점수(`scoring=blokusBonus`): 다 놓기·마지막 한 칸 보너스.
- 팀전(`teams`): 블로커스 4인 팀전(마주 보는 두 사람이 한 팀)을 4·6인에 적용.
- 금색 방해 블록(`neutralBlocks`): 킥스타터판에 들어 있던 금색 조각 3개("고급 규칙용"이라고만 적혀 있음)를 판에 미리 까는 방식으로 해석.
- 느슨한 이음선(`bridgeRule=free`): 체코공대(CTU) 과제판 젬블로처럼 남의 블록에 이음선이 막히지 않음. 처음 하는 사람·어린이용.
- 뒤집기 금지(`allowFlip=false`): 보석 모양 디럭스 블록은 뒤집어 놓기 어렵고 CTU 과제판도 뒤집기 금지. 거울상 블록 4개의 쓰임이 줄어 조금 어려워진다.
- 넣지 않는 것: 젬블로Q(사각형+삼각형 칸, Q포인트 규칙)는 다른 게임이라 별도 검토. 1인 퍼즐북(그림 맞추기)은 추후 후보. 블로커스식 "꼭짓점만 닿기" 규칙은 육각형에서는 성립하지 않는다(육각형은 꼭짓점만 닿을 수 없음).
## 8. 엔진 설계
### 8.1 상태(State)
```ts
type PieceId = 'p1' | 'p2' | 'i3' | 'a3' | 'c3' | 'i4' | 'o4' | 's4' | 'u4' | 'y4'
| 'i5' | 'v5' | 'l5' | 'j5' | 'f5' | 'w5' | 'n5' | 't5';
type ColorId = 'red' | 'yellow' | 'green' | 'blue' | 'purple' | 'orange';
type Layout = 'full' | 'four' | 'three' | 'duo';
type Hex = { q: number; r: number };
interface GembloColor {
color: ColorId;
owner: PlayerId;
start: Hex;
left: PieceId[]; // 안 쓴 블록
done: boolean; // 더 놓을 곳 없음 / 다 놓음 / 기권·시간패
lastPiece: PieceId | null; // blokusBonus용
autoStreak: number;
}
interface GembloPlacement { // 판 위 블록 하나 (장애물·금색 포함)
seq: number; // 0부터, 칸 점유의 블록 번호
color: ColorId | 'gold';
pieceId: PieceId;
orient: number; // 0~11
cells: number[]; // 칸 번호(아래 layout 칸 목록의 인덱스)
auto: boolean;
}
interface GembloState {
options: GembloOptions;
layout: Layout; // 쓰는 구역
board: number[]; // 판 전체 463칸, -1 = 빔, 그 외 = GembloPlacement.seq
placements: GembloPlacement[];
colors: GembloColor[]; // 차례 순서
turn: number; // colors 인덱스
phase: 'obstacleDraft' | 'obstaclePlace' | 'playing' | 'finished';
obstacle: { pool: PieceId[]; hands: Record<PlayerId, PieceId[]>; sectorCount: number[]; seatTurn: number } | null;
teams: PlayerId[][] | null;
turnStartedAt: number;
clock: { remainingMs: Record<PlayerId, number> };
undo: { usedBy: Record<PlayerId, number>; pending: { by: PlayerId; accepted: PlayerId[] } | null };
out: { playerId: PlayerId; reason: 'resign' | 'timeLoss'; at: number }[];
result: GembloResult | null;
}
```
- 칸 번호: 판 전체 463칸을 `r`, 그다음 `q` 오름차순으로 번호를 매긴 고정 목록(모듈 상수). 구역 포함 여부, 이웃 6칸, 대각 6칸과 사이 칸(`m1`, `m2`) 번호를 모듈을 읽을 때 한 번 계산해 표로 둔다(상태에는 안 넣음, JSON 규칙 지킴).
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `place` | `{ pieceId, orient, q, r }` | 차례인 색의 주인, `playing` | 그 색에 블록이 남아 있음, `orient` 0~11(`allowFlip=false`면 0~5), 칸 = `{(q,r) + T(c) − T(c₀)}`(c₀ = 블록 기준 좌표 첫 칸). 5.2~5.4. 사유 예: "판 밖이에요", "다른 블록과 겹쳐요", "같은 색 블록과 닿으면 안 돼요", "첫 블록은 시작점을 덮어야 해요", "내 블록에서 선으로 이어지는 곳이 아니에요", "이 선은 다른 블록에 막혀 있어요" |
| `pickObstacle` | `{ pieceId }` | `draft`의 고르기 차례 사람 | 남은 15개 중에 있음 |
| `placeObstacle` | `{ pieceId, orient, q, r }` | `draft`의 놓기 차례 사람 | 자기가 고른 블록, 4장 3.의 (가)~(라), 겹침 없음 |
| `requestUndo` / `respondUndo` | `{}` / `{ accept }` | 방금 놓은 사람 / 나머지 전원 | `undo` 횟수 남음, 다음 색이 아직 안 놓았을 때만. 전원 수락 → 그 배치 하나와 그 뒤 자동 `colorOut`을 되돌림 |
| `resign` | `{}` | 남아 있는 사람 | 6장 처리 |
| `timeout` | `{}` | 시스템 | 8.5 |
- 한 사람이 2색 이상이면 `place`는 "지금 차례인 색"에만 적용된다(어느 색인지는 상태가 정함).
- `place` 처리 후: 다음 색으로 넘기며, 넘겨받은 색이 끝남이 아니면 `hasAnyPlacement`를 검사해 없으면 `colorOut`을 기록하고 다시 다음 색으로. 남은 색이 없으면 종료.
- 이벤트: `placed`(색, 블록, 칸 목록 — 애니메이션용), `colorOut`(색, 남은 칸 수), `obstaclePlaced`, `playerOut`, `gameEnded`.
- 테스트·컴퓨터용 `legalActions(state, p)`: 지금 차례 색의 모든 합법 `place`(같은 칸 집합은 하나만). 첫 블록은 6인 꼭짓점 `(14,−7)` 기준 56개(뒤집기 금지면 45개), 4인 모서리 `(−9,−3)` 44개, 3인 꼭짓점 `(−5,−5)` 56개.
#### 합법 배치 찾기(성능)
- 모듈을 읽을 때 블록마다 서로 다른 방향 목록(뒤집기 포함 92개, 안 하면 74개)을 정규화해 둔다.
- 차례 색의 이음점을 구한다: 그 색 칸마다 대각 6칸을 보고 5.4 조건을 만족하는 칸만(중복 제거). 첫 블록이면 이음점 = 시작점 하나.
- 이음점 P × 남은 블록 × 방향 × 블록의 각 칸을 P에 맞추는 평행 이동 → 5.2 검사(구역·빈칸·같은 색 이웃). 칸 집합 문자열로 중복 제거. 최악(이음점 100개, 블록 18개 전부)도 약 4만 6천 배치 × 5칸 검사로 수 ms. `hasAnyPlacement`는 하나 찾으면 바로 멈춘다.
- 같은 색 이웃 검사는 "그 색 칸과 맞닿은 칸" 표시 배열을 그때그때 만들어 쓴다(463칸, 싸다).
### 8.3 공개/비공개 정보 (view)
- 모두 공개: 판(칸마다 색·블록 번호), 배치 기록, 색마다 남은 블록·남은 칸 수·끝남 여부, 차례 색과 주인, 팀, 시계, `deadline`, 대기 중인 무르기, 결과, 마지막 배치.
- 차례인 사람에게만: `legal: { bridgePoints: Hex[]; placeable: PieceId[] }`(이음점, 놓을 수 있는 블록). 화면의 미리보기 판정은 모듈이 내보내는 순수 함수 `checkPlacement(view, color, pieceId, orient, q, r)`로 클라이언트에서 바로 하고(규칙과 같은 코드), 최종 판단은 서버 `validate`.
- 제외: `rng`. `secretsOf`는 빈 목록(숨길 정보 없음).
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
1. `seatOrder=random` 자리 배정, 5명 `auto`의 시작 플레이어.
2. 5명 `auto` 장애물 순서·위치·방향.
3. `neutralBlocks` 금색 블록 종류·위치·방향.
4. `autoPlace` 시간 초과 배치에서 같은 점수 후보 고르기.
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- `deadline(state)`: `perMove` → `turnStartedAt + perMoveSec·1000`, `fischer` → `turnStartedAt + remainingMs[주인]`, `none` → `null`, `obstacleDraft`/`obstaclePlace` → `turnStartedAt + 60초`(고정), 종료 → `null`.
- `onTimeout(state, player)` → `{ type: 'timeout' }`. `apply`:
- `obstacleDraft`/`obstaclePlace`: 남은 것 중 RNG로 고르기·조건 맞는 무작위 위치에 놓기.
- `perMove + autoPlace`: 합법 배치 중 칸 수가 가장 큰 블록 → 그중 새 이음점이 가장 많이 생기는 배치(같으면 RNG). `auto: true`, 그 색 `autoStreak + 1`. 사람 기준으로 연속 `autoMoveLimit`회를 넘기면 그 사람의 모든 색을 끝남 처리(`timeLoss`).
- `perMove + pass`: 이번 차례만 넘김(색은 그대로 남음), streak + 1.
- `perMove + retire` 또는 `fischer` 시간 다 씀: 그 사람의 색 모두 끝남(`timeLoss`).
- 사람이 직접 놓으면 그 사람 streak 0.
- 연결 끊김: 끊긴 사람의 색 차례에 `min(deadline, 끊김 + graceSec)`에 `onTimeout`. 무르기 응답 대기 중 끊긴 사람은 30초 뒤 거절로 처리.
- `onLeave`: 기권과 같음.
### 8.6 종료 조건과 결과(GameResult)
```ts
interface GembloResult {
ranking: PlayerId[][]; // 공동 순위 허용
scores: Record<PlayerId, number>; // remaining: 남은 칸(적을수록 좋음), blokusBonus: 점수
scoreText: Record<PlayerId, string>; // "남은 7칸", "모두 놓음", "+20점"
perColor: { color: ColorId; owner: PlayerId; leftCells: number; leftPieces: PieceId[]; allPlaced: boolean }[];
teams?: { members: PlayerId[]; total: number }[];
summary: string; // "빨강(철수) 승리 — 남은 칸 0"
reason: 'normal' | 'resign' | 'timeout';
}
```
- 종료: 모든 색 끝남, 또는 남은 사람이 0~1명(2명에서 한 명 기권 등).
### 8.7 컴퓨터 상대 (`gemblo/bot.ts`)
- 입력: `view`, `legal`(= `legalActions`, 합법 배치 전체). 배치마다 점수:
- `10 × 칸 수` (큰 블록 먼저: 원작 공략 "초반엔 5칸 블록으로 자리를 넓히고 끝에 작은 블록")
- `+ 3 × (놓은 뒤 내 이음점 수 − 놓기 전)` (길을 많이 열어 둠)
- `+ 4 × (상대 색들의 이음점이 줄어든 수)` (막기)
- `+ 2 × (판 가운데 쪽으로 나아간 정도)` (처음 4수만)
- `− 8` 이 배치가 내 다른 이음점을 스스로 막으면(내 블록이 내 이음점 칸을 덮음)
- 계산을 줄이려고 먼저 `칸 수 + 가운데 거리`로 상위 80개만 골라 이음점 변화를 계산한다(합법 배치 수천 개여도 한 수 50ms 이내 목표).
- 단계(1~60): `humanBest`(09 §9.1)를 쓴다. 기준 `small = 10`(블록 한 칸 차이), `critical`은 없음(놓치면 바로 지는 수가 없는 게임). 낮은 단계일수록 작은 블록을 일찍 쓰고 막기를 덜 본다.
## 9. UI/UX
- 화면 배치(PC): 왼쪽 판(SVG, 납작한 육각형 칸, 실물처럼 금빛 판 위 반투명 보석), 오른쪽 패널에 차례 순서(색·주인·남은 칸 막대), 지금 차례 색의 블록 트레이(18칸 격자, 쓴 블록은 흐리게, 놓을 수 없는 블록은 회색+자물쇠), 기록, 채팅.
- 모바일 세로(320px 이상): 위에 차례 띠(색 점 + "파랑 차례 · 남은 34칸"), 가운데 판(폭 100%), 아래 블록 트레이(가로로 밀어 보는 한 줄, 칸마다 44px 이상), 그 아래 버튼 줄 [⟲] [⟳] [뒤집기] [취소] [놓기](각 44px 이상).
- 판 전체 463칸을 320px에 그리면 칸 폭이 약 14px라 손가락으로 집기 어렵다. 그래서 기본은 "내 블록 근처 2배 확대"로 보여 주고, 두 손가락 확대·이동, [전체 보기] 단추로 전환. 3인 구역(241칸)·4인 구역(295칸)은 그 구역만 꽉 차게 맞춘다.
- 놓는 방법:
- PC: 트레이에서 블록 클릭 → 마우스를 따라다니는 반투명 미리보기(잡은 칸이 커서 칸에 맞춰짐) → 휠·R 키로 회전, F 키로 뒤집기 → 놓을 수 있으면 내 색으로 밝게, 안 되면 빨갛게 + 이유 글(예: "같은 색과 닿아요") → 클릭으로 놓기. Esc 취소.
- 모바일: 블록 탭 → 판의 칸을 탭하면 그 칸에 미리보기가 생김 → 끌어서 옮기기, 버튼으로 회전·뒤집기 → [놓기](놓을 수 있을 때만 켜짐). 이음점(작은 내 색 점)을 탭하면 "그 점을 덮는 합법 배치"가 바로 나오고, 같은 점을 다시 탭하면 다음 합법 배치로 바뀐다(작은 화면에서 돌리기 없이 고르기).
- 도움말 표시(`showHints`): 내 이음점 = 내 색 작은 점, 미리보기 중 연결되는 이음선 = 내 블록 꼭짓점에서 뻗는 짧은 선(원작 그림의 화살표처럼). 막힌 이음선을 가리키면 그 선 위에 작은 ✕.
- 움직임: 블록이 위에서 살짝 내려앉으며 보석이 한 번 반짝, 놓은 블록은 다음 배치 전까지 가는 테두리로 표시. 색이 끝나면 그 색 트레이가 접히고 "초록은 더 놓을 곳이 없어요(남은 9칸)" 토스트. 끝나면 남은 블록을 색별로 판 옆에 펼쳐 보여 줌(원작 사진처럼).
- 효과음(사이트 음량): 놓기 "딸깍"(보석 소리), 안 되는 자리 작고 낮은 소리, 색 끝남 짧게 내려가는 소리, 다 놓음 반짝이는 소리.
- 색약 배려: 색마다 보석 안에 다른 무늬(점·줄·별 등)도 넣고, 차례 띠·결과에 색 이름을 글로 함께 쓴다.
- 규칙 보기: ① 시작점 덮기 ② "선으로 한 칸 떨어져 잇기"(원작 화살표 그림) ③ 한 블록이 사이를 막으면 못 감 / 두 블록 틈은 지나감 ④ 끝과 점수. 각 1장씩 그림.
## 10. 테스트 체크리스트
- [ ] 판·구역 칸 수: 전체 463, 3인 241, 4인 295, 듀오 157. 6꼭짓점·4인 모서리·3인 꼭짓점·5인 시작 칸이 모두 해당 구역 안이고 맨 바깥 칸.
- [ ] 블록 18개 칸 수 합 72, 서로 다른 방향 수 표(3.1)와 같음(합 74 / 92). `R`을 6번 하면 제자리, `M`을 2번 하면 제자리.
- [ ] 인원·모드별 색 배분과 차례 순서(4장 표), 팀전 자리 맞춤, 팀전 인원 불일치 거부.
- [ ] 첫 블록: 시작점 안 덮으면 거부, 덮으면 허용. 첫 블록 합법 수 개수(8.2: 56 / 45 / 44 / 56).
- [ ] 같은 색 변 맞댐 거부, 다른 색과 맞댐 허용.
- [ ] 이음선 6방향 각각 허용. 대각 위치가 아닌 곳(예: `B − A = (2,0)` 직선 두 칸)은 거부("선으로 이어지는 곳이 아니에요").
- [ ] 막힘: 사이 두 칸을 다른 색 블록 하나가 덮으면 거부, 다른 색 블록 두 개가 한 칸씩이면 허용, 한 칸만 덮였으면 허용, 금색 장애물 두 개가 맞댄 틈은 허용, 같은 장애물 하나면 거부. `free`에서는 모두 허용.
- [ ] 구역 밖 칸(4인·3인)은 놓을 수 없고, 사이 칸이 구역 밖이면 열린 것으로 봄.
- [ ] 놓을 곳 없는 색 자동 `colorOut`, 이후 차례에서 빠짐, 모든 색 끝나면 종료. 2색 가진 사람의 한 색만 끝난 경우 다른 색은 계속.
- [ ] 점수: 남은 칸 합, 공동 순위, `blokusBonus`(다 놓음 +15, 마지막 `p1` +20), 팀 합계.
- [ ] 5명 `auto`: 장애물 15개, 맨 바깥 칸 없음, 두 번째 줄 1칸 이상, 구역마다 3개, 겹침 없음. 시드 1,000개에서 배치 실패 없음.
- [ ] 5명 `draft`: 고르기 3바퀴·놓기 순서, 조건 위반 거부, 마지막에 놓은 사람이 시작.
- [ ] `neutralBlocks`: 개수, 시작점과 거리, 서로 안 닿음.
- [ ] `allowFlip=false`: `orient` 6~11 거부, 거울상 블록 방향 수 절반.
- [ ] 시간 초과: `autoPlace`가 가장 큰 블록을 합법하게 놓음, 같은 시드 같은 결과, 연속 한도 넘으면 그 사람 색 모두 끝남. `pass`는 색 유지. `fischer` 시간패.
- [ ] 무르기: 전원 수락 시 배치·자동 `colorOut` 함께 복원, 다음 색이 놓은 뒤에는 요청 불가.
- [ ] 기권: 색 끝남 처리, 순위 맨 아래, 2명이면 상대 승.
- [ ] 정보: 차례 아닌 사람·관전자 view에 `legal` 없음, 모든 view에 `rng` 없음. `checkPlacement`(클라이언트)와 `validate` 결과가 무작위 배치 1만 개에서 같음.
- [ ] 성능: 무작위 대국에서 `legalActions` 최악 10ms 이내, `apply` 5ms 이내. 2~6명 모든 모드 무작위 대국이 끝까지 감(상한: 색 수 × 18 + 색 수 차례).
## 11. 참고 자료
- 코리아보드게임즈 「젬블로」 상품 페이지: https://www.koreaboardgames.com/product/detail?prdCd=PD2024002311KZKT (1~6명, 6세+, 20분, 게임 방법: 시작점 덮기, "선을 따라 한 칸 떨어진 곳", "서로 다른 색 블록 사이는 뚫고 지나감", 남은 칸 적은 사람 승리, 젬블로·디럭스·젬블로Q 비교)
- 나무위키 「젬블로」: https://namu.wiki/w/%EC%A0%AC%EB%B8%94%EB%A1%9C (오준원, 2~6명·30분, 블로커스 유사성 논란과 디자이너 설명, 젬블로Q)
- IT동아 「[보드게임의 세계] 보석으로 점령하는 땅 따먹기, '젬블로'」(2015): https://v.daum.net/v/20150918205808230 (2002년 개발, 꼭짓점 시작, 틈 통과, 18개 선택 이유, 432칸과 판 비율 "90% 중반")
- 디지털로그 리뷰(2015): https://digitalog.com/732 (구성 5칸 8·4칸 5·3칸 3·2칸 1·1칸 1, 108개, 미니·일반·디럭스, 인원별 구역·시작점 표시)
- UltraBoardGames 「Gemblo Game Rules」(영문 규칙서 옮김): https://www.ultraboardgames.com/gemblo/game-rules.php (인원별 구역, 2인 두 방식, 5인 장애물 조건, 막힘 규칙 그림, 종료·점수)
- John Gough, 「Gemblo and Polyhex Blokus」, Australian Mathematics Teacher 73(3), 2017: https://files.eric.ed.gov/fulltext/EJ1155929.pdf (18개 모양 그림, 6인 판 한 변 8칸, 3인 2색 대안, 블록을 가로지를 수 없지만 두 블록 틈은 지날 수 있음)
- Scooter Games 「Gemblo」(2013): https://scootergames.wordpress.com/2013/01/31/gemblo/ (킥스타터판 구성과 금색 조각, 합법·불법 사진, 5인 준비가 복잡함)
- Raph Koster 「Gemblo… if you like Blokus」(2006): https://www.raphkoster.com/2006/09/26/gemblo-if-you-like-blokus/ (2인: 2색씩 4인 구역)
- Dice Tower 「Gemblo」: https://dicetower.com/board-game/19427 (2003, Justin Oh, 2~6명, 30분, 출판사 목록)
- 체코공대 B3B33ALP 과제 「Gemblo」: https://cw.fel.cvut.cz/b201/courses/b3b33alp/cviceni/t09 (단순화 규칙: 이음선 막힘 없음, 뒤집기 금지 — `free`·`allowFlip=false` 변형 참고)
- 블로커스 점수·팀전·듀오: https://en.wikipedia.org/wiki/Blokus
## 12. 메모 (상표·법적 주의 등)
- 표시 이름: 친구끼리 쓰는 사이트라 원래 이름 "젬블로"를 쓴다(`13-decisions.md` 0절과 같은 원칙). "젬블로(Gemblo)"는 젬블로컴퍼니의 상표이므로 공개 서비스로 바꿀 때는 "보석 잇기" 같은 일반 이름 후보를 검토. 박스·로고·판 그림은 쓰지 않고 직접 그린다.
- 확인하지 못한 것(구현 전에 실물·규칙서로 확인하면 좋음):
- 실물 판 칸 수: 463칸은 "한 변 8칸"(Gough)과 판 그림·사진에서 잰 크기, 디자이너가 말한 비율로 정한 값이다. 4인 구역(295칸)·3인 구역(241칸)·5인 시작 칸은 규칙서 그림을 재서 옮긴 값이라 실물과 한두 줄 다를 수 있다.
- 6인 시작점: 규칙서·Gough는 "꼭짓점", 2015년판 사진의 초록 표시는 꼭짓점에서 2칸쯤 비켜난 바람개비 모양으로 보인다. 엔진은 꼭짓점으로 정했다.
- 뒤집기: 규칙서 번역본에 언급이 없다. 평평한 일반판 블록은 뒤집을 수 있고 디럭스 보석 블록은 사실상 못 뒤집는다. 기본 `true`로 두고 사용자 확인 필요.
- 동점 처리: 원작에 규칙이 있다고만 알려져 있어 공동 순위로 둠.
- 블록 모양 18개: Gough 그림 기준, 디럭스판 사진과 개수·종류가 맞음(사진이 비스듬해 5칸 블록 일부는 그림으로만 확정).
- 금전·베팅 요소 없음.

453
docs/games/hot-streak.md Normal file
View File

@@ -0,0 +1,453 @@
# 핫스트릭 (`hot-streak`)
> 마일스톤: 2026-10 새 게임 · 인원: 최소 2 ~ 최대 10명 · 예상 시간: 약 15~25분 · 난이도: 쉬움
## 1. 개요
- 원작: Hot Streak(2025, 디자이너 Jon Perry, 출판 CMYK, 한국어판 코리아보드게임즈 2026). 탈을 쓴 마스코트 넷이 카드 덱대로 우왕좌왕 달리고,
플레이어는 경주 전에 베팅 티켓을 뽑아 돈을 건다. 경주 중에는 아무것도 고르지 않고 구경하면서 소리 지르는 게 이 게임의 재미다.
경주는 세 번 하고, 끝났을 때 돈이 가장 많은 사람이 이긴다.
- 끼어들 수 있는 곳은 두 군데다. ① 티켓 뽑기(뱀 순서, 안전/위험 면 고르기) ② 손에 든 비밀 카드 1장을 경주 덱에 몰래 넣기.
- 인기: BGG 파티 게임 5위, 전체 290위, 평점 7.77(8,180명), 2025 골든긱 올해의 파티 게임·올해의 가벼운 게임 수상, 2026 독일 올해의 게임 추천작(§11).
- 인원 근거: 상자 표기는 2~9명이다. 3~8명은 기본 규칙, 2명은 공식 2인 변형, 9명 이상은 공식 "9+ 변형"(종이에 적고 상금을 나눠 갖는 방식)이다.
우리 사이트는 9+ 변형을 "상금 나누기 모드"로 만들어 10명까지 받는다(§2 `bettingMode`).
## 2. 모드와 옵션
공식 규칙이 기본값이다. BGG 변형 게시판에서 많이 쓰는 하우스 룰을 방 설정으로 켤 수 있게 했다(출처는 §7).
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `bettingMode` | 베팅 방식 | `auto`(2~8명 티켓, 9~10명 상금 나누기 — 원작 그대로) / `tickets`(티켓 뽑기, 2~9명) / `pots`(상금 나누기, 2~10명) | `auto` |
| `races` | 경주 수 | 1(맛보기) / 3(원작) / 5(긴 판) | 3 |
| `finalBet` | 마지막 경주 보너스 | `double`(티켓 하나 두 배, 원작) / `bothBonus`(두 티켓 모두 맞히면 평균만큼 보너스) / `none`(없음) | `double` |
| `draftStart` | 다음 경주 첫 순서 | `rotate`(한 자리씩 옮김, 원작) / `spread`(5~6명 두 자리·7~8명 세 자리씩 건너뜀) / `poorest`(돈이 가장 적은 사람부터) | `rotate` |
| `reverseBets` | 꼴찌 걸기(거꾸로 티켓) | 끄기 / 켜기 | 끄기 |
| `cardsPerRace` | 비밀 카드 수(3~6명) | 1(원작) / 2(손패 4장·2장 넣기, "더 시끌벅적") | 1 |
| `burn` | 경주 시작 때 버리는 카드 | 3(원작) / 5 | 3 |
| `spicyDeck` | 넘어지기 카드 4장은 꼭 쓰기 | 끄기 / 켜기 | 끄기 |
| `hurdles` | 허들 칸(밟고 서면 넘어짐) | 끄기 / 켜기 | 끄기 |
| `potScale` | 상금 크기(상금 나누기 모드) | ×1(원작) / ×2 / ×3 | ×1 |
| `lifeStory` | 끝나고 "인생 결과" 한 줄 보여 주기 | 켜기 / 끄기 | 켜기 |
| `turnSeconds` | 티켓 뽑기·카드 넣기 제한 시간 | 20 / 30 / 60초 / 무제한 | 30초 |
| `flipSeconds` | 경주 카드 넘기는 간격 | 1.2 / 2 / 3초 | 2초 |
- `bettingMode=tickets`는 10명이면 고를 수 없다(티켓 18장 < 20장). `playersFor`가 `tickets`면 2~9명, 나머지는 2~10명을 돌려준다.
9명 티켓 모드는 원작 표 밖이라 무작위 카드 수를 5장으로 늘려 정했다(§4 표, 우리 추정).
- `cardsPerRace=2`는 3~6명일 때만 적용되고, 2명(원래 2장)과 7명 이상(덱이 모자람)에서는 1로 처리하며 설정 화면에 회색으로 보인다.
- `reverseBets`·`hurdles`·`spicyDeck`·`burn=5`는 대기실 설정 화면에 "하우스 룰" 묶음으로 보이고, 켜면 게임 화면 위쪽에 작은 뱃지가 붙는다.
- 모든 항목에 `.meta({ title, labels })`를 붙인다(위 "설명"이 title, "선택지"가 labels).
## 3. 구성물
### 3.1 마스코트와 경주로
- 마스코트 4명(원작 이름 그대로, 한국어판 표기는 미확인이라 소리 나는 대로 적음):
| id | 이름 | 모습 | 색 | 레인 | 옆으로 꺾는 방향 |
|---|---|---|---|---|---|
| `G` | 고블러(Gobbler) | 곰 | 주황·보라 | 0 | 오른쪽 |
| `H` | 헐리(Hurley) | 핫도그(번 뱅어) | 빨강·연주황 | 1 | 오른쪽 |
| `D` | 댕글(Dangle) | 아귀 | 파랑 | 2 | 왼쪽 |
| `M` | 맘(Mum) | 여왕 | 노랑·자주 | 3 | 왼쪽 |
- 레인 번호: 결승선을 바라보고 섰을 때 **왼쪽 끝이 0, 오른쪽 끝이 3**. 그래서 처음에는 넷 다 가운데 쪽으로 꺾는다(원작 그림 확인).
- 경주로: 레인 4줄 × 13칸 + 결승선 너머 "결승 구역". 칸 번호는 **결승선까지 남은 거리**로 센다(1 = 결승선 바로 앞, 13 = 맨 뒤).
- 출발: 넷 다 자기 레인 **11번 칸**, 결승선을 바라봄(뒤에 12·13번 칸이 남음).
- 별 칸: 모든 레인의 **1·6·13번 칸**과 결승 구역.
- 접는 선(굵은 흰 선): 3|4, 7|8, 10|11 사이. 덱이 떨어질 때마다 뒤쪽부터 접혀 경주로 끝이 13 → 10 → 7 → 3 → 0으로 줄어든다(§5.6).
- 마지막 스퍼트 구역(사이드 베팅용): 1~3번 칸(마지막 접는 선과 결승선 사이).
- 허들(옵션 `hurdles`): 모든 레인 **8·5·2번 칸**(출발에서 3칸마다 하나, 레인마다 3개).
### 3.2 경주 카드 53장
마스코트마다 11장(× 4 = 44장) + 초록 카드 9장. 카드 id는 `마스코트-종류`(예: `H-W2`)이고, 상태 안에서는 섞을 때마다 바뀌는 접미사를 붙인다(§8.3).
| 종류 id | 카드 | 효과 | 마스코트마다 |
|---|---|---|---|
| `S2` | 일어나서 2 ★시작 카드(테두리 다름) | 일어나기 → 2칸 | 1 |
| `R1` | 일어나서 1 | 일어나기 → 1칸 | 1 |
| `F3` | 3 | 3칸 | 1 |
| `F2` | 2 | 2칸 | 1 |
| `B2` | −2 | 거꾸로 2칸 | 1 |
| `ST` | 별 | 보는 쪽으로 다음 별까지 | 1 |
| `W1` | 1칸 가고 꺾기 | 1칸 → 옆 레인으로 | 1 |
| `W2` | 2칸 가고 꺾기 | 2칸 → 옆 레인으로 | 1 |
| `W3` | 3칸 가고 꺾기 | 3칸 → 옆 레인으로 | 1 |
| `FD` | 넘어지기 | 넘어짐(이미 넘어져 있으면 실격) | 1 |
| `TA` | 뒤돌기 | 보는 방향을 반대로 | 1 |
- 꺾기 방향은 마스코트마다 정해져 있다(§3.1 표: 고블러·헐리 오른쪽, 댕글·맘 왼쪽). 카드의 "왼쪽/오른쪽"은 **그 마스코트가 지금 보는 방향 기준**이다.
| 초록 카드(모두 함께) | id | 장 수 |
|---|---|---|
| 모두 1칸 | `A1a`, `A1b` | 2 |
| 모두 2칸 | `A2a`, `A2b` | 2 |
| 모두 3칸 | `A3a`, `A3b` | 2 |
| 모두 거꾸로 2칸 | `AB2` | 1 |
| 모두 일어나서 2칸 | `AR2` | 1 |
| 모두 일어나서 3칸 | `AR3` | 1 |
- 카드 구성은 규칙서 그림과 팬이 만든 카드 목록(BGG 파일 "List of all cards in Hot Streak V2")을 맞춰 본 결과다. 마스코트 넷의 구성이 똑같다는 것과
초록 카드 9장 내역은 목록의 검색 요약으로 확인했고 원본 파일은 열지 못했다(§11 "확실하지 않은 부분").
### 3.3 베팅 티켓 18장
- 마스코트 티켓: 마스코트마다 3장(1단·2단·3단, 위가 비쌈). 한 면은 안전, 뒷면은 위험. 4등은 언제나 $0.
| 단 | 안전 (1등/2등/3등) | 위험 (1등/2등/3등) |
|---|---|---|
| 1단 | $10 / $7 / $5 | $15 / $5 / $2 |
| 2단 | $7 / $5 / $3 | $11 / $3 / $1 |
| 3단 | $5 / $3 / $2 | $7 / $2 / $1 ※ |
- 사이드 티켓: YES 3장, NO 3장(1·2·3단). 맞히면 받고, 위험 면은 틀리면 낸다.
| 단 | 안전 (맞힘/틀림) | 위험 (맞힘/틀림) |
|---|---|---|
| 1단 | +$10 / $0 | +$15 / −$5 |
| 2단 | +$7 / $0 ※ | +$12 / −$5 ※ |
| 3단 | +$5 / $0 | +$10 / −$5 |
- ※ 표시는 규칙서 그림에 안 나와 우리가 맞춘 값이다. 마스코트 티켓은 같은 단의 안전·위험 합이 같다(22=22, 15=15)는 규칙을 따랐고,
사이드 티켓은 "위험 = 안전 + $5, 틀리면 −$5" 규칙을 따랐다. 실물 티켓을 확인하면 이 표만 고친다.
### 3.4 사이드 베팅 카드 12장 (경주마다 1장 공개)
| id | 질문 | 판정(정한 기준) |
|---|---|---|
| `bottom-G/H/D/M` | ○○이(가) 아래 두 자리(3·4등)로 들어올까? | 그 마스코트의 등수가 3 이상. 공동 등수는 낮은 쪽 등수(§6.3) |
| `two-down` | 마스코트 둘 이상이 동시에 넘어져 있을까? | 어느 순간이든 경주로 위에 넘어진 마스코트가 2명 이상 |
| `two-at-line` | 마스코트 둘 이상이 동시에 결승선 앞에 있을까? | 카드 한 장 처리가 끝난 시점에 1번 칸(레인 무관)에 2명 이상 |
| `any-dq` | 실격이 한 명이라도 나올까? | 실격 1명 이상 |
| `crawl-stretch` | 마지막 스퍼트 구역에서 누가 기어갈까? | 넘어진 마스코트가 기어서 움직일 때 출발 칸이나 도착 칸이 1~3번 칸 |
| `empty-stretch` | 1등이 들어올 때 마지막 스퍼트 구역이 비어 있을까? | 첫 마스코트가 결승선을 넘는 순간 다른 마스코트가 1~3번 칸에 없음 |
| `out` | 누가 경주로 밖으로 나갈까? | 옆으로 나감·뒤로 나감·접힌 경주로에 깔림 중 하나 |
| `same-space` | 두 마스코트가 같은 칸에 함께 멈출까? | 카드 한 장 처리가 끝난 시점에 같은 레인·같은 칸에 2명 이상 |
| `knockout` | 누가 녹아웃될까? | 넘어진 마스코트가 또 넘어져서(카드·충돌) 실격 |
- 질문 문장은 원작 카드를 우리말로 새로 적었다. 판정 기준 중 `two-at-line`, `crawl-stretch`, `empty-stretch`의 세부는 디자이너 답변(BGG)과 카드 뒷면 설명을
바탕으로 우리가 정했다. `two-at-line`은 "넘어진 마스코트를 다른 마스코트가 밟아 실격시키면 동시에 있던 것이 아니다"라는 디자이너 답변대로,
처리가 끝난 뒤 남아 있는 마스코트만 센다.
### 3.5 돈
- 놀이용 가상 돈(단위 $). 시작 $10(상금 나누기 모드는 $0). 0 아래로 내려가지 않는다.
## 4. 준비(셋업)
1. 시작 사람(원작: "가장 운 없는 사람")을 무작위로 정한다.
2. 시작 카드 4장(`G-S2`, `H-S2`, `D-S2`, `M-S2`)을 경주 덱에 넣는다. 나머지 49장을 섞어 아래 표만큼 경주 덱에 **앞면으로** 더하고,
이어서 각자 손패를 뒷면으로 나눠 준다. 남은 카드는 이번 게임에 쓰지 않는다(상자로).
| 인원 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9(티켓) | 9~10(상금 나누기) |
|---|---|---|---|---|---|---|---|---|---|
| 무작위 카드 | 10 | 11 | 10 | 9 | 8 | 7 | 6 | 5 ※ | 14 |
| 손패 | 4 | 3 | 3 | 3 | 3 | 3 | 3 | 3 | 없음 |
| 경주마다 넣는 카드 | 2 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 없음 |
- 어느 인원이든 경주가 시작될 때 덱은 정확히 **18장**이다(시작 4 + 무작위 + 넣은 카드).
- `cardsPerRace=2`(3~6명): 무작위 카드 = 18 − 4 − 2×인원(3명 8장, 4명 6장, 5명 4장, 6명 2장), 손패 4장, 경주마다 2장 넣기, 경주 뒤 2장 받기.
- 상금 나누기 모드는 인원과 상관없이 무작위 14장(디자이너 정정), 덱 18장을 모두 앞면으로 보여 준다.
- `spicyDeck`: 49장을 섞기 전에 넘어지기 4장(`?-FD`)을 따로 빼 두었다가, "무작위 카드 + 손패"로 쓸 카드 묶음에 먼저 넣고 나머지를 채운 뒤 그 묶음을 섞어 나눈다.
그래서 넘어지기 4장은 반드시 덱이나 누군가의 손에 있다(BGG 팁).
3. 마스코트 티켓 4더미(1단이 위)와 YES·NO 더미를 놓는다. 모두 안전 면이 위.
4. 사이드 베팅 카드 12장을 섞어 한 장을 공개한다.
5. 모두 $10을 받는다. 마스코트를 출발 칸에 세운다.
## 5. 진행 규칙
게임은 경주 `races`번(기본 3번). 경주마다 **① 베팅 → ② 카드 넣기 → ③ 경주 → ④ 정산** 순서다.
### 5.1 베팅(티켓 모드)
- 각자 티켓 2장(2명이면 3장)을 **뱀 순서**로 뽑는다. 4명이고 시작이 P1이면 P1 P2 P3 P4 P4 P3 P2 P1.
2명이면 P1 P2 P2 P1 P1 P2.
- 내 차례에는 아직 티켓이 남은 더미(마스코트 4개, YES, NO) 하나의 **맨 위 티켓**을 가져오고, 그 자리에서 안전/위험 면을 정한다.
같은 더미에서 두 장을 가져와도 되고, 마스코트 티켓만 둘, 사이드만 둘이어도 된다. 빈 더미는 고를 수 없다.
- `reverseBets` 켜짐: 마스코트 티켓을 가져올 때 "거꾸로"로 놓을 수 있다. 거꾸로 티켓은 4등이면 1등 값, 3등이면 2등 값, 2등이면 3등 값, 1등이면 $0(§6.3).
- 손패는 처음부터 볼 수 있다. 손패를 보고 티켓을 고른다(디자이너 답변).
- **마지막 경주**(`finalBet=double`): 자기 마지막 티켓을 뽑은 직후, 가진 티켓 중 하나를 "두 배"로 정해야 다음 사람 차례로 넘어간다. 마이너스도 두 배다.
- 다른 사람이 어떤 티켓을 어느 면으로 가져갔는지는 모두 공개다.
### 5.2 베팅(상금 나누기 모드)
- 모두 동시에 몰래 적는다: **마스코트 하나**와 사이드 질문에 **YES/NO**. `reverseBets`면 마스코트 대신 "꼴찌 마스코트"를 고를 수도 있다.
- 마지막 경주(`finalBet=double`)에는 둘 중 하나를 두 배로 표시한다. 모두 적으면 동시에 공개된다.
### 5.3 카드 넣기(티켓 모드)
- 모두 동시에 손패에서 1장(2명·`cardsPerRace=2`는 2장)을 골라 경주 덱에 몰래 넣는다. 누가 무엇을 넣었는지는 끝까지 비밀이다.
- 채팅으로 "나 댕글 밀어 줬어" 같은 허풍·거짓말은 자유다.
- 상금 나누기 모드에는 이 단계가 없다.
### 5.4 경주
1. 덱 18장을 섞고, 위에서 `burn`장(기본 3)을 보지 않고 버린다("3, 2, 1… 출발!").
2. 덱 위에서 한 장씩 넘겨 그 카드를 처리한다(§5.5). 경주 중에는 아무도 고르지 않는다. 화면은 `flipSeconds`마다 자동으로 넘긴다.
3. 결승선을 넘은 마스코트는 비어 있는 **가장 높은** 시상대 자리, 실격한 마스코트는 비어 있는 **가장 낮은** 자리에 선다.
4. 카드 한 장 처리가 끝났을 때 **결승 또는 실격이 3명 이상**이면 경주가 끝나고, 남은 마스코트가 남은 자리에 선다.
5. 이미 들어왔거나 실격한 마스코트의 카드는 아무 일 없이 넘어간다. 초록 카드는 경주로에 남은 마스코트에게만 적용된다.
6. 덱이 바닥나면 §5.6.
### 5.5 카드 처리
마스코트 상태: 위치(1~13, 결승선 너머는 "결승"), 레인(0~3), 보는 방향(`fwd` 결승선 쪽 / `back` 반대쪽), 넘어짐 여부, 경주 상태(달리는 중/결승/실격).
- **숫자 n**: 보는 방향으로 n칸. 음수면 보는 방향의 반대로 |n|칸. 뒤돈 마스코트에게 −2는 결승선 쪽으로 2칸이다.
- **별**: 보는 방향으로 **지금 칸보다 앞에 있는 가장 가까운 별 칸**까지 간다(별 칸에 서 있어도 다음 별로). 결승선 쪽이면 별 1·6·13 다음은 결승 구역이라
1번 칸에서 별을 받으면 결승선을 넘는다. 뒤쪽으로 갈 별이 없으면(예: 13번 칸에서 뒤돈 채로 별, 또는 접혀서 없어짐) 움직이지 않는다.
- **넘어짐**: 일어서 있으면 넘어진다. 이미 넘어져 있으면 **녹아웃 → 실격**.
- **뒤돌기**: 보는 방향을 바꾼다(넘어져 있어도 바뀜). 두 번 받으면 원래대로.
- **일어나서 n**: 먼저 일어나고 결승선 쪽을 다시 보게 한 뒤(둘 다 해당하면 둘 다) n칸 간다. 일어나기는 언제나 이동보다 먼저다.
- **n칸 가고 꺾기**: n칸 간 뒤, 그 마스코트의 꺾는 방향(보는 방향 기준 왼쪽/오른쪽)으로 옆 레인 한 칸 이동. 레인 0~3 밖이면 **옆으로 나감 → 실격**.
결승 방향 n칸 중에 결승선을 넘었으면 거기서 결승이고 꺾기는 없다(실격 아님).
- **넘어진 마스코트(기어가기)**: 앞·뒤·별 이동이 모두 **딱 1칸**으로 줄어든다(방향은 카드대로). 꺾기는 그대로 한다. 일어나서 n은 일어난 뒤라 n칸 다 간다.
이동과 충돌(초록 카드가 아닐 때):
- 이동은 한 칸씩 한다. 들어간 칸에 **멈춰 있는** 다른 마스코트가 있으면 충돌: 그 마스코트가 넘어진다. 이미 넘어져 있었다면 녹아웃(실격).
움직이는 마스코트는 어떤 일이 있어도 넘어지거나 실격하지 않는다. 넘어진 채 기어가는 마스코트도 남을 넘어뜨린다.
- 옆으로 꺾을 때 들어간 칸도 마찬가지로 충돌이다. 그래서 넘어진 마스코트가 카드 한 장에 두 번(앞 1칸, 옆 1칸) 충돌을 낼 수 있다.
- 한 칸에 여럿이 있으면 모두 충돌한다. 같은 칸에서 둘이 녹아웃되면 **동시 실격**, 다른 칸이면 먼저 지나간 칸 쪽이 먼저 실격(디자이너 공식 답변).
- 결승선 쪽으로 1번 칸을 지나 한 칸 더 가면 결승이다. 남은 이동은 버린다.
- 뒤쪽으로 경주로 끝(지금 길이)을 넘어가면 **뒤로 나감 → 실격**.
- 이동이 끝난 칸에 다른 마스코트와 같이 서 있어도 된다(충돌은 이미 처리됨).
초록 카드(모두):
- 경주로에 남은 마스코트가 **동시에** 각자 계산해 움직인다. 일어나서 n이면 모두 먼저 일어난다. 넘어진 마스코트는 1칸, 뒤돈 마스코트는 반대로 간다.
- **충돌 없음, 결승 없음**: 결승선 쪽으로 가다 1번 칸에서 멈춘다(쓸 수 있는 만큼만 감). 같은 칸에 여럿이 서도 아무 일 없다.
- 뒤로 경주로 밖에 나가면 실격이다. 같은 초록 카드로 나간 마스코트들은 동시 실격이다.
허들(`hurdles` 켜짐, BGG 변형):
- 일어서 있는 마스코트가 이동을 **허들 칸에서 끝내면** 넘어진다(꺾어서 들어간 칸 포함, 초록 카드 포함). 지나가기만 하면 아무 일 없다.
- 넘어진 채 기어서 허들 칸에 들어가면 아무 일 없다(허들 밑으로 기어감). 허들 칸에 넘어져 있는 마스코트도 카드·충돌로는 평소처럼 녹아웃된다.
### 5.6 덱이 바닥났을 때(경주로 접기)
1. 마지막 카드 처리를 마친 뒤에도 경주가 안 끝났으면 경주로 끝을 다음 접는 선까지 접는다: 13 → 10 → 7 → 3 → 0.
2. 접힌 칸에 있는 마스코트는 모두 **동시 실격**(경주로 밖으로 나감)이다. 출발 칸(11)도 첫 접기에 사라진다.
3. 경주 끝 조건(§5.4-4)을 확인한다. 안 끝났으면 버렸던 카드까지 18장을 다시 섞고, `burn`장을 다시 버리고 이어서 넘긴다.
4. 네 번째 접기(3 → 0)는 원작에 없는 경우라 "남은 마스코트 모두 동시 실격"으로 정했다(거의 일어나지 않음).
### 5.7 경주 사이
1. 티켓을 모두 더미로 돌려놓는다(안전 면 위). 지난 사이드 카드는 맨 아래로, 다음 카드를 공개한다.
2. 경주로를 펴고 마스코트를 출발 칸으로.
3. 덱 18장(버린 카드 포함)을 섞어 각자 1장(2명·`cardsPerRace=2`는 2장)씩 손패로 준다 → 손패가 다시 3장(4장). **새 카드가 아니라 경주 덱에서** 받는다.
시작 카드도 손에 들어올 수 있고, 계속 들고 있어서 덱에서 빼 둘 수 있다(디자이너 답변).
4. 상금 나누기 모드: 덱에서 무작위 3장을 빼서 버리고, 쓰지 않은 카드에서 무작위 3장을 새로 넣은 뒤 18장을 모두 앞면으로 보여 준다.
5. 다음 경주의 첫 순서(`draftStart`):
- `rotate`: 지난 경주 첫 사람의 왼쪽(다음 자리).
- `spread`: 1~4명 한 자리, 5~6명 두 자리, 7~8명 세 자리씩 옮긴다(9명은 세 자리).
- `poorest`: 돈이 가장 적은 사람. 같으면 지난 경주 첫 사람에서 시계 반대 방향으로 가장 가까운 사람(BGG 하우스 룰).
### 5.8 예시
- 충돌: 헐리(레인 1, 11번 칸, 서 있음)가 `H-W3`(3칸 가고 오른쪽으로 꺾기)을 받는다. 11→10→9→8번 칸으로 간 뒤 오른쪽(레인 2)으로 꺾는다.
레인 2의 8번 칸에 댕글이 서 있으면 댕글이 넘어진다. 다음에 `D-FD`가 나오면 댕글은 이미 넘어져 있어 녹아웃 → 실격, 비어 있는 가장 낮은 자리(4등)에 선다.
- 별: 고블러가 11번 칸에서 결승선 쪽을 보며 별 → 6번 칸. 뒤돈 상태면 → 13번 칸. 13번 칸에서 뒤돈 채로 또 별 → 갈 별이 없어 그대로.
- 넘어져서 별: 넘어진 맘이 6번 칸에서 별 → 5번 칸으로 1칸만.
- 초록 "모두 2칸": 맘(2번 칸, 서 있음)은 1번 칸에서 멈춤(결승 없음). 넘어진 헐리(5번 칸)는 4번 칸. 뒤돈 고블러(12번 칸)는 뒤로 2칸 → 경주로 밖(13 넘음) → 실격.
- 뒤돈 마스코트의 −2: 뒤돌아 있는 댕글(2번 칸)이 `D-B2` → 결승선 쪽으로 2칸 → 결승(실제로 이렇게 이기는 일이 있다).
- 접기: 덱이 바닥났을 때 고블러 11번 칸, 맘 12번 칸 → 경주로가 10까지 접혀 둘이 동시 실격. 비어 있는 자리가 3·4등이면 둘 다 **4등**으로 친다(§6.3).
## 6. 승패와 점수 계산
### 6.1 티켓 정산(경주마다)
- 마스코트 티켓: 그 마스코트 등수의 값(4등 $0). 거꾸로 티켓은 §5.1.
- 사이드 티켓: 맞히면 맞힘 값, 틀리면 틀림 값(안전 $0, 위험 −$5).
- 마지막 경주 두 배 티켓은 결과(플러스든 마이너스든)를 ×2.
- `finalBet=bothBonus`: 두 배 대신, 마지막 경주에서 내 티켓 둘(2명이면 셋 모두)이 다 플러스면 그 평균(내림)만큼 더 받는다(BGG 하우스 룰).
- 한 사람의 경주 정산은 **모든 티켓 합계를 한 번에** 더한다: 새 돈 = max(0, 지금 돈 + 합계). 원작 "낼 돈이 모자라면 있는 만큼만 내고 $0"을
"합계로 한 번에"로 정했다(티켓 순서에 따라 결과가 달라지지 않게).
- 예: 등수 댕글 1, 고블러 2, 헐리 3, 맘 4. 사이드 "누가 녹아웃될까?"는 일어남(YES).
- A: 댕글 2단 위험($11/$3/$1) → +11, 맘 1단 안전 → 0. 합계 +11.
- B: NO 1단 위험 → −5, 고블러 1단 안전($10/$7/$5) → +7. 합계 +2.
- 마지막 경주에서 B가 NO 티켓을 두 배로 했다면 −10 + 7 = −3. B가 $2였다면 $0이 된다.
### 6.2 상금 나누기 모드 정산
- 상금: 1등 $18, 2등 $12, 3등 $6, 사이드 $18(`potScale`배). `reverseBets`면 꼴찌 상금 $18 추가.
- 그 등수 마스코트에 건 사람끼리 나누고 **내림**한다(5명이면 18 ÷ 5 = $3). 사이드 상금은 맞힌 사람끼리. 아무도 못 받은 상금은 사라진다.
- 두 배로 표시한 베팅은 받는 몫을 ×2. (상금 나누기 모드에는 잃는 돈이 없다.)
- 공동 등수의 마스코트(§6.3)는 그 묶음이 차지한 가장 낮은 등수의 상금만 받는다. 꼴찌 상금은 4등 묶음 모두에게.
### 6.3 등수와 공동 등수
- 시상대는 등수 묶음 목록이다. 예: `[[D], [G], [H, M]]` = 댕글 1등, 고블러 2등, 헐리·맘이 3·4등 자리를 함께 차지.
- **동시 실격**한 k명은 비어 있는 가장 낮은 k자리를 함께 차지하고, 정산에서는 모두 **그중 가장 낮은 등수**로 본다(원작: "둘 다 낮은 쪽 상금").
넷이 한꺼번에 실격하면 모두 4등(디자이너 공식 답변).
- 거꾸로 티켓만은 묶음의 **가장 높은 등수**로 본다(묶음이 3·4등이면 3등으로 쳐서 2등 값). 같은 묶음 마스코트에 정상·거꾸로 둘 다 크게 받는 일을 막는다(BGG 변형 제안).
- 사이드 "아래 두 자리"는 정산 등수(가장 낮은 등수)가 3 이상이면 YES.
### 6.4 게임 종료와 순위
- `races`번째 경주 정산이 끝나면 게임이 끝난다. 돈이 많은 순서로 순위. 같으면 공동 순위(원작에 동점 규칙 없음).
- 결과 점수 문구는 `"$23"`, 요약은 "1위 OO님 $31 · 2위 OO님 $24". 놀이용 가상 돈이라고 결과 화면에 적는다.
- `lifeStory`: 각자 최종 금액에 맞는 "인생 결과" 한 줄을 보여 준다. 원작의 금액별 문장은 쓰지 않고 우리가 구간별로 새로 쓴다:
$0 "빈털터리. 야생으로 돌아갑니다", $1~5 "핫도그 하나 사 먹고 끝", $6~9 "본전도 못 찾았지만 웃었으니 됐다", $10 "딱 본전. 오늘을 다시 사는 기분",
$11~19 "마스코트 인형 열쇠고리 득템", $20~29 "경기장 매점에서 한턱 쏨", $30~39 "곰 마스코트 장학금에 기부", $40~59 "응원가를 직접 녹음함",
$60~99 "구단 주식을 조금 삼", $100+ "너무 많이 땄다. 야생으로 돌아갑니다".
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
| 옵션 | 무엇이 재밌나 | 출처 | 기본 |
|---|---|---|---|
| `bettingMode=pots` | 모두 동시에 적어 기다림이 없고, 18장을 다 보고 건다. 손패 없음. 5명 가족 모임이 기본 규칙보다 좋아했다는 후기 | 규칙서 9+ 변형, BGG 3518486 | 9~10명만 자동 |
| `reverseBets` | 약한 마스코트에 "꼴찌"로 걸 수 있어 뒤쪽 순서도 고를 게 생기고, 넘어지길 응원하게 됨 | BGG 3725834·3546138·3522715 | 끄기 |
| `finalBet=bothBonus` | 마지막 경주 첫 순서가 너무 유리하다는 의견에 대한 대안 | BGG 3518486 | 원작(두 배) |
| `draftStart=spread/poorest` | 많은 인원에서 늘 뒤쪽만 뽑는 사람을 줄임, 꼴찌 따라잡기 | BGG 3724930·3569660·3699984 | 원작(한 자리씩) |
| `cardsPerRace=2` | 3~4명에서 덱이 너무 뻔하다는 의견. 덱 절반 가까이를 플레이어가 채워 더 시끌벅적 | BGG 3558741·3699984·3565470 | 원작(1장) |
| `burn=5` | 결과가 매번 비슷하다는 의견에 디자이너 쪽 답변 "버리는 장 수를 늘려 보라" | BGG 3626028 | 원작(3장) |
| `spicyDeck` | 넘어지기 없는 밋밋한 경주 방지 | BGG 3545848 댓글 | 끄기 |
| `hurdles` | 허들에 걸려 넘어지는 장면이 늘어남 | BGG 3671384(허들 위치는 우리가 정함) | 끄기 |
| `races=1/5`, `potScale` | 빠른 맛보기·긴 판, 큰 인원 상금 키우기 | 규칙서(상금 2·3배), 우리 | 3번·×1 |
- 넣지 않은 변형(문서화만): 팬 확장 "Under Construction"(트랙에 함정 타일 배치·이웃과 협상), "Wacky Events" 미니 확장, 경주 중 손패 카드 내리치기("Swing the Races"),
경주 중 카드 내기("Snake-Play"), 덱 두 개로 나누기, 혼자 하기용 자동 플레이어. 모두 손이 많이 가거나 "경주 중에는 구경만"이라는 원작의 핵심을 바꾼다.
## 8. 엔진 설계
코드 예정: `packages/games/src/hot-streak/` — `cards.ts`(카드 표·티켓 표·사이드 질문), `rules.ts`(옵션·상수·타입), `race.ts`(카드 처리 순수 함수),
`index.ts`(GameDefinition), `bot.ts`(컴퓨터), `sim.ts`(봇용 몬테카를로 경주).
### 8.1 상태(State)
```ts
type MascotId = 'G' | 'H' | 'D' | 'M';
type CardBase = string; // 'H-W2', 'A1a' … (53종)
type CardId = string; // `${CardBase}#${gen}` — 섞을 때마다 gen이 바뀜
type StackId = MascotId | 'YES' | 'NO';
type Side = 'safe' | 'risky';
interface Ticket { stack: StackId; tier: 1 | 2 | 3; side: Side; reverse: boolean; doubled: boolean }
interface Racer {
id: MascotId; lane: 0 | 1 | 2 | 3; pos: number; // 1..13, 결승이면 0
facing: 'fwd' | 'back'; down: boolean;
status: 'racing' | 'finished' | 'dq';
}
interface RaceState {
racers: Record<MascotId, Racer>;
trackEnd: 13 | 10 | 7 | 3 | 0;
deck: CardId[]; // 비공개: 앞으로 넘길 순서
burned: CardId[]; // 비공개
flipped: CardId[]; // 이번 섞음 이후 넘긴 카드(공개)
passes: number; // 섞은 횟수(0부터)
podium: MascotId[][]; // 등수 묶음, 확정된 위쪽부터
bottomFill: MascotId[][];// 아래쪽부터 채운 실격 묶음
flags: { twoDown; twoAtLine; anyDq; crawlStretch; emptyStretchAtWin: boolean | null; out; sameSpace; knockout: boolean };
log: RaceLine[]; // 화면 재생용(공개): 카드, 이동 경로, 충돌, 실격, 결승, 접기
nextFlipAt: number; hurry: PlayerId[];
}
interface HotStreakState {
options; seats: PlayerId[]; mode: 'tickets' | 'pots';
phase: 'draft' | 'double' | 'submit' | 'race' | 'payout' | 'finished';
raceNo: number; startSeat: number;
money: Record<PlayerId, number>;
pool: CardId[]; // 18장 경주 덱(경주 전, 비공개 순서)
faceUp: CardBase[]; // 공개된 덱 목록(1경주 전·상금 나누기 모드)
known: CardBase[]; // 이 게임에서 공개된 적 있는 카드 종류(덱 추정용)
box: CardBase[]; // 안 쓰는 카드(비공개, 상금 나누기 모드 교체용)
hands: Record<PlayerId, CardId[]>; // 비공개
submitted: Record<PlayerId, CardId[] | null>; // 비공개(넣었는지만 공개)
stacks: Record<StackId, (1 | 2 | 3)[]>;
tickets: Record<PlayerId, Ticket[]>;
potBets: Record<PlayerId, { mascot: MascotId; last: boolean; side: 'YES' | 'NO'; doubled: 'mascot' | 'side' | null } | null>;
draftOrder: number[]; draftAt: number;
sideDeck: string[]; // 비공개(맨 앞이 이번 경주 질문)
race: RaceState | null;
results: { podium: MascotId[][]; side: boolean; delta: Record<PlayerId, number> }[];
ready: PlayerId[]; left: PlayerId[]; timeouts: Record<PlayerId, number>;
deadlineAt: number | null; result: GameResult | null;
}
```
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `DRAFT` | `{ stack, side, reverse? }` | 뽑을 차례인 사람, `draft` | 더미가 비지 않음, `reverse`는 옵션 켜짐 + 마스코트 더미일 때만 |
| `DOUBLE` | `{ index }` | 마지막 티켓을 막 뽑은 사람, `double`(마지막 경주) | 내 티켓 범위 안 |
| `POT_BET` | `{ mascot, last, side, doubled }` | 아직 안 적은 사람, `draft`(상금 나누기) | `last`는 옵션 켜짐, `doubled`는 마지막 경주에만 필수 |
| `SUBMIT` | `{ cards: CardId[] }` | 아직 안 넣은 사람, `submit` | 정확히 1장(또는 2장), 중복 없음, 내 손패 |
| `HURRY` | 없음 | 참가자, `race` | 켜고 끄기. 남아 있는 사람 모두 켜면 경주를 끝까지 바로 처리 |
| `READY` | 없음 | 참가자, `payout` | 아직 안 누름 |
| `LEAVE` | 없음 | 참가자 | 나간 사람 차례는 자동(§8.5), 돈은 결과에 남되 순위 맨 아래 |
| `FLIP` | (시스템) | 경주 마감 시각 | `race` 단계 |
| `TIMEOUT` | (시스템) | 마감 지난 사람 | §8.5 |
- `FLIP`·`TIMEOUT`은 `actionSchema`에 넣지 않는다(서버 타이머만). 경주 중 `activePlayers`는 빈 배열, `timeoutPlayers`는 남아 있는 첫 자리 한 명,
`disconnectGraceMs`는 0(누가 끊겨도 경주는 계속 넘어감).
- 이벤트: `drafted`, `doubled`, `submitted`(누가 넣었는지만), `raceStart`, `burn`(장 수만), `flip`(카드와 처리 줄), `fold`, `finish`, `dq`, `raceEnd`, `payout`, `gameOver`.
### 8.3 공개/비공개 정보 (view)
- 공개: 돈, 티켓 더미 남은 단, 모두의 티켓(면·거꾸로·두 배 포함), 이번 사이드 질문, 덱 앞면 목록(`faceUp`), 공개된 적 있는 카드 종류(`known`),
경주 상태(마스코트 위치·레인·방향·넘어짐, 접힌 길이, 이번 섞음 이후 넘긴 카드, 남은 장 수, 시상대, 사이드 판정 진행), 경주 기록, 누가 카드를 넣었는지(여부만).
- 내 것만: 내 손패, 내가 넣은 카드.
- 비공개: 덱 순서, 버린 카드, 남의 손패와 넣은 카드, 다음 사이드 카드, 상자로 간 카드, 상금 나누기 모드에서 공개 전 남의 베팅.
- 카드 id 접미사: 같은 카드가 1경주에 공개되고 2경주에 누군가의 손에 들어가도 유출 검사가 헷갈리지 않도록, 섞을 때마다 `gen`을 올려
`H-FD#4`처럼 새 id를 쓴다(블랙잭 `shoeGen`과 같은 방식). 화면은 `#` 앞(종류)만 그린다.
- `secretsOf(state, p)`: 남의 손패·넣은 카드 id, 덱·버린 카드 id, 다음 사이드 카드들, 공개 전 남의 `potBets`(직렬화 문자열).
- `legal`: 지금 고를 수 있는 더미·면, 넣을 수 있는 카드, 두 배로 할 수 있는 티켓.
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
- 셋업: 첫 시작 사람, 49장 섞기(무작위 카드·손패), 사이드 카드 섞기.
- 경주마다: 18장 섞기 + 버리기, 덱이 바닥날 때 다시 섞기. 경주 사이: 손패 나눠 주기 전 섞기, 상금 나누기 모드의 3장 빼기·3장 넣기.
- `draftStart=poorest` 동점은 난수 없이 §5.7 규칙으로. 그 밖에는 난수를 쓰지 않는다.
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- 뽑기·두 배·넣기·상금 나누기 베팅: `turnSeconds`(넣기·베팅은 모두 같은 마감). 경주: `flipSeconds`마다 `FLIP`. 정산 화면: 8초 또는 모두 `READY`.
- 시간 초과 기본값(단순하고 안전한 쪽):
- 뽑기: 남은 티켓 중 "덱 공개 카드 기준 전진 합"이 가장 큰 마스코트의 맨 위 티켓, 안전 면(마스코트 더미가 다 비면 NO 더미, 그다음 YES).
- 두 배: 1등 값(사이드는 맞힘 값)이 가장 큰 티켓. 넣기: 손패 맨 앞 카드(들). 상금 나누기: 같은 기준의 마스코트 + NO, 두 배는 마스코트.
- 정산: 자동 `READY`.
- 연속 3번 시간 초과면 "자리 비움", 이후 마감 5초. 나간 사람은 1초 만에 자동 행동. 남은 사람이 1명이면 바로 끝(`reason: 'resign'`).
### 8.6 종료 조건과 결과(GameResult)
- `races`번째 경주 정산이 끝나면 종료. `ranking`은 돈 순(같으면 같은 묶음, 나간 사람 맨 뒤), `scores`는 돈, `scoreText`는 `"$N"`,
`summary`는 §6.4. 경주가 끝없이 길어지는 일은 없다(접기 4번이면 반드시 끝남). 그래도 안전장치로 한 경주 카드 처리 200번에서 §5.6-4처럼 끝낸다.
### 8.7 컴퓨터 상대(레벨 1~60)
- 입력은 자기 `view`와 `legal`뿐. 덱 추정: `faceUp`/`known` + 내 손패 + 아직 안 보인 카드(53장 중 나머지)에서 남이 넣었을 카드를 무작위로 채운다.
- `sim.ts`: 위 추정 덱으로 경주를 N번 돌려(레벨 1은 30번, 60은 400번, 사이에서 고르게) 마스코트별 등수 분포와 사이드 질문 확률을 얻는다.
- 뽑기: 남은 티켓의 안전·위험(·거꾸로) 면 기대값을 계산해 고른다. 마지막 경주 두 배는 기대값이 가장 큰 티켓(마이너스 위험 고려).
- 넣기: 손패 카드마다 "그 카드를 넣었을 때 내 티켓 기대 수익"을 시뮬레이션해 가장 좋은 카드를 넣는다(내가 건 마스코트를 밀거나 1등 후보를 넘어뜨림).
- 레벨이 낮을수록 가끔 덜 좋은 수: 공통 `humanBest` 확률표를 쓰되, 점수는 기대 달러이고 `small` = $1, `critical`은 쓰지 않는다.
- 경주 중에는 할 일이 없다. 채팅 봇 말투(`persona`)가 있다면 넘어짐·실격 때 짧게 반응해도 좋다(선택).
## 9. UI/UX
- **PC**: 가운데 가로 경주로(왼쪽이 출발 뒤쪽 13번 칸, 오른쪽이 결승선과 시상대), 레인 4줄. 오른쪽 패널에 내 돈·내 티켓·내 손패, 사람별 돈과 티켓, 사이드 질문 카드.
경주로 위쪽에 "넘긴 카드" 줄과 남은 장 수, 버린 3장 뒷면.
- **휴대폰(320px)**: 경주로를 세로로 세운다(위가 결승선, 레인 4열 × 76px, 칸 높이 32px → 14줄 약 450px). 화면 위에 방금 넘긴 카드 크게,
아래에 접히는 시트(내 티켓·손패·베팅 버튼). 레인 위에 마스코트 색 띠와 이름 첫 글자.
- 마스코트·카드 그림은 우리가 SVG로 새로 그린다(곰·핫도그·아귀·여왕 탈 인형). 넘어짐은 눕힌 그림, 뒤돌기는 좌우 반전 + "↩" 표시.
- **베팅 화면**: 티켓 더미 6개를 카드처럼 나란히(맨 위 단의 안전/위험 값이 한눈에), 더미를 누르면 "안전으로 / 위험으로 (/ 거꾸로)" 두세 버튼과 각 등수 값.
내 차례가 아니면 뱀 순서 줄에서 지금 누구 차례인지 강조. 덱 앞면 목록은 마스코트별 줄로 정리(원작 팁: 레인에 맞춰 줄 세우기).
내 손패는 "이 카드를 넣으면" 미리보기(어떤 마스코트를 어떻게 움직이는지 한 줄 설명).
- **카드 넣기**: 손패를 눌러 고른 뒤 [몰래 넣기]. 남은 사람 표시 "3/5명 넣음".
- **경주 연출**: 덱에서 카드가 뒤집히며 가운데로 → 해당 마스코트가 한 칸씩 폴짝(지나간 칸 반짝) → 꺾기는 옆으로 미끄러짐 → 충돌 "쾅!"과 넘어지는 흔들림,
녹아웃·밖으로 나가면 "실격!" 도장과 함께 날아가 시상대 아래쪽 자리로 → 결승선 통과는 색종이와 "1등!" → 덱이 바닥나면 노란 막대가 굴러와
경주로 끝을 덮는 접기 애니메이션. 사이드 질문이 YES가 되는 순간 카드가 뒤집혀 "YES!" 표시(원작 카드 뒷면 사용법).
화면은 경주 기록(`log`)을 한 박자 늦게 다시 그린다(야단법석 달리기 `replay.ts` 방식). 움직임 줄이기 설정이면 바로 바뀜.
- **[빨리 보기]** 버튼(`HURRY`): 모두 누르면 경주가 끝까지 처리되고 연출을 빠르게 감는다.
- **정산 화면**: 시상대(1·2·3·4, 공동은 한 받침에 둘), 사람마다 티켓별 +/− 줄과 합계, 돈 변화 막대.
- **초보자 도움**: 30초 요약 카드 3장(① 티켓을 뽑아 걸어요 ② 카드 한 장 몰래 넣어요 ③ 구경하며 소리 질러요), [?] 지금 할 수 있는 것,
카드 종류 표(§3.2)와 사이드 질문 판정(§3.4)을 규칙 보기에. 위험 면 버튼에는 "틀리면 −$5" 빨간 글씨.
- 접근성: 경주로 SVG에 상황 aria-label("헐리 레인 2, 8번 칸, 넘어짐"), 경주 기록 `aria-live`, 모든 조작은 버튼(Tab·Enter), 다크 모드 색 변수.
## 10. 테스트 체크리스트
- [ ] 카드 표: 53장(마스코트별 11장 + 초록 9장), 시작 카드 4장, 꺾는 방향(G·H 오른쪽, D·M 왼쪽), 티켓 18장 값(§3.3), 사이드 12장.
- [ ] 셋업: 인원별 무작위 장 수(2~9명, 상금 나누기 14장), 손패 수, 경주 시작 덱이 언제나 18장. `cardsPerRace=2` 3~6명 계산. `spicyDeck`이면 넘어지기 4장이 덱+손패에 모두 있음.
- [ ] 뱀 순서: 4명 P1~P4→P4~P1, 2명 1-2-2-1-1-2, 같은 더미 두 번 가능, 빈 더미 거부, 마지막 경주 두 배 단계가 다음 사람 차례 전에 끼어듦.
- [ ] 카드 처리 단위 테스트: 숫자·음수·뒤돈 음수, 별(앞·뒤·별 칸에서·갈 별 없음·넘어짐 1칸·1번 칸에서 결승), 넘어짐 두 번 = 녹아웃, 뒤돌기 두 번,
일어나서 n(넘어짐+뒤돎 둘 다 회복 후 n칸), 꺾기(옆 레인 충돌, 레인 밖 실격, 결승 뒤 꺾기 없음), 넘어진 채 꺾기(앞 1칸 + 옆 1칸, 충돌 두 번).
- [ ] 충돌: 지나가기만 해도 충돌, 움직이는 쪽은 안전, 한 칸 여럿 모두 충돌, 같은 칸 녹아웃 둘 = 동시 실격, 다른 칸 녹아웃 = 지나간 순서.
- [ ] 초록 카드: 충돌 없음, 1번 칸에서 멈춤, 넘어짐 1칸, 뒤돎 반대, 뒤로 밖 실격(동시), 일어나서 2·3.
- [ ] §5.8 예시 다섯 개를 그대로 테스트로.
- [ ] 시상대: 결승은 위에서, 실격은 아래에서, 3명 확정 순간 끝·남은 1명 자동, 동시 실격 묶음(둘·셋·넷), 거꾸로 티켓은 묶음의 높은 등수.
- [ ] 접기: 13→10→7→3→0, 접힌 칸 동시 실격, 버린 카드 포함 다시 섞기, 다시 `burn`장 버림, 네 번째 접기 전원 실격, 처리 상한 200.
- [ ] 사이드 판정 12개 각각 YES·NO 장면(특히 `two-at-line` 밟혀 실격은 NO, `empty-stretch`, `crawl-stretch`, `out` 세 가지 경로).
- [ ] 정산: §6.1 예시, 합계 한 번에 + 0 아래 없음, 두 배 마이너스, `bothBonus`, 상금 나누기(5명이 1등 → $3씩, 내림, 아무도 없으면 사라짐, 두 배 몫, 꼴찌 상금).
- [ ] 경주 사이: 티켓 복귀, 사이드 다음 카드, 덱에서 1장(2장) 받기, 시작 카드도 손에 올 수 있음, `draftStart` 세 방식(동점 처리 포함), 상금 나누기 3장 교체.
- [ ] 엔진 공통: 무작위 대국 1,000시드(2·3·5·8·9·10명, 옵션 조합), JSON 왕복, 결정성, 유출 검사(`#gen` 접미사 덕분에 오탐 없음), 시간 초과만으로 끝남, 카드 총수 보존(18 + 손패 + 상자 = 53).
- [ ] 경주는 마감 타이머만으로 끝까지 넘어감(연결 끊긴 사람이 있어도), `HURRY` 전원 동의 시 즉시 끝.
- [ ] 컴퓨터: 레벨 1·60이 2~10명 끝까지, 모든 수 합법, 한 수 50ms 이내(시뮬레이션 400번 기준), 60레벨이 무작위보다 돈을 더 많이 범.
- [ ] 방 통합·E2E: PC 방장 + 휴대폰(320px)으로 티켓 뽑기·위험 면·카드 넣기·경주 구경·정산·마지막 두 배까지 한 판, 넣은 카드 비공개 확인.
## 11. 참고 자료
- 규칙서 2쇄 PDF(영문, 38쪽): https://gamers-hq.de/media/pdf/dc/37/cf/Hot_Streak_rulebook_2nd_printing.pdf (BGG 파일 300437과 같은 판).
1쇄: https://nastol.io/storage/games/files/hot_streak_2/941171/Hot_Streak_rulebook.pdf
- BGG 게임 446497(geekdo API로 확인한 2026-10-15 값: 평점 7.77/8,180명, 전체 290위, 파티 5위, 무게 1.22, 추천 3~8명·베스트 5~6명, 수상 내역).
- BGG 규칙·변형 게시판(디자이너 Jon Perry·개발 Alex Hague 답변): 3514838(2인·9+ 정정), 3628277(전원 실격), 3517385·3517383(기어가기 꺾기·충돌),
3525106(시작 카드), 3525669(2인 뱀 순서·두 배 시점·공동 등수), 3639111·3617426(같은 칸·결승선 질문), 3516613(마지막 스퍼트 = 3칸), 3610771(초록 카드),
변형 3522715·3546138·3725834(거꾸로), 3518486(두 배 대안), 3724930·3569660·3699984(첫 순서), 3558741·3565470(카드 2장), 3626028(버리기),
3545848(덱 손보기), 3671384(허들).
- 카드 목록: BGG 파일 303432 "List of all cards in Hot Streak V2"(Scribd 사본 928819229) — 원본은 로그인이 필요해 검색 요약으로만 확인.
- 리뷰: shelfgamer.com(티켓 1단 값), geekdad.com, opinionatedgamers.com, misutmeeple.com, boardgamequest.com.
- 한국어: 코리아보드게임즈 상품 페이지(2~9명·20분·8세+), 공식 블로그 소개글 https://blog.naver.com/kboardgame/224203746865 , 보드라이프 게임 20931.
## 12. 메모 (상표·법적 주의 등)
- 화면 이름은 "핫스트릭", 마스코트 이름은 원작 그대로(친구끼리 쓰는 사이트라 원작 이름 허용, 사용자 결정). 한국어판의 공식 마스코트 표기는 확인하지 못했다.
- 원작 그림·카드 문구·인생 결과 문장은 쓰지 않는다. 그림은 직접 그린 SVG, 문구는 우리말로 새로 적는다.
- 돈은 방 안에서만 쓰는 놀이용 가상 돈이다(docs/04 §6). 기록에는 승패만 남긴다.
- 원작과 다르게 정한 것: 9명 티켓 모드 무작위 5장, 네 번째 접기 전원 실격, 정산 합계 한 번에, 거꾸로 티켓 공동 등수, 허들 위치, 3단 위험·사이드 2단 값(※),
사이드 질문 세 개의 세부 판정. 실물·한국어판 규칙서로 확인되면 이 문서부터 고친다.

384
docs/games/six-nimmt.md Normal file
View File

@@ -0,0 +1,384 @@
# 젝스님트 (`six-nimmt`)
> 마일스톤: 2026-10 새 게임 · 인원: 최소 2 ~ 최대 10명 · 예상 시간: 약 20~45분 · 난이도: 쉬움
## 1. 개요
- 1부터 104까지 숫자 카드를 한 장씩 동시에 몰래 내고, 작은 숫자부터 차례로 네 줄 중 알맞은 줄 끝에 붙인다. 내 카드가 어떤 줄의 여섯 번째 카드가 되면 그 줄의 다섯 장을 가져와야 하고, 카드에 그려진 소머리 수만큼 벌점이 된다. 누군가 벌점 66점 이상이 되면 끝나고, 벌점이 가장 적은 사람이 이긴다.
- 원작은 볼프강 크라머(Wolfgang Kramer)의 "6 nimmt!"(1994년, AMIGO). 영어판 이름은 Take 6!, Take 5, Category 5다. 1994년 독일 게임상(Deutscher Spiele Preis) 1위, 같은 해 올해의 게임상 추천작, 1996년 멘사 셀렉트에 뽑혔다.
- 한국에서는 코리아보드게임즈가 "젝스님트"라는 이름으로 정식판을 낸다(2~10명, 만 8세 이상, 약 20분). 보드라이프 순위 283위, 평점 7.5(690명). 만화·애니 "방과 후 주사위 클럽", "더 지니어스" 패러디 대회인 "퍼펙트 지니어스"의 '4열횡대' 매치로도 쓰였다. 규칙이 짧고 여러 명이 함께 할 수 있어서 보드게임 카페나 모임에서 많이 한다.
- 인원 근거: 원작 기본 규칙서가 2~10명이다(한 사람에 10장 × 10명 + 줄 시작 4장 = 104장). 다만 2명이면 104장 중 24장만 쓰여서 운이 커진다. 원작은 2~6명이면 카드를 줄이는 "프로 변형"을 권한다(§2 `deck`).
### 확인된 것과 우리가 정한 것
- 확인됨(AMIGO 30주년판 영문 규칙서, 코리아보드게임즈 상품 페이지 상세 이미지, 나무위키)
- 104장, 소머리 수(§3), 각자 10장, 줄 4개를 1장씩으로 시작, 동시에 뒷면으로 내고 모두 낸 뒤 공개, 작은 카드부터 놓기.
- 규칙 1(오름차순)과 규칙 2(차이가 가장 작은 줄), 규칙 3(여섯 번째 카드면 앞의 다섯 장을 가져가고 내 카드가 새 줄의 첫 카드), 규칙 4(어느 줄에도 못 놓는 작은 카드는 원하는 줄을 통째로 가져가고 내 카드가 새 첫 카드).
- 10장을 다 내면 라운드 끝, 벌점 66점 이상인 사람이 생길 때까지 라운드를 반복, 가장 적은 사람이 승리, 같으면 공동 승리. "다른 점수나 미리 정한 라운드 수로 해도 된다"는 문장도 원작 규칙서에 있다(§2 `endMode`).
- 프로 변형(2~6명): 카드를 `인원 × 10 + 4`장(1부터)만 쓰고, 모두 앞면으로 펼쳐 차례로 한 장씩 골라 10장을 만든다. 남은 4장이 줄 시작.
- 30주년판 "팬 카드" 4종(짝홀, 산 오르기, 점프하는 소, 숫자 뒤집기)과 협력 변형 "버펄로를 이겨라".
- 옛 변형 "프로페셔널"(줄 왼쪽에도 내림차순으로 붙임): BGA·위키백과·UltraBoardGames.
- 우리가 정한 것(원작 문장이 없거나 화면용으로 고정한 것, 모두 이 문서에 적음)
- 작은 카드로 줄을 고르는 일은 그 카드를 놓을 차례에 바로 한다(뒤 카드는 기다림). 원작 순서 그대로이고, 순서상 고르는 일은 보통 그 차례의 가장 작은 카드에만 생긴다(§5.3).
- 숫자 뒤집기에서 한 자리 숫자(1~9)는 "0X"로 보고 X0이 된다(7 → 70). 원작은 31 → 13, 90 → 09 예만 있다.
- 66점 모드에서도 20라운드가 지나면 끝낸다(2명 판이 너무 길어지지 않게 하는 안전장치).
## 2. 모드와 옵션
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `deck` | 카드 구성과 나누는 법 | `all`(104장을 섞어 10장씩, 원작 기본) / `tactics`(1 ~ `인원×10+4`만 써서 섞어 나눔, 원작 프로 변형의 1번 규칙) / `pro`(1 ~ `인원×10+4`를 앞면으로 펼쳐 차례로 골라 가짐, 원작 프로 변형 전체) | `all` |
| `placement` | 줄에 붙이는 곳 | `right`(오른쪽 끝에만 오름차순, 원작 기본) / `both`(오른쪽엔 더 큰 수, 왼쪽엔 더 작은 수, 옛 "프로페셔널" 변형) | `right` |
| `lowCard` | 어느 줄에도 못 놓는 작은 카드일 때 | `choose`(가져갈 줄을 직접 고름, 원작) / `fewest`(소머리가 가장 적은 줄을 자동으로 가져감, 빠른 판용) | `choose` |
| `fanCard` | 30주년판 팬 카드(한 번에 하나만, 원작 권장) | `none` / `evenOdd`(짝홀) / `mountain`(산 오르기) / `jumpingCow`(점프하는 소) / `flipDigits`(숫자 뒤집기) | `none` |
| `endMode` | 끝나는 조건 | `score`(누군가 `endScore` 이상이면 그 라운드 끝에 종료, 원작) / `rounds`(`rounds` 라운드를 하고 종료) | `score` |
| `endScore` | (`score`) 끝나는 벌점 | 33 / 44 / 55 / 66 / 77 / 88 / 99 | 66 |
| `rounds` | (`rounds`) 라운드 수 | 1 / 2 / 3 / 4 / 5 / 6 | 3 |
| `cardTracker` | 이번 라운드에 나온 카드 표 보여 주기(프로 변형이면 각자 골라 간 카드도) | `true` / `false`(원작처럼 기억으로) | `true` |
| `turnSeconds` | 카드 고르기·줄 고르기·카드 뽑아 가기 제한 시간 | 15 / 20 / 30 / 45 / 60 / 무제한(`null`) | 30 |
zod 메타 예(`.meta({ title, labels })`, 09 §2):
```ts
deck: z.enum(['all', 'tactics', 'pro']).default('all').meta({
title: '카드 구성',
labels: { all: '104장 모두(기본)', tactics: '인원×10+4장만 섞어 나누기', pro: '인원×10+4장을 펼쳐 골라 가기(프로)' },
}),
placement: z.enum(['right', 'both']).default('right').meta({
title: '줄에 붙이는 곳', labels: { right: '오른쪽 끝에만(기본)', both: '양쪽 끝(왼쪽은 더 작은 수)' },
}),
lowCard: z.enum(['choose', 'fewest']).default('choose').meta({
title: '너무 작은 카드를 냈을 때', labels: { choose: '가져갈 줄을 직접 골라요', fewest: '소머리가 가장 적은 줄을 자동으로' },
}),
fanCard: z.enum(['none', 'evenOdd', 'mountain', 'jumpingCow', 'flipDigits']).default('none').meta({
title: '특별 카드(30주년판)',
labels: { none: '안 써요', evenOdd: '짝홀', mountain: '산 오르기', jumpingCow: '점프하는 소', flipDigits: '숫자 뒤집기' },
}),
endMode: z.enum(['score', 'rounds']).default('score').meta({ title: '끝나는 조건', labels: { score: '벌점 점수', rounds: '라운드 수' } }),
endScore: lit(33, 44, 55, 66, 77, 88, 99).default(66).meta({ title: '끝나는 벌점', labels: { 33: '33점', /* … */ 66: '66점(기본)', 99: '99점' } }),
rounds: lit(1, 2, 3, 4, 5, 6).default(3).meta({ title: '라운드 수', labels: { 1: '1라운드', /* … */ 6: '6라운드' } }),
cardTracker: z.boolean().default(true).meta({ title: '나온 카드 표', labels: { true: '보여요', false: '기억으로 해요' } }),
turnSeconds: lit(15, 20, 30, 45, 60, null).default(30).meta({ title: '제한 시간', labels: { 15: '15초', /* … */ null: '무제한' } }),
```
옵션 검증
- `deck = pro`는 2~6명만(원작 "2–6 Players"). 7명 이상이면 고를 카드가 74~104장이라 고르기만 수십 번이 된다. `playersFor(options)`로 대기실 인원 제한을 바꾼다(`pro` → 2~6, 나머지 → 2~10).
- `fanCard`는 `placement = right`일 때만 쓸 수 있다(팬 카드 규칙은 오른쪽에만 붙이는 원작 기준으로 쓰여 있음).
- `tactics`·`pro`를 10명이 고르면 `all`과 같다(104장).
- `endScore`는 `endMode = score`일 때만, `rounds`는 `endMode = rounds`일 때만 쓴다(대기실에서는 안 쓰는 쪽을 흐리게).
## 3. 구성물
- 숫자 카드 104장: 1~104 한 장씩. 카드마다 소머리(벌점) 수가 정해져 있다.
| 카드 | 소머리 | 장 수 |
|---|---|---|
| 55 | 7 | 1 |
| 11의 배수(11, 22, 33, 44, 66, 77, 88, 99) | 5 | 8 |
| 10의 배수(10, 20, …, 100) | 3 | 10 |
| 끝자리가 5인 수(5, 15, …, 95, 55 빼고) | 2 | 9 |
| 나머지 | 1 | 76 |
- 104장 소머리 합계는 171이다(테스트 불변식).
- 계산식: `bulls(n) = n === 55 ? 7 : n % 11 === 0 ? 5 : n % 10 === 0 ? 3 : n % 5 === 0 ? 2 : 1`.
- 줄 4개(위에서부터 1~4번 줄). 한 줄에는 언제나 최대 5장(첫 카드 포함)까지만 놓인다.
- 각자 앞의 "소 더미"(가져간 카드, 손패와 섞이지 않음)와 점수표.
- 팬 카드(옵션): 짝홀 1장(양면: 짝/홀), 산 오르기 1장(화살표 위/아래), 점프하는 소 1장, 숫자 뒤집기(한 사람에 1장).
## 4. 준비(셋업)
1. `deck`에 맞는 카드를 고른다. `all`이면 1~104, `tactics`·`pro`면 1 ~ `인원 × 10 + 4`.
2. 나누기
- `all`·`tactics`: 시드 RNG로 섞어 한 사람에 10장씩 나눈다. 다음 4장을 1~4번 줄의 첫 카드로 뽑힌 순서대로 놓는다(원작처럼 정렬하지 않음). `all`이면 남은 카드는 이번 라운드에 쓰지 않는다(비공개).
- `pro`: 모든 카드를 숫자 순서로 펼친다. 이번 라운드 시작 사람부터 시계 방향으로 한 장씩 골라 가져가고, 모두 10장이 되면 멈춘다. 남은 4장을 작은 수부터 1~4번 줄 첫 카드로 놓는다.
3. 팬 카드(옵션)
- `evenOdd`: 짝홀 카드를 첫 카드가 가장 작은 줄 왼쪽에 둔다. 그 카드가 짝수면 "짝", 홀수면 "홀" 면.
- `mountain`: 산 오르기 카드를 4번 줄 왼쪽에 화살표가 위를 향하게 둔다.
- `jumpingCow`: 점프하는 소를 첫 카드가 가장 작은 줄의 그 카드 오른쪽에 둔다.
- `flipDigits`: 모두 숫자 뒤집기 1장씩 받는다(라운드마다 새로 받음, 안 쓴 것은 라운드 끝에 버림).
4. 첫 라운드 시작 사람은 RNG로 정하고, 라운드마다 다음 자리로 넘어간다. 시작 사람은 `pro`의 고르기 순서와 화면 표시에만 쓴다(카드 놓는 순서는 숫자로 정해짐).
5. 모두 벌점 0점에서 시작한다.
## 5. 진행 규칙
### 5.1 한 차례(10번 반복)
1. **고르기(동시)**: 모두 손패에서 1장을 몰래 고른다. `flipDigits`면 숫자 뒤집기를 같이 낼지도 고른다. 모두 고르기 전에는 고른 카드를 바꿀 수 있다. 다른 사람이 골랐는지만 보이고 무엇을 골랐는지는 안 보인다.
2. **공개**: 마지막 사람이 고르는 순간 모두의 카드가 한꺼번에 공개된다.
3. **놓기**: 가장 작은 카드부터 큰 카드 순서로 한 장씩 줄에 놓는다(§5.2). 놓다가 줄을 가져가야 하면 그 자리에서 가져간다(§5.3). 뒤 카드는 앞 카드가 놓인 뒤의 줄 모양을 보고 놓인다.
4. 10번째 차례가 끝나면 라운드가 끝난다(§6).
### 5.2 카드를 놓을 줄(합법 조건, 기본 규칙)
- 줄의 "끝 카드" = 가장 오른쪽 카드.
- 규칙 1(오름차순): 내 카드보다 끝 카드가 작은 줄에만 놓을 수 있다.
- 규칙 2(가장 작은 차이): 그런 줄이 여럿이면 `내 카드 − 끝 카드`가 가장 작은 줄에 놓는다. 숫자가 모두 달라서 이 줄은 늘 하나로 정해진다. 그러니 플레이어가 줄을 고르는 일은 없다(§5.3 규칙 4만 예외).
- 예: 끝 카드가 17, 44, 69, 101일 때 49는 44 다음에 놓인다. 끝 카드가 41, 42일 때 45는 41이 아니라 42 다음이다(함정).
### 5.3 줄을 가져가는 경우
- **규칙 3(여섯 번째 카드)**: 놓을 줄에 이미 5장이 있으면, 그 5장을 모두 내 소 더미로 가져가고 내 카드가 그 줄의 새 첫 카드가 된다.
- **규칙 4(너무 작은 카드)**: 내 카드가 모든 줄의 끝 카드보다 작으면 원하는 줄 하나를 통째로(1~5장) 가져가고, 내 카드가 그 줄의 새 첫 카드가 된다.
- `lowCard = choose`: 그 카드를 놓을 차례에 진행을 멈추고 그 사람이 줄을 고른다. 고르는 동안 남은 공개 카드는 기다린다.
- `lowCard = fewest`: 소머리가 가장 적은 줄을 자동으로 가져간다. 같으면 끝 카드가 가장 큰 줄(원작 "버펄로" 규칙과 같음), 그래도 같을 수는 없다.
- 기본 규칙에서는 한 차례의 가장 작은 카드만 규칙 4에 걸릴 수 있다. 그 카드가 놓이면 그 카드로 끝나는 줄이 생기고, 뒤 카드는 모두 그보다 크기 때문이다. `both`·팬 카드에서는 중간 카드도 걸릴 수 있어서 엔진은 늘 "놓을 때마다 확인"한다.
- 가져간 카드는 손패로 들어가지 않는다. 다른 사람도 누가 몇 장, 소머리 몇 개를 가져갔는지 볼 수 있다(원작에서도 줄이 공개된 채 옮겨지므로).
### 5.4 예시(기본 규칙, 4명)
- 줄: 1번 [12], 2번 [37], 3번 [43], 4번 [58].
- 1차례: A 14, B 15, C 44, D 61을 냈다. 14 → 1번, 15 → 1번, 44 → 3번, 61 → 4번. 줄: [12 14 15] [37] [43 44] [58 61].
- 2차례: A 21, B 26, C 30, D 36. 21·26 → 1번(5장이 됨). 30도 1번이 가장 가까운데 여섯 번째라 C가 12·14·15·21·26을 가져간다(소머리 1+1+2+1+1 = 6). 1번 줄은 [30]. 36 → 1번 [30 36].
- 3차례: A 3, B 9, C 68, D 83. 3은 모든 끝 카드(36, 37, 44, 61)보다 작다. A가 바로 줄을 고른다. 소머리가 1개뿐인 2번 줄 [37]을 가져가고 2번 줄은 [3]. 이어서 9 → 2번 [3 9], 68 → 4번 [58 61 68], 83 → 4번 [58 61 68 83].
### 5.5 변형 규칙(옵션)
`placement = both` (프로페셔널)
- 오른쪽 끝에는 끝 카드보다 큰 카드, 왼쪽 끝에는 첫 카드보다 작은 카드를 붙일 수 있다.
- 놓을 수 있는 모든 자리(줄마다 왼쪽·오른쪽) 중 차이(`|내 카드 − 그 끝 카드|`)가 가장 작은 자리에 놓는다.
- 차이가 같은 자리가 둘이면(예: 2번 줄 끝 40, 3번 줄 첫 카드 46, 내 카드 43) 그 사람이 고른다(BGA 방식).
- 놓을 자리의 줄이 이미 5장이면 그 5장을 가져가고 내 카드가 새 줄이 된다(왼쪽에 붙여도 같음).
- 어느 자리에도 못 놓으면(모든 줄의 첫 카드보다 크고 끝 카드보다 작음) 규칙 4처럼 줄을 가져간다.
`fanCard = evenOdd` (짝홀, 원작 30주년판)
- 짝홀 카드가 붙은 줄에는 그 면(짝/홀)과 같은 홀짝 카드만 놓을 수 있다. 규칙 1·2는 이 제한을 지킨 뒤에 적용한다. 그래서 어디에도 못 놓으면 규칙 4.
- 누가 어느 줄이든 가져가면(규칙 3·4 모두), 가져가고 새 첫 카드를 놓은 뒤 짝홀 카드를 옮긴다: 지금 있는 줄을 뺀 나머지 세 줄 중 끝 카드가 가장 작은 줄로(방금 새로 시작한 줄일 수도 있음). 면은 그 끝 카드의 홀짝에 맞춘다.
- 짝홀 카드는 줄의 5장 제한에 세지 않는다.
`fanCard = mountain` (산 오르기, 원작 30주년판)
- 산 오르기 카드가 붙은 줄은 내림차순이다. 끝 카드보다 작은 카드만 놓을 수 있고 차이는 `끝 카드 − 내 카드`.
- 다른 세 줄은 원래대로. 가장 작은 차이 규칙은 네 줄 전체에 적용하고, 차이가 같으면 산 오르기 줄에 놓는다.
- 누가 어느 줄이든 가져가면, 산 오르기 카드를 화살표 방향으로 한 줄 옮긴다. 1번 줄(맨 위)이나 4번 줄(맨 아래)에 닿으면 화살표를 반대로 돌린다.
- 5장 제한에 세지 않는다.
`fanCard = jumpingCow` (점프하는 소, 원작 30주년판)
- 소는 숫자가 없고, 그 줄에 놓을 때는 소 바로 왼쪽 카드를 끝 카드로 본다.
- 소가 있는 줄에 카드가 놓이면, 소는 다른 세 줄 중 끝 카드가 가장 작은 줄 끝으로 뛰어간다.
- 소도 5장 제한에 센다. 숫자 4장 + 소면 꽉 찬 줄이다. 그 줄에 카드를 놓으면 숫자 카드 4장만 가져가고(소는 안 가져감), 내 카드가 새 첫 카드, 소는 위처럼 뛰어간다.
- 규칙 4로 소가 있는 줄을 가져가도 소는 뛰어간다.
- 소가 뛰어간 줄이 6칸(숫자 5장 + 소)이 되면, 소를 뛰게 만든 사람이 그 줄도 가져간다. 이때는 그 줄에서 가장 큰 숫자 카드(끝 카드)가 남아 새 첫 카드가 되고 나머지 4장을 가져간다. 그리고 소는 다시 뛴다. 한 번에 여러 줄을 가져갈 수 있다(가져갈 때마다 숫자 카드가 줄어서 반드시 멈춤).
`fanCard = flipDigits` (숫자 뒤집기, 원작 30주년판)
- 한 라운드에 한 번, 카드를 낼 때 숫자 뒤집기를 같이 내면 그 카드의 두 자리를 바꾼 수로 친다(31 → 13, 90 → 09 = 9). 한 자리 수는 0X로 보고 X0이 된다(7 → 70, 우리 해석). 100~104는 뒤집을 수 없다.
- 놓는 순서와 놓을 줄 모두 뒤집은 수로 정한다. 다른 사람의 원래 숫자와 같아지면 뒤집은 사람이 먼저 놓는다.
- 줄에 놓이는 순간 카드는 원래 숫자로 돌아간다(그래서 줄이 오름차순이 아니게 될 수 있음). 소머리도 원래 숫자 기준이다.
- 쓴 숫자 뒤집기는 버린다. 다음 라운드에 새로 1장씩 받는다.
## 6. 승패와 점수 계산
- 라운드 끝에 각자 소 더미의 소머리를 모두 더해 총점(벌점)에 더한다. 소 더미는 비우고, 모든 카드를 모아 §4대로 다음 라운드를 준비한다.
- 끝
- `endMode = score`: 라운드 끝에 누군가 총점 `endScore`(기본 66) 이상이면 끝난다. 라운드 도중에 넘어도 그 라운드는 끝까지 한다. 20라운드가 지나도 아무도 넘지 않으면 그때 끝낸다(안전장치).
- `endMode = rounds`: `rounds` 라운드를 마치면 끝난다.
- 순위: 총점이 적을수록 앞선다. 같으면 공동 순위(원작: "가장 적은 사람이 여럿이면 함께 이긴다"). 게임 중에 나간 사람은 맨 뒤.
- 예: 4라운드가 끝나고 A 70, B 41, C 41, D 55 → A가 66 이상이라 종료. B·C 공동 1등, D 3등, A 4등.
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
- 원작 규칙서에 있는 변형(옵션으로 제공)
- 프로 변형(`deck = tactics` / `pro`): 적은 인원에서 운을 줄이고 수 싸움을 늘린다. 나무위키도 "가장 보편적인 변형"으로 소개한다. `tactics`는 프로 변형의 앞 절반(카드 수 줄이기)만 따로 쓴 것이다(BGA의 Tactics와 같음).
- 다른 끝 점수·라운드 수(`endScore`, `endMode = rounds`): 원작 "다른 점수나 미리 정한 라운드 수로 해도 된다".
- 30주년판 팬 카드 4종(`fanCard`): 원작은 한 번에 하나만 섞어 쓰기를 권한다. 그래서 단일 선택이다.
- 옛 변형·온라인 사이트 변형(옵션으로 제공)
- 프로페셔널(`placement = both`): 1990년대 AMIGO 변형, BGA·BrettspielWelt에서 제공.
- 작은 카드 자동 처리(`lowCard = fewest`): 30주년판 협력 변형에서 "버펄로"가 줄을 고르는 규칙을 모두에게 쓴 것. 빠른 판·어린이 판용.
- 우리가 더한 것: 나온 카드 표(`cardTracker`). 원작은 기억으로 하지만 온라인에서는 기본으로 보여 준다(끄면 원작처럼).
- 지원하지 않는 변형(문서화만, 나중 후보)
- 협력 변형 "버펄로를 이겨라"(30주년판, 1~6명): 팀이 함께 버펄로(가상 플레이어)보다 벌점을 적게 받기. 특수 카드 8종(7번째에 가져가기, 줄 잠그기, 카드 바꾸기, 끼워 넣기, 밀기, 맨 먼저·맨 나중 놓기, 순서 정하기)을 "아무 때나" 팀이 의논해서 쓴다. 의논·끼어들기 단계가 많아 화면 흐름을 따로 설계해야 한다.
- 25주년판(2019) 행동 카드 7종(다섯 번째 줄, 7 nimmt!, 끼워 넣기, 바꾸기, 밀기, 멈춤, 벌점을 플러스로): 손패 12장 + 특수 카드 3장, 2라운드로 끝.
- Nifty(14장, 한 번에 2장씩 냄, 2~7명), Open(1번 카드를 선 표시로 쓰고 차례대로 앞면으로 냄), Hand, Double(208장), Tournament(같은 손패를 돌려 가며 하기): UltraBoardGames 변형 목록.
- 팀전(두 사람 벌점 합산): 출처 없는 하우스 룰. 요청이 있으면 `teams` 옵션으로 검토.
- 6 nimmt! Junior(소 그림 52장, 여섯 종류가 다 모이면 가져감, 많이 모은 사람이 승리)와 11 nimmt!는 다른 게임이라 넣지 않는다.
## 8. 엔진 설계
### 8.1 상태(State)
```ts
type Card = number; // 1..104
type FanCard = 'none' | 'evenOdd' | 'mountain' | 'jumpingCow' | 'flipDigits';
type Marker =
| { kind: 'evenOdd'; row: 0 | 1 | 2 | 3; parity: 'even' | 'odd' }
| { kind: 'mountain'; row: 0 | 1 | 2 | 3; dir: 'up' | 'down' }
| { kind: 'cow'; row: 0 | 1 | 2 | 3 }; // 소는 그 줄 끝(마지막 숫자 카드 오른쪽)에 있음
interface Play {
player: PlayerId;
card: Card;
flip: boolean; // 숫자 뒤집기를 같이 냈나
value: number; // 순서·줄 정하기에 쓰는 수(뒤집었으면 뒤집은 수)
}
interface Pending { // 진행을 멈추고 한 사람의 선택을 기다림
player: PlayerId;
play: Play;
kind: 'takeRow' | 'place'; // takeRow: 규칙 4 / place: both에서 차이가 같은 두 자리
choices: { row: number; side: 'L' | 'R' }[]; // takeRow면 side 없이 0..3 전부
}
interface SixNimmtState {
options: SixNimmtOptions;
seats: PlayerId[];
deckMax: number; // 104 또는 인원×10+4
round: number; // 1부터
startSeat: number; // 이번 라운드 시작 자리
turn: number; // 이번 라운드 몇 번째 차례(1..10)
phase: 'draft' | 'select' | 'choose' | 'finished';
rows: Card[][]; // 길이 4, 각 줄 왼쪽→오른쪽
marker: Marker | null;
hands: Record<PlayerId, Card[]>; // 비공개, 정렬해 둠
flipLeft: Record<PlayerId, boolean>; // 숫자 뒤집기를 아직 갖고 있나
aside: Card[]; // all: 이번 라운드에 안 쓰는 카드(비공개)
draft: { pool: Card[]; at: number /* 고를 자리 */; picked: Record<PlayerId, Card[]> } | null;
selections: Record<PlayerId, { card: Card; flip: boolean } | null>; // 비공개(공개 전)
queue: Play[]; // 공개됐지만 아직 안 놓인 카드(value 오름차순)
pending: Pending | null;
taken: Record<PlayerId, Card[]>; // 이번 라운드 소 더미(공개)
totals: Record<PlayerId, number>; // 지난 라운드까지 총점
roundScores: Record<PlayerId, number[]>; // 라운드별 벌점
seen: Card[]; // 이번 라운드에 공개된 카드(줄 시작 4장 포함), cardTracker용
left: PlayerId[];
timeouts: Record<PlayerId, number>; // 연속 시간 초과 수
log: LogEntry[]; // 최근 60줄
turnSeq: number;
deadlineAt: number | null;
}
```
- `stateVersion` 1. 덱의 카드 총수 보존 불변식: `hands + rows(숫자만) + taken + queue + selections(공개 전) + aside + draft.pool = deckMax`.
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `DRAFT` | `{ card }` | `draft.at` 자리 사람, `draft` | `card`가 `pool`에 있음, 그 사람이 아직 10장 미만 |
| `SELECT` | `{ card; flip?: boolean }` | 나가지 않은 참가자, `select` | `card`가 내 손패에 있음. `flip`은 `fanCard = flipDigits`이고 `flipLeft[me]`이고 `card ≤ 99`일 때만. 이미 골랐어도 다시 보내면 바꿈(모두 고르기 전까지) |
| `TAKE_ROW` | `{ row: 0..3 }` | `pending.player`, `choose`이고 `pending.kind = takeRow` | `row`가 `choices` 안 |
| `PLACE` | `{ row; side: 'L' \| 'R' }` | `pending.player`, `choose`이고 `pending.kind = place` | `choices` 안 |
| `LEAVE` | 없음 | 참가자 | 이후 그 사람 차례는 자동(§8.5) |
| `TIMEOUT` | (시스템) | `timeoutPlayers` | `actionSchema`에 없음. 클라이언트는 못 보냄 |
처리 흐름(`apply` 하나 안에서 끝까지)
1. `SELECT`: 고른 것을 저장한다. 나간 사람은 `select`가 열릴 때 바로 자동으로 고른다. 모두 골랐으면 아래 `reveal`.
2. `reveal`: 고른 카드를 손패에서 빼 `queue`로(`value` 오름차순, 같은 수면 뒤집은 사람 먼저). `selections`를 비우고 `revealed` 이벤트. `seen`에 더한다.
3. `resolve` 반복: `queue` 맨 앞 카드의 자리를 계산한다(§5.2, §5.5).
- 한 자리로 정해지면 놓는다. 여섯 번째면 가져간다. 팬 카드 이동·소 점프 연쇄까지 처리하고 다음 카드.
- 규칙 4이고 `lowCard = choose`이거나, `both`에서 차이가 같은 자리가 둘이면 `pending`을 만들고 `phase = 'choose'`로 멈춘다. 그 사람의 `TAKE_ROW`/`PLACE`가 오면 같은 반복을 이어 간다.
4. `queue`가 비면: 10번째 차례였으면 라운드 정산(§6) → 끝이면 `finished`, 아니면 다음 라운드 준비(§4, `draft` 또는 `select`). 아니면 `turn++`, `phase = 'select'`.
- 그래서 줄을 고르는 사람이 없는 한 "공개 → 다 놓기"가 한 번의 `apply`이고, 화면은 이벤트 순서대로 한 장씩 보여 준다(§9).
- 이벤트(공개 정보만): `picked{player}`(누가 골랐는지만), `revealed{plays}`, `placed{player, card, row, side, pos}`, `rowTaken{player, row, cards, bulls, why: 'sixth' | 'low' | 'cow'}`, `markerMoved{marker}`, `cowJumped{from, to}`, `choosing{player, card}`, `drafted{player, card}`, `roundEnd{round, gained, totals}`, `roundStart{round, rows, marker}`, `timeout{player}`, `left{player}`, `gameOver`.
- `reason` 문구 예: "손에 없는 카드예요", "숫자 뒤집기는 라운드에 한 번만 쓸 수 있어요", "100 이상은 뒤집을 수 없어요", "지금은 줄을 고를 차례가 아니에요", "그 줄은 고를 수 없어요", "이미 모두 냈어요".
### 8.3 공개/비공개 정보 (view)
```ts
interface SixNimmtView {
options; seats; deckMax; round; turn; phase; startSeat;
rows: { cards: { n: Card; bulls: number }[]; bulls: number }[]; // 줄별 소머리 합도
marker: Marker | null;
players: Record<PlayerId, { total: number; roundBulls: number; takenCount: number; picked: boolean; flipLeft: boolean; left: boolean; away: boolean }>;
queue: Play[]; // 공개된 이번 차례 카드(놓기 기다리는 것)
pending: Pending | null;
draft: { pool: Card[]; at: PlayerId; picked?: Record<PlayerId, Card[]> } | null; // picked는 cardTracker일 때만
seen?: Card[]; // cardTracker일 때만
roundScores: Record<PlayerId, number[]>;
lastRound: { round: number; gained: Record<PlayerId, number> } | null; // 라운드 결과 창
log: LogEntry[];
deadlineAt: number | null;
my?: {
hand: { n: Card; bulls: number; preview: { row: number; side: 'L' | 'R'; takes: number } | { low: true } }[];
selected: { card: Card; flip: boolean } | null;
taken: Card[];
};
}
```
- 모두(관전자 포함): 줄, 팬 카드 위치, 총점·이번 라운드 소머리, 누가 골랐는지(무엇인지는 아님), 공개된 카드와 놓이는 과정, 고르는 중인 사람, 라운드별 점수.
- 본인만: 손패, 지금 고른 카드, `preview`(지금 줄 모양 그대로 이 카드만 놓으면 어디에 가고 몇 소머리를 가져가는지. 다른 사람 카드에 따라 달라지므로 화면은 "지금 기준"이라고 적음).
- `pro` 고르기: 펼친 카드와 고를 사람은 모두 공개(원작도 앞면). 누가 무엇을 골라 갔는지는 실제로도 보이는 정보라서 `cardTracker = true`면 `draft.picked`와 게임 중 "그 사람이 아직 안 낸 카드"를 보여 준다. 끄면 보내지 않는다(사람도 컴퓨터도 같은 화면만 봄).
- 절대 보내지 않는 것: 남의 손패(`pro`의 공개 정보는 위 예외), 공개 전 고른 카드, `aside`(`all`에서 이번 라운드에 안 쓰는 카드), RNG 상태.
- 테스트용 `secretsOf(state, p)`: `six-hand:<남>:<카드들>`, `six-sel:<남>:<카드>`(공개 전), `six-aside:<카드들>`. `pro`에서는 누가 무엇을 골라 갔는지가 원래 공개 정보(고르기 기록·이벤트에 나옴)라서 손패를 넣지 않는다. `cardTracker = false`는 "표로 정리해 주지 않는다"는 뜻일 뿐 비밀은 아니다.
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
- `setup`: 첫 라운드 시작 자리.
- 라운드마다(`all`·`tactics`): 카드 섞기(Fisher–Yates) → 10장씩 나누기 → 줄 시작 4장.
- `pro`는 섞지 않는다(펼친 카드를 고름). 남은 4장은 작은 수부터 1~4번 줄.
- 그 밖에는 난수가 없다. 놓기·가져가기·팬 카드 이동은 모두 규칙으로 정해진다.
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- 마감: `select`가 열릴 때(모두 같은 마감), `choose`·`draft` 차례가 바뀔 때 `turnSeconds`. 새 라운드 첫 차례는 라운드 결과 창을 보는 5초를 더한다. 무제한이면 `null`(연결 끊김 처리만).
- `timeoutPlayers`: `select`면 아직 안 고른 사람들, `choose`·`draft`면 그 한 사람.
- `onTimeout` → `{ type: 'TIMEOUT' }`. `apply`가 상태만 보고 정한다(결정적, 본인 손패와 공개 정보만 씀).
- 고르기: 손패 카드마다 "지금 줄에 이 카드만 놓으면 가져갈 소머리"(`preview`, 규칙 4면 가장 적은 줄의 소머리)를 계산한다. 가장 적은 카드 → 같으면 끝 카드와의 차이가 가장 작은 카드 → 같으면 작은 숫자. 숫자 뒤집기는 쓰지 않는다.
- 줄 고르기(규칙 4): 소머리가 가장 적은 줄 → 같으면 끝 카드가 가장 큰 줄(§5.3 `fewest`와 같음).
- 자리 고르기(`both`): 그 자리의 줄이 5장 미만인 쪽 → 둘 다면 가져갈 소머리가 적은 쪽 → 오른쪽.
- 카드 뽑아 가기(`pro`): 남은 카드 중 소머리가 가장 적은 것 → 같으면 가장 작은 숫자.
- 연속 3번 시간 초과면 "자리 비움" 표시, 그 사람 마감 5초. 나간 사람은 1.2초 만에 자동 행동(고르기는 `select`가 열릴 때 바로).
- 남은 사람이 1명이면 바로 끝난다(`reason: 'resign'`).
### 8.6 종료 조건과 결과(GameResult)
- §6 조건이 되면 `finished`.
- `ranking`: 총점 오름차순, 같으면 같은 묶음, 나간 사람은 맨 뒤 묶음.
- `scores`: 총점(벌점). `scoreText`: "벌점 23점".
- `summary` 예: "민수 님 승리! 벌점 23점 · 지호 님이 66점을 넘겨 5라운드에서 끝", "3라운드 끝 · 지호 님과 민수 님 공동 1등(벌점 18점)".
- 결과 화면에 라운드별 점수표(`roundScores`)와 그 판에서 가장 많이 가져간 한 번("한 번에 소머리 17개!")을 보여 준다.
### 8.7 컴퓨터 상대 (`six-nimmt/bot.ts`, `BotStrategy`)
- 입력은 `view`와 `legal`만(09 §9). 상태를 보지 않는다.
- 모르는 카드 `U` = 1..`deckMax`에서 내 손패, 줄, `seen`, 내 소 더미를 뺀 것. `cardTracker = false`면 `seen`이 없어서 줄과 공개 카드만 빼므로 자연히 조금 약해진다. `pro`이고 표가 있으면 상대가 가진 카드를 정확히 안다.
- 고르기: 내 카드(뒤집기 포함 후보)마다 `K`번 흉내 낸다. 상대마다 `U`(또는 알려진 손패)에서 무작위로 1장씩 뽑아 한 차례를 규칙대로 끝까지 놓아 본다(규칙 4는 상대도 소머리가 가장 적은 줄을 고른다고 가정). 점수 = 내가 가져가는 소머리 평균 + 작은 위험 항(내 카드가 줄의 5번째가 되어 다음 차례에 남이 가져갈 확률은 덤, 내가 6번째 바로 앞에 남기는 경우는 감점).
- 줄 고르기: 가져갈 소머리가 가장 적은 줄. 높은 단계는 아직 놓이지 않은 `queue` 카드까지 보고, 내가 새로 시작한 줄 때문에 남이 여섯 번째를 채우게 되는지 따져 동점일 때 고른다.
- 뽑아 가기(`pro`): 소머리 적은 카드 + 숫자 사이가 고르게 퍼지게(같은 구간 몰림 피하기) 점수를 매긴다.
- 단계(1~60, 09 §9.1)
- 흉내 횟수 `K`: 1단계 4번 → 60단계 48번(단계에 비례).
- 실수: `humanBest`(`bots/policy.ts`)를 그대로 쓴다. 이 게임 기준 `small` = 소머리 0.5개, `critical` = 없음(꼭 둬야 할 수 개념이 약함).
- 1~20단계는 위험 항을 쓰지 않는다(눈앞만 봄). 41단계 이상은 `queue`를 보는 줄 고르기와 숫자 뒤집기 시점 계산(가장 큰 위험을 피할 때 쓰기)을 한다.
- 속도: 카드 10장 × `K` 48 × 한 차례 흉내(카드 10장 놓기) = 수천 번 비교라 수 ms 안. 생각 시간은 06 §12대로 사람처럼 1~3초.
- 테스트(`bots/bots.test.ts`): 2·5·10명, 옵션 조합(기본, `pro`, `both`, 팬 카드 4종)마다 컴퓨터끼리 끝까지 두어 모든 수가 합법이고 멈추지 않는지. 60단계 대 1단계 5인 판 100판 평균 벌점이 뚜렷하게 낮은지.
## 9. UI/UX
- PC: 가운데 큰 판에 줄 4개를 가로로(줄마다 5칸 + 흐릿한 빨간 "6번째" 칸). 줄 왼쪽에 줄 번호와 소머리 합(🐮 7), 팬 카드는 줄 왼쪽(짝홀·산 오르기)이나 줄 끝(소)에 그린다. 판 위쪽에 자리 순서대로 사람 칸(이름, 총점, 이번 라운드 소머리, 고름 표시 = 뒷면 카드 아이콘, 차례 고리). 오른쪽 패널은 점수표(라운드별)와 기록. 판 아래에 내 손패 10장(작은 수부터).
- 카드 그림: 직접 그린 단순한 카드. 가운데 큰 숫자, 위쪽에 소머리 아이콘 개수. 소머리 수에 따라 바탕색(1 흰, 2 하늘, 3 노랑, 5 주황, 7 빨강)을 달리해서 위험한 카드가 바로 보이게 한다(원작 그림·색은 쓰지 않음).
- 고르기: 손패 카드를 누르면 위로 올라오고 "이 카드 내기" 버튼이 뜬다. 두 번 누르거나 버튼으로 낸다. 낸 뒤에도 모두 내기 전에는 다른 카드를 눌러 바꿀 수 있다("바꾸기"). 카드 위 작은 표시는 `preview`: "2번 줄 4번째", "⚠ 줄 가져감 🐮6", "⬇ 너무 작음". 표시 줄에 "지금 줄 기준이에요. 다른 사람 카드에 따라 달라져요" 한 줄.
- 숫자 뒤집기: 손패 옆 토글 [🔄 뒤집기]. 켜면 카드 숫자가 뒤집힌 모양으로 미리 보인다(13 ↔ 31).
- 공개 움직임(모두 같은 연출, 이벤트 순서대로 한 박자 늦게 다시 그림, `magical-athlete`의 `replay.ts` 방식)
1. 모든 사람 칸의 뒷면 카드가 동시에 뒤집힌다(0.4초, "착" 소리).
2. 카드들이 판 위 "공개 줄"로 날아가 작은 수부터 줄을 선다(0.4초).
3. 한 장씩(0.45초 간격) 자기 줄로 날아가 붙는다. 붙을 줄이 잠깐 빛난다. 6번째면 줄이 빨갛게 흔들리고 앞 다섯 장이 그 사람 칸으로 쓸려 가며 "음매" 소리와 "+🐮 6" 배너. 규칙 4면 "○○ 님이 가져갈 줄을 고르는 중…" 배너.
4. 밀린 업데이트가 많으면(4개 이상) 빨리 감고, 새로 들어오거나 다시 접속한 화면은 연출 없이 지금 모습만.
- 줄 고르기(내가 규칙 4): 판 위에 큰 안내 "너무 작은 카드예요! 가져갈 줄을 고르세요". 줄마다 [이 줄 가져가기 · 🐮 3] 버튼, 소머리가 가장 적은 줄에 "추천" 표시. 남은 시간 고리.
- 자리 고르기(`both`의 같은 차이): 두 자리에 반짝이는 빈 칸이 생기고 누른다.
- 팬 카드 이동: 짝홀 카드가 미끄러져 옮겨 가며 면이 뒤집힘, 산 오르기 화살표 회전, 소는 줄 사이를 폴짝 뛰어감(소 점프 연쇄면 한 번씩).
- 라운드 끝: 결과 창(5초, 닫기 가능) — 이번 라운드 소머리, 총점 막대, 끝 점수 선(66) 표시. 다음 라운드 카드가 나눠지는 움직임.
- 나온 카드 표(`cardTracker`): 오른쪽 패널 탭 [나온 카드]에 1~`deckMax` 작은 격자. 나온 카드는 흐리게, 내 손패는 테두리, `all`이면 "이번 라운드에 안 쓰는 카드가 섞여 있어요" 안내.
- 휴대폰(가로 320px 기준, 세로 화면)
- 맨 위: 사람 칸을 가로 띠로(아바타 28px, 총점, 고름 ✔). 10명이면 가로로 밀어서 봄.
- 가운데: 줄 4개. 줄마다 6칸이 한 줄에 들어가야 하므로 카드 42×58px(간격 3px, 왼쪽 줄 표시 22px: 22 + 6×42 + 5×3 + 여백 8 ≈ 297px). 카드는 숫자를 크게, 소머리는 "🐮5"처럼 숫자로 줄여 쓴다. 팬 카드는 줄 표시 칸 안의 작은 아이콘.
- 아래: 내 손패 10장을 두 줄 5장씩(카드 56×78px), 아래에 큰 [내기] 버튼(44px 높이). 고른 카드는 위로 떠 있음.
- 공개 줄은 판 위에 겹쳐 나타났다 사라진다(자리 차지 안 함). 점수표·기록은 아래 시트로 접힘.
- 초보 도움말: 첫 판에 세 줄 안내 "① 동시에 1장 내기 ② 작은 수부터, 가장 가까운 줄 끝에 ③ 6번째 카드면 앞의 5장을 가져가요(소머리 = 벌점)". 규칙 보기에 함정 예(45는 41이 아니라 42 다음)를 그림으로.
- 소리: 합성음만(사이트 음량). 카드 내기 "톡", 공개 "착", 놓기 "탁", 가져가기 "음매"(소머리 많을수록 낮고 길게), 내 차례가 열릴 때 짧은 알림.
## 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칸 이하), 직렬화 왕복·결정성.
## 11. 참고 자료
- AMIGO 30주년판 영문 규칙서(2024, 기본 규칙·프로 변형·팬 카드 4종·협력 변형 "버펄로를 이겨라"): https://blog.amigo-spiele.de/content/ap/rule/02401-GB-AmigoRule.pdf
- 코리아보드게임즈 상품 페이지 "젝스님트"(2~10명, 만 8세+, 20분, 수상 목록, 규칙 그림): https://www.koreaboardgames.com/product/detail?prdCd=PD2024002261FGQV
- 상세 이미지: https://cdnfile.koreaboardgames.com/_data/attach/202303/28/9b3eb83aee36f2f50089b2cef644d8b7.jpg
- 나무위키 "젝스님트"(규칙, 소머리 수, 66점 종료, `인원×10+4` 변형, 방과 후 주사위 클럽·퍼펙트 지니어스): https://namu.wiki/w/젝스님트
- 위키백과 "6 nimmt!"(1994년, 수상, Taktik·Logik·Profi 변형, Junior·11 nimmt!): https://en.wikipedia.org/wiki/6_nimmt!
- BGA 게임 도움말(66점에서 깎아 내려가는 표시, Tactics·Logic·Professional, Professional 동점 자리 선택): https://en.doc.boardgamearena.com/Gamehelpsechsnimmt
- UltraBoardGames 변형 모음(Tactics, Logic, Tournament, Professional, Open, Nifty, Hand, Double): https://ultraboardgames.com/6-nimmt/variants.php
- RulesPal 25주년판 규칙 요약(행동 카드 7종, 12장 + 특수 3장, 2라운드): https://rulespal.com/6-nimmt-25-jahre/rulebook
- RulesPal 6 nimmt! Junior 규칙: https://rulespal.com/6-nimmt-junior/rulebook
- BoardGameGeek "6 nimmt!"(id 432, 평균 6.99, 3만 3천 명 평가, 전체 675위·가족 199위, 무게 1.19/5, 추천 3~10명·최적 5~6명): https://boardgamegeek.com/boardgame/432/6-nimmt
- 보드라이프 "젝스님트"(283위, 7.5점, 690명): https://boardlife.co.kr/game/3237
## 12. 메모 (상표·법적 주의 등)
- "6 nimmt!"는 AMIGO의 상표이고 "젝스님트"는 코리아보드게임즈의 한국 상품명이다. 친구끼리 쓰는 사이트라 원래 이름을 그대로 쓴다(사용자 결정). 공개 서비스로 바꾸면 "여섯 번째 소", "소머리 줄 게임" 같은 이름으로 바꾼다.
- 규칙 자체는 저작권 보호 대상이 아니지만 카드 그림(소 얼굴), 색 배치, 규칙서 문장, 팬 카드 이름 그림은 쓰지 않는다. 카드·소머리 아이콘은 직접 만들고 규칙 설명은 이 문서의 우리말로 새로 쓴다.
- 팬 카드 4종의 아이디어 제공자(Guillaume Lefebvre, Daniela Bustos, Frank Heeren, Martin Profanter)를 규칙 보기 맨 아래 작은 글씨로 적는다(원작 규칙서도 이름을 밝힘).
- 벌점·점수는 방 안에서만 쓰고 돈·포인트와 연결하지 않는다.

464
docs/games/tichu.md Normal file
View File

@@ -0,0 +1,464 @@
# 티츄 (`tichu`)
> 마일스톤: 2026-10 새 게임 · 인원: 기본 4명(2:2 팀전). 변형 모드로 3명·6명 · 예상 시간: 1,000점 약 45~60분, 500점 약 25~30분 · 난이도: 보통
## 1. 개요
- 마주 앉은 두 사람이 한 팀이 되는 카드 게임이다. 앞사람보다 센 같은 모양의 카드를 내면서 손패를 먼저 털고, 판에서 따 온 점수 카드(5·10·K·용)로 팀 점수를 모은다. 달무티·대부호와 같은 "버리기(클라이밍)" 계열에 팀플레이, 내기(티츄 선언), 폭탄, 특수 카드 4장이 더해졌다.
- 원작은 스위스 Fata Morgana의 Urs Hostettler가 1991년에 냈다. 중국 민속 카드 놀이(대로이·쟁분)를 바탕으로 만들었다. 영어판은 Rio Grande Games, 한국판은 코리아보드게임즈(현재 "티츄: 블랙", 16,000원)가 낸다.
- 평가: BGG 평균 약 7.6점(약 1만 7천 명), 전체 약 250위권, 무게 2.3/5. 보드라이프 7.8점(680명, 87위). 1992년 Fairplay "À la carte" 카드 게임상 3위. 보드게임아레나에서 2021년부터 약 32만 판이 플레이됐다. 한국 보드게임 동호회와 카페에서 "4명 모이면 티츄"라고 할 만큼 오래 사랑받고 대회도 열린다.
- 인원 근거: 원작 기본은 4명 전용(Tichu Nanking)이다. 같은 룰북에 3인 변형(Threechu, 더미와 한 팀)과 6인 변형(Tichu Tientsin, 3:3)이 실려 있다. 팬들은 대부분 4인만 권한다. 그래서 4인 팀전이 기본이고, 3인·6인은 방 설정의 변형 모드로 둔다. 사람이 3명이면 4인 팀전에 컴퓨터 1명을 넣는 것도 권한다. 5~12인 "Grand Seigneur"는 신분 게임이라 달무티와 겹쳐서 지원하지 않는다.
## 2. 모드와 옵션
공식 규칙(4인 팀전, 1,000점)이 기본값이다. "구분" 칸은 **공식**(원작 룰북), **공식 변형**(원작 룰북에 실린 변형), **변형**(다른 사이트·대회·사이트 자체)이다.
| 옵션 키 | 설명 | 선택지 | 기본값 | 구분 |
|---|---|---|---|---|
| `mode` | 게임 방식 | `team`(4인 2:2 팀전) / `individual`(4인 개인전: 매 라운드 짝꿍이 바뀌고 점수는 각자) / `threechu`(3인: 딜러가 공개된 더미와 한 팀) / `tientsin`(6인 3:3 팀전) | `team` | 공식 / 변형(티츄비·BGA 포럼) / 공식 변형 / 공식 변형 |
| `targetScore` | 목표 점수(이 점수 이상이면 게임 끝). `threechu`에서는 쓰지 않음 | 300 / 500 / 1000 / 1500 | 1000 | 공식(1000) |
| `threechuHands` | `threechu` 판 수(3의 배수, 모두 딜러를 같은 횟수만큼) | 3 / 6 / 9 / 12 | 6 | 공식 변형 |
| `grandTichu` | 그랜드 티츄(첫 8장 보고 ±200) 사용 | 켜기 / 끄기 | 켜기 | 공식 |
| `direction` | 차례 방향 | `right`(오른쪽 = 반시계, 원작) / `left`(왼쪽 = 시계) | `right` | 공식 / 공식 허용(Rio Grande FAQ) |
| `bombTiming` | 폭탄 내는 때 | `anytime`(차례가 아니어도 끼어들기) / `ownTurn`(자기 차례에만) | `anytime` | 공식 / 변형(간단 규칙) |
| `bombWindowSeconds` | 트릭이 끝나기 직전 폭탄을 낼 수 있게 기다리는 시간(§8.5) | 1 / 2 / 3 | 2 | 사이트 |
| `wishRule` | 참새 소원을 어겼을 때 | `enforce`(어기는 수는 화면이 막음) / `penalty`(막지 않고, 어기면 상대 팀 원투로 처리. 한국 대회식) | `enforce` | 공식 의무 / 변형(한국 대회) |
| `trickHistory` | 지난 카드 보기 | `last`(직전 트릭만 다시 보기) / `all`(이번 라운드에 나온 카드 전부 보기, 초보 도움) | `last` | 사이트 |
| `party` | 파티 모드: 라운드마다 효과 하나를 뽑음(§7). `team`·`individual`에서만 | 켜기 / 끄기 | 끄기 | 변형(티츄비 파티전 아이디어, 효과는 이 사이트가 정의) |
| `turnSeconds` | 한 턴 제한 시간 | 20 / 30 / 45 / 60 / 무제한(`null`) | 30 | 사이트 |
| `exchangeSeconds` | 카드 교환 제한 시간 | 30 / 45 / 60 / 무제한(`null`) | 45 | 사이트 |
- 인원(`playersFor`): `team`·`individual` 4명, `threechu` 3명, `tientsin` 6명. 컴퓨터로 빈자리를 채울 수 있다.
- 구현 순서 제안: 1단계 = `team` + `targetScore`·`grandTichu`·`direction`·`bombTiming`·`bombWindowSeconds`·`trickHistory`·시간 옵션, `wishRule=enforce`. 2단계 = `individual`, `threechu`, `tientsin`, `wishRule=penalty`, `party`. 2단계 옵션은 구현 전까지 스키마에 넣지 않는다.
## 3. 구성물
- 56장.
- 숫자 카드 52장: 4가지 무늬 × 13가지 숫자. 무늬는 **옥**(초록), **칼**(검정), **탑**(파랑), **별**(빨강)이다. 숫자는 약한 순서로 2, 3, 4, 5, 6, 7, 8, 9, 10, J, Q, K, A. 무늬끼리는 세기 차이가 없다(무늬는 스트레이트 플러시 폭탄에만 쓰인다).
- 특수 카드 4장: **참새**(1), **개**, **봉황**, **용**. 무늬가 없다.
- 카드 점수(라운드 끝에 따 온 카드로 계산)
| 카드 | 점수 |
|---|---|
| 5 (4장) | 각 5점 |
| 10 (4장) | 각 10점 |
| K (4장) | 각 10점 |
| 용 | +25점 |
| 봉황 | −25점 |
| 나머지 | 0점 |
- 한 라운드 카드 점수 합은 언제나 100점이다(5×4 + 10×4 + 10×4 + 25 − 25).
- 엔진 카드 ID: 숫자 카드 `<무늬><숫자>`(무늬 `j`옥·`s`칼·`p`탑·`t`별, 숫자 2~14, J=11, Q=12, K=13, A=14). 예: `j2`, `t10`, `s14`. 특수 카드 `MJ`(참새), `DOG`(개), `PH`(봉황), `DR`(용).
## 4. 준비(셋업)
기본(`team`) 기준. 다른 모드의 차이는 §5.9.
1. **자리와 팀**: 방장 자리부터 시계 방향으로 0, 1, 2, 3번 자리다. 0·2번이 한 팀(A팀), 1·3번이 한 팀(B팀)이다. 짝꿍은 맞은편에 앉는다. 방장이 시작 전에 자리를 바꿔 팀을 정한다.
2. **차례 순서**: `direction = right`(원작)이면 내 오른쪽 사람이 다음 차례다(반시계). `left`면 왼쪽(시계). 엔진은 자리 번호를 이 방향으로 늘어놓은 배열 하나(`order`)로 차례를 돈다. 어느 방향이든 팀 사람이 번갈아 나온다(A, B, A, B).
3. **첫 8장**: 덱을 섞어 모두에게 8장씩 준다. 이때 그랜드 티츄를 정한다(§5.6). 원작은 한 장씩 가져가지만 화면에서는 8장을 한꺼번에 준다.
4. **나머지 6장**: 모두 정하면 남은 24장을 6장씩 더 준다. 각자 14장.
5. **카드 교환**: 모두 동시에, 왼쪽 상대·짝꿍·오른쪽 상대에게 1장씩 총 3장을 뒷면으로 건넨다. 같은 사람에게 2장을 줄 수 없다. 모두 고르면 한꺼번에 옮겨지고, 받은 3장이 손에 들어온다(§5.7).
6. **첫 트릭**은 참새를 가진 사람이 시작한다. 참새를 꼭 낼 필요는 없다.
7. 다음 라운드는 덱을 다시 섞어 3번부터 반복한다. 첫 트릭은 언제나 참새를 가진 사람이 연다.
## 5. 진행 규칙
### 5.1 낼 수 있는 조합
"숫자"는 2~A(2~14)다. 참새는 1로 친다. 봉황은 §5.4대로 빈 숫자를 채울 수 있다.
| 조합 | 뜻 | 예 | 세기 비교 |
|---|---|---|---|
| 싱글 | 카드 1장 | `7` | 숫자가 높을수록 셈 |
| 페어 | 같은 숫자 2장 | `8 8` | 숫자 |
| 연속 페어 | 숫자가 이어지는 페어 2쌍 이상 | `5 5 6 6`, `J J Q Q K K` | 가장 높은 페어의 숫자. **페어 수가 같아야** 비교 가능 |
| 트리플 | 같은 숫자 3장 | `2 2 2` | 숫자 |
| 풀하우스 | 트리플 + 페어(다른 숫자) | `5 5 5 9 9` | **트리플의 숫자만** 본다. `6 6 6 2 2`는 `5 5 5 A A`를 이긴다 |
| 스트레이트 | 숫자가 이어지는 5장 이상(무늬 상관없음) | `4 5 6 7 8 9` | 가장 높은 숫자. **장수가 같아야** 비교 가능 |
| 폭탄(포카드) | 같은 숫자 4장 | `9 9 9 9` | §5.5 |
| 폭탄(스트레이트 플러시) | 같은 무늬로 이어지는 5장 이상 | 칼 `3 4 5 6 7` | §5.5 |
- 같은 숫자 4장을 페어 2개나 트리플로 나눠 내도 된다(폭탄을 깨는 것은 자유).
- 스트레이트: 참새(1)를 넣을 수 있다. 예: `참새 2 3 4 5`. A 다음은 없다(`Q K A 2 3`은 안 됨). 가장 긴 스트레이트는 `참새~A` 14장이다. 개와 용은 넣을 수 없다.
- 연속 페어·풀하우스·페어·트리플에는 참새·개·용을 넣을 수 없다.
- 같은 무늬 5장 이상이 이어지면 그 묶음은 **항상 폭탄**이다. 일반 스트레이트로 낼 수 없다(원작 FAQ). 반대로 무늬가 하나라도 섞이면 일반 스트레이트다. 예: 칼 `3 4 5 6 7` + 별 `8` = 6장 일반 스트레이트.
- 위 표에 없는 모양(예: 페어 두 개가 떨어져 있는 `5 5 8 8`, 4장짜리 스트레이트)은 낼 수 없다.
### 5.2 트릭 진행
- **선(리드)**: 트릭을 시작하는 사람은 아무 조합이나 낸다. 폭탄으로 시작해도 된다. 개는 선일 때만 낼 수 있다(§5.3).
- **따라 내기**: 다음 차례부터 순서대로, 바닥 맨 위 조합과 **같은 종류·같은 장수**이면서 **더 센** 조합을 내거나 패스한다. 폭탄은 예외로 무엇이든 이긴다(§5.5).
- 예: 바닥이 `8 8`이면 `9 9`~`A A` 페어만 낼 수 있다. `7 7 7`이나 `9 9 10 10`은 안 된다.
- 예: 바닥이 6장 스트레이트 `3~8`이면 `4~9` 같은 6장 스트레이트만 된다. 5장·7장은 안 된다.
- **패스**: 낼 수 있어도 언제든 패스할 수 있다. 패스해도 같은 트릭에서 차례가 다시 오면 낼 수 있다. 선은 패스할 수 없다.
- **트릭 끝**: 맨 위 조합을 낸 사람을 뺀, 아직 카드가 있는 나머지 모두가 이어서 패스하면 트릭이 끝난다. 화면은 `bombWindowSeconds`(기본 2초) 동안 "카드 모으는 중"을 보여 주고, 이 사이에도 폭탄을 낼 수 있다(§5.5, §8.5). 그 뒤 맨 위 조합을 낸 사람이 바닥 카드를 모두 가져가고(용이면 §5.3) 새 트릭을 시작한다.
- 가져간 사람이 이미 손패를 다 털었으면, 차례 순서상 그다음 사람 중 카드가 남은 사람이 새 트릭을 시작한다.
- 손패를 다 턴 사람은 그 라운드에서 빠진다(차례에서 건너뛴다). 나간 순서를 기록한다.
### 5.3 특수 카드
**참새 (1)**
- 가진 사람이 그 라운드 첫 트릭을 시작한다. 처음에 참새를 내지 않아도 된다.
- 숫자 1로 친다. 싱글로 내면 가장 약한 카드다. 1~5 이상 스트레이트에 넣을 수 있다. 페어 등 다른 조합에는 못 넣는다.
- **소원**: 참새를 낼 때(싱글이든 스트레이트 안이든) 숫자 하나(2~A)를 "소원"으로 부를 수 있다. 안 불러도 된다. 특수 카드는 부를 수 없다.
- 소원이 걸려 있는 동안, **자기 차례**가 된 사람이 그 숫자의 진짜 카드를 갖고 있고, 그 카드를 넣어서 규칙에 맞게 낼 수 있는 조합이 하나라도 있으면 **반드시 그 카드를 넣은 조합을 내야 한다.** 패스할 수 없고, 그 숫자가 없는 다른 조합도 낼 수 없다.
- 봉황을 써서라도, 폭탄으로라도 낼 수 있으면 내야 한다. 예: 소원 8, 바닥 `7 7`, 내 손에 `8` 1장과 봉황 → `8 봉황`(8 페어)을 내야 한다.
- 예: 소원 8, 바닥이 용, 내 손에 `8 8 8 8` → 8 폭탄을 내야 한다.
- 선이면, 그 숫자를 넣은 아무 조합이나 내야 한다(그 숫자 싱글은 언제나 낼 수 있으니 선은 반드시 지킨다). 개로 시작할 수 없다.
- 그 숫자 카드가 없으면(봉황만 있어도) 의무가 없다. 봉황은 그 숫자로 쓰여도 소원을 채우지 않는다.
- 그 숫자는 있지만 넣어서 이길 수 있는 조합이 없으면 아무 수나 내거나 패스한다.
- 차례가 아닐 때 끼어드는 폭탄(§5.5)은 소원을 지키지 않아도 된다.
- 누군가 그 숫자의 진짜 카드를 어떤 조합으로든(끼어든 폭탄 포함) 내면 소원이 풀린다. 그 전까지는 트릭이 바뀌어도 라운드가 끝날 때까지 계속된다.
- `wishRule = penalty`일 때는 §7 참고.
- 점수는 0점.
**개**
- 선일 때 싱글로만 낼 수 있다. 다른 조합에 못 넣는다. 따라 내기로는 못 낸다.
- 내면 트릭이 바로 끝나고, **선이 짝꿍에게 넘어간다.** 짝꿍이 이미 나갔으면 차례 순서상 짝꿍 다음 사람 중 카드가 남은 사람에게 간다.
- 개는 아무도 이길 수 없고 폭탄으로도 막을 수 없다. 개 카드는 낸 사람이 딴 카드로 친다(0점).
**봉황**
- 조커처럼 2~A 중 아무 숫자 1장을 대신해 조합을 완성한다. 예: `9 봉황` = 9 페어, `5 6 봉황 8 9` = 5~9 스트레이트, `J J Q Q 봉황 K` = 연속 페어 J~K.
- 폭탄에는 쓸 수 없다. `9 9 9 봉황`은 폭탄이 아니고, 낼 수 있는 조합도 아니다.
- `3 3 3 3 봉황`은 풀하우스가 아니다(원작 FAQ).
- 참새·개·용과 페어를 만들 수 없다. 참새(1) 자리를 대신할 수 없다.
- 봉황이 여러 숫자로 해석될 수 있으면 엔진이 **가장 센 해석**을 고른다. 예: `7 7 9 9 봉황` → `9 9 9 7 7` 풀하우스(9). `3 4 5 6 봉황` → `3~7` 스트레이트(7). `10 J Q K 봉황` → `10~A`(A).
- **싱글 봉황**: 바로 앞 싱글보다 0.5 높다. 바닥이 8이면 8.5가 되어 9 이상이 이긴다. A 위에 내면 A.5(14.5)가 되어 용과 폭탄만 이긴다.
- 선으로 내면 1.5다(2가 이긴다). 참새(1) 위에 내도 1.5다.
- **용 위에는 낼 수 없다.**
- 점수 −25점.
**용**
- 가장 센 싱글이다. A와 A.5(봉황)도 이긴다. 폭탄만 용을 이긴다. 싱글로만 낼 수 있다(스트레이트 등에 못 넣는다).
- 용이 맨 위인 채로 트릭이 끝나면(용으로 트릭을 이기면), 그 트릭 전체(용 25점 포함)를 **상대 팀 중 한 명**에게 줘야 한다. 누구에게 줄지는 용을 낸 사람이 고른다. 이미 나간 상대에게 줘도 된다. 그 뒤 새 트릭은 용을 낸 사람이 시작한다(나갔으면 §5.2대로 다음 사람).
- 용이 폭탄에 지면 트릭은 폭탄 낸 사람이 가져간다(줄 필요 없음).
- 점수 +25점.
### 5.4 세기 숫자 정리(엔진용)
- 싱글 값: 참새 1, 숫자 2~14, 봉황 = 바로 앞 싱글 값 + 0.5(선이면 1.5), 용 = 100(봉황이 넘을 수 없음).
- 페어·트리플·연속 페어·스트레이트·풀하우스 값: 위 §5.1 "세기 비교" 숫자. 봉황은 대신한 숫자로 센다(스트레이트에서 0.5를 더하지 않는다).
- 따라 내기는 "같은 종류 + 같은 장수 + 값이 더 큼"일 때만 된다. 값이 같으면 못 낸다.
### 5.5 폭탄
- 폭탄 = 같은 숫자 진짜 카드 4장(포카드) 또는 같은 무늬로 이어지는 진짜 카드 5장 이상(스트레이트 플러시). 참새는 무늬가 없어서 스트레이트 플러시에 못 들어간다. 봉황은 폭탄에 못 쓴다.
- 폭탄끼리는 **장수가 많은 쪽**이 이기고, 장수가 같으면 **숫자가 높은 쪽**이 이긴다(스트레이트 플러시는 가장 높은 숫자). 그래서 스트레이트 플러시(5장 이상)는 어떤 포카드보다 세다.
- 예: `8 8 8 8` < `A A A A` < 옥 `9~K` 5장 < 칼 `2~7` 6장.
- 폭탄은 아무 조합(싱글 용 포함) 위에 낼 수 있고, 더 센 폭탄만 이긴다.
- **언제 낼 수 있나**(`bombTiming = anytime`, 원작)
- 바닥에 조합이 하나라도 있으면, 카드가 남은 사람은 **자기 차례가 아니어도** 언제든 폭탄을 낼 수 있다. 내 조합(내가 맨 위)에 내도 된다.
- 모두 패스해서 트릭이 끝나기 직전(카드 모으는 중)에도 낼 수 있다.
- 빈 바닥(새 트릭을 아직 아무도 안 냈을 때)에 끼어들 수는 없다. 선이 자기 차례에 폭탄으로 시작하는 것은 된다.
- 개를 막을 수 없다. 트릭을 모아 간 뒤나 용 주기를 고르는 중에는 낼 수 없다.
- 끼어든 폭탄은 소원 의무가 없다. 자기 차례에 낸 폭탄은 일반 수와 같아서 소원 의무가 있다.
- 폭탄을 내면 그 폭탄이 맨 위가 되고, 패스 기록이 지워지고, **폭탄 낸 사람의 다음 사람**(카드가 남은)이 차례다.
- `bombTiming = ownTurn`이면 폭탄도 자기 차례에만 낼 수 있다(선으로 시작, 따라 내기 모두). 카드 모으는 시간은 없다.
### 5.6 티츄 선언
- 티츄는 "이번 라운드에 내가 **1등으로** 손패를 다 턴다"는 내기다. 짝꿍이 1등을 해도 선언한 본인이 1등이 아니면 실패다. 성공·실패 점수는 카드 점수와 따로 팀 점수에 더한다.
| 선언 | 언제 | 성공(본인 1등) | 실패 |
|---|---|---|---|
| 그랜드 티츄 | 첫 8장만 보고, 나머지 6장을 받기 전 | +200 | −200 |
| 스몰 티츄 | 14장을 받은 뒤, 자기 첫 카드를 내기 전 | +100 | −100 |
- 그랜드 티츄(`grandTichu = on`): 첫 8장을 받으면 모두 동시에 [그랜드 티츄!] 또는 [안 함]을 고른다. 누가 선언하면 바로 모두에게 보인다. 아직 고르지 않은 사람은 그것을 보고 정할 수 있다(원작도 차례로 정하며 앞사람 선언을 본다). 모두 고르면 나머지 6장을 준다.
- 스몰 티츄: 14장을 받은 뒤 교환 중이든 게임 중이든, 자기가 아직 카드를 한 장도 안 냈으면 [티츄!]를 누를 수 있다. 차례와 상관없다.
- 이미 그랜드 티츄를 한 사람은 스몰 티츄를 또 할 수 없다.
- 누군가 이미 손패를 다 털었으면 선언할 수 없다(1등이 이미 정해짐).
- 개를 내도 "카드를 낸 것"이다. 교환으로 카드를 건넨 것은 낸 것이 아니다.
- 한 팀 두 사람이 모두 선언해도 된다. 상대 팀과 같이 선언해도 된다.
- 교환 중에 누가 스몰 티츄를 선언하면, 아직 모두 확정되기 전이므로 다른 사람들은 건넬 카드를 바꿀 수 있다(교환은 모두 고를 때까지 다시 고를 수 있다, §5.7).
- 짝꿍끼리 채팅으로 패를 알려 주면 안 된다는 안내를 규칙 화면에 넣는다(막지는 않음).
### 5.7 카드 교환
- 14장을 받은 뒤 모두 동시에 왼쪽 상대·짝꿍·오른쪽 상대에게 1장씩 고른다. 어떤 카드든(특수 카드 포함) 줄 수 있다.
- 고른 뒤 [보내기]를 눌러도, 모두가 보내기 전에는 다시 고를 수 있다. 마지막 사람이 보내는 순간 한꺼번에 옮겨진다.
- 받은 카드는 누가 줬는지와 함께 받은 사람에게만 보인다. 남들은 "모두 교환 완료"만 본다.
### 5.8 라운드 끝
- **원투(더블 빅토리)**: 같은 팀 두 사람이 1등·2등으로 나가면 라운드가 **바로** 끝난다. 그 팀이 200점, 상대는 카드 점수 0점. 카드 점수는 세지 않는다. 티츄 선언 점수는 따로 계산한다.
- 그 밖에는 **3명이 나가서 1명만 카드가 남으면** 라운드가 바로 끝난다. 마지막에 바닥에 있던 트릭은 맨 위 조합을 낸 사람(방금 나간 3등)이 가져간다. 맨 위가 용이면 용 주기(§5.3)를 먼저 한다. 카드 모으는 시간(폭탄 기회)은 없다.
- 끝까지 남은 사람(꼴찌)은
- 손에 남은 카드를 **상대 팀**에게 준다(상대 팀 카드 점수에 더함).
- 자기가 딴 카드를 모두 **1등**에게 준다.
### 5.9 다른 모드(변형)
**개인전 `individual`** (티츄비 개인전, BGA 포럼 "Round Robin")
- 4인, 규칙은 팀전과 같다. 라운드마다 짝꿍이 바뀐다. 자리 0·1·2·3번 사람을 기준으로 1라운드 (0,2)/(1,3), 2라운드 (0,1)/(2,3), 3라운드 (0,3)/(1,2), 4라운드부터 다시 반복한다. 팀이 바뀌면 화면 자리도 짝꿍이 맞은편이 되게 다시 앉힌다.
- 라운드 팀 점수(카드 + 티츄)를 두 사람이 **각자 똑같이** 개인 점수로 받는다.
- 누군가 `targetScore` 이상이면 그 라운드 뒤 끝나고, 개인 점수 순으로 순위를 매긴다. 1위가 동점이면 한 라운드 더 한다.
- 주의(BGA 포럼 지적): 목표에 가까운 사람의 짝꿍이 일부러 못할 수 있다. 친구끼리 하는 재미용 모드라고 안내한다.
**3인 `threechu`** (원작 룰북 Threechu)
- 사람 3명 + 더미(빈 자리) 1개. 라운드마다 딜러 1명이 맞은편 더미와 한 팀이 되어 두 손패를 모두 친다. 다른 두 사람이 상대 팀이다. 딜러는 첫 라운드 무작위, 다음 라운드부터 차례 방향으로 한 사람씩 넘어간다.
- 딜러는 자기와 더미 모두 그랜드 티츄를 할 수 없다. 딜러는 처음부터 더미 손패를 볼 수 있다.
- 교환은 상대에게만 한다. 각 손패(딜러·더미·상대 둘)가 자기 상대 두 손패에게 1장씩, 2장을 준다. 더미 몫은 딜러가 고른다. 딜러와 더미끼리는 주고받지 않는다.
- 교환이 끝나면 더미 손패는 모두에게 공개된다. 딜러가 더미 차례에 더미 카드를 대신 낸다(끼어드는 폭탄 포함). 딜러는 더미가 첫 카드를 내기 전에 더미 이름으로 스몰 티츄를 선언할 수 있다.
- 더미는 소원을 지키지 않아도 된다.
- 점수는 각자 따로 쌓는다. 딜러와 상대 두 사람은 각자 자기 팀이 4인전에서 받았을 점수를 그대로 받는다(더미는 점수가 없다).
- `threechuHands` 판(3의 배수)을 하고 끝난다(원작: 1,000점 방식은 더미 쪽이 유리해서 권하지 않음). 1위 동점은 공동 1위.
**6인 `tientsin`** (원작 룰북 Tichu Tientsin)
- 3:3 팀전. 자리 0·2·4번이 A팀, 1·3·5번이 B팀(번갈아 앉음). 덱은 56장 1벌이다. 차례 순서로 라운드 시작 사람부터 나눠 앞의 2명이 10장, 나머지 4명이 9장을 받는다(원작 룰북에 장수가 없어 공개된 플레이 후기 기준으로 정함, §12).
- 그랜드 티츄는 첫 6장을 보고(7번째 카드를 받기 전) 정한다.
- 교환은 짝꿍 둘에게만 1장씩, 2장을 주고 짝꿍 둘에게서 1장씩 받는다.
- 개는 짝꿍 둘 중 원하는 사람에게 선을 넘긴다. 둘 다 나갔으면 차례 순서상 첫 번째 짝꿍 다음 사람 중 카드가 남은 사람에게 간다. 용 트릭은 상대 셋 중 한 명에게 준다.
- 원투 보너스가 없다. 대신 **트리플 빅토리**(한 팀 세 명이 상대보다 먼저 모두 나감)면 바로 끝나고 300점, 카드 점수는 세지 않는다.
- 그 밖에는 1명만 남으면 끝난다. 꼴찌(6등)는 남은 손패와 딴 카드를 **모두 상대 팀**에 준다. 5등은 딴 카드를 1등에게 준다.
- 라운드 시작 사람: 첫 라운드는 무작위, 다음부터는 앞 라운드 1등. 첫 트릭은 4인전과 같이 참새 가진 사람이 연다.
## 6. 승패와 점수 계산
- 라운드 팀 점수 = (원투면 200, 트리플 빅토리면 300, 아니면 그 팀이 딴 카드 점수) + 팀원들의 티츄 성공·실패 점수.
- 카드 점수는 §5.8의 꼴찌 넘기기를 한 뒤 센다. 두 팀 카드 점수 합은 늘 100점이다. 한 팀이 음수일 수도 있다(봉황을 따고 다른 점수 카드가 없으면 −25).
- 예 1: A팀 지수가 스몰 티츄, 지수 1등, B팀 민호 2등, A팀 서연 3등, B팀 하늘 꼴찌. 하늘이 남은 손패(K, 5 = 15점)는 A팀에, 하늘이 딴 카드(10점)는 지수(1등)에게 간다. A팀 카드 점수 합 70, B팀 30 → A팀 70 + 100 = 170점, B팀 30점.
- 예 2: B팀 민호가 그랜드 티츄, A팀 지수·서연이 1·2등(원투) → A팀 200점, B팀 0 − 200 = −200점.
- 예 3: A팀 지수가 스몰 티츄, 짝꿍 서연이 1등 → 지수 실패로 A팀 −100(서연이 1등이어도).
- **게임 끝**(`team`·`tientsin`): 라운드가 끝났을 때 한 팀이라도 `targetScore` 이상이면 끝난다. 둘 다 넘으면 점수가 높은 팀이 이긴다. **같으면 한 라운드 더 한다**(Rio Grande 룰북: 동점이 아닐 때까지 계속).
- `individual`: 개인 점수로 같은 방식(1위 동점이면 한 라운드 더). `threechu`: 정해진 판 수 뒤 개인 점수 순(동점은 공동 순위).
- 점수는 방 안 결과 표시용이다. 칩이나 돈이 아니다.
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
- **목표 점수 바꾸기**(`targetScore`): 500점이면 약 절반 시간. 티츄비·tichu.one 등 온라인 사이트도 목표 점수를 바꿀 수 있다.
- **그랜드 티츄 끄기**(`grandTichu`): 처음 배우는 방에서 큰 내기를 뺀다. 끄면 14장을 한 번에 준다.
- **시계 방향으로 하기**(`direction = left`): Rio Grande FAQ가 허용한다. 교환의 "왼쪽/오른쪽 상대" 이름도 같이 바뀐다.
- **폭탄은 자기 차례에만**(`bombTiming = ownTurn`): 끼어들기 눈치 싸움을 없앤 간단 규칙. 온라인 구현 중 끼어들기를 뺀 사례가 있다(공식 아님).
- **소원 위반 패널티**(`wishRule = penalty`, 한국 대회식, 나무위키): 화면이 소원 의무를 막지 않고 표시도 하지 않는다(소원 숫자만 보여 줌). 지켜야 할 사람이 안 지키면(소원 숫자를 넣어 낼 수 있었는데 다른 수를 내거나 패스) 그 즉시 라운드가 끝나고 **상대 팀이 원투한 것으로 처리**한다: 상대 팀 200점, 위반 팀 카드 점수 0점. 2022년 이후 대회 규칙처럼 상대 팀의 티츄 선언은 성공으로, 위반 팀의 선언은 실패로 계산한다. 위반 판정은 엔진이 자동으로 한다. 컴퓨터는 이 모드에서도 소원을 지킨다.
- **지난 카드 모두 보기**(`trickHistory = all`): 이번 라운드에 나온 카드를 무늬·숫자 표로 보여 주고, 팀별 딴 점수도 실시간으로 보여 준다. 카드 세기를 못 하는 초보 도움. 기본 `last`는 직전 트릭 하나만 다시 볼 수 있다.
- **파티 모드**(`party`, 티츄비 "파티전"에서 아이디어를 얻고 효과는 이 사이트가 정의): 라운드 시작(첫 8장 전)에 아래 효과 중 하나를 시드 RNG로 뽑아 모두에게 크게 보여 준다. 같은 효과가 두 라운드 연속 나오지 않는다.
- **두 배 판**: 이번 라운드 팀 점수(카드·원투·티츄 모두)를 2배로 한다.
- **점수 뒤집기**: 카드 점수 부호가 바뀐다(5 → −5, 10·K → −10, 용 −25, 봉황 +25). 원투 200과 티츄 점수는 그대로. 점수 카드를 피해야 하는 판이 된다.
- **손패 돌리기**: 교환이 끝난 직후 모든 손패가 차례 방향으로 다음 사람에게 통째로 넘어간다. 그랜드·스몰 티츄 선언은 사람에게 남는다(새 손패로 1등을 해야 함). 스몰 티츄는 돌린 뒤에도 첫 카드를 내기 전까지 할 수 있다.
- **평범한 판**: 효과 없음(긴장 풀기).
- 지원하지 않는 변형(문서화만)
- Grand Seigneur(5~12인 신분 게임): 달무티와 겹친다.
- 티츄비 파티전의 다른 효과(MADDOG, KOREAN, PASS MAGIC 등): 공개된 설명으로는 규칙을 확정할 수 없다.
- 2벌(112장) 6인전: 같은 특수 카드 2장의 처리가 원작에 없다.
## 8. 엔진 설계
### 8.1 상태(State)
```ts
type Seat = number; // 손패 자리 번호. team/individual 0~3, threechu 0~3(더미 포함), tientsin 0~5
type Rank = number; // 1(참새)~14(A)
type ComboType = 'single' | 'pair' | 'pairSeq' | 'triple' | 'fullHouse' | 'straight' | 'bomb4' | 'bombSF' | 'dog';
interface Combo {
type: ComboType;
length: number; // 카드 장수
value: number; // §5.4 세기 값(봉황 싱글은 x.5, 용 100)
phoenixAs: Rank | null; // 봉황이 대신한 숫자(싱글이면 null)
}
interface Play { seat: Seat; cards: string[]; combo: Combo; outOfTurn: boolean }
type Phase =
| { kind: 'grand'; decided: boolean[] } // 첫 8장, 그랜드 티츄 고르기
| { kind: 'exchange'; give: ({ to: Seat; card: string }[] | null)[] } // 자리별 보낼 카드(보내기 전 null)
| { kind: 'playing' }
| { kind: 'dragonGift'; by: Seat } // 용 트릭 줄 상대 고르기
| { kind: 'roundEnd'; ready: boolean[] } // 점수 보여 주기
| { kind: 'finished' };
interface TichuState {
options: TichuOptions;
players: PlayerId[]; // 참가자(불변)
round: number;
/** 자리 정보. order는 차례 방향대로 늘어놓은 자리 번호 */
seats: { owner: PlayerId; dummy: boolean }[]; // threechu 더미의 owner = 이번 딜러
order: Seat[];
team: number[]; // 자리별 팀(0/1). individual은 라운드마다 다시 정함
dealer: Seat | null; // threechu 딜러, tientsin 라운드 시작 사람
effect: 'double' | 'negative' | 'rotate' | 'plain' | null; // party
hands: string[][]; // 자리별 손패(비공개)
pending: string[][]; // grand 단계: 아직 안 준 6장(비공개)
received: { from: Seat; card: string }[][]; // 교환으로 받은 카드(받은 사람만 열람)
calls: ('none' | 'tichu' | 'grand')[];
played: boolean[]; // 자리별: 이번 라운드에 카드를 낸 적 있음(스몰 티츄 가능 여부)
wish: Rank | null; // 걸려 있는 소원
trick: {
leader: Seat;
plays: Play[]; // 이번 트릭(공개). 맨 위 = 마지막
passed: Seat[]; // 맨 위 이후 패스한 자리
closingAt: number | null; // 모두 패스해 "카드 모으는 중"인 마감 시각
waived: Seat[]; // 모으는 중 "폭탄 없음"을 누른 자리
};
lastTrick: { winner: Seat; cards: string[]; plays: Play[] } | null; // 직전 트릭 다시 보기
playedCards: string[]; // 이번 라운드에 나온 카드(trickHistory=all에서만 view에 넣음)
won: string[][]; // 자리별 딴 카드
out: Seat[]; // 나간 순서
current: Seat; // 지금 일반 차례
scores: number[]; // team/tientsin: 팀 0·1, individual/threechu: 참가자 순서
rounds: RoundResult[];
turnStartedAt: number;
turnNo: number;
seq: number;
timeoutsInRow: Record<PlayerId, number>;
away: Record<PlayerId, boolean>;
log: LogEntry[]; // 공개 기록(낸 조합, 패스, 선언, 폭탄, 용 주기, 소원, 나감)
final: TichuFinal | null;
}
interface RoundResult {
round: number;
out: Seat[];
teams: PlayerId[][];
cardPoints: number[]; // 팀별(원투·트리플 빅토리면 0)
bonus: number[]; // 원투 200 / 트리플 300
callPoints: number[]; // 팀별 티츄 합
effect: TichuState['effect'];
penalty: { seat: Seat } | null; // wishRule=penalty 위반
total: number[]; // 팀별 이번 라운드 점수
}
```
- 판정 함수(서버·화면 공용, `packages/games/src/tichu/combo.ts`): `classify(cards, prevTop) → Combo | null`(봉황은 가장 센 해석, 단 prevTop을 이기는 해석이 있으면 그중 가장 센 것), `beats(combo, top)`, `isBomb(combo)`, `mustFulfillWish(hand, top, wish, leading)`, `cardPoints(cards, effect)`. 화면은 고른 카드의 조합 이름과 낼 수 있는지 미리 보여 줄 때 같은 함수를 쓴다.
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `grand` | `{ call: boolean }` | 모두, phase=`grand`, 아직 안 고름 | `call=true`는 `grandTichu=on`이고, threechu 딜러가 아님 |
| `tichu` | `{ seat?: Seat }` | 언제든(grand 뒤 ~ playing) | 그 자리가 아직 카드를 안 냄, calls=`none`, 아무도 안 나감. `seat`는 threechu 딜러가 더미 몫을 선언할 때만 |
| `exchange` | `{ seat?: Seat; give: { to: Seat; cardId: string }[] }` | 모두, phase=`exchange` | 받을 자리 목록이 `exchangeTargets(seat)`와 정확히 같고(중복 없음), 카드가 그 손에 있고 서로 다름. 모두 보내기 전에는 다시 보낼 수 있음(덮어씀) |
| `play` | `{ cardIds: string[]; seat?: Seat; wish?: Rank \| null; dogTo?: Seat }` | 일반 차례 또는 끼어드는 폭탄 | 아래 |
| `pass` | `{ seat?: Seat }` | 일반 차례, 선이 아님 | 소원 의무(`enforce`)가 있으면 거부 |
| `noBomb` | `{}` | phase=`playing`이고 `closingAt`이 있음, 카드가 남은 사람 | 한 번만. 모두 누르면 바로 트릭을 모음 |
| `dragonTo` | `{ to: Seat }` | 용 낸 자리의 주인, phase=`dragonGift` | `to`가 상대 팀 자리 |
| `ready` | `{}` | 참가자, phase=`roundEnd` | 한 번만 |
| `closeTrick` / `timeout` / `leave` | — | 시스템 전용(스키마에 없음) | `closeTrick`은 `now ≥ closingAt` |
`play` 검증 순서
1. 행동하는 사람이 그 자리의 주인이다(threechu 더미 자리는 딜러). 카드가 모두 그 손에 있고 중복이 없다. phase=`playing`.
2. `classify`가 조합을 돌려준다(아니면 "낼 수 없는 모양이에요").
3. **일반 차례**(`seat == current`이고 `closingAt == null`)
- 선(`plays` 비어 있음): 아무 조합. 개는 선일 때만.
- 따라 내기: `beats(combo, top)`.
- 소원 의무(`wishRule=enforce`, 더미 제외): `mustFulfillWish`가 참이면 고른 카드에 소원 숫자의 진짜 카드가 있어야 한다("소원 8을 넣어서 내야 해요").
4. **끼어드는 폭탄**(3번의 일반 차례가 아닐 때): `bombTiming=anytime`, combo가 폭탄, `plays`가 비어 있지 않음, 맨 위를 이김, 그 자리에 카드가 있음. `closingAt`이 있는 동안은 맨 위 조합을 낸 사람도 포함해 누구나 된다.
5. 참새가 들어 있으면 `wish`는 2~14 또는 null(생략 = null). 참새가 없는데 `wish`를 보내면 거부.
6. 개는 `dogTo`가 tientsin에서만 필요(짝꿍 중 카드가 남은 사람). 다른 모드는 자동.
`apply` 요점
- `play`: 손에서 빼고 `plays`에 넣고 `passed=[]`, `closingAt=null`, `waived=[]`. 소원 숫자의 진짜 카드가 있으면 `wish=null`. 참새가 있으면 `wish = payload.wish`. `played[seat]=true`. 손패 0장이면 `out`에 넣는다.
- 라운드 끝 판정(§5.8, §5.9): 원투/트리플 빅토리 또는 1명만 남음 → 맨 위가 용이면 `dragonGift`, 아니면 트릭을 맨 위 자리에 주고 점수 계산 → `roundEnd`.
- 개: 트릭을 바로 끝내고(개 카드는 낸 사람의 `won`), 선 = 짝꿍(§5.3).
- 그 밖: `current` = 낸 자리 다음, 카드가 남은 자리. 끼어든 폭탄이면 폭탄 낸 자리 다음.
- `pass`: `passed`에 넣는다. 맨 위 자리를 뺀 카드가 남은 모두가 `passed`에 있으면 `closingAt = now + bombWindowSeconds`(`ownTurn`이면 바로 모음). 아니면 다음 자리.
- `closeTrick`(또는 모두 `noBomb`): 맨 위가 용 싱글이면 `dragonGift`. 아니면 맨 위 자리가 카드를 모두 `won`에 넣고 `lastTrick` 저장, 새 트릭 선 = 그 자리(나갔으면 다음 카드 남은 자리).
- `dragonTo`: 트릭을 고른 상대의 `won`에 넣는다. 라운드 끝이 걸려 있으면 점수 계산, 아니면 용 낸 자리가 선.
- `pass`·`play`가 `wishRule=penalty`에서 의무를 어기면 즉시 `penalty`로 라운드를 끝낸다(§7).
- 거부 문구 예: "앞 조합과 같은 모양·같은 장수로 내야 해요", "더 센 조합만 낼 수 있어요", "폭탄은 바닥에 카드가 있을 때만 끼어들 수 있어요", "봉황은 용 위에 낼 수 없어요", "새 트릭을 시작할 때는 패스할 수 없어요", "이미 카드를 내서 티츄를 부를 수 없어요".
### 8.3 공개/비공개 정보 (view)
- 모두(관전자 포함): 자리·팀·손패 장수, 티츄 선언, 나간 순서, 현재 트릭의 모든 조합(누가, 어떤 카드, 조합 이름), 패스 표시, 지금 차례, 소원 숫자, "카드 모으는 중" 남은 시간, 직전 트릭(`lastTrick`), 팀 점수와 라운드 기록, 파티 효과.
- `grand` 단계: 본인 8장만. 남은 6장(`pending`)은 아무에게도 안 보낸다. 다른 사람은 "골랐음/안 골랐음"과 그랜드 선언만 본다.
- `exchange` 단계: 본인 손패와 본인이 고른 카드. 남은 "보냄/안 보냄"만. 끝난 뒤 받은 카드는 받은 사람에게만(누가 줬는지 포함). 다른 사람에게는 무엇을 줬는지 보내지 않는다.
- threechu: 더미 손패는 딜러에게 처음부터, 교환이 끝나면 모두에게 공개.
- `trickHistory=all`이면 `playedCards`와 팀별 딴 카드 점수도 넣는다. `last`면 넣지 않는다(직전 트릭만).
- 본인 view의 `my`: `hand`(정렬), `canPlay`, `canPass`, `leading`, `mustWish`(enforce에서 의무가 있으면 그 숫자, penalty에서는 늘 null), `canTichu`, `canGrand`, `bombs`(내 손의 폭탄 묶음 목록), `canBombNow`, `suggestions`(한 번 탭으로 낼 수 있는 대표 조합 최대 8개), `exchangeTargets`(자리와 "왼쪽 상대/짝꿍/오른쪽 상대" 이름), `dragonTargets`.
- `activePlayers`: 일반 차례 사람. `closingAt` 동안은 **카드가 남은 모든 사람**(누가 폭탄을 가졌는지 드러나지 않게). `grand`·`exchange`·`roundEnd`는 아직 안 한 사람 전부. `dragonGift`는 용 낸 사람.
- 절대 보내지 않는 것: 남의 손패, `pending`, 남의 교환 카드, 덱 순서, RNG 상태. 테스트용 `secretsOf(state, player)`는 남의 손패·pending·남이 주고받은 교환 카드 ID를 돌려준다(threechu 더미 손패는 교환 뒤 비밀이 아님).
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
- 매 라운드 덱 섞기(첫 8장과 나머지 6장은 한 번 섞은 덱에서 차례로 나눔).
- threechu 첫 딜러, tientsin 첫 라운드 시작 사람.
- party 효과 뽑기.
- 그 밖에는 결정적(봉황 해석, 자동 행동, 용 자동 주기).
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- **끼어드는 폭탄 처리(턴제 서버에서)**
- "언제나 행동 가능" 방식이다. `play`(폭탄)는 차례와 상관없이 오고, `validate`가 §8.2-4 조건으로 판단한다. 먼저 도착한 것부터 처리한다(GameRunner가 한 번에 하나씩).
- 반응 속도 싸움을 줄이려고 두 가지를 둔다. (1) 모두 패스해도 바로 모으지 않고 `bombWindowSeconds`(기본 2초) 동안 "카드 모으는 중"으로 기다린다. 폭탄이 없는 판에서도 똑같이 기다려서 폭탄 유무가 드러나지 않는다(모으는 연출 시간과 겹침). 남은 사람이 모두 [폭탄 없음]을 누르면 바로 모은다. (2) 컴퓨터와 자동 행동은 차례가 시작되고 최소 1.2초 뒤에 낸다(사람이 폭탄을 끼울 틈).
- 원작 FAQ "폭탄은 일반 수보다 먼저, 여러 폭탄은 차례 순서로"는 서버 도착 순서로 대신한다. 같은 묶음 안에서 늦게 온 폭탄은 새 맨 위를 이겨야 통과한다.
- 마감(`deadline`)
- `grand` 15초, `exchange` `exchangeSeconds`, 일반 차례 `turnSeconds`, `dragonGift` 15초, `roundEnd` 10초, 카드 모으는 중 `bombWindowSeconds`.
- 시간 옵션이 무제한(`null`)이면 grand·exchange·차례·dragonGift 마감이 없다(카드 모으는 시간은 그대로). 기다리는 사람이 모두 자리 비움이면 5초.
- `onTimeout`(모두 합법 수만 돌려준다)
- `grand`: `{ call: false }`. 자동으로 선언하지 않는다.
- `exchange`: 상대 둘에게는 손에서 가장 약한 숫자 카드 2장(점수 카드 5·10·K, 페어·폭탄에 들어 있는 카드, 특수 카드는 되도록 피함), 짝꿍에게는 가장 센 숫자 카드 1장. 정렬은 숫자 → 카드 ID 순(결정적).
- 일반 차례, 선: 소원 의무가 있으면 그 숫자를 넣은 가장 약한 조합. 아니면 가장 약한 싱글(개만 남았으면 개). 참새를 내면 소원 없음.
- 일반 차례, 따라 내기: 소원 의무가 있으면 가장 약한 의무 조합, 없으면 `pass`.
- 카드 모으는 중: 시스템이 `closeTrick`.
- `dragonGift`: 상대 중 손패가 많은 사람(같으면 차례 순서상 먼저). 이미 나간 상대보다 카드가 남은 상대를 고른다.
- `roundEnd`: `ready`.
- 티츄 선언과 폭탄은 절대 자동으로 하지 않는다(소원 의무로 폭탄밖에 없을 때만 예외).
- 연결이 끊겨도 탈락시키지 않고 위 자동 행동으로 진행한다. 연속 3번 시간 초과면 그 사람의 마감을 5초로 줄인다(자리 비움). 다시 행동하면 원래대로.
- `onLeave`: 나간 사람 자리는 컴퓨터가 이어받게 방에 알린다(방 공통 규칙). 컴퓨터가 없으면 자동 행동.
### 8.6 종료 조건과 결과(GameResult)
- `team`·`tientsin`·`individual`: 라운드 끝(`roundEnd` 처리)에 §6의 목표 점수 조건. threechu: `threechuHands` 판이 끝나면.
```ts
interface TichuFinal {
ranking: PlayerId[][]; // team: [[이긴 팀 두 명], [진 팀 두 명]]. individual/threechu: 개인 순위(동점 공유)
scores: Record<PlayerId, number>; // team: 팀 점수를 두 사람에게 같게
scoreText: Record<PlayerId, string>; // "1,020점"
summary: string; // "지수·서연 팀이 1,020 대 760으로 이겼어요! (원투 2번)"
reason: 'normal' | 'abandoned';
}
```
### 8.7 컴퓨터 상대 (`tichu/bot.ts`, view + legal만 사용)
- 손패 나누기: 손패를 조합으로 나누는 가장 좋은 방법(조합 수가 가장 적고, 약한 낱장이 적게)을 숫자별 개수로 DP를 돌려 구한다. "선을 잡을 카드"(용, A, 봉황, 폭탄, 높은 페어)와 "버려야 할 카드"를 센다.
- 그랜드 티츄: 8장 점수(용 3, 봉황 3, A 2, 폭탄 4, K 1 …)가 기준 이상이면 선언. 스몰 티츄: 교환 뒤 "선 잡을 카드 수 ≥ 버릴 조합 수 − 1"이면 선언. 점수 차가 크게 지고 있으면 기준을 낮춘다. 짝꿍이 이미 선언했으면 하지 않는다.
- 교환: 짝꿍이 선언했으면 가장 센 카드(용·봉황·A)를 짝꿍에게. 아니면 짝꿍에게 A나 높은 카드, 상대에게 조합을 깨지 않는 가장 약한 낱장(개는 상대에게, 점수 카드는 상대에게 주지 않음).
- 선: 가장 약한 조합부터, 같은 약함이면 장수가 많은 조합(스트레이트·연속 페어)부터. 짝꿍이 티츄를 불렀고 짝꿍 손패가 적으면 개로 선을 넘긴다.
- 따라 내기: 짝꿍이 맨 위면 대개 패스. 상대가 맨 위면 조합을 깨지 않고 이기는 가장 약한 수. 상대 티츄 선언자가 곧 나갈 것 같으면(손패 1~3장) 폭탄과 센 카드를 아끼지 않는다. 폭탄은 자기 차례와 "카드 모으는 중"에만 고려한다(그 밖의 끼어들기는 하지 않음).
- 참새 소원: 내 손에 없는 숫자 중 상대가 가졌을 법한 높은 숫자(보통 A, K). 짝꿍이 티츄를 불렀으면 소원을 걸지 않는다(짝꿍 폭탄을 깰 수 있어서, 원작 팁).
- 용 주기: 손패가 많은 상대, 티츄를 부르지 않은 상대 쪽.
- 난이도(1~60): 단계가 높을수록 위 판단을 그대로 따르고, 낮을수록 `humanBest`처럼 차선책을 섞는다(1단계 약 45%만 최선, 60단계 약 97%). 낮은 단계는 티츄 기준이 들쭉날쭉하고(가끔 무리한 선언), 짝꿍 트릭을 덮는 실수를 한다. 카드 세기는 view에 보이는 것만 쓴다(`trickHistory=last`면 직전 트릭까지).
- `legalActions`(테스트·봇용): 조합 종류·장수·값·봉황 사용 여부·소원 숫자 포함 여부가 같은 수는 대표 하나만 낸다(무늬는 카드 ID가 가장 앞선 것, 우연히 같은 무늬가 되어 폭탄이 되면 다른 무늬로 바꾼 대표도 넣음). 폭탄은 모두, `pass`·`noBomb`·`tichu`도 넣는다.
## 9. UI/UX
- **PC(가로)**: 가운데 판 + 오른쪽 패널.
- 판: 나는 아래, 짝꿍은 위, 상대는 좌우. `direction=right`면 다음 차례가 오른쪽 사람이다(화살표로 표시). 각 자리에 이름, 손패 장수(뒷면 부채), 팀 색 띠, 티츄/그랜드 배지(T, GT), 패스 말풍선, 나간 순서 메달(1·2·3).
- 가운데: 맨 위 조합을 크게, 이번 트릭의 앞 조합은 작게 겹쳐서. 조합 이름 "스트레이트 6장 (3~8)"과 "누가 냈는지". 소원이 있으면 "소원: 8" 큰 배지가 바닥 옆에 계속 떠 있다. 카드 모으는 중에는 바닥 테두리에 2초 원형 바늘과 "폭탄?" 표시.
- 오른쪽 패널: 팀 점수판(목표 점수 막대), 라운드 기록, [직전 트릭 보기], (`all`이면) 나온 카드 표, 기록 로그, 채팅.
- **휴대폰 세로(320px 기준)**
- 위: 상대·짝꿍 세 자리를 한 줄 칩으로(이름 6자 줄임, 장수, T/GT, 패스, 차례 빛). 점수는 "A 620 : 480 B" 한 줄, 누르면 점수판 시트.
- 가운데: 바닥 맨 위 조합(카드 높이 약 64px, 6장 넘으면 겹침), 조합 이름, 소원 배지.
- 아래: 내 손패 14장을 7장씩 두 줄(카드 폭 약 42px, 겹침 없이 탭 영역 44px 이상). 고른 카드는 위로 올라온다. [숫자순/조합순] 정렬 토글.
- 버튼 줄: [내기] [패스] [티츄!](가능할 때만) [폭탄](폭탄이 있으면 항상 보이고, 지금 낼 수 있을 때만 켜짐). 한 손 조작을 위해 화면 아래쪽에 둔다.
- **조작**
- 카드를 탭해 고르면, 위에 "풀하우스 (9) · 낼 수 있어요" 또는 "앞 조합(페어)과 모양이 달라요"가 바로 나온다(공용 `classify`).
- [추천] 칩: `my.suggestions`를 "9 페어", "5~9 스트레이트"처럼 보여 주고 한 번 탭으로 고른다.
- 낼 수 있는 카드는 밝게, 못 쓰는 카드는 흐리게. 소원 의무가 있으면 그 숫자 카드에 테두리와 "소원 카드를 꼭 넣어야 해요" 안내(`penalty` 모드에서는 안내 없음).
- 참새가 든 조합을 [내기]하면 소원 고르기 시트: 2~A 13개 버튼 + [소원 없음].
- [폭탄]을 누르면 내 폭탄 목록이 뜨고 하나를 탭하면 바로 낸다(차례가 아닐 때도).
- 용 주기: 상대 둘(또는 셋) 큰 버튼, 각자 손패 장수 표시.
- 그랜드 단계: 8장과 [그랜드 티츄! (+200 / −200)] [안 함] 두 큰 버튼. 남이 선언하면 그 자리에 GT 배지가 튀어나온다.
- 교환: 위에 칸 3개(왼쪽 상대·짝꿍·오른쪽 상대). 카드를 탭하고 칸을 탭(또는 끌어 놓기). [보내기] 뒤에도 모두 끝나기 전에는 [다시 고르기]. 끝나면 받은 3장을 보낸 사람 이름표와 함께 1초 보여 주고 손패에 넣는다.
- **소리·움직임**(달무티와 같은 방식, 합성음만): 카드 내기 "착", 패스 두드림, 폭탄 = 화면 살짝 흔들림 + 쿵, 티츄 선언 배너 + 징, 그랜드 티츄는 더 큰 배너, 원투 = "원투!" 배너와 팡파르, 트릭 모으기 = 카드가 이긴 자리로 쓸려 감, 용 주기 = 카드 더미가 받는 상대에게 날아감. 처음 들어올 때·새로고침·다시 보기 건너뛰기에는 나지 않는다.
- **라운드 끝 화면**: 나간 순서, 팀별 카드 점수(꼴찌 넘기기 화살표 포함), 원투, 티츄 성공/실패, 이번 라운드 합과 누적. [다음 라운드](모두 누르거나 10초).
- **초보 도움말**: "규칙 보기"에 조합 표(그림 예시), 특수 카드 4장 카드 설명, 점수 카드 표. 첫 판에는 "같은 모양·같은 장수로 더 세게!", "폭탄은 언제든 끼어들 수 있어요" 팁을 위에 고정(끌 수 있음). 특수 카드를 길게 누르면 설명 말풍선.
## 10. 테스트 체크리스트
- [ ] 덱 56장, 카드 점수 합 100. 섞은 뒤 8장 → 6장, 각자 14장. 같은 시드면 같은 배분.
- [ ] 조합 판정: `5 5 6 6` 연속 페어, `5 5 7 7` 거부, `참새 2 3 4 5` 스트레이트, `Q K A 2 3` 거부, 4장 스트레이트 거부, `6 6 6 2 2` > `5 5 5 A A`, `3 3 3 3 봉황` 거부, `9 9 9 봉황` 거부.
- [ ] 봉황 해석: `7 7 9 9 봉황` = 풀하우스 9, `3 4 5 6 봉황` = 3~7, `10 J Q K 봉황` = 10~A, 바닥 `4~8` 위에 `5 6 7 8 봉황`은 5~9로 통과.
- [ ] 싱글 봉황: 8 위 8.5(9가 이김, 8은 못 이김), 선 1.5(2가 이김), 참새 위 1.5, A 위 14.5(용이 이김), 용 위 거부.
- [ ] 장수 비교: 6장 스트레이트 위에 5장·7장 거부, 2쌍 연속 페어 위에 3쌍 거부.
- [ ] 폭탄 순서: 8888 < AAAA < 5장 SF(9~K) < 6장 SF(2~7). 칼 3~7은 항상 폭탄(일반 스트레이트로 바닥 5장 스트레이트를 "따라 내기"로 처리하지 않음). 칼 3~7 + 별 8은 일반 6장 스트레이트.
- [ ] 끼어드는 폭탄: 차례가 아닌 사람이 바닥 위에 폭탄 → 통과, 다음 차례 = 폭탄 낸 사람 다음. 빈 바닥에 끼어들기 거부. 개 직후 거부. 내 조합 위에 내 폭탄 허용. 카드 모으는 중 폭탄 허용, 모은 뒤 거부. `ownTurn`이면 차례 밖 폭탄 거부.
- [ ] 소원: 참새 싱글 + 소원 8 → 다음 사람이 8을 갖고 바닥 1보다 세면 8 싱글만 허용(9·패스 거부). 8이 없고 봉황만 있으면 의무 없음. 바닥 `7 7`, 손 `8 봉황` → `8 봉황`만 허용. 바닥 용, 손 `8 8 8 8` → 폭탄만 허용. 선이 8을 가지면 8 포함 조합만 허용(개 거부). 끼어드는 폭탄은 의무 없음. 스트레이트 안의 참새도 소원을 건다. 8이 끼어든 폭탄으로 나와도 소원이 풀린다. 소원이 트릭을 넘어 유지된다.
- [ ] `penalty`: 의무를 어긴 패스 → 즉시 라운드 끝, 상대 팀 200 + 상대 선언 성공, 위반 팀 선언 실패.
- [ ] 개: 선만 가능, 짝꿍이 선. 짝꿍이 나갔으면 짝꿍 다음 카드 남은 사람. tientsin은 `dogTo` 필수.
- [ ] 용: 트릭을 이기면 `dragonGift`, 상대 팀만 받기 허용(같은 팀 거부), 나간 상대에게도 허용. 폭탄에 지면 폭탄 낸 사람이 가져감. 3등이 용으로 나가 라운드가 끝날 때도 용 주기 후 계산.
- [ ] 트릭 끝: 나간 사람은 패스 판정에서 빠짐. 맨 위 낸 사람이 나갔으면 다음 카드 남은 사람이 선.
- [ ] 티츄: 첫 카드 전 허용, 낸 뒤 거부, 그랜드 한 사람은 스몰 거부, 누가 나간 뒤 거부. 교환 중 선언 뒤 다른 사람이 교환을 다시 보낼 수 있음. 그랜드는 `grandTichu=off`면 거부, threechu 딜러 거부.
- [ ] 교환: 같은 사람에게 2장 거부, 손에 없는 카드 거부, 모두 보내야 옮김, 받은 카드는 받은 사람 view에만.
- [ ] 점수: §6 예 1·2·3 그대로. 원투면 카드 점수 무시. 봉황만 딴 팀 −25. 꼴찌 손패는 상대 팀, 딴 카드는 1등.
- [ ] 게임 끝: 1000 이상 한 팀이면 끝, 둘 다 넘으면 높은 팀, 동점이면 한 라운드 더.
- [ ] individual: 짝꿍 순환 3가지, 팀 점수가 두 사람 개인 점수에 같게. threechu: 2장 교환(딜러↔더미 없음), 교환 뒤 더미 공개, 더미 소원 의무 없음, 딜러 순환, 정해진 판 수 뒤 끝. tientsin: 10·10·9·9·9·9 배분, 6장 뒤 그랜드, 짝꿍 2명과 교환, 트리플 빅토리 300, 5등 딴 카드 → 1등.
- [ ] party: 두 배 판 점수 2배, 점수 뒤집기 합 −100, 손패 돌리기 후 선언은 사람에게 남음, 같은 효과 연속 없음.
- [ ] 정보 유출: 매 단계 남의 손패·pending·남의 교환 카드가 view JSON에 없음(`secretsOf`). 카드 모으는 중 `activePlayers`가 폭탄 유무와 상관없이 같음.
- [ ] 시간 초과: 모든 상태에서 `onTimeout`이 합법 수(소원 의무 포함). 선 시간 초과 = 가장 약한 싱글, 따라 내기 = 패스.
- [ ] 무작위 대국 1,000판: 카드 총수 56 보존(손 + 바닥 + 딴 카드), 라운드 카드 점수 합 100(뒤집기 효과면 −100), 상한 턴 안에 끝남, 직렬화 왕복.
- [ ] 차례가 아닌 일반 `play`, 중복 패킷, 끝난 라운드의 행동은 거부되고 상태가 바뀌지 않음.
## 11. 참고 자료
- Fata Morgana 공식 영어 규칙(1992 번역, 2004 개정, FAQ·Threechu·Tientsin 포함): https://fatamorgana.ch/fatamorgana/tichu/english-rules (PDF: https://fatamorgana.ch/media/pages/fatamorgana/tichu/english-rules/ee9126a1b5-1703236359/tichu_e.pdf)
- Rio Grande Games 룰북(3~10인, 시계 방향 허용, 동점이면 계속, 소원·봉황 FAQ): https://www.riograndegames.com/wp-content/uploads/2013/02/Tichu-Rules.pdf (사본: https://cdn.1j1ju.com/medias/f4/75/98-tichu-rulebook.pdf)
- 나무위키 "티츄"(한국어 용어 참새·개·봉황·용, 스티/라티, 원투, 소원 위반 대회 규칙): https://namu.wiki/w/티츄
- 티츄비(한국 온라인 티츄, 팀전·개인전·파티전, 목표 점수 변경): https://tichu.be/welcome , https://tichu.be/guide/tichu , https://tichu.be/guide/tichu-single , https://tichu.be/guide/tichu-party
- 코리아보드게임즈 "티츄: 블랙"(4명, 8세+, 60분): https://www.koreaboardgames.com/product/detail?prdCd=PD2024002138FLFJ
- Wikipedia "Tichu"(소원 의무 상세, 교환 중 티츄 선언 시 카드 바꾸기, 개 처리): https://en.wikipedia.org/wiki/Tichu
- 보드게임아레나 도움말과 포럼(개인전 순환 변형): https://en.doc.boardgamearena.com/Gamehelptichu , https://forum.boardgamearena.com/viewtopic.php?p=155183
- 6인 배분(9장, 2명 10장) 출처: https://erasmusu.com/en/erasmus-blog/main/amazing-game-tichu-394775
- 보드라이프 티츄: https://boardlife.co.kr/game/478 , BGG: https://boardgamegeek.com/boardgame/215/tichu
## 12. 메모 (상표·법적 주의 등)
- "Tichu"는 Fata Morgana의 상품명이다. 이 사이트는 친구끼리 쓰는 사이트라 원래 이름 "티츄"를 그대로 쓴다(사용자 확인). 공개 서비스로 바꾸면 이름을 다시 검토한다.
- 카드 그림은 직접 만든다. 원작·코리아보드게임즈판 그림(용·봉황 일러스트, 무늬 그림)을 복사하지 않는다. 무늬는 옥·칼·탑·별 이름만 빌리고 모양은 새로 그린다.
- 6인전 손패 장수는 원작 룰북에 없다. 공개된 플레이 후기(9장, 2명 10장)를 따랐고, 규칙 화면에 "원작에 장수가 없어 이 사이트가 정한 방식"이라고 적는다.
- 파티 모드 효과와 `trickHistory`, `bombWindowSeconds`는 이 사이트가 정한 것이다. 규칙 화면에 "공식 아님" 표시를 붙인다.
- 돈, 칩을 쓰지 않는다. 점수는 방 안 결과 표시용이다.