Files
joke-app/docs/games/liar.md

162 lines
17 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.
# 라이어 게임 (`liar`)
> 마일스톤: 2026-10 새 게임 · 인원: 최소 3 ~ 최대 10명 · 예상 시간: 약 5~15분 · 난이도: 쉬움
## 1. 개요
- 모두 같은 제시어를 받았는데 몰래 뽑힌 **라이어** 한 명만 주제만 알고 제시어를 모른다. 돌아가며 한 문장씩 제시어를 설명하는 사이 라이어를 찾아내는 말놀이 파티 게임. 준비물 없이 말로만 하는 국내 놀이로 널리 알려져 있고, 해외 상품 '카멜레온(The Chameleon, 2017)', '스파이폴(Spyfall, 2014)'과 같은 계열이다. 만든 사람과 어느 방송에서 널리 알려졌는지는 확인하지 못했다.
- 원작 상품이 따로 없어 사이트·방송마다 규칙이 조금씩 다르다. 이 문서의 규칙이 우리 사이트 규칙이고, 화면의 [규칙]과 [?] 도움말에도 같은 내용을 적었다.
- 인원 근거: 3명 미만이면 투표가 성립하지 않고(1대1), 10명을 넘으면 설명 두 바퀴가 너무 길어진다.
- 마피아처럼 게임 자체 채팅(`ownChat`)과 서버가 돌리는 단계·타이머를 쓴다(진행자 불필요).
## 2. 모드와 옵션
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `topic` | 주제 | `random` / 과일·동물·직업·음식·장소·운동·탈것·물건·나라·동화 주인공 | `random` |
| `foolMode` | 바보 모드: 라이어도 같은 주제의 다른 단어를 받고 자기가 라이어인지 모른다 | on / off | off |
| `rounds` | 설명 바퀴 수(두 번째 바퀴는 거꾸로) | 1 / 2 | 2 |
| `describeSeconds` | 한 사람 설명 시간 | 15 / 20 / 30 / 45 / 60 / 무제한 | 30 |
| `discussionSeconds` | 자유 토론 시간 | 30 / 60 / 90 / 120 / 180 / 무제한 | 90 |
| `voteSeconds` | 투표 시간(재투표도 같은 시간) | 15 / 20 / 30 / 45 / 무제한 | 30 |
| `guessMode` | 라이어의 정답 맞히기 | `text`(직접 적기) / `choice`(주제 단어 목록에서 고르기) | `text` |
| `guessSeconds` | 정답 맞히기 시간 | 20 / 30 / 45 / 60 / 무제한 | 30 |
| `kidSafeChat` | 고운 말 필터(욕설·링크·전화번호 막기, 마피아와 같은 필터) | on / off | on |
## 3. 구성물
- 제시어 은행 `packages/games/src/liar/words.ts`: 주제 10개 × 단어 16~17개(모두 두 글자 이상).
- 단어마다 컴퓨터가 쓸 설명 문장 5개(`hints`, 앞쪽일수록 덜 구체적)와 정답으로 쳐 줄 다른 표기(`aliases`, 예: 휴대폰 ↔ 핸드폰·스마트폰, 텔레비전 ↔ 티비·TV).
- 주제마다 어느 단어에나 맞는 무난한 말(`generic`) 5개: 아직 아무 설명도 못 들은 라이어 컴퓨터가 쓴다.
- 테스트가 확인: 설명 문장에 그 단어(다른 표기 포함, 띄어쓰기 무시)가 없음, 무난한 말에 주제의 어떤 단어도 없음, 모두 고운 말 필터 통과, 80자 이하.
- 한 글자 단어(배, 귤, 컵 …)는 넣지 않았다: "제시어를 직접 말하면 안 돼요" 검사가 다른 말까지 막는다.
## 4. 준비(셋업)
1. 주제(무작위면 10개 중 하나), 그 주제의 제시어 하나, 라이어 한 명을 서버 시드 난수로 뽑는다.
2. 바보 모드면 라이어에게 같은 주제의 다른 단어 하나를 준다.
3. 첫 발언자를 무작위로 정하고, 그 사람부터 자리 순서대로 돈다. 라이어도 첫 발언자가 될 수 있다(라이어를 빼면 "첫 사람은 시민"이라는 정보가 생기므로).
## 5. 진행 규칙
### 5.1 단계
제시어 확인(10초) → 설명(바퀴 수만큼) → 자유 토론 → 투표(필요하면 재투표) → 정답 맞히기(라이어가 지목됐을 때만) → 결과.
### 5.2 제시어 확인과 설명
- 확인 시간: 시민 화면에는 "제시어 + 주제", 라이어 화면에는 "나는 라이어 + 주제"만. 모두 [확인했어요]를 누르면 바로 넘어간다.
- 설명: 순서대로 한 사람씩, 자기 차례에만 한 문장(80자까지)을 쓴다. 보내면 바로 다음 사람 차례. 시간이 지나면 "넘김"으로 기록하고 다음 사람.
- 두 바퀴면 두 번째 바퀴는 거꾸로 돈다(처음에 아무것도 모르고 말한 사람이 마지막에 말한다). 첫 바퀴 마지막 사람은 두 번 이어서 말한다.
- **제시어를 직접 말하면 안 된다**: 자기 단어(다른 표기 포함)가 띄어쓰기·대소문자·문장 부호를 무시하고 들어 있으면 서버가 거절한다("제시어를 직접 말하면 안 돼요."). 설명과 토론 채팅 모두.
- 라이어(보통 모드)는 막지 않는다. 막으면 "이 말은 거절됐다 = 정답"이 새기 때문. 바보 모드 라이어는 자기 단어가 막힌다(시민과 똑같이 보이려고).
- 설명 중에는 설명할 차례인 사람만 쓸 수 있다(다른 사람 채팅은 닫힘). 확인 시간·정답 맞히기 중에도 채팅은 닫힌다(라이어에게 힌트를 주지 못하게).
### 5.3 자유 토론
- 모두 [토론 채팅]에 자유롭게 쓴다(200자, 한 번에 6줄까지 바로, 그 뒤 0.3초에 한 줄 — `chat-pace.ts`). 모두 [토론 끝내기]를 누르면 바로 투표(마피아와 같은 "모두 동의" 방식, 방장 혼자서는 못 끝냄).
### 5.4 투표
- 나를 뺀 한 명을 고른다. 시간 안에는 바꿀 수 있고, 모두 투표하면 바로 집계한다. 투표하지 않으면 그 사람 표는 없다.
- 투표 중에도 토론 채팅을 쓸 수 있다. 누가 투표했는지는 보이고, 누구를 골랐는지는 집계 때 공개.
- 가장 많이 받은 한 명이 지목된다.
- **동점**: 동점인 사람끼리 **재투표 한 번**(후보는 동점자만, 동점자 본인은 자기 말고 다른 동점자에게). 또 동점이면 **라이어 승리**. 아무도 투표하지 않으면 모두가 동점으로 본다(재투표 후보 = 모두).
- 근거: 국내 진행에서 가장 흔한 "동점이면 다시 투표"를 한 번만 하고, 끝까지 못 고르면 라이어를 못 찾은 것으로 본다(카멜레온·스파이폴도 지목에 실패하면 숨은 쪽이 이긴다).
### 5.5 정답 맞히기
- 지목된 사람이 라이어가 아니면 바로 라이어 승리.
- 라이어면 모두에게 라이어가 공개되고, 라이어가 제시어를 **한 번** 맞힌다.
- `text`: 직접 적는다(20자). 띄어쓰기·대소문자·문장 부호를 무시하고, 다른 표기(aliases)도 정답, 끝에 "요/다/이다/입니다"가 붙어도 정답(그림 맞히기와 같은 비교 함수 `judge`).
- `choice`: 그 주제 단어 목록(가나다순)에서 하나를 고른다. 목록에 없는 말은 거절.
- 시간이 지나면 틀린 것으로 본다.
- 바보 모드: 지목되어 공개된 뒤에야 라이어가 자기가 라이어인 걸 안다. 자기가 받은 단어는 정답이 아니다.
## 6. 승패와 점수 계산
| 결과 | 승리 | 점수 |
|---|---|---|
| 라이어가 아닌 사람이 지목됨 | 라이어 | 라이어 2점 |
| 재투표도 동점 | 라이어 | 라이어 2점 |
| 라이어가 지목됐지만 제시어를 맞힘 | 라이어 | 라이어 2점 |
| 라이어가 지목되고 제시어도 못 맞힘 | 시민 | 시민마다 1점 |
| 라이어가 게임을 나감 | 시민 | 시민마다 1점 |
| 시민이 모두 나감 | 라이어 | 라이어 2점 |
- 결과 화면 순위: 이긴 쪽 / 진 쪽 두 묶음. 점수 글(scoreText)은 "라이어 · 2점", "시민 · 1점" 처럼 역할과 함께. 나간 사람은 0점이고 진 쪽에 넣는다.
- 여러 판 연속은 방의 [한 판 더]로 한다(새 주제·제시어·라이어).
## 7. 지역 룰 / 하우스 룰
- 바보 모드(옵션). 설명 바퀴 수, 각 시간, 정답 맞히기 방식(옵션).
- 일부러 뺀 것: 라이어 2명, 최후 변론 단계(토론에서 충분히 말할 수 있어서), 방장 혼자 토론 끝내기, 사용자 단어 목록, 음성 설명.
## 8. 엔진 설계
### 8.1 상태(State)
```ts
interface LiarState {
options; players: { id; left }[]; topic; word; liar; liarWord /* 바보 모드 */; order /* 1바퀴 순서 */;
phase: reveal{ready} | describe{round, turn} | discussion{ready} | vote{round 1|2, candidates, votes} | guess | ended;
descriptions: { n, round, from, text | null }[]; chat: { n, from, text, at }[]; lastChatAt;
events: PublicEvent[]; accused; guess; seq; final: LiarFinal | null;
}
```
### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `chat` | `text` | 설명 차례인 사람(설명) / 모두(토론·투표) | 채팅 열린 단계, 80자(설명)·200자, 고운 말, 자기 단어 금지, 한 번에 6줄, 그 뒤 0.3초에 한 줄 |
| `ready` | — | 확인 시간·토론 | 아직 안 누름 |
| `vote` | `target` | 투표 | 나 말고, 후보(재투표는 동점자) 중 |
| `guess` | `text` | 정답 맞히기의 라이어 | 1~20자, `choice`면 주제 단어 |
| `phaseTimeout` | — | 서버(시계) | `endsAt` 이후 (무제한 단계: 아직 안 마친 사람만, 방의 연결 끊김 유예 뒤) |
| `leave` | — | 서버(나감) | 아직 안 나감 |
### 8.3 공개/비공개 정보 (view)
- `my.word`: 시민은 제시어, 라이어는 null, 바보 모드 라이어는 자기 단어. `my.role`: 라이어(보통 모드, 또는 공개 뒤) / 시민. 바보 모드 라이어의 화면은 단어만 다르고 시민 화면과 모양이 똑같다(테스트).
- `players[].liar`: 정답 맞히기 단계(라이어 지목) 또는 끝나기 전까지 모두 null. 시민 화면은 누가 라이어든 한 글자도 다르지 않다(테스트: 라이어만 바꾼 두 판의 시민·관전 화면이 같음).
- 관전자는 주제만 보고 제시어는 끝나야 본다. `final`(라이어·제시어·바보 모드 단어·라이어의 답·점수)은 끝난 뒤에만.
- 정답 고르기 목록(`phase.choices`)은 정답 맞히기 단계에만 들어간다.
- `secretsOf`: 바보 모드 라이어의 단어(공개 전까지 라이어만). 보통 모드 제시어는 시민 모두가 보므로 따로 테스트로 확인(라이어·관전 화면에 없음).
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
주제(무작위일 때), 제시어, 라이어, 바보 모드 단어, 첫 발언자. 모두 `ctx.rng`.
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- 모든 단계에 `endsAt`. 마피아처럼 첫 자리 사람이 시계를 대표하고(`timeoutPlayers`), `timeoutNotBefore`로 자리 비운 사람이 단계를 일찍 끝내지 못한다.
- 시간 초과: 확인 → 첫 설명, 설명 → 넘김, 토론 → 투표, 투표 → 집계, 정답 맞히기 → 틀림.
- 나가기(`onLeave`): 그 사람은 이후 차례·투표·"모두 동의"에서 빠진다. 설명 차례였으면 다음 사람. 투표 중이면 그 사람 표와 그 사람이 받은 표를 지우고, 남은 사람이 다 투표했으면 바로 집계. 라이어가 나가면 시민 승리, 시민이 모두 나가면 라이어 승리.
- **시간 무제한**(단계별 옵션 값 `null`): 그 단계는 `endsAt: null`. 설명은 차례인 사람이 말할 때까지, 토론은 모두 [토론 끝내기], 투표는 모두 투표, 정답 맞히기는 라이어가 답할 때까지 기다린다. 제시어 확인(10초)은 그대로.
- 시간 초과 대상(`timeoutPlayers`)은 아직 안 마친 사람들. 연결이 끊긴 채 방의 유예 시간이 지나면 그 사람의 `phaseTimeout`이 넘김(설명 `text: null`, 토론 끝, 표 없음 `passed`, 답 없음 → 시민 승리)으로 처리된다.
- 컴퓨터는 무제한 단계를 기본 시간(설명 30초, 토론 90초, 투표·맞히기 30초)처럼 맞춰 행동한다.
### 8.6 종료 조건과 결과(GameResult)
6절 표. `reason: 'normal'`, `summary` 예: "라이어 승리! 라이어가 아닌 사람이 지목됐어요. 제시어는 '수박'이었어요."
## 9. UI/UX
- 위: 단계 배너(단계 이름, 주제, 지금 말하는 사람, 큰 남은 시간) + **"내 제시어" 카드**(꾹 누르는 동안만 보임, 키보드 Enter로 2.5초). 라이어는 "🤥 나는 라이어".
- 발표 상자: 투표 막대그래프와 누가 누구를 골랐는지, 지목된 사람이 라이어인지, 라이어의 답.
- PC 세 칸: 사람들(말하는 순서 번호, 말하는 중·투표함·라이어·나감 표시, 투표 때 초록 테두리로 고르기) / 설명 기록(바퀴별) + 토론 채팅 / 할 일(확인·설명 입력·토론 끝내기·투표 안내·정답 입력 또는 단어 목록). 좁은 화면은 할 일 → 사람들 → 설명·채팅 순으로 쌓인다(320px까지).
- 게임 중 방 채팅·빠른 반응은 닫힌다(`ownChat`). 끝나면 최종 공개 표(역할·점수).
- 30초 요약 카드 3장, [?] 도움말은 보는 사람에 맞게(라이어/시민/관전, 바보 모드 라이어는 시민과 똑같은 글).
- 움직임 더하기(2026-10-13): 투표 결과는 적은 표부터 한 줄씩(0.35초 간격) 나오며 줄마다 작은 칩 소리. 다 나오면 지목된 사람에게 스포트라이트(그 칸만 밝고 나머지가 어두워짐, 칸이 화면 밖이면 칸만 빛남)가 떨어지고 칸이 빛나며 흔들린 뒤 배너: 라이어를 잡으면 "잡았다!", 아니면 "헛다리!". 동점이면 "동점!" / "또 동점!". 라이어의 정답은 "정답!"(빨강) / "땡!"(초록), 끝에 "라이어 승리!" / "시민 승리!" 배너. 하나가 끝나야 다음이 나오고(1.5초 간격), 클릭을 막지 않으며 동작 줄이기 설정이면 움직이지 않는다.
## 10. 테스트 체크리스트
- [x] 제시어 은행: 주제 10개, 단어 15개 이상, 설명 4개 이상, 설명에 단어 없음, 고운 말 필터 (`liar.test.ts`)
- [x] 정답 비교(띄어쓰기·대소문자·다른 표기)
- [x] 라이어·관전 화면에 제시어 없음, 시민 화면은 라이어가 누구든 같음, 바보 모드 화면 모양 같음
- [x] 설명 순서(두 번째 바퀴 거꾸로), 넘김, 80자, 제시어 금지(라이어는 안 막음)
- [x] 토론 모두 동의, 투표 즉시 집계, 동점 → 재투표 → 또 동점 라이어 승리, 아무도 안 찍음
- [x] 정답 맞히기(맞힘·틀림·시간 초과·고르기), 나가기(설명 차례·투표 중·라이어·시민 전원)
- [x] 엔진 무작위 대국(3~10명, 4가지 옵션, 유출·JSON·결정성), 결과 점수 글
- [x] 컴퓨터: 3~10명 끝까지, 거절 0, 제시어 안 말함, 높은 레벨이 더 잘함 (`bot.test.ts`)
- [x] 실제 방: 사람 1 + 컴퓨터 4로 끝까지(사람이 설명·토론·투표 / 사람이 가만히) (`apps/server/src/rooms/liar.room.test.ts`)
- [x] E2E: PC 1 + 휴대폰 2, 실제 화면 조작으로 끝까지 (`e2e/games.e2e.ts liar`)
## 11. 참고 자료
- 규칙 메모: 새 게임 설명 문서 39절(라이어 게임).
- 비슷한 게임: The Chameleon(Big Potato, 2017), Spyfall(Hobby World, 2014) — 지목 실패 시 숨은 쪽 승리, 숨은 쪽이 들켜도 정답을 맞히면 승리.
## 12. 메모 (상표·법적 주의 등)
- 국내 놀이 이름이라 상표 걱정은 적다. 동화 주인공 주제는 저작권이 끝난 옛이야기(전래 동화·고전 동화) 인물만 넣었다.
## 13. 컴퓨터 플레이어 (2026-10-12)
- 마피아처럼 live 전략(`LIVE_BOT_STRATEGIES.liar`, `packages/games/src/liar/bot.ts`): 각 컴퓨터가 자기 시계로 자기 화면만 보고 한 번에 한 가지를 한다. 연습 방은 5명(사람 1 + 컴퓨터 4).
- 이 게임은 컴퓨터가 말해야 진행되므로 `BOT_CHAT_REQUIRED`에 넣었다(방의 "컴퓨터 채팅" 설정과 상관없이 항상 켜짐).
- **로컬 모델(LLM)로 문장을 바꾸지 않는다**(`hint` 없음): 정해 둔 문장만 쓴다. 모델이 제시어를 흘리거나, 라이어 컴퓨터가 모를 말을 할 위험이 있어서. 서버는 모델이 켜져 있으면 "입력 중…"을 글자 수만큼 보여 준 뒤 그대로 보낸다(`typeLive`, hint 없으면 문장을 바꾸지 않음).
- 시민 컴퓨터: 자기 단어의 설명 문장 중 아직 아무도 안 쓴 것(똑똑한 편은 덜 구체적인 앞쪽부터). 다 쓰였으면 다른 사람 설명에 한 표("OO님 설명에 한 표예요") 또는 주제의 무난한 말.
- 라이어 컴퓨터: 지금까지 나온 설명을 주제의 단어마다 설명 은행과 글자쌍(두 글자씩)으로 맞춰 보고(드문 글자쌍일수록 무게), 가장 맞는 단어를 추정해 그 단어의 설명 문장으로 말한다. 아무 설명도 못 들었으면 무난한 말. 지목되면 같은 추정으로 정답을 적거나 고른다.
- 투표: 설명이 (자기 단어 또는 라이어의 추정 단어와) 덜 맞는 사람, 넘긴 사람을 의심. 라이어 컴퓨터는 자기를 지목하지 않고, 채팅에서 많이 의심받는 사람 쪽으로 기운다.
- 토론: 정해 둔 문장으로 의심 지목, 동의·반박, 지목당하면 반박, 이름이 불리면 대답. 토론 후반에 [토론 끝내기].
- 레벨(1~60): 라이어가 알아듣는 설명의 비율(30%~95%)과 추정·의심의 잡음 크기, 라이어가 추정 단어로 설명할 용기(35%~95%). 레벨이 높을수록 시민은 라이어를 더 잘 찾고 라이어는 더 잘 맞힌다(테스트: 레벨 60 시민 대 레벨 1 라이어 → 시민 승률이 반대 경우보다 20%p 넘게 높음).
- 컴퓨터가 쓰는 레벨은 서버가 `LiveBotInput.level`로 넘긴다(방의 컴퓨터 레벨, 없으면 id로 정한 레벨).