371 lines
38 KiB
Markdown
371 lines
38 KiB
Markdown
# 루미큐브 (`rummikub`)
|
||
|
||
> 마일스톤: M4 · 인원: 최소 2 ~ 최대 4명 · 예상 시간: 약 30~60분 · 난이도: 보통
|
||
|
||
## 1. 개요
|
||
- 1~13 숫자가 적힌 4색 타일로 "그룹"(같은 숫자, 다른 색)과 "런"(같은 색, 연속 숫자)을 만들어 내려놓는다. 자기 받침대(랙)의 타일을 가장 먼저 다 쓰면 이긴다.
|
||
- 핵심 재미는 테이블 타일 재배치(manipulation)다. 이미 놓인 세트를 쪼개고 합치고 바꿔서 내 타일을 끼워 넣을 수 있다. 한국에서는 가족 보드게임 판매량 상위권이고, 노년층 두뇌 게임으로도 인기가 많다.
|
||
- 인원 근거: 공식 규칙서 기본판 106타일은 2~4명이다. 5~6명은 160타일 확장판(XP)용이라 범위에서 뺀다.
|
||
|
||
## 2. 모드와 옵션
|
||
기본값은 **루미큐브 앱**(Rummikub® 공식 앱) 방식이다(2026-10-14, §13). 종이 규칙서와 다른 점은 옵션으로 고를 수 있다.
|
||
|
||
| 옵션 키 | 설명 | 선택지 | 기본값 |
|
||
|---|---|---|---|
|
||
| `initialMeldPoints` | 첫 등록에 필요한 최소 점수 | 0(없음) / 20 / 30 / 50 | 30 |
|
||
| `turnSeconds` | 턴 제한 시간(공식 1분, 앱은 15초·30초·1분·2분) | 30 / 60 / 90 / 120 / 180 / null(무제한) | 60 |
|
||
| `timeoutValidDraft` | 시간 초과 때 작업 중인 바닥이 올바른 경우 | `revert`(앱·규칙서: 되돌리고 1장) / `commit`(자동 완료) | `revert` |
|
||
| `invalidTimeoutPenalty` | 시간 초과 때 바닥이 틀린 경우 가져오는 장수 | 1(앱) / 3(종이 규칙서) | 1 |
|
||
| `invalidCommitPenalty` | "완료"를 눌렀는데 틀렸을 때 | `reject`(앱: 알려 주고 계속 고치기) / `penalty3`(되돌리고 3장 뽑고 턴 종료) | `reject` |
|
||
| `jokerPenalty` | 랙에 남은 조커 감점 | 30(공식) / 50(대회) | 30 |
|
||
| `initialMeldAllowExtend` | 첫 등록 턴에 기존 테이블 세트에도 붙이기 허용 | on / off(공식) | off |
|
||
| `showDraftToOthers` | 차례인 사람이 옮기는 바닥(끄는 중인 타일 포함)을 모두에게 실시간으로 보이기 | on(앱) / off | on |
|
||
| `gamesPerMatch` | 한 매치의 판 수(앱은 1판, 종이 규칙서는 인원수만큼 판 = 1라운드) | 1 / 인원수 / 2 / 3 / 4 | 1 |
|
||
| `hints` | "낼 수 있는 조합 찾기" 힌트 버튼 | on / off | on |
|
||
|
||
## 3. 구성물
|
||
- 숫자 타일 104개: 4색(검정 K, 빨강 R, 파랑 B, 주황 O) × 숫자 1~13 × 각 2개.
|
||
- 조커 2개. 조커는 어떤 색, 어떤 숫자든 대신할 수 있다.
|
||
- 합계 106개. 타일 ID 규칙 예: `R7a`, `R7b`, `JK1`, `JK2`.
|
||
- 타일 점수: 숫자 타일은 적힌 숫자, 조커는 테이블에서 대신하는 타일의 숫자. 게임 끝에 랙에 남은 조커는 `jokerPenalty`(30점)다.
|
||
|
||
## 4. 준비(셋업)
|
||
1. 106개를 시드 RNG로 섞는다(뒷면 상태의 "풀").
|
||
2. 선 플레이어 정하기(공식): 각자 1개씩 뽑아 숫자가 가장 큰 사람이 선이다. 조커를 뽑거나 최고 숫자가 같으면 그 사람들만 다시 뽑는다. 뽑은 타일은 풀에 돌려놓고 다시 섞는다. 화면에서는 뽑기 애니메이션으로 보여 주고, 엔진에서는 RNG로 같은 절차를 재현한다.
|
||
3. 각자 14개를 받는다.
|
||
4. 남은 타일이 풀이 된다(2인 78개, 3인 64개, 4인 50개).
|
||
5. 진행은 선부터 시계 방향(왼쪽)으로 한다.
|
||
|
||
## 5. 진행 규칙
|
||
|
||
### 5.1 세트(조합) 정의
|
||
- **그룹**: 같은 숫자, 서로 다른 색 3~4개. 예: 빨강7, 파랑7, 검정7. 같은 색이 두 개 들어가면 무효다.
|
||
- **런**: 같은 색, 연속 숫자 3개 이상(최대 13개). 예: 파랑3, 파랑4, 파랑5, 파랑6.
|
||
- 1은 항상 가장 작은 수다. 13 다음에 1이 올 수 없다(12-13-1 불가).
|
||
- 조커는 세트에 필요한 아무 타일이나 대신한다. 한 세트에 조커 2개도 쓸 수 있다. 단 세트에 진짜 타일이 최소 1개 있어야 한다(조커 2개만으로는 3개 세트가 안 되므로 자연히 성립).
|
||
|
||
### 5.2 턴에 할 수 있는 일
|
||
내 차례에는 둘 중 하나를 한다.
|
||
1. **내려놓기(완료)**: 랙에서 타일을 1개 이상 테이블에 내고, 턴이 끝날 때 테이블 전체가 유효한 세트로만 이루어져 있어야 한다.
|
||
2. **뽑기**: 풀에서 1개를 가져오고 턴이 끝난다. 낼 수 있어도 일부러 뽑을 수 있다. 방금 뽑은 타일은 이번 턴에 낼 수 없다(뽑으면 턴이 끝나므로 자연히 성립).
|
||
- 풀이 비어 있으면 "뽑기" 대신 "넘기기"가 된다.
|
||
|
||
### 5.3 첫 등록(initial meld)
|
||
- 아직 첫 등록을 하지 않은 플레이어는 자기 랙의 타일만으로 하나 이상의 새 세트를 만들어 내야 한다. 그 합이 `initialMeldPoints`(30) 이상이어야 한다.
|
||
- 조커는 첫 등록에 쓸 수 있고, 대신하는 타일의 숫자로 계산한다.
|
||
- 첫 등록 턴에는 테이블의 기존 세트를 건드리거나 거기에 붙일 수 없다(공식). `initialMeldAllowExtend = on`이면 30점을 랙 타일만의 새 세트로 채운 뒤라면 같은 턴에 기존 세트에 붙이기와 재배치도 허용한다.
|
||
- 예: 랙 [빨강10, 빨강11, 빨강12] = 33점이면 가능하다. [파랑1, 파랑2, 파랑3] + [검정5, 빨강5, 주황5] = 6 + 15 = 21점이면 불가능하다. [조커, 검정9, 검정10]을 8-9-10으로 쓰면 27점이라 불가능하고, 9-10-11로 쓰면 30점이라 가능하다(5.5 조커 위치 해석 참고).
|
||
|
||
### 5.4 테이블 재배치(첫 등록을 한 뒤부터)
|
||
- 테이블의 어떤 세트든 쪼개고, 합치고, 타일을 옮기고, 끝에서 떼어 내고, 그룹의 4번째 타일을 빼 오는 등 마음대로 바꿀 수 있다.
|
||
- 조건
|
||
- 턴이 끝날 때 테이블의 모든 타일이 유효한 세트에 속해 있어야 한다(남는 낱개 타일 없음).
|
||
- 테이블에 있던 타일은 랙으로 가져갈 수 없다.
|
||
- 이번 턴에 랙에서 최소 1개를 내야 한다(재배치만 하고 끝낼 수 없음).
|
||
- 공식 규칙서 예시
|
||
- 파랑4-5-6에 파랑3 붙이기.
|
||
- 8 그룹(3색)에 남은 색 8 붙이기.
|
||
- 4가 4색인 그룹에서 파랑4를 빼서 랙의 파랑3, 파랑5, 파랑6과 런 만들기.
|
||
- 빨강4-5-6-7-8 런을 랙의 빨강6으로 4-5-6 / 6-7-8로 쪼개기.
|
||
|
||
### 5.5 조커 규칙
|
||
- 조커는 테이블에 놓인 뒤, 같은 역할의 타일로 바꿔 넣으면 회수할 수 있다.
|
||
- 런 안의 조커: 그 자리의 색·숫자 타일로 바꾼다.
|
||
- 3개짜리 그룹의 조커: 빠진 두 색 중 아무 색으로 바꿔도 된다.
|
||
- 회수한 조커는 같은 턴에 테이블에 다시 써야 하고, 랙으로 가져갈 수 없다. 이번 턴에 랙에서 최소 1개를 내야 하는 조건도 그대로다.
|
||
- 첫 등록 전에는 조커를 회수할 수 없다(첫 등록 전에는 재배치 자체가 불가).
|
||
- 엔진 구현 원칙: 조커 회수를 따로 액션으로 두지 않는다(앱에서도 조커를 다른 타일처럼 끌어 옮긴다). "턴 종료 시점의 테이블 전체가 유효하고, 테이블 타일 집합 ⊇ 턴 시작 시점 테이블 타일 집합"만 검사하면 위 조건이 모두 자동으로 지켜진다. 조커가 다른 세트로 옮겨 가도 되고, 런 끝 조커를 떼어 새 세트에 써도 된다(공식 예시 3·4번과 같음).
|
||
- 단순화 메모: 공식 문구는 "회수한 조커는 새 세트를 만드는 데 써야 한다"이지만, 조커를 기존 세트로 옮기는 것도 허용한다. 엄격히 하려면 "턴 시작 때 테이블에 있던 조커는 턴 시작 때와 같은 세트 구성원 집합에 머물 수 없다" 같은 검사가 필요하지만, 실제 대국에서 차이가 거의 없어 기본은 생략한다.
|
||
- **조커 값 해석**(점수·표시용): 서버가 각 세트를 정규화할 때 조커의 색·숫자를 정한다.
|
||
- 런: 클라이언트가 보낸 순서 그대로 유효하면 그 순서를 따른다. 아니면 정렬한 뒤 빈칸을 조커로 채우고, 남는 조커는 위쪽 끝(13 방향)에 먼저 붙이고 불가능하면 아래쪽 끝에 붙인다.
|
||
- 그룹: 숫자는 그룹의 숫자이고 색은 "빠진 색 중 하나"로 표시한다(정해지지 않음).
|
||
- 런과 그룹 둘 다 될 수 있는 세트(예: [빨강5, 조커, 조커])는 클라이언트의 `as` 힌트를 따르고, 힌트가 없으면 런으로 해석한다.
|
||
|
||
### 5.6 칸 판, 작업 중인 바닥(draft)과 되돌리기 (2026-10-14, 앱 방식)
|
||
- 바닥은 앱처럼 **칸 판**(가로 20 × 세로 12칸)이다. 타일은 칸 하나에 하나씩 놓이고, **한 줄에 빈칸 없이 나란히 붙은 타일이 한 묶음**이다. 빈칸 하나가 묶음을 나눈다. 묶음 안의 순서는 왼쪽→오른쪽이고, 조커 해석(§5.5)도 이 순서를 따른다. 20 × 12면 어떤 바닥(106장 + 묶음 사이 빈칸, 13장 런 한 줄)도 들어간다.
|
||
- 타일 위에 놓으면 그 칸부터 그 줄 오른쪽 타일이 놓는 장수만큼 밀려 사이에 끼워진다(줄 끝을 넘으면 놓을 수 없음). 빈 칸에 놓으면 그 자리에 놓이고, 묶음 바로 옆 칸이면 그 묶음에 붙는다.
|
||
- 내 턴 동안 바닥을 바꾸는 것은 서버에 있는 "작업 중인 바닥"(칸 목록)을 바꾸는 것이다. 손을 놓을(drop) 때마다 바닥 전체를 보낸다(`arrange`). [완료]를 누르기 전까지 실제 테이블이 아니다.
|
||
- 작업 중에는 틀려도 된다(낱개 타일, 2장 묶음, 바닥 묶음 옆에 붙인 타일 등). 검증은 [완료]와 시간 초과 때만 한다. 화면은 놓을 때마다 각 묶음을 초록(새로 만들거나 바뀐 올바른 묶음)·빨강 점선(틀림, 이유 표시)으로 보여 준다.
|
||
- **[되돌리기]**는 앱처럼 한 단계가 아니라 **차례 시작 상태로 통째로** 돌린다(앱 사용자 정리: "There are no incremental undos ... it removes everything you did!"). 그래서 단계 기록(history)을 저장하지 않는다(놓을 때마다 스냅숏이 커지지 않게).
|
||
- 재접속해도 작업 중인 바닥은 서버에 남는다.
|
||
- 예전 저장(stateVersion 1: 칸 위치 없는 묶음 목록)은 서버가 불러올 때 `migrate`가 바닥 묶음과 작업 중인 묶음에 칸 위치를 붙인다(되돌리기 기록은 버림). 규칙이 바뀌었으므로 v1 게임의 다시 보기는 열리지 않는다(기존 정책).
|
||
|
||
### 5.7 시간 제한과 벌칙(앱 기본 + 옵션)
|
||
- 턴 제한은 `turnSeconds`(공식 1분)다.
|
||
- 시간 초과 때(앱 기본: [완료]를 누르지 않은 배치는 무조건 처음으로)
|
||
- 바닥이 턴 시작과 같은 묶음이면(자리만 옮긴 것 포함) 1개를 뽑고 턴이 끝난다(풀이 비었으면 넘기기).
|
||
- 바닥이 올바르고 랙 타일이 1개 이상 들어 있어도 기본(`timeoutValidDraft = revert`)은 바닥을 되돌리고 1개를 뽑는다. 앱 리뷰: "even if you've already completed an earlier legal move, your entire turn is reset and you are penalized another tile". `commit`이면 자동으로 완료한다.
|
||
- 바닥이 틀리면 턴 시작 상태로 되돌리고, 낸 타일은 랙으로 돌아오며, `invalidTimeoutPenalty`(기본 1 = 앱, 종이 규칙서 3)개를 뽑고 턴이 끝난다. 1장이면 기록은 "시간 초과", 3장이면 "벌칙"으로 보인다.
|
||
- "완료"를 눌렀는데 틀리면 `invalidCommitPenalty = reject`(기본)일 때 거부만 하고, 틀린 묶음을 빨간색으로 표시한 뒤 계속 고칠 수 있게 한다. 타이머는 계속 간다.
|
||
|
||
### 5.8 풀이 다 떨어졌을 때(공식)
|
||
- 풀이 비어도 누군가 랙을 다 비우거나 더 이상 아무도 낼 수 없을 때까지 계속한다.
|
||
- 엔진 판정: 풀이 빈 상태에서 남아 있는 모든 플레이어가 연속으로 한 번씩 "넘기기"(또는 시간 초과로 내려놓지 못함)를 하면 게임이 끝난다.
|
||
|
||
## 6. 승패와 점수 계산
|
||
- **랙을 비운 경우(공식)**
|
||
- 나머지 플레이어는 각자 랙 타일 숫자 합을 음수로 받는다(조커는 `jokerPenalty`).
|
||
- 승자는 그 합의 절대값을 양수로 받는다. 한 판의 점수 합은 항상 0이다.
|
||
- 예: 4인에서 A가 끝냄. B 랙 [3, 12] = -15, C [조커] = -30, D [1, 1, 13] = -15. A = +60.
|
||
- **풀이 비고 아무도 못 내서 끝난 경우(공식)**
|
||
- 랙 합이 가장 작은 사람이 승자다.
|
||
- 나머지는 (자기 랙 합 - 승자 랙 합)을 음수로 받고, 승자는 그 합의 절대값을 받는다.
|
||
- 예: 랙 합 A=5, B=12, C=30. A 승리. B = -(12-5) = -7, C = -(30-5) = -25, A = +32.
|
||
- 랙 합이 같은 최저자가 여럿이면 랙 타일 수가 적은 사람이 승자다. 그래도 같으면 공동 승자이고, 다른 사람의 음수 합을 공동 승자 수로 나누어 내림한 값을 나눠 갖는다(이 경우 판 합이 0이 아닐 수 있음, 결과 표시용).
|
||
- **여러 판(`gamesPerMatch` > 1)**: 판별 점수를 더한다. 공식 최종 승자 결정은 "판을 가장 많이 이긴 사람"이고, 동률이면 총점이 높은 사람이다.
|
||
- 순위: 1위는 승자, 나머지는 그 판 점수가 높은(감점이 적은) 순이다. 같으면 공동 순위다.
|
||
- 이 점수는 방 안 결과 표시용이고, 돈이나 칩이 아니다.
|
||
|
||
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
|
||
- 첫 등록 점수 변경(`initialMeldPoints`). 어린이용 20점이나 0점(없음), 고수용 50점.
|
||
- 조커 감점 50점(대회 룰, `jokerPenalty`).
|
||
- 첫 등록 턴 추가 재배치 허용(`initialMeldAllowExtend`).
|
||
- 시간 초과 때 유효 초안 자동 확정(`timeoutValidDraft`).
|
||
- 넉넉한 턴 시간(90~180초). 노년층과 어린이 방에 권장한다.
|
||
- 지원하지 않는 변형(문서화만): 13-1 이어 붙이기, 조커 회수를 첫 등록 전에도 허용, 5~6인 확장(160타일).
|
||
|
||
## 8. 엔진 설계
|
||
### 8.1 상태(State)
|
||
```ts
|
||
type TileColor = 'K' | 'R' | 'B' | 'O';
|
||
type Tile =
|
||
| { id: string; kind: 'num'; color: TileColor; n: number } // n: 1..13
|
||
| { id: string; kind: 'joker' };
|
||
|
||
interface TableSet {
|
||
id: string; // 세트 ID(애니메이션 연속성용, 서버가 발급)
|
||
tileIds: string[]; // 정규화된 순서(런은 오름차순)
|
||
kind: 'run' | 'group';
|
||
jokerAs: Record<string, { color: TileColor | null; n: number }>; // 조커 해석(표시·점수용)
|
||
r: number; c: number; // 칸 판 위치: r줄 c칸부터 오른쪽으로 채운다(2026-10-14)
|
||
}
|
||
|
||
interface Cell { id: string; r: number; c: number } // 작업 중인 바닥의 타일 하나(0 ≤ r < 12, 0 ≤ c < 20)
|
||
|
||
interface RummiState {
|
||
options: RummiOptions;
|
||
rng: RngState;
|
||
seats: PlayerId[];
|
||
tiles: Record<string, Tile>; // 전체 타일 정의(불변)
|
||
pool: string[]; // 비공개, 섞인 순서
|
||
racks: Record<PlayerId, string[]>; // 비공개
|
||
table: TableSet[]; // 공개, 확정된 테이블
|
||
hasMelded: Record<PlayerId, boolean>; // 첫 등록 여부(공개)
|
||
current: PlayerId;
|
||
turnStartedAt: number;
|
||
draft: { cells: Cell[]; edits: number }; // 현재 턴의 작업 중인 바닥(칸)과 놓은 횟수. 단계 기록 없음(§5.6)
|
||
consecutivePassesWithEmptyPool: number;
|
||
phase: 'playing' | 'finished';
|
||
endReason: 'rackEmpty' | 'stalemate' | null;
|
||
winnerIds: PlayerId[];
|
||
gameScores: Record<PlayerId, number>; // 이번 판 점수
|
||
match: { gameNo: number; wins: Record<PlayerId, number>; totals: Record<PlayerId, number> };
|
||
seq: number;
|
||
}
|
||
```
|
||
|
||
### 8.2 액션
|
||
| type | payload | 누가 / 언제 | 검증 조건 |
|
||
|---|---|---|---|
|
||
| `arrange` | `{ cells: Cell[], turn }` | `current`, playing | 놓을 때마다 작업 중인 바닥 전체. 보존 검사만 한다(아래 C1~C3). 묶음 유효성은 보지 않는다. 클라이언트는 놓을 때만 보낸다 |
|
||
| `drag` | `{ ids, x, y, turn }` | `current`, playing | **스트림 액션**(`isStreamAction`, 그림 맞히기 획과 같은 길): 끄는 중인 타일의 칸 단위 위치. 상태는 안 바뀌고 공개 이벤트만 모두에게 간다(뷰 재계산 없음, 기록은 묶어서 저장). 아직 바닥에 없는 받침대 타일은 `null`(뒷면)로 가린다. 클라이언트가 0.2초에 1번까지만 보낸다(소켓 한도 초당 20, `act()`의 대기 잠금을 거치지 않는 `socket.send`). 늦게 온 것·남의 것·옵션이 꺼진 방은 오류 없이 버린다. `ids: []` = 놓지 않고 끝남 |
|
||
| `resetDraft` | `{}` | `current` | 언제나 가능(바닥을 턴 시작 상태로, [되돌리기]) |
|
||
| `commit` | `{ cells?, turn }` | `current` | `cells`가 있으면 그 바닥을 보존 검사 후 한 번에 놓고 검증(컴퓨터, 마지막 손놓기와 겹칠 때). 아래 "턴 확정 검증" 통과. 실패하면 `invalidCommitPenalty`에 따름 |
|
||
| `draw` | `{}` | `current` | 초안이 턴 시작과 같거나, 다르면 초안을 버리고 뽑는다(UI에서 확인 대화상자). 풀이 비었으면 `pass`와 같다 |
|
||
| `pass` | `{}` | `current` | 풀이 비었을 때만 |
|
||
|
||
바닥 보존 검사(`arrange`, `commit.cells`)
|
||
- C1: 모든 타일 ID는 (턴 시작 테이블 타일 ∪ 내 랙 타일)에 속하고, 중복이 없고, 칸 판 안에 있고, 한 칸에 하나다.
|
||
- C2: 턴 시작 테이블의 모든 타일이 바닥에 있다(테이블 → 랙 이동 금지, 조커도 마찬가지).
|
||
- C3: 첫 등록 전(`hasMelded=false`)이고 `initialMeldAllowExtend=off`이면, 턴 시작 테이블의 타일은 제자리 칸에서 움직일 수 없다. 그 옆에 랙 타일을 붙이는 것은 작업 중에는 되지만 [완료] 때 "첫 등록 전에는 바닥 묶음에 붙일 수 없어요"로 거부된다(묶음 구성이 턴 시작과 같아야 함).
|
||
- 턴 확정 검증의 묶음 = 칸 판에서 읽은 묶음(`stripsOf`). 확정되면 각 묶음은 그 자리(같은 줄·시작 칸)에 정규화된 순서(런은 오름차순)로 놓인다.
|
||
|
||
턴 확정 검증(`commit`, 시간 초과 판정 공용)
|
||
```ts
|
||
function validateTurn(s: RummiState, p: PlayerId, draft: DraftSet[]): Result {
|
||
// 1) 보존: C1, C2 (위와 동일)
|
||
// 2) 랙에서 1개 이상 냄
|
||
const startTable = new Set(s.table.flatMap(t => t.tileIds));
|
||
const fromRack = draft.flatMap(d => d.tileIds).filter(id => !startTable.has(id));
|
||
if (fromRack.length === 0) return fail('랙에서 타일을 1개 이상 내야 해요');
|
||
// 3) 모든 세트가 유효(normalizeSet이 null이면 무효)
|
||
const normalized = draft.map(d => normalizeSet(d, s.tiles));
|
||
if (normalized.some(n => n === null)) return fail('올바르지 않은 조합이 있어요', { invalidSetIdx });
|
||
// 4) 첫 등록 조건
|
||
if (!s.hasMelded[p]) {
|
||
// 기존 세트는 그대로여야 하고(C3), 새 세트는 랙 타일로만 구성
|
||
const newSets = normalized.filter(n => n.tileIds.every(id => !startTable.has(id)));
|
||
const pts = sum(newSets.map(setPoints)); // 조커는 jokerAs.n
|
||
if (pts < s.options.initialMeldPoints) return fail(`첫 등록은 ${s.options.initialMeldPoints}점 이상이어야 해요 (지금 ${pts}점)`);
|
||
// initialMeldAllowExtend=off 이면: 기존 세트에 랙 타일이 섞인 세트가 없어야 함
|
||
}
|
||
return ok();
|
||
}
|
||
|
||
function normalizeSet(d: DraftSet, tiles): TableSet | null {
|
||
const ts = d.tileIds.map(id => tiles[id]);
|
||
if (ts.length < 3) return null;
|
||
const nums = ts.filter(t => t.kind === 'num');
|
||
const jokers = ts.length - nums.length;
|
||
const asGroup = () => {
|
||
if (ts.length > 4) return null;
|
||
if (new Set(nums.map(t => t.n)).size !== 1) return null;
|
||
if (new Set(nums.map(t => t.color)).size !== nums.length) return null; // 색 중복 금지
|
||
return /* kind:'group', jokerAs: {n, color:null} */;
|
||
};
|
||
const asRun = () => {
|
||
if (ts.length > 13) return null;
|
||
if (new Set(nums.map(t => t.color)).size !== 1) return null;
|
||
// (a) 클라이언트 순서 그대로 검사: 첫 숫자 타일의 index i, 값 v → start = v - i
|
||
// 모든 숫자 타일 k에 대해 n == start + k, 1 <= start, start+len-1 <= 13 이면 그 순서 채택
|
||
// (b) 아니면 정렬: 숫자 중복이면 null. span = max-min+1. gaps = span - nums.length
|
||
// gaps > jokers 면 null. extra = jokers - gaps.
|
||
// 위쪽으로 min(extra, 13-max)개, 나머지는 아래쪽(min-1 이상 남아야 함). 불가능하면 null
|
||
return /* kind:'run', 오름차순 tileIds, jokerAs 각 위치 값 */;
|
||
};
|
||
const g = asGroup(), r = asRun();
|
||
if (g && r) return d.as === 'group' ? g : r;
|
||
return g ?? r;
|
||
}
|
||
```
|
||
- 계산량: 테이블은 최대 106타일이고 세트 하나마다 O(k log k)이므로 매 검증이 1ms 미만이다.
|
||
|
||
`commit` 성공 시 적용
|
||
- `table = normalized`(세트 ID는 기존 세트와 타일이 가장 많이 겹치는 것을 이어받아 애니메이션을 자연스럽게 한다).
|
||
- 랙에서 `fromRack`을 뺀다. 첫 등록이면 `hasMelded = true`로 바꾼다. `consecutivePassesWithEmptyPool = 0`.
|
||
- 랙이 비면 게임 종료(`rackEmpty`). 아니면 다음 플레이어로 넘긴다.
|
||
|
||
`reason` 예: "첫 등록은 30점 이상이어야 해요 (지금 21점)", "첫 등록 전에는 테이블의 타일을 옮길 수 없어요", "테이블의 타일은 내 받침대로 가져올 수 없어요", "빨간 표시된 조합을 고쳐 주세요".
|
||
|
||
### 8.3 공개/비공개 정보 (view)
|
||
- 모두 공개(관전자 포함): 확정 테이블(`table`), 각 플레이어 랙 타일 수, 첫 등록 여부, 풀 남은 수, 현재 턴, 마감 시각, 매치 점수.
|
||
- 본인만: 자기 랙 타일 전체.
|
||
- 작업 중인 바닥(`draft: { cells, groups }`)
|
||
- 현재 턴 플레이어는 자기 바닥 전체와 각 묶음의 유효 여부(초록/빨강, 이유), 현재 첫 등록 점수 합계를 본다.
|
||
- 다른 사람과 관전자는 `showDraftToOthers = on`(기본, 앱처럼)이면 놓을 때마다 바닥 전체를 받고, 끄는 중인 타일은 `drag` 스트림 이벤트로 본다(받침대에서 아직 안 내려놓은 타일은 뒷면). 바닥에 올린 랙 타일이 보이는 것은 실제 게임과 같다. 되돌려도 이미 본 정보는 남는다는 점을 옵션 설명에 적는다. `off`면 "생각 중" 표시와 놓은 횟수만 받는다.
|
||
- `secretsOf`(누출 검사)는 바닥에 올린 타일을 그 사람의 숨은 타일에서 뺀다.
|
||
- 절대 보내지 않는 것: 풀 순서, 남의 랙, RNG 상태. 뽑기 이벤트는 본인에게만 타일 내용을 주고, 다른 사람에게는 "1개 뽑음"만 준다. 시간 초과 벌칙으로 되돌아간 타일 목록도 본인에게만 준다.
|
||
|
||
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
|
||
- `setup`: 선 정하기 시뮬레이션(뽑기와 재뽑기), 106타일 섞기, 분배.
|
||
- 매치의 다음 판 `setup`: 새로 섞고 선을 다시 정한다(공식).
|
||
- 그 외 진행 중에는 RNG를 쓰지 않는다(뽑기는 섞인 풀의 앞에서부터).
|
||
|
||
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
|
||
- `deadline = turnStartedAt + turnSeconds*1000`. `turnSeconds = null`(무제한)이면 차례 마감이 없고 타이머도 안 보인다(`turnMs = 0`). 연결이 끊기면 방의 유예 시간 뒤 서버가 `timeout`을 보내는 처리는 그대로이고, 3번 연속 넘어간 자리 비움 사람에게는 무제한이어도 짧은 마감(3초)이 붙는다. 판 사이 준비 30초는 차례 시간이 아니라서 그대로다.
|
||
- `onTimeout(state, p)`는 내부 액션 `timeout`을 돌려준다. `apply`에서 5.7의 규칙대로 처리한다.
|
||
- 초안 변경 없음 → 1개 뽑기 또는 넘기기.
|
||
- 유효 초안 → `commit` 또는 되돌리고 1개 뽑기.
|
||
- 무효 초안 → 되돌리고 `invalidTimeoutPenalty`개 뽑기(풀에 남은 만큼만).
|
||
- 연결이 끊겨도 작업 중인 바닥은 서버에 남는다. 다시 들어오면 그대로 이어서 한다. 타이머는 멈추지 않는다.
|
||
- 끊긴 플레이어가 계속 돌아오지 않으면(서버 정책: 연속 3턴 타임아웃) 이후 그 플레이어의 턴은 즉시 `draw`로 처리한다. 엔진은 `deadline`을 짧게 돌려주기만 하면 된다.
|
||
|
||
### 8.6 종료 조건과 결과(GameResult)
|
||
- 누군가 `commit`으로 랙을 비움 → `rackEmpty`.
|
||
- 풀이 빈 상태에서 연속 넘기기 수가 진행 인원 수에 도달 → `stalemate`.
|
||
```ts
|
||
interface GameResult {
|
||
ranking: { player: PlayerId; rank: number; score: number; rackValue: number; tilesLeft: number }[];
|
||
winner: PlayerId[];
|
||
endReason: 'rackEmpty' | 'stalemate';
|
||
match?: { gameNo: number; wins: Record<PlayerId, number>; totals: Record<PlayerId, number>; finished: boolean };
|
||
summary: string; // "영희 님이 타일을 모두 내려놓았어요! (+60점)"
|
||
}
|
||
```
|
||
|
||
## 9. UI/UX
|
||
- 모바일 세로 화면
|
||
- 위: 상대 정보(이름, 남은 타일 수, 첫 등록 표시, 타이머 링).
|
||
- 가운데: 칸 판 테이블(§5.6). 화면 폭에 맞추되 좁은 화면은 칸을 키워(1.5~2배) 가로·세로로 스크롤한다. 머리줄의 [-]/[+]로 크기를 바꾼다(기기에 저장). 내 차례에는 칸 선이 보인다. 줄은 최소 6줄, 가장 아래 타일 밑으로 한 줄 더 보인다(최대 12줄).
|
||
- 아래: 내 랙. 타일 44×60px이고 탭 영역은 48px 이상.
|
||
- 하단 고정 버튼: [되돌리기] [도와줘 / 받침대로] [새 묶음] [한 장 가져오기 / 넘기기] [완료]. 정렬 [색깔순 | 숫자순]은 받침대 위.
|
||
- PC: 테이블이 넓고 랙은 아래 1~2줄이다.
|
||
- 조작(2026-10-14, 앱 방식) — 마우스·터치 모두 포인터 이벤트
|
||
- 끌어다 놓기: 랙 → 바닥 아무 칸, 바닥 → 바닥(쪼개기·합치기·끼우기), 바닥에서 내가 이번 차례에 낸 타일 → 랙. 6px 넘게 움직이면 끌기, 그보다 짧으면 탭(고르기)이다. 고른 타일 중 하나를 끌면 고른 타일이 한 줄로 같이 움직인다. 놓을 곳은 노란 점선 칸으로 미리 보인다. 타일에는 `touch-action: none`을 줘서 휴대폰에서 끌 때 화면이 같이 밀리지 않게 하고, 빈 바닥을 밀면 스크롤된다.
|
||
- 탭 방식: 타일을 눌러 고르고 바닥의 빈 칸을 누르면 거기에 놓인다. [새 묶음]은 빈 곳에 따로 놓고, [받침대로]는 고른 타일 중 내가 낸 것을 받침대로 돌린다. 드래그가 어려운 노년층을 위한 방식이고, 둘 다 지원한다.
|
||
- 바닥 타일을 두 번 누르면 그 묶음을 통째로 고른다(앱의 "길게 눌러 묶음 끌기" 대신).
|
||
- 첫 등록 전에는 바닥 타일을 집을 수 없고, 바닥 묶음을 밀어내는 곳에도 놓을 수 없다(안내 문구).
|
||
- 다른 사람 화면: 차례인 사람이 놓을 때마다 타일이 칸 사이를 미끄러져 움직이고(CSS left/top 전환), 끄는 중인 타일은 반투명 그림자 줄로 0.2초마다 따라 움직인다. 손을 놓으면 그 타일이 그림자 자리에서 칸으로 들어간다. 미리 보기가 없던 타일(컴퓨터, 옵션 끔)은 그 사람 칸에서 날아온다.
|
||
- 자동 정렬
|
||
- "색별": 색(검정·빨강·파랑·주황) 다음 숫자 순.
|
||
- "숫자별": 숫자 다음 색 순. 조커는 맨 끝.
|
||
- 랙 배치 순서는 클라이언트 로컬 상태이고, 서버는 순서를 저장하지 않는다.
|
||
- 실시간 검증 표시: 새로 만들거나 바뀐 묶음에 초록 테두리(올바름), 틀린 묶음에 빨강 점선 테두리와 짧은 이유("같은 색이 두 개예요")를 묶음 위에 보여 준다. 그대로인 바닥 묶음은 테두리가 없다. 첫 등록 전에는 "첫 등록: 21 / 30점" 진행 막대를 보여 준다.
|
||
- "완료" 버튼은 바닥이 올바를 때만 강조색으로 바뀐다(틀렸을 때도 누를 수는 있고, 누르면 이유를 보여 주고 바닥이 흔들린다).
|
||
- 힌트(`hints`): "도와줘" 버튼을 누르면 랙에서 바로 낼 수 있는 새 세트 1개를 하이라이트한다. 재배치 탐색은 하지 않는다(계산량 제한). 클라이언트에서 자기 랙 정보만으로 계산하므로 서버 비공개 정보가 필요 없다.
|
||
- 애니메이션: 타일 이동 200ms, 세트 확정 때 반짝임, 다른 사람의 확정 때 바뀐 세트를 1초 동안 강조해서 무엇이 바뀌었는지 보이게 한다.
|
||
- 색 구분: 숫자 아래에 색별 모양(검정 ●, 빨강 ♥, 파랑 ◆, 주황 ★)을 넣어 색약 사용자도 구별할 수 있게 한다.
|
||
- 초보 도움말: 그룹과 런 그림 예시, 재배치 예시 애니메이션 4종(공식 규칙서의 예와 같은 상황).
|
||
|
||
### 9.1 소리·움직임
|
||
소리는 모두 화면 안에서 합성한다(플라스틱 타일 "딱" 소리 = 짧은 잡음 + 높은 음). 상대·컴퓨터의 행동은 화면 정보가 바뀔 때 울리고, 처음 들어왔을 때·다시 접속했을 때는 울리지 않는다. 내 타일 옮기기처럼 서버에 보이지 않는 조작만 누르는 순간 울린다.
|
||
- 타일 고르기·집기: 가벼운 "틱". 바닥·받침대에 놓기: "딱". 되돌리기: 휙.
|
||
- 타일 옮기기(내 화면): 끌던 타일은 손을 놓은 자리에서, 눌러 옮긴 타일은 원래 자리(받침대·다른 칸)에서 칸으로 미끄러져 들어간다(`flyFrom`). 바닥 안에서 밀린 타일은 칸 사이를 미끄러진다.
|
||
- 확정(누구든): 놓은 장수만큼 "딱딱딱"(최대 5번). 내 확정이면 성공음이 더해진다. 다른 사람이 바닥에 새로 놓은 타일은 끌던 그림자 자리(미리 보기가 없으면 그 사람 칸)에서 날아오고, 바뀐 묶음은 노랗게 반짝인다.
|
||
- 첫 등록: 성공음 + 배너("첫 등록!", 아래에 누가 했는지).
|
||
- 틀린 확정(서버가 받아 주지 않을 때): 실패음 + 바닥이 흔들린다(anim-shake).
|
||
- 한 장 가져오기(누구든): 미끄러지는 소리 뒤에 "딱". 내가 가져온 타일은 "남은 타일"에서 받침대로 날아오고, 다른 사람이 가져가면 뒤집힌 타일이 그 사람 칸으로 날아간다(`flyGhost`).
|
||
- 벌칙(3장 등): 실패음 + 장수만큼 가져오는 소리와 날아가는 타일. 내 벌칙이면 받침대가 흔들리고 배너("벌칙! 3장"), 다른 사람이면 그 사람 칸이 흔들린다.
|
||
- 넘기기: 휙. 다른 사람이 자기 차례에 타일을 옮기는 중이면 아주 작은 "딱".
|
||
- 새 판: 섞는 소리 + 나눠 주는 소리, 받침대 14장이 차례로 날아온다.
|
||
- 다 냈다: 큰 배너 "루미큐브!"(누가 다 냈는지)와 그 사람 칸이 통 튄다. 다음 판이 남아 있으면 팡파르. 더 낼 사람이 없어 끝나면 "판 끝" 배너. 게임이 끝나면 이어서 승리 배너("승리!" / "○○님 승리"). 게임 전체의 승리·패배음은 방 화면이 낸다. 배너는 공통 `useBanner`.
|
||
- 내 차례: 기존 차례 알림음. 지금 차례인 사람 칸은 은은하게 빛난다(anim-glow). 남은 타일 수·사람별 타일 수가 바뀌면 숫자가 통 튄다(anim-bump).
|
||
|
||
## 10. 테스트 체크리스트
|
||
- [ ] 셋업: 106타일(숫자 104 + 조커 2), 각자 14개, 풀 크기(2인 78 / 3인 64 / 4인 50). 같은 시드면 같은 결과다.
|
||
- [ ] 세트 판정: [빨강12, 빨강13, 빨강1]은 무효. [파랑5, 빨강5, 파랑5]는 무효(색 중복). 5개짜리 그룹은 무효. [빨강1, 빨강2]는 무효(2개).
|
||
- [ ] 조커 해석: [조커, 검정9, 검정10]을 이 순서로 보내면 8-9-10(27점)이라 첫 등록이 거부된다. [검정9, 검정10, 조커]로 보내면 9-10-11(30점)이라 허용된다.
|
||
- [ ] [빨강12, 빨강13, 조커]는 위쪽으로 붙일 수 없으므로 11-12-13으로 해석된다(유효).
|
||
- [ ] 첫 등록 전 플레이어가 테이블 세트 옆에 랙 타일을 붙이면 완료가 거부된다. 테이블 타일을 옮기는(쪼개는) `arrange`는 C3에서 거부된다.
|
||
- [ ] 재배치: 테이블 [빨강4..8] + 랙 빨강6 → [빨강4,5,6] [빨강6,7,8] 확정이 성공한다.
|
||
- [ ] 조커 회수: 테이블 [파랑5, 조커, 파랑7] + 랙 [파랑6, 검정3, 빨강3] → [파랑5,6,7] [검정3, 빨강3, 조커] 성공. 조커가 테이블에서 사라지는(랙으로 가는) 바닥은 C2로 거부된다. 첫 등록 전에는 조커를 옮길 수 없다.
|
||
- [ ] 랙 타일 없이 재배치만 하고 `commit`하면 "랙에서 타일을 1개 이상 내야 해요"로 거부된다.
|
||
- [ ] 시간 초과(앱 기본): 올바른 바닥도, 틀린 바닥도 턴 시작 상태로 복구되고 랙도 원래대로 돌아온 뒤 1개를 뽑는다. 자리만 옮긴 것은 벌칙 없이 1개.
|
||
- [ ] 시간 초과(규칙서 옵션): 틀린 바닥이면 3개, 풀에 2개만 있으면 2개만 뽑는다. `commit` 옵션이면 올바른 바닥은 자동 완료된다.
|
||
- [ ] 되돌리기: `arrange` 여러 번 뒤 `resetDraft` → 턴 시작 상태. 재접속해도 작업 중인 바닥이 유지된다.
|
||
- [ ] 칸 판: 나란히 붙은 타일이 한 묶음, 빈칸으로 나뉨. 타일 위에 놓으면 오른쪽이 밀림, 줄 끝을 넘으면 거부. 한 칸에 두 장·판 밖·남의 타일은 거부. 확정된 묶음끼리는 칸 판에서 붙지 않는다(무작위 대국 불변식).
|
||
- [ ] 모두에게 보이기: 기본 옵션에서 상대·관전자 view에 바닥에 올린 타일만 있고 랙의 나머지는 없다. `drag` 이벤트는 바닥에 없는 랙 타일을 `null`로 가리고 상태를 바꾸지 않는다.
|
||
- [ ] 예전 저장(v1)을 `migrate`하면 칸 위치가 붙고 이어서 둘 수 있다.
|
||
- [ ] 점수: 4인 예시(B -15, C 조커 -30, D -15, A +60). 교착 종료 예시(A +32, B -7, C -25).
|
||
- [ ] 교착 종료: 풀이 빈 3인 게임에서 3명이 연속 넘기면 종료된다. 중간에 누가 `commit`하면 카운트가 0으로 초기화된다.
|
||
- [ ] 정보 유출: 관전자와 상대 view에 남의 랙 타일 ID·숫자, 풀 내용이 없다. `showDraftToOthers=off`이면 초안 타일도 없다. 뽑기 이벤트에 타일 내용이 본인에게만 있다.
|
||
- [ ] 동시성: 같은 `commit` 패킷이 두 번 오면 두 번째는 "차례가 아니에요"로 거부된다. 턴이 넘어간 뒤 도착한 이전 턴 `arrange`도 거부된다.
|
||
|
||
## 11. 참고 자료
|
||
- Rummikub 공식 영문 규칙서(2600-English): https://rummikub.com/wp-content/uploads/2019/12/2600-English-1.pdf (106타일, 14개 분배, 첫 등록 30점, 조커 회수, 1분 제한, 미완성 시 3개 벌칙, 풀 소진 처리, 점수 계산, 조커 30점)
|
||
- Wikipedia "Rummikub": https://en.wikipedia.org/wiki/Rummikub
|
||
- 나무위키 "루미큐브": https://namu.wiki/w/루미큐브 (조커 감점 30점 공식 / 50점 대회 룰, 2~4명)
|
||
- 루미큐브 앱 (§13): App Store 설명 https://apps.apple.com/us/app/rummikub/id1015322991 (턴 시간·상대 수 설정, 연습 게임), App Store 리뷰 https://apps.apple.com/us/app/rummikub/id973113361?see-all=reviews&platform=iphone (Undo = 차례 전체 되돌리기, 시간 초과 = 차례 전체 되돌리고 1장, 묶음 끌기), 앱 사용자 정리 https://game-solver.com/rummikub-2/ (턴 시간 무제한(컴퓨터 상대)·15초·30초·1분·2분, 단계 되돌리기 없음)
|
||
|
||
## 12. 메모 (상표·법적 주의 등)
|
||
- **표시 이름(2026-10-06 확정)**: 친구끼리 쓰는 사이트라 원래 이름 "루미큐브"으로 표시한다(`13-decisions.md` 0절). 아래 상표 메모는 공개 서비스로 바꿀 때를 위한 참고로 남긴다.
|
||
- "Rummikub"와 "루미큐브"는 M&M Ventures(Kodkod)의 등록 상표다. 국내 유통사도 있다. 화면, 방 목록, 도메인, 홍보에 상표명과 로고를 쓰지 않는다.
|
||
- 표시 이름 후보(사용자가 선택): "숫자 타일", "숫자 맞추기 타일", "타일 놀이", "숫자 줄 세우기".
|
||
- 문서와 코드 ID(`rummikub`)는 내부용이다. 외부 노출이 걱정되면 `number-tiles` 같은 중립 ID로 바꾸는 것을 검토한다.
|
||
- 승리 시 "루미큐브!" 외침 대신 "다 냈다!" 같은 일반 문구를 쓴다.
|
||
- 타일 디자인(둥근 숫자, 웃는 얼굴 조커 등 원작 고유 그래픽)을 따라 하지 않는다. 게임 규칙 자체는 저작권 보호 대상이 아니지만 규칙서 문장과 그림은 보호 대상이므로 직접 작성한다.
|
||
- 돈, 칩을 쓰지 않는다. 점수는 방 안 결과 표시용이다.
|
||
|
||
## 13. 루미큐브 앱 규칙 조사 (2026-10-14)
|
||
사용자 요청: "루미큐브 규칙 루미큐브 앱 규칙으로 변경", "드래그해서 화면에 놔두고 합치는 방식(루미큐브 앱처럼)으로 변경 — 모두한테 보이게 설정". 앱 안의 규칙 화면은 공개 문서가 없어서 공식 규칙서·앱 스토어 설명·앱 리뷰·사용자 정리를 같이 봤다.
|
||
|
||
| 항목 | 종이 규칙서(2600-English) | 앱 | 이 사이트(기본) |
|
||
|---|---|---|---|
|
||
| 타일·분배 | 106장(조커 2), 14장 | 같음 | 같음(그대로) |
|
||
| 첫 등록 | 랙 타일만으로 30점 이상, 조커는 대신하는 숫자 | 같음 | 같음(그대로) |
|
||
| 바닥 조작 | 묶음 쪼개기·합치기 | 칸 판에 끌어다 놓기, 나란히 붙으면 한 묶음 | **칸 판 끌어다 놓기**(§5.6) |
|
||
| 되돌리기 | — | 차례 전체만 되돌림("no incremental undos") | **[되돌리기] = 차례 처음으로**(예전 한 단계 되돌리기·처음으로 두 버튼을 하나로) |
|
||
| 턴 시간 | 1분 | 15초·30초·1분·2분(컴퓨터 상대 무제한) | 1분 기본, **30초 추가**, 90·120·180초·무제한 유지 |
|
||
| 시간 초과(아무것도 안 함) | 1장 | 1장 | 1장(그대로) |
|
||
| 시간 초과(올바르게 놓아 둠) | 완료 전이면 미완성 | 차례 전체 되돌리고 1장("your entire turn is reset and you are penalized another tile") | **되돌리고 1장**(예전 기본 "자동 확정"은 옵션) |
|
||
| 시간 초과(틀린 바닥) | 되돌리고 3장 | 되돌리고 1장(같은 리뷰) | **1장**(예전 기본 3장은 옵션) |
|
||
| 틀린 채로 완료 | — | 완료가 안 됨 | 알려 주고 계속 고치기(그대로) |
|
||
| 조커 회수 | 첫 등록 뒤, 같은 차례에 다시 써야 함 | 같음(조커도 끌어 옮김) | 같음(그대로). 바닥 타일은 받침대로 못 가져오므로 자동으로 지켜짐 |
|
||
| 풀이 비었을 때 | 아무도 못 낼 때까지 | 같음 | 같음(그대로) |
|
||
| 점수 | 남은 타일 합, 조커 30 | 같음 | 같음(그대로) |
|
||
| 판 수 | 인원수만큼(1라운드) | 한 판씩(토너먼트 별도) | 1판(그대로) |
|
||
| 상대의 조작 보기 | 테이블에서 다 보임 | 상대가 옮기는 타일이 보임 | **기본 켬**(예전 기본 끔) + 끄는 중인 타일 미리 보기 |
|
||
|
||
- 확실하지 않은 점: 앱의 "틀린 바닥 시간 초과" 장수는 리뷰 문장("penalized another tile")으로만 확인했다(공식 앱 도움말 비공개). 그래서 종이 규칙서의 3장을 옵션으로 남겼다. 앱 칸 판의 정확한 크기는 확인하지 못해 20 × 12로 정했다(13장 런 + 106장이 다 들어가는 크기).
|
||
- 옵션은 새로 만들지 않고 기존 옵션의 기본값만 바꿨다(`timeoutValidDraft` commit→revert, `invalidTimeoutPenalty` 3→1, `showDraftToOthers` off→on). `turnSeconds`에 30을 더했다.
|