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

16 KiB
Raw Permalink Blame History

클루 (clue)

마일스톤: M9 · 인원: 최소 3 ~ 최대 6명 · 예상 시간: 약 3050분(빠른 이동 2030분) · 난이도: 보통

1. 개요

  • 저택에서 일어난 살인 사건의 범인·흉기·장소를 '추리(질문)'와 소거법으로 알아내는 추리 보드게임. 1943년 영국의 앤서니 프랫이 고안, 1949년 워딩턴스 출시(영국 이름 Cluedo, 미국 이름 Clue).
  • 인원 근거: 원작 36인. 2인은 넣지 않았다. 노트 파일의 "판에 따라 26명"은 일부 판의 이야기인데, 공식 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
  1. 말은 모두 자기 출발점(복도), 흉기 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)

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. 테스트 체크리스트

  • 인원별 손패/공개 장수, 봉투가 손패·공개 카드와 겹치지 않음, 스칼렛 선, 흉기 6곳 (clue.test.ts)
  • 거리 대칭, 걸어간 만큼 정확히 가까워짐, 비밀 통로, 같은 방 재입장 금지, 빠른 이동
  • 추리로 말·흉기 이동과 불려 온 권리, 반증 순서·못 보여 준 사람 기록, 반증자만 고름, 보여 준 카드는 두 사람만, 이벤트에 카드 없음
  • 고발 맞음/틀림, 틀린 사람의 반증 의무, 모두 틀림 → 무승부
  • 시간 초과(차례 통째로, 반증 자동), 자리 비움 단축·종료, 나가기(카드 공개, 반증 이어 가기, 혼자 남으면 승리)
  • 무작위 수백 판: 보존, 보는 사람마다 허용 카드 밖 누출 없음, onTimeout 유효, 엔진 randomPlayout(secretsOf), 결정성
  • 컴퓨터: 깊이별 추론, 확실할 때만 고발, 추론 건전성, 강약 차이, 사람이 시간만 넘겨도 끝남 (bot.test.ts)
  • 도움말(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개가 가운데를 둘러싼 형태지만 칸·문 위치는 쓰지 않았다.