Files
joke-app/docs/games/clue.md
EJClaw 843786f687 움직임 더하기 2차: 루미큐브·마피아·라이어·바둑·클루·오목·포커
- 루미큐브: 옮긴 타일이 원래 자리에서 미끄러져 가고, 남이 바닥에 낸 타일은 그 사람 칸에서 날아옴. 가져온 타일은 남은 타일 더미에서 받침대로 날아오고, 남이 가져가면 뒤집힌 타일이 그 사람 칸으로 날아감. 배너를 공통 useBanner로 바꾸고 "루미큐브!"·"판 끝"·승리 배너 추가
- 마피아: 밤에는 화면이 남색으로 어두워지며 달, 아침에는 해가 떠오름. 득표 막대가 한 줄씩 자라고, 탈락한 사람 칸이 뒤집히며 흐려짐. 탈락·살았다·버텼다·조용한 밤·이긴 팀 배너를 차례로
- 라이어: 득표가 한 줄씩 나온 뒤 지목된 사람에게 스포트라이트와 흔들림, "잡았다!"/"헛다리!"·동점·정답/땡·승리 배너
- 바둑: 패스·계가 배너, 계가 때 집 표시가 차례로 나타나고 결과 점수가 0부터 올라감, 승리 배너
- 클루: 말과 흉기가 새 자리로 튀어 오르며 미끄러져 감, 추리한 세 장이 사건 봉투로 날아가고, 보여 준 카드는 뒤집히며(남에게는 뒷면 카드가 날아감)
- 오목: 금수 자리를 누르면 빨간 ✕와 "금수" 글자, 판이 흔들림(키보드 Enter도 같은 안내). "오목!"·승패 배너
- 포커: 쇼다운·인디언 이마 카드가 뒷면이 돌아간 뒤 앞면이 돌아 나오는 진짜 뒤집기로
- 모두 누구의 행동이든 화면 변화에 반응하고, 클릭을 막지 않으며, 동작 줄이기 설정을 따름. 게임 문서 UI 절에 반영

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 22:36:44 +09:00

168 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 클루 (`clue`)
> 마일스톤: M9 · 인원: 최소 3 ~ 최대 6명 · 예상 시간: 약 30~50분(빠른 이동 20~30분) · 난이도: 보통
## 1. 개요
- 저택에서 일어난 살인 사건의 범인·흉기·장소를 '추리(질문)'와 소거법으로 알아내는 추리 보드게임. 1943년 영국의 앤서니 프랫이 고안, 1949년 워딩턴스 출시(영국 이름 Cluedo, 미국 이름 Clue).
- 인원 근거: 원작 3~6인. **2인은 넣지 않았다.** 노트 파일의 "판에 따라 2~6명"은 일부 판의 이야기인데, 공식 2인 변형 규칙의 출처를 확인하지 못했다. 2명이면 반증하는 사람이 늘 상대 한 명뿐이라 "누가 보여 줬는지"라는 정보가 사라지고 거의 카드 맞히기가 된다. 확인되면 옵션으로 추가한다.
## 2. 모드와 옵션
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `movement` | 이동 방식 | `dice` 주사위 2개로 복도 이동(원작처럼) / `free` 빠르게(아무 방이나 바로) | `dice` |
| `turnSeconds` | 차례 제한 시간(이동·추리·고발) | 30 / 45 / 60 / 90초 / 무제한 | 60 |
카드 보여 주기(반증)는 옵션 없이 20초. `free`는 노트 파일의 "이동을 줄이는 옵션이 있으면 좋다"를 반영한 하우스 룰이다.
## 3. 구성물
- 카드 21장: 용의자 6(스칼렛·머스터드 대령·화이트 부인·그린 목사·피콕 부인·플럼 교수), 흉기 6(촛대·단검·납 파이프·권총·밧줄·스패너), 방 9(부엌·무도회장·온실·식당·당구장·도서실·라운지·홀·서재).
- 용의자 말 6개(색: 빨강·노랑·흰색·초록·파랑·보라), 흉기 6개(지도 위 아이콘), 주사위 2개.
- 그림·지도는 직접 만든 이모지·CSS. 원작 판 그림은 쓰지 않는다(12절).
## 4. 준비(셋업)
1. 첫 사람을 RNG로 뽑고, 그 사람부터 시계 방향으로 스칼렛·머스터드·화이트·그린·피콕·플럼을 맡는다(원작: 스칼렛이 먼저, 원작 판에서의 시계 방향 순서). 사람이 맡지 않은 용의자 말도 지도에 있고, 추리로 불려 다닌다.
2. 종류마다 한 장씩 RNG로 뽑아 **사건 봉투**에 넣는다.
3. 남은 18장을 섞어 모두에게 **같은 장수**를 나눠 준다. 똑같이 나누고 남는 카드는 **모두에게 공개**한다(원작 규칙).
| 인원 | 각자 | 공개 |
|---|---|---|
| 3 | 6 | 0 |
| 4 | 4 | 2 |
| 5 | 3 | 3 |
| 6 | 3 | 0 |
4. 말은 모두 자기 출발점(복도), 흉기 6개는 서로 다른 방 6곳에 RNG로 놓는다.
## 5. 진행 규칙
### 5.1 차례
내 차례 순서: ① 이동 → ② (방에 들어갔으면) 추리 → ③ 반증 → ④ 차례 끝내기. **고발**은 내 차례 동안(카드를 기다리는 중 빼고) 언제든 할 수 있다.
### 5.2 저택(단순화한 지도)
원작은 칸 단위 판이지만 화면에 그대로 옮기면 너무 크다. 그래서 9개 방 + 복도를 **방 사이 거리 표**로 바꿨다.
- 화면 배치(3열 × 4행): 위 `부엌 · 무도회장 · 온실`, 왼쪽 `식당`(2칸 높이), 오른쪽 `당구장 · 도서실`, 아래 `라운지 · 홀 · 서재`, 가운데는 복도와 사건 봉투.
- 복도 거리(칸): 부엌–무도회장 7, 무도회장–온실 4, 온실–당구장 7, 당구장–도서실 4, 도서실–서재 7, 서재–홀 4, 홀–라운지 8, 라운지–식당 4, 식당–부엌 6, 식당–무도회장 7, 무도회장–당구장 6, 식당–홀 6, 홀–도서실 7. 출발점: 스칼렛(라운지 7·홀 7), 머스터드(라운지 6·식당 7), 화이트(부엌 8·무도회장 6), 그린(무도회장 6·온실 8), 피콕(온실 7·당구장 6), 플럼(도서실 6·서재 8). 나머지 거리는 이 길들의 최단 거리(`board.ts`의 `DIST`).
- **비밀 통로**(원작 그대로 2쌍): 부엌↔서재, 온실↔라운지. 모서리 방에서 차례를 시작하면 주사위 없이 건너가 바로 추리한다.
### 5.3 이동 (`dice`)
- 방이나 복도에서 시작: [주사위 굴리기] → 두 눈의 합만큼 걷는다. 합 이하 거리의 방(지금 있는 방 제외)에 **들어간다**(원작처럼 남는 걸음은 버린다).
- 더 먼 방을 고르면 그쪽으로 합만큼 **걸어가 복도에 멈추고** 차례가 끝난다. 다음 차례 거리는 그 자리에서 다시 잰다(지나온 방 쪽으로 되돌아가도 됨). 방 문 앞을 지나쳐도 들어간 것이 아니다.
- 지금 있는 방에 다시 들어갈 수 없다(원작: 같은 차례에 같은 방에 다시 들어갈 수 없음 → 머물러 추리할 수 없음).
- **불려 온 경우**(원작): 다른 사람의 추리로 내 말이 어떤 방으로 옮겨졌다면, 다음 내 차례에 움직이지 않고 그 방에서 추리할 수 있다([여기서 추리하기]). 그 차례가 끝나면 권리는 사라진다.
- 막힌 문·말이 길을 막는 규칙은 거리 표에서는 뺐다.
### 5.4 이동 (`free`)
주사위 없이 지금 있는 방이 아닌 아무 방에나 들어간다(불려 온 경우엔 머물러 추리도 가능).
### 5.5 추리(suggestion)
- 지금 들어간 방 + 용의자 1 + 흉기 1. 추리를 건너뛰고 차례를 끝낼 수도 있다(원작도 선택).
- 말한 용의자 말과 흉기를 그 방으로 옮긴다(원작). 그 말을 맡은 사람에게 5.3의 "불려 온 경우" 권리가 생긴다.
- 반증: 추리한 사람의 **다음 사람부터 시계 방향**으로 묻는다. 셋 중 한 장도 없는 사람은 서버가 바로 "못 보여 줌"으로 처리하고(공개 정보), 처음으로 가진 사람이 **반드시 한 장**을 골라 추리한 사람에게만 보여 준다(여러 장이면 보여 주는 사람이 고름). 거기서 멈춘다. 고발이 틀려 탈락한 사람도 반증은 계속한다(원작). 나간 사람은 건너뛴다(카드가 공개되어 있으므로).
- 한 장뿐이어도 보여 주는 사람이 직접 누른다(한 장/여러 장이 반응 속도로 드러나지 않게).
- 다른 사람들은 "누가 보여 줬다"와 "누가 못 보여 줬다"만 안다.
### 5.6 고발(accusation)
- 범인·흉기·장소(장소는 아무 방)를 말한다. 한 사람에 한 번.
- 맞으면 바로 승리. 틀리면 **탈락**: 더 이상 차례가 없지만 반증은 계속한다(원작). 고발 내용과 맞음/틀림은 모두에게 공개(원작에서도 소리 내어 말함).
- **원작과 다른 점**: 원작은 틀린 사람이 봉투를 몰래 본다. 온라인에서는 탈락한 사람이 채팅으로 정답을 흘릴 수 있어 **보여 주지 않는다**.
## 6. 승패와 점수 계산
- 고발을 맞힌 사람 1위, 나머지 모두 2위(공동). 점수 없음(`scoreText` 없음).
- 모두 고발이 틀리면 아무도 못 이기고 모두 공동 순위(무승부).
- 남은 한 사람만 방에 있으면(다른 사람이 모두 나감) 그 사람이 이긴다(`resign`).
## 7. 지역 룰 / 하우스 룰
- `free` 빠른 이동(5.4).
- 일부러 뺀 것: 막힌 문, 칸 단위 이동, 2인 변형, 틀린 고발자의 봉투 확인(5.6), "탐정 수첩" 서버 저장(화면 노트는 기기에만 저장).
## 8. 엔진 설계
### 8.1 상태(State)
```ts
interface ClueState {
options; seats; gameNo;
suspectOf: Record<PlayerId, Suspect>;
solution: { suspect; weapon; room }; // 비밀
hands: Record<PlayerId, string[]>; // 카드 id 'card-<item>'
publicCards: string[]; // 남는 카드 + 나간 사람 카드
pos: Record<Suspect, Pos>; // { at: 방|출발점 } | { from, to, moved } (복도)
weaponAt: Record<Weapon, Room>;
current; phase; dice;
movedIn: Record<PlayerId, boolean>; // 추리로 불려 옴
out; left; // 고발 실패 / 나감
suggestions: { by; suspect; weapon; room; passed[]; refuter; shown /*비밀*/; auto; turnNo }[];
accusations: { by; suspect; weapon; room; correct; turnNo }[];
turnNo; idle; idleTurn; deadlineAt; seq; final;
}
```
단계(phase): `move` → (`moveTo`) → `suggest` → `refute` → `afterSuggest` → 다음 사람 `move`. `finished`.
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `roll` | – | 차례인 사람, `move`, 주사위 모드 | |
| `passage` | – | `move`, 주사위 모드 | 비밀 통로가 있는 방에 있음 |
| `stay` | – | `move` | 방에 있고 `movedIn` |
| `go` | `room` | 주사위: `moveTo` / 빠른: `move` | 지금 방이 아님, 주사위면 거리 ≤ 합 |
| `walk` | `room` | `moveTo` | 거리 > 합 |
| `suggest` | `suspect, weapon` | `suggest` | |
| `show` | `card` | `refute`의 반증자 | 추리한 세 장 중 내 손의 카드 |
| `accuse` | `suspect, weapon, room` | 차례인 사람(탈락 아님), `refute` 아닐 때 | |
| `end` | – | `suggest`(추리 건너뛰기), `afterSuggest` | |
| `timeout` / `leave` | – | 서버 | |
### 8.3 공개/비공개 정보 (view)
- 카드 id(`card-rope`)와 추리에서 말하는 이름(`rope`)을 나눠, 카드 id는 볼 수 있는 사람의 view에만 나온다: 내 손패(`myHand`), 공개 카드, 내가 보여 준/받은 카드(`suggestions[].shown`은 추리한 사람·반증자에게만), 게임 끝난 뒤 전부.
- 반증 중 `canShow`(보여 줄 수 있는 카드)는 반증자 view에만. 봉투(`solution`)·모든 손패(`hands`)는 끝난 뒤에만.
- 이벤트에는 카드 id가 전혀 없다(`refuted`는 누가→누구에게만).
- `secretsOf(p)`: p가 아직 아무에게도 보여 주지 않은 손패 + 봉투 3장(끝나면 없음). 테스트는 여기에 더해 "보는 사람마다 알아도 되는 카드 집합" 밖의 카드 id가 view에 없는지 수백 판 검사한다.
### 8.4 랜덤 요소
첫 사람, 봉투 3장, 나머지 섞기, 흉기 위치, 주사위. 모두 `ctx.rng`.
### 8.5 타이머·시간 초과·연결 끊김
- 차례 `turnSeconds`, 반증 20초. 내 차례를 3번 연속 시간 초과로 넘기면 그 사람 차례는 10초.
- `turnSeconds` 무제한(null): 차례와 반증 모두 마감이 없다. 연결이 끊긴 채 방의 유예 시간이 지난 사람만 아래처럼 자동 진행되고, 그렇게 3번 넘긴 사람은 무제한 방에서도 10초 차례가 된다.
- 내 차례 시간 초과: 차례 하나를 통째로 자동 진행 — 주사위를 굴려 가장 가까운 닿는 방에 들어가고(없으면 가장 가까운 방 쪽으로 걸음), 추리 없이 끝낸다. 빠른 이동이면 가장 가까운 방.
- 반증 시간 초과: 맞는 카드 중 첫 장(용의자→흉기→방 순)을 보여 준다.
- 아직 고발하지 않은 사람이 모두 3번 연속 시간 초과 상태면 아무도 못 이기고 끝난다(`timeout`). 혼자 남은 자리 비운 사람 때문에 판이 끝나지 않는 것을 막는다.
- 나가기: 그 사람 카드는 모두에게 공개, 반증 중이었으면 다음 사람에게 묻기, 차례였으면 다음 사람.
### 8.6 종료 조건과 결과
맞는 고발 / 모두 탈락 / 한 사람만 남음 / 모두 자리 비움. 요약에 정답을 쓴다("고발이 맞았어요! 정답은 플럼 교수 · 밧줄 · 서재였어요.").
### 8.7 컴퓨터 상대 (`bot.ts`)
자기 view만으로 카드마다 "가질 수 있는 사람(+봉투)" 집합을 줄여 가는 소거 노트.
- 1~20(쉬움): 단순 소거 — 내 카드, 공개 카드, 나에게 보여 준 카드, "한 종류에서 봉투에 있을 수 있는 카드가 하나뿐이면 그것".
- 21~40(보통): + "못 보여 준 사람은 그 세 장이 없다", 손패 장수(다 찾은 사람은 다른 카드를 안 가짐 / 가능한 카드 수 = 손패 수면 전부 그 사람 것).
- 41~60(어려움, 기본): + "그 사람이 셋 중 하나는 가졌다" 제약(둘이 지워지면 남은 하나), 남의 틀린 고발(둘이 봉투로 확정이면 나머지는 아님).
- 고발: 봉투가 확실할 때만. 쉬움은 남은 정답 후보가 2개면 가끔(35%) 찍는다.
- 추리: 아직 모르는 카드를 우선(종류가 풀렸으면 내 카드/봉투 카드로 그 자리를 막음). 이동: 모르는 방 쪽으로(닿으면 들어가고, 아니면 가장 가까운 모르는 방으로 걸어감, 비밀 통로 활용).
- 반증: 그 사람에게 이미 보여 준 카드를 먼저(새 정보를 안 줌).
- 모든 깊이에서 추론이 건전한지(진짜 주인을 지우지 않는지) 실제 대국으로 테스트한다. 같은 조건 강한 컴퓨터(60)는 약한 컴퓨터(5) 둘을 상대로 3인전 대부분을 이긴다.
## 9. UI/UX
- PC: 왼쪽 저택 지도(3×4 칸, 가운데 복도·사건 봉투), 오른쪽 행동 패널, 아래 내 카드·공개 카드, 추리 노트. 오른쪽 사이드: 참가자(맡은 말, 카드 수, 차례/보여 주는 중/고발 실패/나감), 추리 기록(누가 무엇을 추리했고 누가 보여 줬는지, 내가 보거나 보여 준 카드는 [카드 이름]으로).
- 휴대폰(320px~): 지도·패널·카드·노트가 한 줄로 쌓인다.
- 이동: 주사위를 굴리면 지도 방에 칸 수가 나오고 닿는 방은 초록, 먼 방은 점선. 방을 누르고 [들어가기]/[걸어가기]로 확정. 방 칸에는 말(색 원+첫 글자)·흉기 아이콘·비밀 통로 표시.
- 추리·고발: 용의자/흉기(/장소) 칩을 고르고 버튼. 내가 아는(정답 아닌) 카드는 칩에 ✗로 흐리게. 고발은 두 번 눌러 확정("정말 고발해요 (틀리면 탈락)").
- 반증: 반증자에게만 보여 줄 카드 버튼이 뜬다. 추리한 사람에게는 받은 카드가 크게 보인다.
- 추리 노트: 21장 목록, 내 카드·공개 카드·나에게 보여 준 카드는 자동 ✗(누가 보여 줬는지 함께), 나머지는 눌러서 ✗ → ? → ✓. `localStorage` 키 `bg:clue:note:<방 코드>:<게임 번호>` — 기기에만 저장.
- 키보드: 모든 방·칩·카드·노트가 버튼. 스크린리더: 방마다 "식당, 5칸, 들어갈 수 있어요, 말: …, 흉기: …", 추리·반증 결과를 aria-live로 읽음. 다크 모드는 공통 색 변수.
- 움직임 더하기(2026-10-13): 말과 흉기는 움직일 때(내 이동, 남의 이동, 추리로 방에 끌려올 때) 원래 자리에서 새 자리로 살짝 튀어 오르며 미끄러져 간다(지도 기준이라 스크롤해도 맞음). 추리하면 고른 세 장(용의자·흉기·장소)이 추리한 사람의 말에서 가운데 "사건 봉투"로 날아간다. 카드를 보여 주면 나에게 보여 준 카드는 뒤집히며 나타나고(`anim-flip`), 다른 사람 화면에는 뒤집힌 카드 한 장이 보여 준 사람의 말에서 추리한 사람의 말로 날아간다. 날아가는 카드는 클릭을 막지 않고, 동작 줄이기 설정이면 움직이지 않는다.
## 10. 테스트 체크리스트
- [x] 인원별 손패/공개 장수, 봉투가 손패·공개 카드와 겹치지 않음, 스칼렛 선, 흉기 6곳 (`clue.test.ts`)
- [x] 거리 대칭, 걸어간 만큼 정확히 가까워짐, 비밀 통로, 같은 방 재입장 금지, 빠른 이동
- [x] 추리로 말·흉기 이동과 불려 온 권리, 반증 순서·못 보여 준 사람 기록, 반증자만 고름, 보여 준 카드는 두 사람만, 이벤트에 카드 없음
- [x] 고발 맞음/틀림, 틀린 사람의 반증 의무, 모두 틀림 → 무승부
- [x] 시간 초과(차례 통째로, 반증 자동), 자리 비움 단축·종료, 나가기(카드 공개, 반증 이어 가기, 혼자 남으면 승리)
- [x] 무작위 수백 판: 보존, 보는 사람마다 허용 카드 밖 누출 없음, onTimeout 유효, 엔진 randomPlayout(secretsOf), 결정성
- [x] 컴퓨터: 깊이별 추론, 확실할 때만 고발, 추론 건전성, 강약 차이, 사람이 시간만 넘겨도 끝남 (`bot.test.ts`)
- [x] 도움말(`help.test.ts`), E2E(PC 1 + 휴대폰 2, 주사위·통로·추리·반증·비밀 유지·고발까지)
## 11. 참고 자료
- Hasbro Clue/Cluedo 공식 설명서(추리·반증 순서, 불려 온 말, 틀린 고발자의 반증 의무, 남는 카드 공개)
- 내부 노트: `groups/grp_discord_joke-app/notes/new-game-descriptions-20261012.md` 64절
## 12. 메모 (상표·법적 주의 등)
'Clue/Cluedo'와 인물 이름은 해즈브로 상표. 사이트 방침(README 5절)대로 이름은 쓰되 지도·카드 그림은 직접 만든 이모지/CSS로 새로 그렸다. 저택 배치는 원작처럼 방 9개가 가운데를 둘러싼 형태지만 칸·문 위치는 쓰지 않았다.