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

32 KiB
Raw Blame History

윷놀이 (yut)

마일스톤: M4 · 인원: 최소 2 ~ 최대 4명(개인전), 팀전 4·6·8명(2팀) · 예상 시간: 약 15~25분 · 난이도: 쉬움

1. 개요

  • 윷가락 4개를 던져 나온 결과(도·개·걸·윷·모, 빽도)만큼 말을 움직여, 자기 말을 모두 먼저 판 밖으로 내보내면(날) 이기는 한국 전통 놀이. 설날·명절에 남녀노소가 함께 하는 가장 대중적인 놀이로, 규칙 설명 없이도 대부분의 한국인이 안다. 그만큼 "우리 집 규칙"이 다양하므로 기본값을 정하고 나머지는 옵션으로 연다.
  • 인원 근거: 전통 윷놀이는 2명이 겨루거나, 여러 명이 두 편으로 나뉘어(인원 제한 없음) 한다. 개인전은 화면·말 색 구분이 가능한 4명까지, 팀전은 2팀 × 최대 4명(총 8명)으로 제한한다. minPlayers = 2, maxPlayers = 8이며 개인전 5명 이상은 옵션 검증에서 막는다.

2. 모드와 옵션

증강 윷놀이(augmented, augChaos, augRounds, augOffers, augOff)는 yut-augmented.md에 따로 정리했다.

옵션 키 설명 선택지 기본값
mode 개인전 / 팀전 individual(2~4명), team(4·6·8명, 2팀) individual
pieces 한 편(개인 또는 팀)이 가진 말 수 2, 3, 4, 5 4
stickModel 윷가락 확률 모델 realistic(가락 하나가 평평한 면(배)이 위로 갈 확률 0.6), fair(0.5) realistic
backdo 빽도 사용 여부(표시된 가락 하나만 배가 위면 1칸 뒤로) true, false(빽도 결과를 그냥 도로 처리) true
backdoFromDo "도" 자리(첫 칸)에 있는 말이 빽도를 받으면 chammeogi(참먹이로 가서 한 바퀴 돈 것으로 침), finish(즉시 남) chammeogi
finishRule 날(완주) 판정 pass(참먹이를 지나야 남, 참먹이에 멈추면 아직 안 남), reach(참먹이에 도착만 해도 남) pass
nakPercent 낙(윷가락이 판 밖으로 떨어짐) 확률. 0이면 낙 없음 0, 3, 5, 10 0
backdoCaptureBonus 빽도로 잡아도 한 번 더 던지기를 주는지 true, false true
ranking 3~4명 개인전에서 1등이 나온 뒤 first(1등 나오면 종료, 나머지는 진행도로 순위), all(꼴찌가 정해질 때까지 계속) first
backdoNoPiece 지역 룰: 판에 내 말이 없을 때 빽도가 나오면 (7장) discard(쓸 곳이 없어 버림), rethrow(없던 걸로 하고 다시 던짐), enter(새 말이 참먹이 한 칸 뒤 날윷(19)에 올라감) discard
nakRule 지역 룰: 낙이 나오면 (nakPercent > 0일 때만) keep(그 던지기만 무효, 모아 둔 결과 유지), lose(차례 끝, 이번 차례에 모아 둔 결과도 모두 버림) keep
useOrder 지역 룰: 모아 둔 결과를 쓰는 순서 free(원하는 순서로), thrown(던진 순서대로) free
stacking 지역 룰: 내 말이 있는 자리에 멈추면 always(무조건 업음), choose(업을지 따로 둘지 고름) always
forkRule 지역 룰: 모서리(모·뒷모)·방에 멈췄다가 출발할 때 shortcut(늘 지름길, 방에서는 참먹이 쪽), choose(지름길과 다른 길 중 고름) shortcut
turnSeconds 행동(던지기·말 고르기) 1회당 제한 시간 15, 30, 60, null(무제한, 끊김 처리만) 30

옵션 검증(zod superRefine):

  • mode = individual이면 인원 2~4명.
  • mode = team이면 인원 4, 6, 8명(짝수). 좌석 순서대로 0,2,4,6번 자리가 청팀, 1,3,5,7번 자리가 홍팀. 방장이 시작 전 좌석을 바꿔 팀을 조정한다.
  • 2명은 individual만 허용(1:1).

3. 구성물

  • 윷판 1개: 29개 자리(바깥 20 + 대각선 안쪽 9). 정확한 그래프는 5장 참조.
  • 윷가락 4개: 한쪽은 평평한 면(배), 반대쪽은 둥근 면(등). 그중 1개에 빽도 표시(X).
  • 말: 편마다 pieces개(기본 4개), 편마다 다른 색. 팀전은 팀당 한 세트.

4. 준비(셋업)

  1. 편 구성: 개인전은 각자 1편, 팀전은 2편(청팀·홍팀).
  2. 모든 말은 "대기"(판 밖, 아직 출발 안 함) 상태로 시작.
  3. 선 정하기: RNG로 첫 차례 편을 정한다(전통의 "윷 던져 높은 쪽이 선"을 대신함). 개인전 차례는 좌석 시계 방향. 팀전은 청1 → 홍1 → 청2 → 홍2 … 순으로 팀이 번갈아 가며, 팀 안에서는 좌석 순으로 돌아간다(그 팀의 다음 차례 사람이 던지고 말도 고른다).
  4. RNG 상태를 State에 저장한다.

5. 진행 규칙

5.1 윷 던지기 결과

윷가락 4개를 각각 독립적으로 던진다. 각 가락이 배(평평한 면)가 위로 나올 확률을 p라 한다(realistic 0.6, fair 0.5).

결과 조건(배가 위인 가락 수) 이동 한 번 더 realistic(p=0.6) fair(p=0.5)
도 1개(표시 가락이 아닌 것) 앞으로 1 아니오 0.1152 0.1875
빽도 1개이고 그것이 표시 가락 뒤로 1 아니오 0.0384 0.0625
개 2개 앞으로 2 아니오 0.3456 0.375
걸 3개 앞으로 3 아니오 0.3456 0.25
윷 4개 앞으로 4 예 0.1296 0.0625
모 0개(모두 등) 앞으로 5 예 0.0256 0.0625
  • 계산식: 배 k개일 확률 = C(4,k)·p^k·(1−p)^(4−k). 빽도 = p·(1−p)^3, 도 = 3·p·(1−p)^3.
  • backdo = false이면 빽도 조건도 그냥 "도"로 처리한다(표시 가락 무시).
  • realistic의 0.6은 나무위키에 소개된 실제 윷 단면 모델(배가 위로 갈 확률 약 0.61, 모 약 2.3%)을 반올림한 값이다. 실제 놀이 감각(개·걸이 많고 모가 드묾)과 맞다.
  • 낙: nakPercent > 0이면 매 던지기마다 먼저 RNG로 낙 여부를 판정한다. 낙이면 그 던지기는 무효(결과 없음)이며, 그 던지기가 윷·모로 얻은 추가 던지기였더라도 그 전에 모아 둔 결과는 그대로 남는다. 낙 자체는 한 번 더 던지기를 주지 않는다.

5.2 윷판 그래프(정확한 정의)

자리 ID와 전통 명칭(명칭은 지역마다 조금 다르며 UI 표기는 선택 사항):

ID 명칭 ID 명칭 ID 명칭 ID 명칭
0 참먹이(출발·도착) 5 모(모서리) 10 뒷모(모서리) 15 찌모(모서리)
1 도 6 뒷도 11 찌도 16 날도
2 개 7 뒷개 12 찌개 17 날개
3 걸 8 뒷걸 13 찌걸 18 날걸
4 윷 9 뒷윷 14 찌윷 19 날윷
20 앞모도 21 앞모개 22 방(중앙) 23 속윷
24 속모 25 뒷모도 26 뒷모개 27 사려
28 안찌

배치(말은 반시계 방향으로 돈다): 참먹이(0)는 오른쪽 아래 모서리, 모(5) 오른쪽 위, 뒷모(10) 왼쪽 위, 찌모(15) 왼쪽 아래.

화면 표기(2026-11-08): 전통 명칭이 어렵다는 요청으로 화면·기록·설명에는 숫자를 쓴다(board.ts의 NODE_NAMES). 모서리는 가는 순서대로 1번(출발·참먹이 0) → 2번(모 5) → 3번(뒷모 10) → 4번(찌모 15)이고, 판에는 큰 숫자(1번 칸에는 작은 "출발")와 가운데 "방"만 적는다. 바깥 칸은 N번 다음 k칸(14: 1번 다음, 69: 2번 다음, 1114: 3번 다음, 1619: 4번 다음), 대각선 칸은 그 모서리에서 방 쪽으로 센 N번 지름길 k칸(20·21: 2번, 25·26: 3번, 24·23: 4번, 28·27: 1번)이다.

  • 대각선 1 (모 → 찌모): 5 → 20 → 21 → 22(방) → 23 → 24 → 15
  • 대각선 2 (뒷모 → 참먹이): 10 → 25 → 26 → 22(방) → 27 → 28 → 0

한 칸 전진 함수 next(node, ctx) (ctx = 이번 이동의 출발 자리인지, 직전에 지난 자리):

현재 자리 이번 이동을 여기서 "출발"하는 경우 이동 중 "지나가는" 경우
대기(HOME) 1 -
14, 69, 1114, 1618 n+1 n+1
19 0 0
5 (모) 20 (지름길) 6
10 (뒷모) 25 (지름길) 11
15 (찌모) 16 16 (지름길 없음)
20 → 21, 21 → 22 동일 동일
22 (방) 27 (참먹이 쪽으로 꺾음) 직전이 21이면 23(직진), 직전이 26이면 27(직진)
23 → 24, 24 → 15 동일 동일
25 → 26, 26 → 22 동일 동일
27 → 28, 28 → 0 동일 동일
0 (참먹이, 한 바퀴 돈 말) GOAL GOAL(pass)
  • 핵심: 모서리(모·뒷모)와 방은 그 자리에 "멈춰 있다가" 다음 이동을 시작할 때만 꺾는다. 지나가는 중이면 직진한다.
  • 방에 멈췄다가 출발하면 항상 참먹이 방향(27)으로 간다(가장 빠른 길). 지역 룰 forkRule = choose면 모·뒷모·방에서 다른 길도 고를 수 있다(7.1).
  • 대기 상태의 말이 처음 들어올 때는 0을 지나는 것이 아니라 1부터 센다(도 = 1, 모 = 5).

5.3 차례 진행

  1. 던지기 단계: 현재 차례 사람이 THROW. 결과를 그 차례의 "모아 둔 결과" 목록(pending)에 넣는다.
    • 윷 또는 모가 나오면 반드시 한 번 더 던진다(던지기 단계 유지). 윷·모가 계속 나오면 계속 던진다(상한 없음).
    • 도·개·걸·빽도가 나오면(또는 낙) 던지기를 멈추고 이동 단계로 간다.
  2. 이동 단계: pending에서 결과 하나와 움직일 말(대기 말 또는 판 위의 말 무더기) 하나를 골라 MOVE. 순서는 자유. 모든 결과를 다 쓸 때까지 반복한다.
    • 대기 말은 전진 결과(도~모)로만 판에 올릴 수 있다. 빽도로는 못 올린다.
    • 어떤 결과도 둘 곳이 없으면(예: 판 위에 말이 없는데 남은 결과가 빽도뿐) 그 결과들은 자동으로 버려진다(지역 룰 backdoNoPiece, useOrder로 바뀜, 7.1). 일부 결과만 둘 곳이 없으면, 다른 결과를 먼저 쓰게 하고 매 이동 후 다시 판정한다(예: 빽도 + 개 → 개로 말을 올린 뒤 빽도를 그 말에 쓸 수 있음).
  3. 잡기 보너스: 이동이 상대 말을 잡으면 즉시 던지기 단계로 돌아가 1번 더 던진다. 남은 pending 결과는 그대로 유지되고 새 결과가 추가된다. 한 번 이동으로 업힌 상대 말 여러 개를 잡아도 보너스는 1번. 한 차례에 잡기를 여러 번 하면 그때마다 1번씩.
  4. pending이 비고 추가 던지기도 없으면 차례 종료, 다음 편(팀전은 다음 팀의 다음 사람)으로.

5.4 이동 규칙

  • 전진 n: next()를 n번 적용. 중간에 GOAL에 닿으면 남은 칸은 버리고 그 말(무더기)은 "남"(완주).
  • 날 판정:
    • pass(기본): 한 바퀴를 돈 말이 참먹이(0)를 "지나가야" 남. 참먹이에 정확히 멈추면 아직 판 위(잡힐 수 있음). 다음 이동에서 어떤 전진 결과든 1칸만 나가도 남.
    • reach: 한 바퀴 돈 말이 0에 도착하는 순간 남.
  • 빽도(뒤로 1): 그 말이 바로 직전에 있던 자리로 되돌아간다(말마다 지나온 자리 기록 trail을 유지하고 마지막 칸을 되돌림). 방(22)처럼 들어오는 길이 둘인 자리에서도 "왔던 길"로 돌아간다.
    • 도 자리(1)에서 빽도(이 말의 기록이 [1]뿐): backdoFromDo = chammeogi면 참먹이(0)로 가고 "한 바퀴 돈 말"로 취급한다(다음 전진에서 바로 날 수 있음). finish면 즉시 남.
    • 참먹이(0)에서 빽도: 기록상 직전 자리(19 또는 28)로. 기록이 없으면 19로.
    • 빽도로 대기 말을 움직일 수는 없다.
  • 업기: 자기 편 말이 있는 자리에 멈추면 무조건 업는다(합쳐서 하나의 무더기). 지역 룰 stacking = choose면 따로 둘 수도 있다(7.1). 이후 그 무더기는 함께 움직이고, 함께 잡히고, 함께 난다. 업힌 무더기를 일부만 떼어 움직일 수 없다. 팀전에서는 팀 말끼리 업힌다.
  • 잡기: 상대 편 말(무더기)이 있는 자리에 "멈추면" 그 말들을 모두 대기로 돌려보낸다(기록 초기화). 지나가는 것은 잡지 않는다. 참먹이(0)에 서 있는 말도 잡힌다. 대기·남은 말은 잡을 수 없다.
  • 한 자리에 서로 다른 편 말이 함께 있을 수 없다(멈추면 반드시 잡으므로).

5.5 예시

  • 예시 1(한 차례에 완주): 대기 말만 있는 상태에서 윷(4) → 모(5) → 걸(3)이 나와 pending=[윷,모,걸]. 모로 새 말을 올림 → 5(모)에 멈춤. 걸: 5에서 출발하므로 지름길 20 → 21 → 22(방)에 멈춤. 윷: 22에서 출발하므로 27 → 28 → 0 → GOAL(4번째 칸). 이 말은 남(pass 기준). 한 차례 만에 1개 완주.
  • 예시 2(방 직진): 말이 20(앞모도)에 있고 걸(3) → 21, 22를 지나 23(속윷)에 멈춤. 방을 지나갔으므로 직진해 찌모 쪽으로 간다.
  • 예시 3(빽도 + 잡기): 내 말 A가 6(뒷도), 상대 말이 5(모)에 있음. 빽도를 A에 쓰면 5로 가서 상대 말을 잡고 한 번 더 던진다(backdoCaptureBonus=true). A는 이제 5에 "멈춰" 있으므로 다음 이동은 지름길(20)로 들어간다.
  • 예시 4(참먹이 대기): pass 기준, 말이 28(안찌)에서 도(1)로 0에 멈춤 → 아직 안 남. 상대가 0에 멈추면 잡힌다. 다음 차례 도 이상이면 남.

6. 승패와 점수 계산

  • 자기 편 말 pieces개를 모두 낸 편이 1등. 팀전은 이긴 팀 전원이 승리.
  • 개인전 3~4명:
    • ranking = first: 1등이 나오는 즉시 종료. 나머지 순위는 (1) 난 말 수 많은 순, (2) "남은 거리 합"이 작은 순, (3) 그래도 같으면 공동 순위.
    • ranking = all: 1등이 나온 편은 빠지고 남은 편끼리 계속. 마지막 1편이 남으면 그 편이 꼴찌로 확정되며 종료.
  • 남은 거리(말 1개 기준, pass 규칙에서 GOAL까지 최소 칸 수 = 0까지의 거리 + 1): 대기 12, 1→11, 2→10, 3→9, 4→8, 5→7, 6→11, 7→10, 8→9, 9→8, 10→7, 11→10, 12→9, 13→8, 14→7, 15→6, 16→5, 17→4, 18→3, 19→2, 0(참먹이)→1, 20→6, 21→5, 22→4, 23→8, 24→7, 25→6, 26→5, 27→3, 28→2. 업힌 무더기는 말 수만큼 곱한다. (reach 규칙이면 전부 1씩 뺀다.) 이 표는 순위 판정 전용이며 이동 규칙에는 쓰이지 않는다.
  • 점수(옵션 없이 고정): 결과 화면에는 "난 말 수"와 순위만 표시한다.

7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)

방 설정의 [지역 룰(우리 동네 규칙)] 묶음에서 고른다. 모든 기본값은 위 5장 규칙(가장 흔한 규칙) 그대로라서 기존 방·기록·리플레이는 바뀌지 않는다. 예전에 저장된 옵션에 새 키가 없으면 기본값으로 읽는다(엔진·화면 모두 "기본이 아닌 값인지"만 비교). 고른 규칙은 로비 요약 한 줄(기본과 다른 것만 덧붙임), 게임 중 [규칙 보기]의 "이 방의 지역 룰" 목록, [?] 도움말에 쉬운 말로 나온다.

  • 기존 옵션: 빽도 사용 여부(backdo), 도 자리 빽도 처리(backdoFromDo), 날 판정(finishRule), 낙(nakPercent), 빽도 잡기 보너스(backdoCaptureBonus), 순위 방식(ranking), 윷가락 확률(stickModel): 2장 표 참조.
  • 말 수 25개(pieces): 전통적으로 35개, 흔히 4개.

7.1 추가한 지역 룰 (2026-10-13)

나무위키 "윷놀이"의 지역 차이 설명과 놀이 안내 글에서 "놀기 전에 미리 정하라"고 하는 대표적인 다툼거리를 골랐다.

키 실제로 갈리는 지점 우리 엔진 동작
backdoNoPiece 판에 말이 없는데 빽도가 나오면 낙처럼 버리는 집, 다시 던지는 집, "출발점보다 한 칸 뒤로 가서 다음에 2칸 이상 가면 출발점을 지난 것으로 치는" 집 discard: 지금처럼 쓸 곳이 없으면 버림(5.3-2). rethrow: 던진 순간 판에 내 말이 없고 모아 둔 결과에 전진 결과(말을 올릴 수 있는 것)도 없으면 그 빽도는 pending에 넣지 않고 한 번 더 던진다(thrown 다음 backdoRethrow 이벤트, 통계에는 빽도로 셈). [윷, 빽도]처럼 윷으로 말을 올린 뒤 쓸 수 있으면 그대로 둔다. enter: 판에 내 말이 하나도 없을 때만 대기 말에 빽도를 쓸 수 있고, 그 말은 참먹이 한 칸 뒤 날윷(19)에 선다(기록 [19]). 다음에 도면 참먹이(0)에 서고(한 바퀴 돈 말), 개 이상이면 참먹이를 지나 난다(reach면 도도 남). 19에 상대 말이 있으면 잡는다. 판에 내 말이 있으면 빽도는 판 위 말에만.
nakRule 윷·모 다음 낙이 나면 앞의 윷·모를 인정하는 지역과 그냥 차례를 넘기는 지역 keep: 지금처럼 그 던지기만 무효. lose: 낙이 나오면 이번 차례에 아직 안 쓴 결과를 모두 버리고(discarded 이벤트) 차례가 끝난다. 잡기 보너스 던지기에서 낙이 나와도 같다. nak 이벤트에 endsTurn: true.
useOrder 윷→모→걸이 나오면 순서를 바꿔 모→걸→윷으로 써도 되는지 free: 지금처럼 자유. thrown: pending[0]만 쓸 수 있다(다른 인덱스는 "이 방은 던진 순서대로 써요…"로 거부). 맨 앞 결과를 쓸 곳이 없으면 그 결과만 버리고 다음 결과로 넘어간다. 잡기 보너스로 새로 던진 결과는 뒤에 붙는다.
stacking 내 말 위에 멈추면 무조건 업는지, 업지 않고 옆에 둘 수 있는지(업기 거부) always: 지금처럼 무조건 업음. choose: 같은 편 말이 있는 자리에 멈추는 수마다 "따로 두기" 수(MOVE.stack = false)가 하나 더 생긴다. 따로 선 무더기는 Piece.group(그 무더기에서 가장 작은 말 번호)으로 구분하고, 각자 움직이며(MOVE.piece로 어느 무더기인지 지정), 빽도 기록도 따로다. 상대가 그 자리에 멈추면 그 자리의 내 말을 모두 잡는다(한 자리에 한 편만 있는 불변식 유지). 그 자리에 다시 업으며 멈추면 그 자리의 무더기가 모두 하나로 합쳐진다.
forkRule 모서리·방에서 무조건 꺾는지, "갈림길 중 자기가 선택"하는지(나무위키: 무조건 꺾는 규칙이 지배적이나 고르게 하는 문헌도 있음) shortcut: 지금처럼 멈췄다 출발하면 지름길(방에서는 참먹이 쪽). choose: 모(5)·뒷모(10)·방(22)에 멈춰 있던 말이 전진할 때 다른 길(MOVE.alt = true)도 고를 수 있다. 모 → 뒷도(6) 쪽 바깥 길, 뒷모 → 찌도(11) 쪽 바깥 길, 방 → 속윷(23)(찌모 쪽). 지나가는 중의 갈림길과 빽도는 그대로.
  • 시간 초과 자동 행동(8.5)과 컴퓨터는 같은 우선순위에서 동점이면 보통 수(지름길, 업기)를 먼저 고른다. 컴퓨터는 남은 거리 표로 다른 길의 손해를 계산하므로, 잡을 수 있을 때만 다른 길로 간다. 따로 서 있는 내 말도 함께 잡힐 위험으로 계산하고, 업기 보너스 점수는 업을 때만 준다.

7.2 일부러 넣지 않은 변형

  • 자리마다 벌칙·업기·강제 이동이 있는 "함정 윷판": 판 그림과 자리 규칙을 통째로 바꿔야 하는 다른 게임에 가깝다.
  • 빽도 저장(판에 말이 없을 때 나온 빽도를 다음 차례로 넘겨 다음 결과에서 1칸 빼기): 차례를 넘어 남는 상태와 "어느 결과에서 빼는지" 세부가 집마다 달라 다툼만 늘어난다. 같은 상황을 backdoNoPiece의 세 가지로 대신한다.
  • 뒷개·뒷걸·자유걸(표시 가락 조합으로 뒤로 2~3칸), 북한식 뒷도 2배: 가락 표시와 확률표가 바뀌는 드문 변형.
  • 잡기 보너스 제한(그 차례에 윷·모가 나왔으면 잡아도 더 안 던짐, 잡고 받은 던지기에서는 윷·모가 나와도 더 안 던짐): 문헌에 "경우에 따라서는" 정도로만 나오는 드문 규칙. 윷·모 한 번 더 던지기와 잡으면 한 번 더 던지기는 거의 모든 지역이 같아서 끄는 옵션도 두지 않는다(빽도 잡기 보너스만 backdoCaptureBonus로 이미 있음).
  • 낙 판정 기준(선에 걸치면 낙인지 등): 화면 속 윷은 판정 자체가 확률(nakPercent) 하나라 고를 것이 없다.
  • 정확히 참먹이에 도착해야만 나는 규칙: 남는 칸 수를 버릴 수 없어 말이 오래 멈추는 드문 규칙이다(finishRule의 pass/reach로 충분).
  • 대기 말 두 개를 업고 출발하기, 업는 말 수 제한: 드물고 근거가 약하다.

8. 엔진 설계

8.1 상태(State)

type NodeId = number;               // 0..28, 5.2 표
type SideId = number;               // 개인전: 좌석 인덱스, 팀전: 0=청 1=홍
type Throw = 'do' | 'gae' | 'geol' | 'yut' | 'mo' | 'backdo';

interface Piece {
  id: number;                        // 편 내 0..pieces-1
  status: 'home' | 'board' | 'done';
  node: NodeId | null;               // board일 때만
  lapped: boolean;                   // 참먹이(0)에 서 있을 때 "한 바퀴 돈" 말인지 (0에 있는 board 말은 항상 true)
  trail: NodeId[];                   // 판에 오른 뒤 지나온 자리(빽도용). 업히면 무더기 대표의 trail을 공유 복사
}

interface YutState {
  options: YutOptions;
  rng: RngState;
  players: PlayerId[];               // 좌석 순
  sideOf: Record<PlayerId, SideId>;
  sides: { id: SideId; members: PlayerId[]; pieces: Piece[]; finishedRank: number | null }[];
  turnOrder: PlayerId[];             // 개인전: 좌석 순, 팀전: 청1,홍1,청2,홍2...
  turnIndex: number;                 // turnOrder에서 현재 차례
  phase: 'throw' | 'move' | 'finished';
  throwsOwed: number;                // 앞으로 더 던져야 하는 횟수(윷/모/잡기). throw 단계 진입 시 1
  pending: Throw[];                  // 모아 둔 결과
  lastThrow: { sticks: [boolean, boolean, boolean, boolean] | null; result: Throw | 'nak' } | null;
  turnSeq: number;                   // 행동마다 +1 (타이머·중복 요청 방지)
  deadlineAt: number | null;
  log: GameEvent[];                  // 최근 이벤트(최대 N개)
}
  • 같은 노드의 같은 편 말들이 곧 "무더기"다. 별도 스택 객체를 두지 않고 노드로 묶는다(불변식: 한 노드에는 한 편만).

8.2 액션

type payload 누가 / 언제 검증 조건
THROW 없음 현재 차례 사람, phase='throw' throwsOwed > 0. 위반 시 "지금은 윷을 던질 차례가 아니에요."
MOVE { throwIndex: number; from: NodeId | 'home'; piece?: number; alt?: boolean; stack?: boolean } (piece·alt·stack은 지역 룰 stacking·forkRule = choose에서만, 7.1) 현재 차례 사람, phase='move' pending[throwIndex] 존재. from='home'이면 자기 편 대기 말이 있고 결과가 빽도가 아님. from이 노드면 자기 편 말이 그 노드에 있음. 빽도는 판 위 말에만. 위반 시 "그 말은 움직일 수 없어요." 등
CONCEDE 없음 아무 참가자, 언제나 개인전: 그 편 탈락(남은 편이 1이면 종료). 팀전: 팀원 전원이 기권해야 팀 패배(또는 방장 설정)
  • 팀전에서는 현재 차례인 팀원만 행동할 수 있다(같은 팀 다른 사람은 채팅·추천만).
  • apply 이벤트: thrown{sticks,result}, nak, moved{side,from,to,path,count}, stacked, captured{victimSide,count}, finishedPieces{count}, discarded{throws}, turnChanged, sideFinished{rank}, gameOver.

8.3 공개/비공개 정보 (view)

  • 윷놀이에는 숨겨진 정보가 없다. 모든 참가자·관전자에게 같은 View를 준다: 말 위치, pending, 직전 던지기의 가락 4개 앞뒷면, 차례, 남은 시간.
  • 단, rng 상태(시드·내부 카운터)는 절대 View에 넣지 않는다(다음 던지기 예측 가능해짐).
  • 현재 차례 사람에게만 legalMoves: { throwIndex, from, to, captures, finishes }[]를 추가로 계산해 넣는다(하이라이트용). 다른 사람에게도 넣어도 무방하지만 페이로드 절약을 위해 차례인 사람만.

8.4 랜덤 요소 (시드 RNG 사용 지점)

  • 첫 차례 편 결정(setup 1회).
  • THROW마다: (1) nakPercent > 0이면 rng() < nakPercent/100로 낙 판정, (2) 가락 4개 각각 rng() < p로 배/등 결정(인덱스 0이 빽도 표시 가락). 결과는 5.1 표로 매핑. 가락 단위로 뽑아야 애니메이션(어떤 가락이 뒤집혔는지)과 확률이 일치한다.

8.5 타이머·시간 초과·연결 끊김 시 자동 행동

  • deadline: 행동이 필요할 때마다 now + turnSeconds. 끊긴 사람은 차례가 오면 5초 유예 후 자동 행동.
  • onTimeout:
    • phase='throw' → THROW.
    • phase='move' → 결정적 우선순위로 하나 선택: (1) 상대를 잡는 수(잡히는 말 수 많은 것 우선), (2) 말을 내는 수, (3) 자기 말 업기, (4) 가장 뒤처진(남은 거리 큰) 말을 가장 큰 결과로 전진, (5) 대기 말 올리기. 동률이면 throwIndex 작은 것, from 노드 번호 작은 것('home' 마지막).
  • 같은 사람이 3회 연속 시간 초과되면 "자리 비움" 표시(자동 진행은 계속).

8.6 종료 조건과 결과(GameResult)

  • 어떤 편의 말이 모두 done이 되면 그 편 순위 확정. 6장 규칙에 따라 종료.
interface YutResult {
  ranking: { rank: number; players: PlayerId[]; side: SideId; finishedPieces: number; remainingDistance: number }[];
  winners: PlayerId[];
  summary: string; // 예: "청팀 승리! (4개 모두 남)"
  stats: { throws: Record<Throw | 'nak', number>; captures: Record<SideId, number> };
}

9. UI/UX

  • 모바일 세로: 위쪽 2/3에 정사각형 윷판(자리 원 지름 48px 이상, 모서리·방은 더 크게), 아래에 "모아 둔 결과" 칩(도·개·걸·윷·모·빽도, 각 64px 이상)과 큰 "윷 던지기" 버튼, 맨 아래 대기 말·난 말 표시. PC: 윷판 왼쪽, 정보 패널 오른쪽.
  • 조작: 결과 칩을 먼저 누르고 → 움직일 수 있는 말이 반짝이고 → 말을 누르면 도착 자리가 표시되고 → 다시 누르면 확정(오조작 방지 2단계). 결과가 1개이고 움직일 말이 1가지면 "자동 이동" 버튼 강조.
  • 지역 룰 선택(7.1): 고른 말에 다른 길이나 따로 두기가 있으면 [이동하기] 위에 "갈 길 고르기"(지름길/바깥 길, 방에서는 참먹이 쪽/찌모 쪽, 도착 자리와 잡기 표시)와 "업기(함께 움직임)/따로 두기" 버튼이 나오고, 점선 미리보기가 고른 대로 바뀐다. 말을 한 번 더 누르면 고른 대로 움직인다. 따로 선 무더기는 한 자리에 나란히 작게 그린다. 던진 순서대로(useOrder = thrown)면 맨 앞 결과 칩만 눌린다.
  • 합법 수 하이라이트: 도착 자리에 점선 경로 미리보기. 잡을 수 있으면 빨간 테두리 "잡기!", 업기면 "업기", 나면 "날!" 배지.
  • 애니메이션: 윷가락 4개가 공중에서 가락마다 다르게 돌다 떨어져 한 번 튀는 0.8초 애니메이션(서버 결과를 받은 뒤 재생, 결과 조작 불가), 결과 글자는 톡 튀어나오고 윷·모는 빨간 글씨, 낙이면 가락이 흔들린다. 말은 칸마다 통통 튀며 이동하고(한 칸 0.17초), 도착하면 자리에 고리가 한 번 퍼진다(잡기 빨강, 나기 금색). 잡힌 말은 움직이는 말이 도착할 때까지 그 자리에 있다가 튀어 오르며 돌아 사라진다. 상대·컴퓨터 차례도 똑같이 움직인다.
  • 효과음(화면 변화 기준, 한 번만, 사이트 음량을 따름, apps/web/src/games/yut/sound.ts): 던질 때 휙 + 가락 4개가 멍석에 떨어지는 딱딱 소리(애니메이션과 같은 때), 윷·모는 밝게 올라가는 음(한 번 더), 빽도는 미끄러져 내려가는 음, 낙은 둔탁한 소리. 말이 한 칸 갈 때마다 작은 "콩", 도착할 때 잡기(부딪히고 떨어지는 소리)·업기(두 번 딸깍)·나기(짧게 올라가는 음). 내 차례 알림은 보이는 화면에서만 게임이 내고, 숨은 탭은 방 화면이 낸다.
  • 초보자 도움말: "규칙 보기"에 그림으로 도~모, 지름길(모서리·방에 멈추면 꺾임), 업기, 잡기 설명. 힌트 옵션을 켜면 추천 수(8.5 우선순위)를 연하게 표시.
  • 접근성: 결과 칩에 글자(도/개/걸/윷/모/빽도)와 이동 칸 수(1~5, −1)를 함께. 색약 대비로 편마다 모양(원·세모·네모·별) 구분.

10. 테스트 체크리스트

  • 확률: 시드 고정 10만 회 던지기에서 realistic/fair 각 결과 빈도가 5.1 표 값 ±0.5%p 이내.
  • 윷 → 모 → 걸: 던지기 단계가 걸에서 멈추고 pending=[yut,mo,geol], 순서 자유롭게 사용 가능(예시 1 그대로 재현해 1개 완주).
  • 모(5)를 지나가는 이동(4에서 걸 → 7)은 지름길로 안 꺾인다. 5에 멈췄다 출발하면 20으로 꺾인다.
  • 방(22): 21에서 지나가면 23, 26에서 지나가면 27, 22에서 출발하면 27.
  • 찌모(15)에 멈췄다 출발해도 16으로(지름길 없음).
  • pass: 28에서 도 → 0에 멈춤, 미완주, 상대가 0에 오면 잡힘. 다음 도 → 남. reach: 28에서 도 → 즉시 남.
  • 빽도는 왔던 길로: 21→22로 온 말이 빽도 → 21. 26→22로 온 말이 빽도 → 26. 빽도로 21에 간 말이 다음에 개 → 22를 지나 23(직진).
  • 도 자리 빽도: chammeogi면 0으로 가고 다음 개 → 남. finish면 즉시 남.
  • 판 위 말 없음 + pending=[backdo] → 결과 버려지고 차례 넘어감. pending=[backdo, gae] → 개로 말을 올린 뒤 빽도 사용 가능.
  • 업기: 같은 편 말 위에 멈추면 합쳐지고, 이후 한 번에 2개가 같이 이동·같이 남. 업힌 2개가 잡히면 둘 다 대기로, 잡은 쪽 보너스는 1번.
  • 잡기 보너스: 잡은 즉시 phase='throw', 남은 pending 유지. 보너스 던지기에서 윷이 나오면 또 던짐.
  • 지나가는 칸의 상대 말은 잡히지 않는다.
  • 낙 10%: 낙이 나오면 결과 없음, 그 전에 모아 둔 윷 결과는 유지되어 이동 단계로 간다.
  • 팀전 4명: 차례 순서 청1→홍1→청2→홍2, 홍1 차례에 청2가 보낸 MOVE는 "지금은 다른 사람 차례예요."로 거부.
  • 개인전 3명 ranking=all: 1등 편이 빠진 뒤 차례 순서에서 제외되고 끝까지 진행.
  • 시간 초과: throw 단계 → 자동 던지기. move 단계에서 잡기 가능한 수가 있으면 그것을 고른다.
  • 연결 끊김: 끊긴 사람 차례에 유예 후 자동 진행, 재접속하면 즉시 현재 View 수신.
  • 정보 유출: View JSON에 rng, 시드, 다음 결과가 없음(직렬화 스냅샷 테스트).
  • 결정성: 같은 시드 + 같은 액션 열 → 같은 최종 State(리플레이 테스트).
  • 옵션 검증: 개인전 5명, 팀전 5명 거부.
  • 지역 룰(7.1): 기본값은 예전 동작 그대로. backdoNoPiece 버림/다시 던지기/날윷, nakRule 차례 끝, useOrder 던진 순서(맨 앞 결과만, 못 쓰면 그것만 버림), stacking 따로 두기(따로 움직임, 함께 잡힘, 다시 업으면 합쳐짐), forkRule 다른 길(모·뒷모 바깥 길, 방 → 속윷, 빽도는 기록대로), 각 옵션 검증 문구. 무작위 대국 테스트에 지역 룰 조합 5개 추가.

11. 참고 자료

12. 메모 (상표·법적 주의 등)

  • 윷놀이는 전통 민속놀이로 상표·저작권 문제가 없다. 윷판 그림·말 디자인만 자체 제작하면 된다.
  • 내기(돈 걸기) 기능은 넣지 않는다. 점수·포인트도 방 안에서만 쓰이는 표시용이다.
  • 지역마다 규칙이 달라 사용자 항의가 잦을 수 있으므로, 방 만들기 화면에 현재 적용 규칙 요약(빽도 사용, 날 판정 방식 등)을 한 줄로 보여 준다.