joke-app/docs/games/dalmuti.md

# 달무티 (`dalmuti`)

> 마일스톤: M7 · 인원: 최소 4 ~ 최대 8명 · 예상 시간: 한 라운드 약 10분 (기본 3라운드 약 30분) · 난이도: 쉬움

## 1. 개요
- 신분 계급이 있는 버리기형 카드 게임이다. 숫자가 낮을수록 좋은 카드다. 앞사람과 같은 장수를 더 낮은 숫자로 내고, 손패를 먼저 다 털수록 다음 라운드에서 높은 신분이 된다. 높은 신분은 세금으로 낮은 신분의 좋은 카드를 받는다.
- 원작은 리처드 가필드의 "The Great Dalmuti"(1995)다. 한국에서는 "위대한 달무티"로 학교와 모임 파티 게임으로 많이 알려졌다. 같은 계열 민속 게임으로 "대통령(President)", "대부호(大富豪)"가 있다.
- 인원 근거: 원작 박스 기준 4~8명. 나무위키도 4~8명(5~7명 권장)이다. 2~3명이나 9명 이상은 비공식이라 지원하지 않는다.

## 2. 모드와 옵션
| 옵션 키 | 설명 | 선택지 | 기본값 |
|---|---|---|---|
| `rounds` | 라운드 수 | 1 / 3 / 5 / 7 | 3 |
| `scoring` | 최종 순위 방식 | `rank-points`(라운드별 순위 점수 합) / `last-round`(마지막 라운드 순위) | `rank-points` |
| `firstRanking` | 첫 라운드 신분 정하기 | `draw`(카드 뽑기, 원작) / `random` | `draw` |
| `revolution` | 혁명 규칙 사용 | on / off | on |
| `jesterTaxable` | 세금 낼 때 광대도 "좋은 카드"로 내야 하나 | on / off | off |
| `passLocksOut` | 한 번 패스하면 그 트릭에서 다시 못 냄(하우스 룰) | on / off(원작) | off |
| `removeHighCards` | 9~12 카드를 빼고 하기(손패가 많을 때, 나무위키 언급) | on / off | off |
| `turnSeconds` | 턴 제한 시간 | 15 / 20 / 30 / 45 | 20 |

## 3. 구성물
- 숫자 카드 78장: 숫자 n인 카드가 n장이다(1이 1장, 2가 2장, …, 12가 12장).
- 광대(Jester) 2장. 단독으로 내면 13이고, 다른 카드와 함께 내면 그 숫자로 변한다(와일드).
- 합계 80장. `removeHighCards = on`이면 9~12(42장)를 빼고 38장으로 한다.
- 카드 이름(원작 계급 이름, 화면 표시용)

| 숫자 | 이름 | 장수 |
|---|---|---|
| 1 | 달무티 | 1 |
| 2 | 대주교 | 2 |
| 3 | 시종장 | 3 |
| 4 | 남작부인 | 4 |
| 5 | 수녀원장 | 5 |
| 6 | 기사 | 6 |
| 7 | 재봉사 | 7 |
| 8 | 석공 | 8 |
| 9 | 요리사 | 9 |
| 10 | 양치기 | 10 |
| 11 | 광부 | 11 |
| 12 | 농노 | 12 |
| 13(광대) | 광대 | 2 |

- 플레이어 신분(라운드 순위)
  - 1위: 대달무티
  - 2위: 소달무티
  - 3위 ~ N-2위: 평민
  - N-1위: 소농노
  - N위: 대농노
  - 4인이면 평민이 없다.

## 4. 준비(셋업)
1. **첫 라운드 신분**(`firstRanking = draw`): 섞은 덱에서 각자 1장씩 뽑는다. 숫자가 낮을수록 높은 신분이고, 광대는 13으로 본다. 같은 숫자끼리는 그 사람들만 다시 뽑아 순서를 정한다. 엔진은 RNG로 같은 절차를 시뮬레이션하고 결과를 애니메이션으로 보여 준다.
2. **자리와 순서**: 신분 순서대로 시계 방향으로 앉는다(대달무티 → 소달무티 → 평민들 → 소농노 → 대농노 → 다시 대달무티). 턴 순서도 이 순서다.
3. **분배**: 덱을 섞어 대달무티부터 신분 순서대로 1장씩 전부 나눠 준다. 나누어떨어지지 않으면 앞 신분이 1장씩 더 받는다.

| 인원 | 손패(80장) |
|---|---|
| 4 | 20 × 4 |
| 5 | 16 × 5 |
| 6 | 14, 14, 13, 13, 13, 13 |
| 7 | 12, 12, 12, 11, 11, 11, 11 |
| 8 | 10 × 8 |

4. **혁명 확인 단계**(`revolution = on`): 모든 플레이어가 손패를 확인하고 "확인"을 누른다. 광대 2장을 모두 가진 사람에게만 "혁명 선언" 버튼이 함께 보인다. 모든 사람이 같은 단계를 거치므로 단계가 생긴 것만으로 광대 소유자가 드러나지 않는다.
   - **혁명**: 광대 2장을 가진 사람(대농노 제외)이 선언하면 광대 2장을 공개한다. 이번 라운드는 세금을 걷지 않고, 신분은 그대로다.
   - **대혁명**: 대농노가 광대 2장을 가지고 선언하면 신분 순서가 완전히 뒤집힌다. 대농노가 대달무티, 대달무티가 대농노가 되고 평민 순서도 뒤집힌다. 자리와 턴 순서도 뒤집히고 세금은 없다.
   - 선언은 선택이다. 선언하지 않으면 평소대로 세금을 걷는다.
5. **세금**(혁명이 없을 때)
   - 대농노는 손패에서 가장 좋은(숫자가 가장 낮은) 카드 2장을 대달무티에게 준다. 소농노는 가장 좋은 카드 1장을 소달무티에게 준다. 선택권이 없으므로 서버가 자동으로 옮긴다.
   - `jesterTaxable = off`(기본)이면 광대는 "가장 좋은 카드" 계산에서 빼고 숫자 카드 중 가장 낮은 것을 준다. 같은 숫자가 여럿이면 어느 것을 줘도 같으므로 카드 ID 순으로 정한다.
   - 받은 대달무티는 아무 카드 2장(방금 받은 카드 포함 가능), 소달무티는 아무 카드 1장을 골라 돌려준다. 두 사람은 동시에 고른다.
   - 4인이면 소달무티 ↔ 소농노, 대달무티 ↔ 대농노만 있다.
6. **첫 트릭**은 대달무티가 시작한다(대혁명이면 새 대달무티).

## 5. 진행 규칙

### 5.1 트릭 진행
- **선(리드)**: 트릭을 시작하는 사람은 같은 숫자 카드를 원하는 장수(1장 이상)만큼 낸다. 광대를 섞어도 된다.
- **따라 내기**: 다음 사람부터 순서대로, 바로 앞에 나온 묶음과 같은 장수이면서 숫자가 더 낮은(더 좋은) 묶음을 내거나 패스한다.
  - 예: 9 세 장이 나왔으면 1~8 중 같은 숫자 세 장만 낼 수 있다(1은 1장뿐이라 광대를 섞어야 3장이 된다).
- **광대**
  - 광대만 내면 1장당 13이다. 광대 1장은 13 한 장, 광대 2장은 13 두 장이다.
  - 숫자 카드와 함께 내면 그 숫자로 간주한다. 예: 4 + 광대 = 4 두 장, 1 + 광대 = 1 두 장(원작에 1과 광대를 같이 내는 것을 막는 문구가 없다).
  - 한 묶음에 숫자 카드가 섞일 때 숫자 카드는 모두 같은 숫자여야 한다.
- **패스**: 낼 수 있어도 언제든 패스할 수 있다. 원작 기본(`passLocksOut = off`)에서는 패스해도 같은 트릭에서 차례가 다시 오면 낼 수 있다.
- **트릭 종료**: 마지막으로 낸 사람을 뺀, 아직 카드가 있는 나머지 모두가 연속으로 패스하면 트릭이 끝난다. 바닥 카드를 치우고 마지막으로 낸 사람이 새 트릭을 시작한다.
  - 마지막으로 낸 사람이 그 묶음으로 손패를 다 털었으면, 턴 순서상 그 사람의 다음이면서 아직 카드가 있는 사람이 새 트릭을 시작한다.
  - `passLocksOut = on`이면 패스한 사람은 그 트릭의 나머지 차례가 자동으로 건너뛰어진다. 트릭 종료 조건은 같다.

### 5.2 손패를 다 턴 경우와 라운드 종료
- 손패를 모두 낸 순서대로 다음 라운드 신분이 정해진다. 처음 턴 사람이 다음 대달무티, 두 번째가 소달무티, …
- 카드가 남은 사람이 1명이 되면 라운드가 끝나고 그 사람이 다음 대농노다. 그 사람의 남은 카드는 따로 내지 않는다.
- 다음 라운드는 새 신분으로 자리를 다시 잡고 4번 셋업 3단계(분배)부터 반복한다.

### 5.3 예시(5인)
- 대달무티 A가 7 두 장을 낸다. B는 5 두 장, C는 패스, D는 2 + 광대(2 두 장), E는 패스, A는 패스(1은 1장뿐이고 광대가 없음), B는 패스, C는 패스.
- D를 뺀 모두가 연속으로 패스했으므로 트릭이 끝나고 D가 새 트릭을 시작한다.

## 6. 승패와 점수 계산
- 원작에는 정해진 승리 조건이 없다(합의할 때까지 계속). 이 사이트에서는 `rounds`만큼 하고 끝낸다.
- `rank-points`(기본): 각 라운드에서 순위 r(1~N)인 사람이 N - r점을 받는다(1위 N-1점, 꼴찌 0점).
  - 예(5인): 1위 4, 2위 3, 3위 2, 4위 1, 5위 0점.
  - 최종 순위는 총점이 높은 순이고, 같으면 마지막 라운드 순위가 높은 사람이 앞선다.
- `last-round`: 마지막 라운드 순위가 최종 순위다.
- 점수는 방 안 결과 표시용이다. 칩이나 돈이 아니다.

## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
- 혁명 끄기(`revolution`).
- 세금에 광대 포함(`jesterTaxable`). 일부 모임은 광대도 좋은 카드로 내야 한다고 한다.
- 한 번 패스하면 트릭에서 빠짐(`passLocksOut`). 대부호/대통령 계열에서 흔한 규칙이다.
- 9~12 빼기(`removeHighCards`). 인원이 적어 손패가 많을 때 쓴다.
- 지원하지 않는 변형(문서화만): 혁명 시 숫자 강약 반전(대부호식 "혁명"), 8 끊기, 같은 숫자 연속 금지(시바리), 낙오(도시락) 규칙.

## 8. 엔진 설계
### 8.1 상태(State)
```ts
interface DCard { id: string; n: number } // 1..12, 광대는 13
type Play = { cardIds: string[]; count: number; rank: number }; // rank: 광대 섞이면 숫자 카드의 숫자, 광대만이면 13

interface DalmutiState {
  options: DalmutiOptions;
  rng: RngState;
  players: PlayerId[];                  // 참가자(불변)
  order: PlayerId[];                    // 이번 라운드 신분 순서 = 턴 순서. [0]=대달무티
  round: number;                        // 1부터
  hands: Record<PlayerId, DCard[]>;     // 비공개
  phase:
    | { kind: 'firstRankDraw'; draws: Record<PlayerId, number[]> } // 연출용, 즉시 다음 단계
    | { kind: 'revolutionCheck'; confirmed: Record<PlayerId, boolean> }
    | { kind: 'taxReturn'; owed: Record<PlayerId, { to: PlayerId; count: number; done: boolean }> }
    | { kind: 'playing' }
    | { kind: 'roundOver' }
    | { kind: 'finished' };
  revolution: 'none' | 'revolution' | 'great' ;
  taxLog: { from: PlayerId; to: PlayerId; cardIds: string[] }[]; // 당사자만 열람
  trick: {
    leader: PlayerId;                   // 이 트릭을 시작한 사람
    top: (Play & { by: PlayerId }) | null; // 바닥 맨 위 묶음
    passesSinceTop: PlayerId[];         // top 이후 패스한 사람
    lockedOut: PlayerId[];              // passLocksOut용
    pile: Play[];                       // 이 트릭에 나온 묶음(공개)
  };
  current: PlayerId;
  finishOrder: PlayerId[];              // 이번 라운드 나간 순서
  roundResults: { order: PlayerId[]; revolution: string }[];
  totals: Record<PlayerId, number>;
  turnStartedAt: number;
  seq: number;
}
```

### 8.2 액션
| type | payload | 누가 / 언제 | 검증 조건 |
|---|---|---|---|
| `confirmHand` | `{ declareRevolution?: boolean }` | 모든 플레이어, phase=`revolutionCheck` | 한 번만. `declareRevolution=true`는 광대 2장을 모두 가진 사람만(아니면 "광대 2장이 있어야 혁명할 수 있어요") |
| `returnTax` | `{ cardIds: string[] }` | 대달무티(2장), 소달무티(1장), phase=`taxReturn` | 자기 손에 있는 카드이고 장수가 정확함 |
| `play` | `{ cardIds: string[] }` | `current`, phase=`playing` | 카드가 자기 손에 있음. 숫자 카드(광대 제외)는 모두 같은 숫자. 리드면 1장 이상. 따라 내기면 장수 = top.count이고 rank < top.rank. `passLocksOut` on이면 lockedOut이 아님 |
| `pass` | `{}` | `current`, phase=`playing` | 리드가 아닐 때만(리드는 반드시 내야 함) |

- `revolutionCheck`는 모두가 확인하면 끝난다.
  - 선언자가 있으면 혁명 또는 대혁명을 적용하고 `playing`으로 간다.
  - 없으면 세금을 자동으로 옮기고 `taxReturn`으로 간다. 두 사람이 모두 돌려주면 `playing`.
- `play` 처리: 묶음의 rank를 정하고 top을 바꾼 뒤 `passesSinceTop = []`. 손패가 0이 되면 `finishOrder`에 넣는다. 남은 사람이 1명이면 `roundOver`.
- 다음 차례 계산: 턴 순서에서 다음 사람 중 카드가 있는(그리고 lockedOut이 아닌) 사람.
- 트릭 종료 판정: (카드가 남은 사람 중 top.by가 아닌 모두)가 `passesSinceTop`에 있으면 종료한다. top.by가 이미 나간 경우에는 카드가 남은 모두가 패스하면 종료한다.
- `roundOver` 처리: 점수를 반영한다. 라운드가 남았으면 `order = finishOrder + [남은 1명]`으로 새 라운드 분배를 하고 `revolutionCheck`로 간다. 다 했으면 `finished`.
- `reason` 예: "앞사람과 같은 장수(3장)로 내야 해요", "더 낮은 숫자만 낼 수 있어요", "같은 숫자끼리만 낼 수 있어요", "새로 시작할 때는 패스할 수 없어요".

### 8.3 공개/비공개 정보 (view)
- 모두(관전자 포함)
  - 신분 순서, 각자 손패 장수, 현재 트릭의 모든 묶음(누가 무엇을 냈는지), 현재 차례, 패스 표시, 나간 순서.
  - 라운드와 총점, 혁명 여부. 혁명이 선언되면 선언자와 "광대 2장"이 공개된다.
- 본인만: 자기 손패.
- 세금: 주고받은 카드 내용은 준 사람과 받은 사람에게만 보인다. 다른 사람과 관전자는 "대농노 → 대달무티 2장" 같은 장수만 받는다.
- `revolutionCheck`: 각자에게 `canDeclareRevolution`이 본인 view에만 있다. 다른 사람은 확인 완료 여부만 본다.
- 절대 보내지 않는 것: 남의 손패, 덱 섞인 순서, RNG 상태.

### 8.4 랜덤 요소 (시드 RNG 사용 지점)
- 첫 라운드 신분 뽑기(동점 재뽑기 포함).
- 매 라운드 덱 섞기.
- 그 외 없음(세금 자동 선택은 숫자 → 카드 ID 순으로 결정적).

### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
- 마감: `revolutionCheck` 20초, `taxReturn` 30초, 플레이 `turnSeconds`.
- `onTimeout`
  - `revolutionCheck`: `confirmHand { declareRevolution: false }`. 자동으로 혁명을 선언하지 않는다.
  - `taxReturn`: 숫자가 가장 큰(가장 나쁜) 숫자 카드부터 필요한 장수만큼 돌려준다(광대 제외).
  - `playing` 리드: 광대를 빼고 가장 큰 숫자 카드를 그 숫자 전부 낸다. 광대만 남았으면 광대를 모두 낸다.
  - `playing` 따라 내기: `pass`.
- 연결이 끊겨도 탈락시키지 않는다. 위 자동 행동으로 라운드가 끝까지 진행된다. 연속 3턴 타임아웃이면 서버가 마감을 5초로 줄인다.

### 8.6 종료 조건과 결과(GameResult)
- `round == rounds`의 라운드가 끝나면 종료한다.
```ts
interface GameResult {
  ranking: { player: PlayerId; rank: number; total: number; roundRanks: number[] }[];
  winner: PlayerId[];
  summary: string; // "3라운드 동안 지수 님이 가장 높은 신분을 지켰어요!"
}
```

## 9. UI/UX
- 모바일 세로 화면
  - 위: 신분 순서대로 상대를 원형으로 배치한다. 각자 왕관/모자 아이콘(신분), 손패 장수, 패스 말풍선을 표시한다.
  - 가운데: 현재 트릭 바닥 묶음(마지막 묶음을 크게, 이전 묶음은 겹쳐서 작게). "지금 기준: 5 × 2장"을 큰 글자로 보여 준다.
  - 아래: 내 손패를 숫자별로 묶어서 보여 준다(같은 숫자 겹치기 + 장수 배지). 탭 영역은 48px 이상이다.
- 조작
  - 숫자 묶음을 탭하면 필요한 장수만큼 자동으로 선택된다(따라 내기일 때 기준 장수만큼). +/-로 장수를 조절한다. 광대는 "광대 섞기" 토글로 추가한다.
  - "내기"와 "패스" 큰 버튼을 둔다.
  - 낼 수 있는 숫자 묶음만 밝게 표시하고, 나머지는 흐리게 한다. 광대를 섞어야만 낼 수 있는 묶음은 "광대 필요" 표시를 붙인다.
- 세금 화면: 받은 카드를 강조하고 "돌려줄 카드 2장을 고르세요"를 안내한다. 기본 추천은 가장 큰 숫자 카드다.
- 혁명 확인 화면: 모두에게 "손패 확인" 버튼이 있고, 광대 2장 보유자에게만 "혁명!" 버튼이 추가로 보인다.
- 애니메이션: 신분 바뀔 때 자리 이동, 대혁명 때 자리가 뒤집히는 연출, 세금 카드 이동.
- 초보 도움말: "숫자가 낮을수록 강해요", "앞사람과 같은 장수로만 낼 수 있어요"를 상단 고정 팁으로 둔다(끌 수 있음). "규칙 보기"에 카드 장수 표와 신분 그림을 넣는다.

## 10. 테스트 체크리스트
- [ ] 덱: 80장(숫자 n이 n장, 광대 2장). 6인 분배가 14, 14, 13, 13, 13, 13이고, 앞 신분이 더 받는다.
- [ ] 첫 신분 뽑기: 같은 시드면 같은 결과다. 동점자 재뽑기 후 순서가 확정된다.
- [ ] 세금: 대농노 손패 [광대, 광대, 3, 3, 7…]이고 `jesterTaxable=off`이면 3, 3이 대달무티에게 간다. `on`이면 광대 2장이 간다.
- [ ] 세금 돌려주기: 대달무티가 방금 받은 카드를 돌려줄 수 있다. 장수가 틀리면 거부된다.
- [ ] 혁명: 평민이 광대 2장으로 선언하면 세금 없이 신분 그대로 시작한다. 대농노가 선언하면 순서가 완전히 뒤집히고 새 대달무티가 첫 트릭을 시작한다.
- [ ] 혁명 정보 유출: 광대 2장 보유자가 있든 없든 `revolutionCheck` 단계가 똑같이 생긴다. 다른 사람 view에 `canDeclareRevolution`이 없다.
- [ ] 따라 내기: 9×3 위에 8×2는 거부(장수 다름), 9×3은 거부(같은 숫자), 4 + 4 + 광대는 허용, 광대×2 + 1은 허용(1×3).
- [ ] 광대 단독: 바닥 12×1 위에 광대 1장은 거부된다(13은 12보다 나쁨). 리드로 광대 1장은 허용(13×1)되고, 그 위에 아무 숫자 1장이 허용된다.
- [ ] 트릭 종료: 마지막으로 낸 사람을 뺀 전원이 패스하면 그 사람이 리드한다. 마지막 묶음으로 손패를 턴 경우 다음 사람이 리드한다.
- [ ] `passLocksOut=off`: 패스한 사람이 차례가 다시 오면 낼 수 있다. `on`이면 차례가 건너뛰어진다.
- [ ] 라운드 종료: 1명만 남으면 끝나고 그 사람이 대농노가 된다. 다음 라운드 순서 = 나간 순서.
- [ ] 점수: 5인 3라운드에서 순위 점수 합과 동점 처리(마지막 라운드 순위)가 맞다.
- [ ] 시간 초과: 리드 시간 초과 때 가장 큰 숫자 묶음을 전부 낸다. 따라 내기 시간 초과는 패스다. 세금 돌려주기 시간 초과는 가장 큰 숫자 카드다.
- [ ] 정보 유출: 관전자와 다른 플레이어 view에 남의 손패와 세금 카드 내용이 없다(장수만 있음).
- [ ] 차례가 아닌 `play`, 손에 없는 카드, 중복 패킷은 거부되고 상태가 바뀌지 않는다.

## 11. 참고 자료
- 나무위키 "달무티": https://namu.wiki/w/달무티 (80장 구성, 계급 이름, 신분 뽑기, 세금, 혁명·대혁명, 광대 13/와일드, 1+광대 허용, 9~12 빼기)
- Wikipedia "The Great Dalmuti": https://en.wikipedia.org/wiki/The_Great_Dalmuti (대농노가 덱 전체 분배, 세금, 혁명, 같은 장수 더 낮은 숫자, 승리 조건 없음)

## 12. 메모 (상표·법적 주의 등)
- "The Great Dalmuti"와 "달무티"는 원작사(Wizards of the Coast 등)와 국내 유통사의 상품명이다. 화면과 홍보에는 일반 이름을 쓴다. 후보: "신분 카드 게임", "왕과 농노", "계급 놀이"(사용자 선택).
- 카드 계급 이름(대주교, 남작부인 등)은 원작 고유 표현이다. 상표 우려를 줄이려면 숫자와 일반 이름(1 왕, 2 왕비… 등)으로 바꾸는 것도 고려한다. 일러스트는 직접 만든다.
- "농노" 같은 계급 표현은 게임 설정이므로 문제 없지만, 어린이 방에서는 "꼴찌" 대신 "다음엔 역전!" 같은 부드러운 문구를 쓴다.
- 돈, 칩을 쓰지 않는다. 점수는 방 안 결과 표시용이다.