38 KiB
38 KiB
루미큐브 (rummikub)
마일스톤: M4 · 인원: 최소 2 ~ 최대 4명 · 예상 시간: 약 30~60분 · 난이도: 보통
1. 개요
- 1~13 숫자가 적힌 4색 타일로 "그룹"(같은 숫자, 다른 색)과 "런"(같은 색, 연속 숫자)을 만들어 내려놓는다. 자기 받침대(랙)의 타일을 가장 먼저 다 쓰면 이긴다.
- 핵심 재미는 테이블 타일 재배치(manipulation)다. 이미 놓인 세트를 쪼개고 합치고 바꿔서 내 타일을 끼워 넣을 수 있다. 한국에서는 가족 보드게임 판매량 상위권이고, 노년층 두뇌 게임으로도 인기가 많다.
- 인원 근거: 공식 규칙서 기본판 106타일은 2
4명이다. 56명은 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. 준비(셋업)
- 106개를 시드 RNG로 섞는다(뒷면 상태의 "풀").
- 선 플레이어 정하기(공식): 각자 1개씩 뽑아 숫자가 가장 큰 사람이 선이다. 조커를 뽑거나 최고 숫자가 같으면 그 사람들만 다시 뽑는다. 뽑은 타일은 풀에 돌려놓고 다시 섞는다. 화면에서는 뽑기 애니메이션으로 보여 주고, 엔진에서는 RNG로 같은 절차를 재현한다.
- 각자 14개를 받는다.
- 남은 타일이 풀이 된다(2인 78개, 3인 64개, 4인 50개).
- 진행은 선부터 시계 방향(왼쪽)으로 한다.
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개를 가져오고 턴이 끝난다. 낼 수 있어도 일부러 뽑을 수 있다. 방금 뽑은 타일은 이번 턴에 낼 수 없다(뽑으면 턴이 끝나므로 자연히 성립).
- 풀이 비어 있으면 "뽑기" 대신 "넘기기"가 된다.
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)
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, 시간 초과 판정 공용)
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.
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초마다 따라 움직인다. 손을 놓으면 그 타일이 그림자 자리에서 칸으로 들어간다. 미리 보기가 없던 타일(컴퓨터, 옵션 끔)은 그 사람 칸에서 날아온다.
- 끌어다 놓기: 랙 → 바닥 아무 칸, 바닥 → 바닥(쪼개기·합치기·끼우기), 바닥에서 내가 이번 차례에 낸 타일 → 랙. 6px 넘게 움직이면 끌기, 그보다 짧으면 탭(고르기)이다. 고른 타일 중 하나를 끌면 고른 타일이 한 줄로 같이 움직인다. 놓을 곳은 노란 점선 칸으로 미리 보인다. 타일에는
- 자동 정렬
- "색별": 색(검정·빨강·파랑·주황) 다음 숫자 순.
- "숫자별": 숫자 다음 색 순. 조커는 맨 끝.
- 랙 배치 순서는 클라이언트 로컬 상태이고, 서버는 순서를 저장하지 않는다.
- 실시간 검증 표시: 새로 만들거나 바뀐 묶음에 초록 테두리(올바름), 틀린 묶음에 빨강 점선 테두리와 짧은 이유("같은 색이 두 개예요")를 묶음 위에 보여 준다. 그대로인 바닥 묶음은 테두리가 없다. 첫 등록 전에는 "첫 등록: 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.md0절). 아래 상표 메모는 공개 서비스로 바꿀 때를 위한 참고로 남긴다. - "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장이 다 들어가는 크기).
- 옵션은 새로 만들지 않고 기존 옵션의 기본값만 바꿨다(
timeoutValidDraftcommit→revert,invalidTimeoutPenalty3→1,showDraftToOthersoff→on).turnSeconds에 30을 더했다.