586 lines
49 KiB
Markdown
586 lines
49 KiB
Markdown
# 섯다 (`seotda`)
|
||
|
||
> 마일스톤: M3 · 인원: 최소 2 ~ 최대 10명 (20장 3장 섯다는 최대 6명) · 예상 시간: 약 15~25분 (20판 기준) · 난이도: 쉬움~보통
|
||
>
|
||
> 2026-10-13 다시 만듦: 한게임 섯다의 화면·흐름·용어를 본떴다(초록 테이블, 가운데 판돈, 숫자 키 베팅 버튼, 원 단위, 2장 한 번에 받기 기본, 20/40장, 베팅 규칙 111~444, 실제 화투 그림, 남은 패를 전부 따져 보는 컴퓨터).
|
||
|
||
## 1. 개요
|
||
|
||
- 화투 20장(1~10월 각 2장)으로 각자 2장의 조합(족보)을 겨루는 한국 전통 베팅 카드 게임이다. 명절·모임에서 고스톱과 함께 가장 널리 알려진 화투 놀이이고, "광땡", "장땡", "땡잡이", "구사" 같은 용어는 일상어처럼 쓰인다.
|
||
- 금액은 한게임 섯다처럼 **원**으로, 가운데 모인 돈은 **판돈**, 판마다 내는 돈은 **기본금**이라 부른다. 이 원은 방 안에서만 쓰는 놀이용 숫자다. 진짜 돈·유료 재화·환전·양도·방 간 이월이 없다(12장). 엔진 안의 이름(`startingChips`, `baseUnit`, `stack`)은 예전 칩 시절 이름을 그대로 쓴다.
|
||
- 인원 근거: 전통 규칙에 고정된 인원 상한은 없고, 덱 장수가 물리적 상한을 정한다. 2장 섯다는 1인 2장이므로 최대 10명, 20장 3장 섯다는 1인 3장이므로 최대 6명(18장), 40장이면 3장 섯다도 10명. 최소 2명. 실제로는 4~6명이 가장 흔하다.
|
||
- 베팅 방식(삥/콜/따당/하프/체크/다이)과 사이드 팟·리바이는 포커 문서(`poker`)의 한국식 판돈 베팅 공용 모듈을 그대로 쓴다. 이 문서에도 필요한 정의를 모두 다시 적는다.
|
||
|
||
## 2. 모드와 옵션
|
||
|
||
| 옵션 키 | 설명 | 선택지 | 기본값 |
|
||
|---|---|---|---|
|
||
| `cardMode` | 게임 방식: 2장 섯다 / 3장 섯다(3장 받아 2장 선택) | `two` / `three` | `two` |
|
||
| `dealMode` | 2장 섯다 패 받기 | `oneRound`(2장 한 번에 받고 베팅 1회, 한게임 2장 섯다) / `twoRounds`(1장 받고 베팅, 1장 더 받고 베팅, 전통 규칙) | `oneRound` |
|
||
| `threeOpen` | 3장 섯다 공개패: 처음 2장 중 1장을 골라 모두에게 보여 줌 | 켬(한게임) / 끔 | 켬 |
|
||
| `threePick` | 3장 섯다 최종 2장 고르는 때 | `end`(마지막 베팅 뒤, 한게임) / `beforeBet`(3번째 패를 받자마자, 마지막 베팅 전) | `end` |
|
||
| `deck` | 화투 장수 | `20`(1~10월 광·열끗과 띠, 8월은 기러기) / `40`(1~10월 4장 모두, 피 포함) | `20` |
|
||
| `startingChips` | 시작 금액(원) | 50만 / 100만 / 200만 / 500만 | 100만원 |
|
||
| `baseUnit` | 기본금 = 판마다 모두 내는 돈 = 삥 금액(원) | 2,000 / 1만 / 2만 / 5만 | 1만원 |
|
||
| `betRule` | 베팅 규칙 | `free`(일반) / `111`·`222`·`333`·`444`(선부터 1~4명은 첫 베팅에서 하프·다이만) | `free` |
|
||
| `maxRaise` | 허용하는 최대 베팅 | `half`(하프까지) / `full`(풀까지) | `half` |
|
||
| `quarter` | 쿼터 버튼(한게임에는 없음) | 켬 / 끔 | 끔 |
|
||
| `endCondition` | 게임 종료 방식 | `hands`(정해진 판 수) / `lastStanding`(최후 1인) | `hands` |
|
||
| `handLimit` | `hands`일 때 총 판 수(재경기는 판 수에 포함하지 않음) | 10 / 20 / 30 / 50 | 20 |
|
||
| `schoolUpEvery` | N판마다 기본금 2배(0=안 올림) | 0 / 5 / 10 / 15 | 0 |
|
||
| `rebuy` | 리바이(원을 다 잃으면 시작 금액 다시 받기) | `off` / `limited` / `unlimited` | `unlimited` |
|
||
| `rebuyLimit` | `limited`일 때 1인당 횟수 | 1 / 2 / 3 | 1 |
|
||
| `turnSeconds` | 행동 제한 시간(초) | 15 / 20 / 30 / 60 / `null`(무제한) | 20 |
|
||
| `dealerRule` | 다음 판의 선 | `winner`(직전 판 승자) / `rotate`(시계 방향) | `winner` |
|
||
| `gwangTtaeng` | 광땡 종류 | `all`(38·18·13광땡) / `only38`(38광땡만) | `all` |
|
||
| `ttaengjabi` | 땡잡이(3·7) | `off` / `strict`(3월 광 + 7월 열끗) / `loose`(3월 + 7월 아무 패, 한게임) | `loose` |
|
||
| `amhaeng` | 암행어사(4월 열끗 + 7월 열끗) | 켬 / 끔 | 켬 |
|
||
| `gusa` | 구사 재경기(4·9, "49파토") | 켬 / 끔 | 켬 |
|
||
| `mungGusa` | 멍텅구리구사(4월 열끗 + 9월 열끗) 재경기 범위 | `off`(일반 구사로 취급) / `upTo8`(8땡 이하 재경기) / `upTo9`(9땡 이하, 한게임) / `upToJang`(장땡 이하) | `upTo9` |
|
||
| `tieRule` | 같은 족보 동점 처리 | `rematch`(동점자끼리 재경기) / `split`(나눠 가짐) | `rematch` |
|
||
| `rejoinCost` | 구사 재경기 때 다이한 사람의 재참가 | `none`(불가) / `half`(현재 판돈의 절반을 내고 참가) / `full`(현재 판돈만큼 내고 참가) | `none` |
|
||
| `hints` | 족보 도우미: 내 족보 이름 표시, 족보표에서 내 패 강조 | 켬 / 끔 | 켬 |
|
||
|
||
- 2026-10-13 전에 만든 방(상태 버전 1, 칩 단위)은 버전 2로 옮길 때 금액을 모두 1000배 해서 원으로 바꾸고(시작 1,000칩 → 100만원), 진행 중인 게임의 규칙은 그대로 둔다(쿼터 켬, 20장, 일반 베팅). 저장된 옛 옵션 값(500칩 등)은 스키마에서 기본값으로 바뀐다(`.catch`).
|
||
- 한게임 섯다 기준으로 바꾼 기본값: `dealMode` 1장씩 → 2장 한 번에, `ttaengjabi` 엄격 → 3·7 아무 패, `mungGusa` 8땡 → 9땡까지, 쿼터 버튼 기본 끔. 한게임의 땡값·딜러비·등급·무료 충전 같은 머니 제도는 넣지 않는다(12장).
|
||
|
||
옵션 검증: `cardMode=three`이고 20장이면 참가자 6명 이하, `dealMode`는 무시(3장 섯다 고유 흐름). `baseUnit × 20 ≤ startingChips`. `betRule`은 매 (재)경기 첫 베팅 라운드의 처음 N번 행동에만 걸린다(시간 초과로 체크가 안 되면 다이). `gusa=off`이면 `mungGusa`도 무시(4·9는 모두 3끗).
|
||
|
||
## 3. 구성물
|
||
|
||
화투 20장(기본). 각 월의 "특수 패" 1장 + "일반 패" 1장. `deck=40`이면 1~10월의 피 2장씩도 넣어 40장(피는 숫자로만 쓰인다):
|
||
|
||
| 월 | 꽃(그림 소재) | 특수 패 | 일반 패 |
|
||
|---|---|---|---|
|
||
| 1 | 송학(소나무·학) | 광 | 띠 |
|
||
| 2 | 매조(매화·꾀꼬리) | 열끗 | 띠 |
|
||
| 3 | 벚꽃 | 광 | 띠 |
|
||
| 4 | 흑싸리(등나무·두견새) | 열끗 | 띠 |
|
||
| 5 | 난초(창포·다리) | 열끗 | 띠 |
|
||
| 6 | 모란(나비) | 열끗 | 띠 |
|
||
| 7 | 홍싸리(싸리·멧돼지) | 열끗 | 띠 |
|
||
| 8 | 공산(억새·보름달) | 광 | 일반(기러기 그림) |
|
||
| 9 | 국진(국화·술잔) | 열끗 | 띠 |
|
||
| 10 | 단풍(사슴) | 열끗 | 띠 |
|
||
|
||
- 규칙상 의미가 있는 특수 패는 1·3·8월 광, 4·7·9월 열끗뿐이다. 나머지 열끗·띠·일반 패는 숫자(월)로만 쓰인다.
|
||
- 놀이용 원, 선 표시, 판돈 영역.
|
||
- 카드 그림은 Wikimedia Commons의 화투 SVG(CC BY-SA 4.0, 9.1 "화투 그림")를 쓴다.
|
||
|
||
## 4. 준비(셋업)
|
||
|
||
1. 참가자를 좌석에 앉히고 좌석 순서를 `rng`로 섞는다.
|
||
2. 모든 플레이어 보유 금액 = `startingChips`.
|
||
3. 첫 판의 선을 `rng`로 고른다.
|
||
4. 첫 판을 시작한다.
|
||
|
||
## 5. 진행 규칙
|
||
|
||
### 5.1 한 판의 흐름 (2장 섯다)
|
||
|
||
기본(`dealMode=oneRound`, 한게임 2장 섯다): 기본금 → 2장을 한 번에 나눠 줌 → 베팅 1회 → 쇼다운. 아래는 `dealMode=twoRounds`(1장씩)의 흐름이다.
|
||
|
||
1. 기본금: 원이 있는 참가자 전원이 `baseUnit`을 판돈에 낸다(모자라면 전부 내고 올인).
|
||
2. 기리(패 떼기): 실제 섞기는 서버 `rng`가 한다. 화면에서는 선의 오른쪽 사람이 패를 떼는 짧은 연출만 보여 준다(규칙 영향 없음).
|
||
3. 선부터 시계 방향으로 1장씩(비공개) 나눠 준다.
|
||
4. 1차 베팅(선부터 시계 방향, 5.4).
|
||
5. 남은 사람에게 1장씩 더 나눠 준다(비공개).
|
||
6. 2차 베팅(선이 다이했으면 선 다음 좌석의 남은 사람부터).
|
||
7. 2명 이상 남으면 쇼다운: 남은 사람의 패를 동시에 공개하고 6장 규칙으로 판정.
|
||
8. 도중에 1명만 남으면 그 사람이 판돈을 가져간다. 그 전에 남은 사람이 패를 모두에게 공개할지 고른다(`phase=reveal`, `reveal { show }`, 2026-10-14). 공개하면 모든 사람·관전자 화면에 그 패(3장 섯다는 고른 2장, 아직 안 골랐으면 손패 전부)와 족보 이름이 보이고 판 기록에 "패 공개"가 남는다. 시간 초과(`decisionSeconds`, 자리 비움이면 5초)·방 나감·컴퓨터 기본값은 공개 안 함. 다른 사람이 모두 나가 볼 사람이 없으면 묻지 않고 공개하지 않는다.
|
||
9. 판 종료 결과를 5초간 보여 준 뒤 다음 판(리바이·탈락·종료 확인 포함).
|
||
|
||
`dealMode=oneRound`(기본): 3~6 대신 2장을 한 번에 나눠 주고 베팅 1회 후 쇼다운.
|
||
|
||
### 5.2 3장 섯다 (`cardMode=three`)
|
||
|
||
기본(한게임 3장 섯다, 2026-10-13 인터넷 규칙 다시 확인):
|
||
1. 기본금 → 2장씩 나눠 줌(비공개).
|
||
2. 공개패 고르기(동시 진행, `threeOpen`): 각자 2장 중 1장을 골라 모두에게 앞면으로 보여 준다. 시간이 지나면(또는 나간 사람은) 낮은 월의 패가 공개된다.
|
||
3. 1구 베팅(선부터).
|
||
4. 남은 사람에게 1장 더(비공개, 손에 3장).
|
||
5. 2구 베팅.
|
||
6. 2명 이상 남으면 최종 패 고르기(동시 진행): 각자 3장 중 2장을 고른다. 시간이 지나면 가장 센 조합. 2구 베팅에서 한 사람만 남으면 고르지 않고 끝난다(카드 공개를 고르면 손패 3장을 모두 보여 준다).
|
||
7. 쇼다운(고른 2장으로 판정). 버린 1장은 공개패가 아니면 끝까지 아무에게도 보이지 않는다(공개패를 버리면 다른 사람 화면에서 그 패가 빠진다).
|
||
|
||
옵션: `threeOpen=끔`이면 2단계가 없다. `threePick=beforeBet`이면 4단계 직후에 2장을 고르고(뒷면 2장만 남김) 그다음 마지막 베팅 → 쇼다운(2026-10-13 이전의 3장 섯다 흐름). 진행 중이던 방(상태 버전 2)은 버전 3으로 옮길 때 예전 흐름(공개패 없음, 베팅 전 고르기)을 그대로 쓴다.
|
||
|
||
근거: 한게임 섯다 안내 "3장 섯다: 2장을 먼저 받고 베팅 한 후 패 1장을 더 받고 베팅을 한 번 더 하는 게임방식", "2장 섯다: 전통적인 섯다 방식으로 화투패 2장을 모두 받은 다음 베팅하여 승부"(hangame-images.toastoven.net/hangame/pc/gostop/introduce/html/gssudda/guide_gssudda01_02.html). 한게임 앱 안내(블루스택 공략): "패를 2장 받고, 2장의 패 중 모두에게 공개할 패를 1장 선택 → 1구 베팅 → 추가 패 → 3장의 패 중 최종 패 선택". 나무위키 '섰다': 인터넷 3장 섯다(한게임/피망)는 2장 받고 1장 공개 → 첫 베팅 → 1장 더 → 두 번째 베팅 → 가장 좋은 2장으로 승부.
|
||
|
||
### 5.3 선(先)
|
||
|
||
- 선 = 그 판의 카드를 받는 첫 사람이자 각 베팅 라운드의 첫 행동자.
|
||
- 다음 판의 선: `winner`면 직전 판에서 판돈(메인 팟)을 가져간 사람. 나눠 가졌으면 그중 직전 선에서 시계 방향으로 가장 가까운 사람. `rotate`면 직전 선 다음 좌석의 참가자.
|
||
- 재경기의 선: 직전 선이 재경기 참가자면 그대로, 아니면 직전 선 다음 좌석부터 시계 방향으로 첫 재경기 참가자.
|
||
|
||
### 5.4 베팅 (한국식 판돈 베팅, 포커 문서 5.2와 동일한 공용 모듈)
|
||
|
||
용어: `pot` = 현재 판돈 전체(기본금 포함), `currentBet` = 이번 라운드 최고 베팅액, `toCall` = `currentBet - 내 이번 라운드 베팅액`, `opened` = 이번 라운드에 누군가 걸었는가.
|
||
|
||
| 행동 | 조건 | 낼 금액 |
|
||
|---|---|---|
|
||
| 체크 | `opened=false` | 0 (돈을 걸지 않고 넘김) |
|
||
| 삥 | `opened=false` | `baseUnit` (기본 단위만큼) |
|
||
| 콜 | `toCall > 0` | `toCall` (앞사람만큼 맞춤) |
|
||
| 따당 | `toCall > 0`, 레이즈 가능 | `2 × toCall` (앞사람이 건 금액의 2배) |
|
||
| 쿼터 | 레이즈 가능 | `toCall + floor((pot + toCall) / 4)` |
|
||
| 하프 | 레이즈 가능 | `toCall + floor((pot + toCall) / 2)` |
|
||
| 풀 | 레이즈 가능, `maxRaise=full` | `toCall + (pot + toCall)` |
|
||
| 다이 | 자기 차례 언제나 | 0, 이번 판 포기(낸 돈은 판돈에 남음) |
|
||
|
||
- 쿼터는 `quarter` 옵션을 켠 방에서만 쓸 수 있다(한게임 섯다에는 없다).
|
||
- 베팅 규칙(`betRule`) 111·222·333·444: (재)경기의 첫 베팅 라운드에서 처음 1·2·3·4번의 행동은 하프(하프를 못 하면 남은 올리기, 그것도 없으면 체크·콜) 또는 다이만 할 수 있다. 그 뒤는 자유.
|
||
- 버튼과 숫자 키(PC): 콜 7, 다이 8, 삥 4, 체크 5, 따당 1, 하프 0(한게임과 같다), 쿼터 2, 풀 9.
|
||
- 레이즈 가능 조건: (1) 이번 라운드에서 아직 체크·콜·삥·레이즈를 하지 않았다(한 라운드에 1인 1회, 체크·콜 후 레이즈 금지), (2) 낼 금액이 `toCall`보다 크다. `toCall`을 뺀 추가분이 `baseUnit`보다 작으면 `baseUnit`으로 올린다.
|
||
- 첫 행동자가 체크하면 다음 사람도 체크/삥/쿼터/하프(/풀)/다이 중 고를 수 있다. 전원 체크하면 다음 단계로 넘어간다.
|
||
- 라운드 종료: 다이·올인하지 않은 모든 사람이 이번 라운드에 한 번 이상 행동했고 모두 `currentBet`을 맞췄을 때.
|
||
- 올인: 낼 금액이 스택 이상이면 전부 내고 올인. `toCall`보다 적게 올인하면 사이드 팟이 생긴다. 올인한 사람은 더 행동하지 않고 남은 카드는 받는다.
|
||
- 사이드 팟 계산은 포커 문서 5.5와 같다: 올인 금액 레벨별로 팟을 나누고, 각 팟의 자격자는 그 레벨까지 낸 다이하지 않은 사람. 아무도 맞추지 못한 초과분은 돌려준다.
|
||
|
||
예(3명, 기본금 10 — 단위를 줄여 적음, 실제 방은 1만원 같은 원 단위): 기본금 후 판돈 30. 선 A 삥 10(판돈 40) → B 하프: 콜 10 + (50의 절반 25) = 35(판돈 75) → C 따당: `toCall=35` → 70(판돈 145) → A는 이미 삥을 했으므로 콜 60 또는 다이 → A 콜(판돈 205) → B 콜 35(판돈 240). 세 사람 모두 70을 맞춰 종료. 검산: 30 + 70 × 3 = 240.
|
||
|
||
### 5.5 재경기(구사·동점)
|
||
|
||
재경기가 결정되면(6.3) 그 판의 판돈은 그대로 두고 새 판을 진행한다.
|
||
1. 참가자:
|
||
- 구사 재경기: 쇼다운에 남아 있던 사람 전원(구사를 든 사람 포함). `rejoinCost`가 `none`이 아니면 그 판에서 다이한 사람(탈락자 제외)에게 재참가 여부를 묻는다(동시 진행, 15초, 시간 초과는 불참). 재참가하면 `half`=현재 판돈의 절반(내림), `full`=현재 판돈만큼을 판돈에 낸다. 보유 금액이 모자라면 재참가할 수 없다.
|
||
- 동점 재경기(`tieRule=rematch`): 동점으로 최고패를 가진 사람만. 진 사람은 빠진다.
|
||
2. 덱 20장을 새로 섞고, 기본금는 다시 내지 않는다. 카드 분배·베팅·쇼다운은 5.1/5.2와 같다(새 베팅은 기존 판돈 위에 더해진다).
|
||
3. 이전 판에서 올인한 사람은 계속 올인 상태로 카드만 받는다.
|
||
4. 사이드 팟이 있었던 경우: 각 팟을 그 팟의 자격자끼리 따로 판정한다. 재경기가 필요 없는 팟(자격자끼리 승자가 하나로 정해진 팟)은 재경기 전에 바로 지급하고, 재경기가 필요한 팟만 남긴다. 재경기 참가자는 남은 팟들의 재경기 참가자 합집합이며, 재경기 후 각 남은 팟을 다시 그 팟 자격자(재참가자 포함)끼리 판정한다.
|
||
5. 같은 판에서 재경기가 연속 3번 일어나면 4번째 재경기 대신 그 팟을 재경기 참가자끼리 균등 분할한다(무한 반복 방지).
|
||
6. 재경기는 `handLimit`의 판 수에 포함하지 않는다(원래 판의 연장).
|
||
|
||
### 5.6 원이 떨어졌을 때
|
||
|
||
- 판(재경기 포함)이 완전히 끝난 뒤 보유 금액이 0인 사람은 `busted`.
|
||
- `rebuy=off`: 탈락(관전 화면, 결과 순위에는 남음).
|
||
- `rebuy=limited/unlimited`: "다시 받기 / 그만하기"(15초, 시간 초과는 그만하기). 받으면 `startingChips`로 채움. `hands` 방식에서 마지막 판 직후에는 묻지 않는다.
|
||
- 보유 금액이 기본금보다 적으면 가진 만큼 내고 올인 상태로 참가한다.
|
||
|
||
### 5.7 기본금 상승과 자리 비움
|
||
|
||
- `schoolUpEvery = N > 0`이면 N판마다 `baseUnit` 2배(상한 `startingChips / 5`).
|
||
- 연속 2번 시간 초과하면 `away` 표시, 이후 그 사람의 제한 시간 5초. 직접 행동하면 해제.
|
||
- 방을 나간 사람(`left`)은 매 판 기본금를 낸 뒤 자동 다이. 보유 금액이 0이 되면 탈락.
|
||
|
||
## 6. 승패와 점수 계산
|
||
|
||
### 6.1 족보 (높은 순)
|
||
|
||
끗 계산: 두 장의 월을 더한 값의 일의 자리. 예: 7+8=15 → 5끗, 9+10=19 → 9끗(갑오), 2+8=10 → 0끗(망통).
|
||
|
||
| 순위 | 이름 | 구성 | 비교값(구현용) |
|
||
|---|---|---|---|
|
||
| 1 | 38광땡 | 3월 광 + 8월 광 | 1000 |
|
||
| 2 | 18광땡 | 1월 광 + 8월 광 (`gwangTtaeng=all`) | 990 |
|
||
| 3 | 13광땡 | 1월 광 + 3월 광 (`gwangTtaeng=all`) | 980 |
|
||
| 4 | 장땡(10땡) | 10월 + 10월 | 910 |
|
||
| 5 | 9땡 ~ 2땡 | 같은 월 두 장 | 909 ~ 902 |
|
||
| 6 | 삥땡(1땡) | 1월 + 1월 | 901 |
|
||
| 7 | 알리 | 1월 + 2월 | 806 |
|
||
| 8 | 독사 | 1월 + 4월 | 805 |
|
||
| 9 | 구삥 | 1월 + 9월 | 804 |
|
||
| 10 | 장삥 | 1월 + 10월 | 803 |
|
||
| 11 | 장사 | 4월 + 10월 | 802 |
|
||
| 12 | 세륙 | 4월 + 6월 | 801 |
|
||
| 13 | 갑오(9끗) | 끗 9 | 9 |
|
||
| 14 | 8끗 ~ 1끗 | 끗 8 ~ 1 | 8 ~ 1 |
|
||
| 15 | 망통(0끗) | 끗 0 | 0 |
|
||
|
||
- 위 표에서 먼저 맞는 줄을 쓴다(예: 1월 광 + 3월 광은 `all`이면 13광땡, `only38`이면 일반 조합으로 1+3=4끗).
|
||
- 광 조합이 아니면 광땡이 아니다: 1월 띠 + 8월 광 = 9끗(갑오), 3월 띠 + 8월 광 = 1끗.
|
||
- 같은 값 = 동점(무늬 같은 추가 비교 없음). 땡과 광땡은 같은 패가 두 사람에게 갈 수 없으므로 동점이 생기지 않고, 알리~세륙과 끗은 동점이 생길 수 있다(예: 1월 광+2월 띠 vs 1월 띠+2월 열끗 → 둘 다 알리).
|
||
|
||
### 6.2 특수패 (옵션)
|
||
|
||
특수패는 위 표의 "일반값"을 가지면서, 특정 상대를 만났을 때만 특별한 효과를 낸다.
|
||
|
||
| 특수패 | 구성 | 효과 | 일반값(효과가 없을 때) |
|
||
|---|---|---|---|
|
||
| 땡잡이 | `strict`: 3월 광 + 7월 열끗 / `loose`: 3월 + 7월 아무 패 | 쇼다운 최고 일반패가 1땡~9땡이면 승리(장땡·광땡에는 무효) | 망통(0) |
|
||
| 암행어사 | 4월 열끗 + 7월 열끗 | 쇼다운 최고 일반패가 13광땡 또는 18광땡이면 승리(38광땡에는 무효) | 1끗 |
|
||
| 구사 | 4월 + 9월(멍텅구리구사 조합 제외) | 다른 사람의 최고 일반패가 알리 이하(값 ≤ 806)이고 구사 쪽이 이기지 못하면 재경기 | 3끗 |
|
||
| 멍텅구리구사 | 4월 열끗 + 9월 열끗 | 다른 사람의 최고 일반패가 `upTo8`=8땡 이하(≤ 908) / `upTo9`=9땡 이하(≤ 909) / `upToJang`=장땡 이하(≤ 910)이고 멍구사 쪽이 이기지 못하면 재경기. 광땡은 언제나 이김 | 3끗 |
|
||
|
||
- 땡잡이(`strict`)와 암행어사는 7월 열끗을 함께 쓰므로 한 판에 동시에 나올 수 없다. `loose` 땡잡이는 한 판에 2명까지 나올 수 있다.
|
||
- 옵션이 꺼진 특수패는 일반값만 갖는다.
|
||
|
||
### 6.3 쇼다운 판정 알고리즘
|
||
|
||
입력: 쇼다운 참가자 집합 S(2명 이상), 각자의 2장.
|
||
1. 각자의 일반값 v(p)를 6.1로 구한다(특수패도 일반값).
|
||
2. `Vmax = max v(p)`.
|
||
3. 잠정 승자 W:
|
||
- 땡잡이가 켜져 있고 S에 땡잡이가 있고 `901 ≤ Vmax ≤ 909`이면 W = 땡잡이를 든 사람(들).
|
||
- 아니면, 암행어사가 켜져 있고 S에 암행어사가 있고 `Vmax ∈ {980, 990}`이면 W = 암행어사를 든 사람.
|
||
- 아니면 W = `v(p) = Vmax`인 사람들.
|
||
4. 구사 재경기 검사(`gusa` 켬): 구사 또는 멍텅구리구사를 든 사람 h 중 W에 속하지 않은 사람이 있고, `max{ v(q) : q ∈ S, q ≠ h }`가 h의 기준값 이하이면 → 구사 재경기(5.5). 기준값: 구사 806, 멍텅구리구사는 `mungGusa`에 따라 908/909/910(`off`면 일반 구사로 보아 806).
|
||
5. 재경기가 아니고 W가 1명이면 그 사람이 승리.
|
||
6. W가 2명 이상이면 `tieRule`: `rematch`면 W끼리 재경기, `split`이면 균등 분할(나머지 원은 선에서 시계 방향으로 가장 가까운 승자부터 1원씩).
|
||
|
||
이 판정은 팟마다 그 팟의 자격자(S ∩ 자격자)로 따로 수행한다(5.5의 4).
|
||
|
||
설계 결정(사용자 확인 필요): 원 규칙은 "구사는 상대 최고패가 알리 이하면 재경기"이지만, 구사(3끗)가 그대로 이기는 경우(상대가 모두 2끗 이하)까지 재경기하면 구사를 든 쪽이 손해다. 그래서 구사 쪽이 이미 이기는 경우는 재경기 없이 승리로 처리한다(4단계의 "W에 속하지 않은").
|
||
|
||
### 6.4 판정 예시
|
||
|
||
1. A 38광땡, B 암행어사 → A 승(암행어사는 38광땡에 무효, B는 1끗).
|
||
2. A 13광땡, B 암행어사, C 장땡 → 일반값 A=980, B=1, C=910, 최고 일반값 980(13광땡) → 암행어사 발동 → B 승.
|
||
3. A 9땡, B 땡잡이(3광+7열끗), C 알리 → 최고 일반값 909(9땡) → 땡잡이 발동 → B 승.
|
||
4. A 장땡, B 땡잡이 → 최고 일반값 910 → 무효 → A 승.
|
||
5. A 땡잡이, B 알리 → 최고 일반값 806 → 무효, A는 망통 → B 승.
|
||
6. A 구사(4월 띠 + 9월 열끗), B 알리 → W={B}, A는 W 밖, 상대 최고 806 ≤ 806 → 구사 재경기.
|
||
7. A 구사, B 1땡 → 901 > 806 → B 승.
|
||
8. A 구사, B 2끗, C 망통 → W={A}(3끗 최고) → 재경기 없이 A 승.
|
||
9. A 멍텅구리구사(4열끗+9열끗), B 8땡 → `upTo8`: 908 ≤ 908 → 재경기. B가 9땡이면 B 승. `upToJang`이면 장땡까지 재경기.
|
||
10. A 5끗(2월+3월), B 5끗(6월+9월) → 동점 → `rematch`면 A·B 재경기, `split`이면 반씩.
|
||
11. A 구사, B 5땡, C 땡잡이 → 일반값 A=3, B=905, C=0, 최고 905 → W={C}(땡잡이). 구사 검사: A 기준 806, 상대 최고 905 > 806 → 재경기 아님 → C 승. A가 멍텅구리구사(`upTo8`)였다면 905 ≤ 908 → 재경기.
|
||
12. 3장 섯다: 손패 1월 광, 8월 광, 4월 열끗 → 조합 (1광+8광)=18광땡, (1광+4열끗)=독사, (8광+4열끗)=2끗 → 18광땡 선택이 최선.
|
||
|
||
### 6.5 판돈 지급
|
||
|
||
- 승자(들)가 해당 팟을 가져간다. 다이한 사람·패배자의 낸 돈은 돌려주지 않는다.
|
||
- 사이드 팟은 자격자가 적은 팟부터 판정해 지급하고 마지막에 메인 팟.
|
||
|
||
### 6.6 게임 종료와 점수
|
||
|
||
- `endCondition=hands`: `handLimit`판(재경기 제외)이 끝나면 종료. 점수 = `최종 보유 금액 - startingChips × 리바이 횟수`. 점수 높은 순 순위, 같으면 공동 순위.
|
||
- `endCondition=lastStanding`: 원이 남은 사람이 1명이면 종료(리바이 결정 대기 중이면 대기). 순위 = 늦게 탈락한 순, 같은 판 동시 탈락은 그 판 시작 금액이 많은 쪽이 위. 300판 도달 시 `hands` 방식 점수로 강제 종료.
|
||
- 접속 중이고 원이 남은 사람이 1명 이하가 되면 즉시 종료.
|
||
|
||
## 7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)
|
||
|
||
| 하우스 룰 | 옵션 | 기본 |
|
||
|---|---|---|
|
||
| 2장 한 번에 / 1장씩 2번 받기 | `dealMode` | 2장 한 번에 |
|
||
| 3장 받아 2장 고르기 | `cardMode=three` | 2장 |
|
||
| 광땡 종류(38만 / 38·18·13) | `gwangTtaeng` | 모두 |
|
||
| 땡잡이 느슨(3·7 아무 패) / 엄격(3광+7열끗) / 없음 | `ttaengjabi` | 느슨 |
|
||
| 암행어사 | `amhaeng` | 켬 |
|
||
| 구사 재경기("49파토") | `gusa` | 켬 |
|
||
| 멍텅구리구사 범위(8땡/9땡/장땡까지) | `mungGusa` | 9땡까지 |
|
||
| 화투 20장 / 40장 | `deck` | 20장 |
|
||
| 베팅 규칙 111~444 | `betRule` | 일반 |
|
||
| 쿼터 버튼 | `quarter` | 끔 |
|
||
| 동점 재경기 / 나눔 | `tieRule` | 재경기 |
|
||
| 구사 재경기 때 다이한 사람 재참가 비용 | `rejoinCost` | 재참가 불가 |
|
||
| 선 = 이긴 사람 / 회전 | `dealerRule` | 이긴 사람 |
|
||
| 풀 베팅 허용 | `maxRaise` | 하프까지 |
|
||
| 땡값(땡·광땡으로 이기면 다른 사람에게 추가로 받기), 구사 선택권(구사 쥔 사람이 재경기 여부 결정), 사구 파토 시 판돈 반환 | 미지원(향후) | - |
|
||
|
||
## 8. 엔진 설계
|
||
|
||
### 8.1 상태(State)
|
||
|
||
```ts
|
||
// 서버만 보는 전체 상태
|
||
type PlayerId = string;
|
||
type Month = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
|
||
interface HwatuCard {
|
||
id: number; // 0..19 = (month-1)*2 + (special ? 0 : 1)
|
||
month: Month;
|
||
kind: 'gwang' | 'yeol' | 'normal'; // 1·3·8월 특수=gwang, 그 외 월 특수=yeol, 나머지 normal
|
||
}
|
||
|
||
interface SeotdaOptions {
|
||
cardMode: 'two' | 'three';
|
||
dealMode: 'twoRounds' | 'oneRound';
|
||
startingChips: 500 | 1000 | 2000 | 5000;
|
||
baseUnit: 2 | 10 | 20 | 50;
|
||
maxRaise: 'half' | 'full';
|
||
endCondition: 'hands' | 'lastStanding';
|
||
handLimit: 10 | 20 | 30 | 50;
|
||
schoolUpEvery: 0 | 5 | 10 | 15;
|
||
rebuy: 'off' | 'limited' | 'unlimited';
|
||
rebuyLimit: 1 | 2 | 3;
|
||
turnSeconds: 15 | 20 | 30 | 60;
|
||
dealerRule: 'winner' | 'rotate';
|
||
gwangTtaeng: 'all' | 'only38';
|
||
ttaengjabi: 'off' | 'strict' | 'loose';
|
||
amhaeng: boolean;
|
||
gusa: boolean;
|
||
mungGusa: 'off' | 'upTo8' | 'upTo9' | 'upToJang';
|
||
tieRule: 'rematch' | 'split';
|
||
rejoinCost: 'none' | 'half' | 'full';
|
||
hints: boolean;
|
||
}
|
||
|
||
interface SeatState {
|
||
id: PlayerId;
|
||
seat: number;
|
||
stack: number;
|
||
rebuys: number;
|
||
status: 'playing' | 'busted' | 'eliminated' | 'left';
|
||
away: boolean;
|
||
timeoutsInRow: number;
|
||
eliminatedAtHand: number | null;
|
||
stackAtHandStart: number;
|
||
}
|
||
|
||
interface RoundPlayer {
|
||
id: PlayerId;
|
||
hand: HwatuCard[]; // 받은 카드(2 또는 3장)
|
||
chosen: [number, number] | null; // 3장 섯다 선택한 두 카드 id
|
||
discarded: HwatuCard | null; // 3장 섯다 버린 카드(영구 비공개)
|
||
folded: boolean;
|
||
allIn: boolean;
|
||
committedTotal: number; // 이번 판(재경기 포함) 총 기여
|
||
committedRound: number;
|
||
actedThisRound: boolean;
|
||
raisedThisRound: boolean;
|
||
lockedFromRaise: boolean; // 체크·콜 후 레이즈 금지
|
||
ready: boolean;
|
||
}
|
||
|
||
interface Pot { amount: number; eligible: PlayerId[] }
|
||
|
||
interface BettingRound {
|
||
street: number; // 0 = 1차, 1 = 2차
|
||
order: PlayerId[]; // 선(또는 선 다음 남은 사람)부터
|
||
toAct: PlayerId | null;
|
||
currentBet: number;
|
||
opened: boolean;
|
||
}
|
||
|
||
interface ShowdownInfo {
|
||
hands: { id: PlayerId; cards: HwatuCard[]; name: string; value: number; special: SpecialKind | null }[];
|
||
outcome:
|
||
| { type: 'win'; potIndex: number; winners: PlayerId[]; reason: 'normal' | 'ttaengjabi' | 'amhaeng' }
|
||
| { type: 'split'; potIndex: number; winners: PlayerId[] }
|
||
| { type: 'rematch'; potIndex: number; reason: 'gusa' | 'mungGusa' | 'tie'; participants: PlayerId[] };
|
||
}
|
||
type SpecialKind = 'ttaengjabi' | 'amhaeng' | 'gusa' | 'mungGusa';
|
||
|
||
interface SeotdaHand {
|
||
handNo: number; // 재경기는 같은 handNo
|
||
rematchNo: number; // 0 = 본 판, 1..3 = 재경기 차수
|
||
phase: 'dealing' | 'open' | 'betting' | 'choose' | 'reveal' | 'rejoin' | 'showdown' | 'handEnd';
|
||
opened: Record<PlayerId, number | null>; // 3장 섯다 공개패
|
||
dealerSeat: number; // 선
|
||
deck: HwatuCard[]; // 남은 덱(비공개)
|
||
players: Record<PlayerId, RoundPlayer>; // 이번 (재)경기 참가자
|
||
participants: PlayerId[]; // 이번 (재)경기 참가 순서(선부터)
|
||
betting: BettingRound | null;
|
||
carriedPots: Pot[]; // 재경기로 넘어온 팟(자격자 고정)
|
||
pots: Pot[]; // 이번 (재)경기 베팅으로 생긴 팟
|
||
rejoinPending: PlayerId[];
|
||
showdown: ShowdownInfo[] | null;
|
||
deadlineAt: number | null;
|
||
}
|
||
|
||
interface SeotdaState {
|
||
options: SeotdaOptions;
|
||
rng: RngState;
|
||
seats: SeatState[];
|
||
baseUnit: number; // 기본금 상승 반영
|
||
hand: SeotdaHand | null;
|
||
handsPlayed: number;
|
||
lastWinner: PlayerId | null;
|
||
phase: 'playing' | 'rebuy' | 'finished';
|
||
rebuyPending: PlayerId[];
|
||
rebuyDeadlineAt: number | null;
|
||
eliminationSeq: PlayerId[][];
|
||
publicLog: PublicLogEntry[]; // 비밀 정보 없음
|
||
}
|
||
```
|
||
|
||
엔진 메모: `minPlayers=2`, `maxPlayers=10`(정적). `cardMode=three`의 6명 상한은 `optionsSchema.superRefine`과 `playerRange(options)` 헬퍼로 확인한다. 족보 계산 `evalSeotda(a, b, options) → { value, name, special }`과 판정 `resolve(S, options)`는 순수 함수로 분리해 표 기반 단위 테스트(20장에서 나올 수 있는 190개 조합 전부)를 한다.
|
||
|
||
### 8.2 액션
|
||
|
||
| type | payload | 누가 / 언제 | 검증 조건 |
|
||
|---|---|---|---|
|
||
| `check` | - | `phase=betting`, 내 차례 | `opened=false` |
|
||
| `ping` | - | 내 차례 | `opened=false`, `raisedThisRound=false`, 스택 > 0 |
|
||
| `call` | - | 내 차례 | `toCall > 0` |
|
||
| `ddadang` | - | 내 차례 | `toCall > 0`, 레이즈 가능 |
|
||
| `quarter` / `half` | - | 내 차례 | 레이즈 가능, 낼 금액 > `toCall` |
|
||
| `full` | - | 내 차례 | 위 + `maxRaise=full` |
|
||
| `die` | - | 내 차례 | 항상 |
|
||
| `open` | `{ cardId: number }` | `phase=open`(3장 섯다 공개패), 남은 참가자(동시) | 내 손패 2장 중 하나, 아직 미공개. 시간 초과·나감 = 낮은 월 |
|
||
| `choose` | `{ cardIds: [number, number] }` | `phase=choose`(3장 섯다), 남은 참가자(동시, 올인 포함) | 두 id가 내 손패에 있고 서로 다름, 아직 미선택 |
|
||
| `rejoin` | `{ accept: boolean }` | `phase=rejoin`, `rejoinPending`에 있는 사람 | `accept=true`면 스택 ≥ 재참가 비용 |
|
||
| `reveal` | `{ show: boolean }` | `phase=reveal`, 혼자 남은 사람 | 항상 |
|
||
| `ready` | - | `phase=handEnd` | 미준비 |
|
||
| `rebuy` | `{ accept: boolean }` | `phase=rebuy`, 대상자 | 남은 리바이 횟수 > 0 |
|
||
| `leave` | - | 서버가 퇴장 시 주입 | - |
|
||
|
||
거부 사유 예: "지금은 내 차례가 아니에요", "누가 이미 걸어서 체크할 수 없어요", "이번 라운드에는 더 올릴 수 없어요(콜 또는 다이)", "보유 금액이 모자라 재참가할 수 없어요", "카드 두 장을 골라 주세요".
|
||
|
||
### 8.3 공개/비공개 정보 (view)
|
||
|
||
| 정보 | 본인 | 다른 플레이어 | 관전자(`null`) |
|
||
|---|---|---|---|
|
||
| 내 손패 | 보임 | 장수만 | 장수만 |
|
||
| 3장 섯다 선택 결과 | 보임 | 선택 완료 여부만 | 같음 |
|
||
| 3장 섯다 버린 카드 | 내 것만 | 영구 비공개 | 영구 비공개 |
|
||
| 덱 | 안 보임 | 안 보임 | 안 보임 |
|
||
| 쇼다운 패 | 쇼다운 참가자의 2장(선택한 2장) 공개 | 같음 | 같음 |
|
||
| 다이한 사람 패 | 내 것만 | 영구 비공개 | 영구 비공개 |
|
||
| 다른 사람의 족보 이름 | - | 쇼다운 후에만 | 쇼다운 후에만 |
|
||
|
||
- 공개: 좌석·스택·상태, 선 표시, 판돈과 사이드 팟, 이번 라운드 베팅액과 마지막 행동, 현재 행동자와 마감 시각, 재경기 여부와 사유, 재경기 차수.
|
||
- 비공개 카드 자리는 `{ hidden: true }`만 보낸다. 카드 `id`는 월·종류와 고정 대응하므로 비공개 카드의 `id`도 보내지 않는다.
|
||
- `view`는 본인 차례일 때 `legalActions`(가능 행동과 정확한 낼 금액)와, `hints` 켬일 때 본인 족보 이름(예: "알리", "5끗", "구사 - 상대가 알리 이하면 재경기")을 내려 준다.
|
||
- 이벤트에도 비공개 카드 값을 넣지 않는다(`{ type: 'dealt', to, count }`). 쇼다운 공개 이벤트에만 카드 값을 넣는다.
|
||
|
||
### 8.4 랜덤 요소 (시드 RNG 사용 지점)
|
||
|
||
1. `setup`: 좌석 섞기, 첫 선.
|
||
2. 매 판·매 재경기 시작: 20장 Fisher-Yates 섞기. 분배는 덱 위에서 순서대로.
|
||
- 판정, 분할 나머지 원, 자동 선택은 결정적(난수 없음). 같은 시드 + 같은 액션 열 → 같은 결과.
|
||
|
||
### 8.5 타이머·시간 초과·연결 끊김 시 자동 행동
|
||
|
||
`deadline`: 베팅 `turnSeconds`(자리 비움 5초), 3장 선택 `turnSeconds + 10`초(동시), 재참가·카드 공개 `decisionSeconds`(기본 15초, 카드 공개는 자리 비움이면 5초), `handEnd` 5초, 리바이 15초. `turnSeconds=null`(무제한)이면 베팅·3장 선택에는 마감이 없다(자리 비움도 생기지 않음). 재참가·리바이·판 결과 화면은 그대로 시간이 흐른다.
|
||
|
||
| 단계 | `onTimeout` 자동 행동 |
|
||
|---|---|
|
||
| 베팅 | `opened=false`면 `check`, 아니면 `die` |
|
||
| 3장 선택 | 일반값이 가장 높은 2장 조합. 같으면 특수패(땡잡이·암행어사·구사) 조합, 그것도 같으면 카드 id 합이 작은 조합 |
|
||
| 재참가 | `{ accept: false }` |
|
||
| 카드 공개(혼자 남음) | `{ show: false }`(자리 비움 횟수에 넣지 않음) |
|
||
| `handEnd` | `ready` |
|
||
| 리바이 | `{ accept: false }` |
|
||
|
||
연결이 끊긴 사람의 차례는 일반 마감까지 기다린 뒤 자동 행동한다. 재접속하면 즉시 직접 행동할 수 있다.
|
||
|
||
### 8.6 종료 조건과 결과(GameResult)
|
||
|
||
종료 판정은 6.6.
|
||
|
||
```ts
|
||
interface SeotdaResult /* extends GameResult */ {
|
||
ranking: {
|
||
playerId: PlayerId;
|
||
rank: number; // 공동 순위 허용
|
||
score: number; // hands: 최종 보유 금액 - startingChips × rebuys / lastStanding: 생존 순서(1위=N)
|
||
finalChips: number;
|
||
rebuys: number;
|
||
eliminatedAtHand: number | null;
|
||
}[];
|
||
summary: string; // 예: "20판 종료. 1위 영희(+86만원), 최고 족보 38광땡"
|
||
stats: {
|
||
handsPlayed: number;
|
||
rematches: number;
|
||
bestHand: { playerId: PlayerId; name: string; handNo: number } | null;
|
||
biggestPot: { handNo: number; amount: number; winners: PlayerId[] };
|
||
};
|
||
}
|
||
```
|
||
|
||
### 8.7 컴퓨터 플레이어 (`bot.ts`, `odds.ts`)
|
||
|
||
자기 화면(view)에 보이는 것만 쓴다: 내 패, 방의 덱(20/40장), 각자 든 장 수, 이번 (재)경기의 공개 베팅 기록(`betLog`).
|
||
|
||
1. **상대 패 범위**: 베팅 하나하나가 그 사람의 패를 좁힌다. 하프·따당·풀은 센 패 쪽(손에 쥘 수 있는 모든 2장 조합을 "무작위 상대에게 이길 몫" 순으로 줄 세운 백분위로 0.55~0.68 근처), 삥·쿼터는 그보다 약하게, 콜은 "뭔가 있음", 체크는 맨 위를 조금 깎는다(함정 체크). 뻥카(블러프)도 있으니 약한 패도 0.22 이상의 무게를 남긴다. 1장만 들고 한 베팅(1장씩 받는 방의 첫 라운드)은 덜 믿는다. 베팅 규칙 111~444로 억지로 한 하프는 정보가 없다.
|
||
2. **승률(판돈 몫) 계산**: 남은 카드에서 나올 수 있는 모든 경우(내가 아직 받을 카드 포함, 3장 섯다는 상대의 3장 중 최고 2장)를 범위 무게를 곱해 더한다. 판정은 실제 쇼다운과 같다(땡잡이·암행어사·구사 재경기·동점). 이기면 1, 나누거나 재경기면 1/참가자 수, 지면 0. 맞대결과 대부분의 3명 판은 경우의 수가 3만 개 이하라 **전부 센다**(예: 20장 2장 섯다 맞대결 153가지, 1장 들었을 때 19×153가지). 그보다 크면(4명 이상, 40장 다인원) 같은 방법으로 무작위 3,000판을 뽑아 센다. 한 번 판단에 수 ms(테스트 기준 최대 수십 ms), CPU만 쓴다 — 경우의 수가 작아 GPU가 필요 없다.
|
||
3. **결정**: 버튼마다 기댓값(원)을 낸다. 다이 0, 체크 = 판돈 × 내 몫, 콜 = 판돈(+뒤에 따라올 사람) × 내 몫 − 콜 금액, 올리기 = 모두 접을 확률 × 판돈 + 아니면 (센 쪽만 남은 상대에 대한 몫) × 커진 판돈 − 건 금액. 접을 확률은 베팅 크기와 그 사람이 이미 보여 준 세기(올렸으면 잘 안 접음)로 정한다. 카드가 더 올 때는 받을 카드마다 "좋으면 계속, 나쁘면 그때 다이"로 한 수 앞을 본다. 레벨(1~60)에 따라 `humanBest`가 가끔 덜 좋은 수를 고른다. 드물게 뻥카(약한 패로 하프), 아주 센 패는 가끔 체크·콜로 기다린다.
|
||
4. **바보 같은 다이 막기**: 체크가 공짜면 다이하지 않는다. 카드가 더 올 때 콜이 손익분기보다 조금 나쁜 정도면 따라간다(1장만 들었고 올리기가 한 번이면 콜 금액의 80%까지, 올리기가 이어지면 35%까지). 예전 봇은 1장 패를 고정값(0.35~0.5)으로 보고 "콜 금액 비율 + 0.12"와 비교해, 1장만 받은 상태에서 하프 한 번에 절반쯤 다이했다(2026-10-13 사용자 신고, `bot.test.ts`에 20장 × 2~4명 회귀 테스트).
|
||
5. 3장 섯다 고르기는 세 조합 각각의 판돈 몫을 같은 방법으로 비교해 고른다(예: 구사보다 세륙). 구사 재참가는 (판돈 + 비용)/참가자 수 > 비용이고 비용이 가진 돈의 1/3 이하일 때.
|
||
|
||
## 9. UI/UX
|
||
|
||
한게임 섯다 화면을 본떴다(`apps/web/src/games/seotda/board.tsx`).
|
||
|
||
화면 배치:
|
||
- PC: 나무 테두리의 초록 테이블. 다른 사람 자리는 내 왼쪽 아래에서 위를 돌아 오른쪽 아래까지 둥글게, 내 자리는 테이블 아래 가운데에 크게(패 2~3장, 족보 이름 금색 큰 글씨, 보유 금액). 가운데에 동전 더미와 **판돈** 큰 숫자, 그 밑에 판 수·기본금·현재 콜 금액. 재경기면 "재경기 2회차 · 구사" 띠.
|
||
- 자리 상자: 아바타, 닉네임, 선 표시, 남은 시간 고리, 보유 금액(만 단위로 줄임), 이번 판에 건 돈, 카드 뒷면, 마지막 행동 말풍선(콜·하프·다이 … 색 구분), 쇼다운 뒤 족보 이름(땡 이상은 금색)과 딴/잃은 금액(+1만 5,000원 / -1만원), 이긴 자리는 금빛 테두리.
|
||
- 휴대폰: 테이블이 세로로 바뀐다. 위에 다른 사람 자리 2~3열, 가운데 판돈, 아래 내 자리. 버튼은 3열.
|
||
- 아래: 베팅 버튼 3×2(콜·다이·하프 / 삥·체크·따당, 쿼터·풀을 켜면 한 줄 더). 버튼마다 낼 금액과 숫자 키(PC)를 적는다. 못 누르는 버튼은 흐리게 두고 자리를 바꾸지 않는다(오조작 방지). 마우스를 올리면 "걸고 나면 내 돈 … 판돈 …"을 미리 보여 준다.
|
||
- 옆 패널: 놀이용 원 안내, 판 정보·시간, 보유 금액 순위, 이번 판 베팅 기록, **족보 도우미**(번호가 작을수록 센 족보, 내 패 줄을 보라색으로 강조, 켜진 특수패만), 판 기록.
|
||
|
||
소리와 움직임(내 행동이든 상대·컴퓨터 행동이든 화면 변화에 반응, 한 변화에 한 번만):
|
||
- 새 판·재경기: 섞는 소리, 카드가 위에서 날아와 놓임(`anim-deal`), 장수만큼 카드 소리.
|
||
- 베팅: 건 사람 자리에서 판돈으로 동전이 날아가고(`sd-fly`) 칩 소리(베팅이 클수록 동전·소리가 많음), 판돈 숫자가 튐(`anim-bump`). 체크는 짧은 딸깍, 다이는 휙 소리.
|
||
- 쇼다운: 남은 사람 패가 뒤집힘(`anim-flip`)과 뒤집는 소리, 족보 이름이 튀어나옴. 이어서 판돈에서 이긴 사람 자리로 동전이 날아가고 모으는 소리. 내가 이기면 승리음과 진동, 쇼다운에서 지면 진 소리.
|
||
- 큰 글자(`anim-banner`): 땡잡이!, 암행어사 출두!, 구사 재경기, 멍텅구리구사 재경기, 같은 족보 재경기, 38광땡!·장땡! 같은 큰 승리. 특수패·광땡·장땡은 팡파르.
|
||
- 내 차례: 차례 소리와 짧은 진동.
|
||
|
||
조작:
|
||
- 3장 섯다 선택: 카드 3장을 누르면 2장이 올라오고, 세 조합 버튼(가장 센 조합에 "추천")으로도 고를 수 있다. 고른 조합 이름이 "○○(으)로 정하기" 버튼에 보인다.
|
||
|
||
### 9.1 화투 그림
|
||
|
||
실제 화투 모양을 쓰기로 했다(2026-10-13 사용자 요청 "진짜 화투 이미지"). 처음 계획(직접 그린 단순 SVG)은 버렸다.
|
||
- 출처: Wikimedia Commons "Category:SVG Hwatu" https://commons.wikimedia.org/wiki/Category:SVG_Hwatu — Marcus Richert가 Louie Mantia, Jr.의 Hanafuda SVG를 바탕으로 한국 화투처럼 다시 칠한 그림(File:Hwatu overview.svg)을 Spenĉjo가 카드별 파일로 나눈 것.
|
||
- 라이선스: CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). 48장 모두 Commons API로 라이선스를 확인했다(2026-10-13).
|
||
- 바꾼 점: 좌표 반올림·공백 제거로 크기만 줄였다(그림은 그대로, 원본과 렌더링 비교에서 장마다 평균 픽셀 차이 1.3/255 이하). 변형본도 CC BY-SA 4.0. 출처·라이선스 파일: `apps/web/src/components/cards/hwatu/ATTRIBUTION.txt`. 규칙 화면에도 출처 한 줄을 보인다.
|
||
- 빌드: `HwatuCard`가 `new URL(`./hwatu/${id}.svg`, import.meta.url)`로 불러 Vite가 해시 붙은 `/assets/` 파일로 내보낸다(외부 URL 없음, 오래 캐시). 카드 오른쪽 위 작은 월 숫자 뱃지는 초보자용으로 우리가 덧붙인다. 카드 뒷면·보너스 패(고스톱)는 직접 그린다.
|
||
- 고스톱(`gostop`)도 같은 `HwatuCard`를 쓰므로 같은 그림이 나온다(쌍피에는 "쌍피" 꼬리표).
|
||
- 파일 대응(파일 이름 = 엔진 카드 id = (월−1)×4 + 칸, Commons 파일 "Hwatu <월> <종류>.svg"):
|
||
|
||
| 월 | 칸 0 | 칸 1 | 칸 2 | 칸 3 |
|
||
|---|---|---|---|---|
|
||
| 1 | `0` January Hikari | `1` January Tanzaku | `2` January Kasu 1 | `3` January Kasu 2 |
|
||
| 2 | `4` February Tane | `5` February Tanzaku | `6` February Kasu 1 | `7` February Kasu 2 |
|
||
| 3 | `8` March Hikari | `9` March Tanzaku | `10` March Kasu 1 | `11` March Kasu 2 |
|
||
| 4 | `12` April Tane | `13` April Tanzaku | `14` April Kasu 1 | `15` April Kasu 2 |
|
||
| 5 | `16` May Tane | `17` May Tanzaku | `18` May Kasu 1 | `19` May Kasu 2 |
|
||
| 6 | `20` June Tane | `21` June Tanzaku | `22` June Kasu 1 | `23` June Kasu 2 |
|
||
| 7 | `24` July Tane | `25` July Tanzaku | `26` July Kasu 1 | `27` July Kasu 2 |
|
||
| 8 | `28` August Hikari | `29` August Tane | `30` August Kasu 1 | `31` August Kasu 2 |
|
||
| 9 | `32` September Tane | `33` September Tanzaku | `34` September Kasu 1 | `35` September Kasu 2 |
|
||
| 10 | `36` October Tane | `37` October Tanzaku | `38` October Kasu 1 | `39` October Kasu 2 |
|
||
| 11 | `40` November Hikari | `41` November Kasu 2 | `42` November Kasu 1 | `43` November Kasu 3 |
|
||
| 12 | `44` December Hikari | `45` December Tane | `46` December Tanzaku | `47` December Kasu |
|
||
|
||
초보자 도움:
|
||
- "규칙 보기": 진행 순서, 끗 계산법, 족보표, 특수패 설명, 베팅 용어(기본금·삥·콜·따당·하프·체크·다이, 숫자 키).
|
||
- 첫 판 말풍선 튜토리얼. 내 차례 진동/소리, 남은 시간 게이지.
|
||
- 힌트: "지금 패는 5끗이에요. 중간 정도 패예요." 같은 쉬운 문장(강도 3단계: 높음/중간/낮음 색).
|
||
|
||
## 10. 테스트 체크리스트
|
||
|
||
- [ ] 족보 전수: 20장에서 나오는 190개 2장 조합의 이름·값이 6.1/6.2 표와 일치(옵션 조합 `gwangTtaeng`, `ttaengjabi`, `amhaeng`, `gusa`, `mungGusa`별 스냅샷).
|
||
- [ ] 1월 광 + 3월 광: `all`이면 13광땡, `only38`이면 4끗. 1월 띠 + 8월 광은 갑오.
|
||
- [ ] 6.4 예시 1~12가 모두 기대 결과와 일치.
|
||
- [ ] 땡잡이 `strict`: 3월 띠 + 7월 열끗은 일반 망통이며 9땡을 잡지 못함. `loose`면 잡음.
|
||
- [ ] `loose` 땡잡이 2명 + 5땡 → 땡잡이 두 사람 동점 처리(`tieRule`).
|
||
- [ ] 구사 재경기: 판돈 유지, 기본금 재징수 없음, 참가자는 쇼다운 생존자만(`rejoinCost=none`).
|
||
- [ ] 구사 재경기 `rejoinCost=half`: 다이한 사람이 판돈 절반(내림)을 내고 참가, 보유 금액이 모자라면 거부, 시간 초과 시 불참.
|
||
- [ ] 동점 재경기 3연속 후 4번째에는 균등 분할, 나머지 원은 선에서 가까운 승자.
|
||
- [ ] 사이드 팟 + 재경기: A 올인(메인만), 메인에서 A·B 동점, 사이드(B·C)에서 B 단독 승 → 사이드는 즉시 B에게, 메인만 A·B 재경기.
|
||
- [ ] 베팅: 5.4 예시(기본금 30 → 삥 → 하프 35 → 따당 70 → 콜 → 콜) 최종 판돈 240.
|
||
- [ ] 체크·콜 후 같은 라운드 레이즈 거부, `maxRaise=half`에서 `full` 거부.
|
||
- [ ] 2차 베팅 첫 행동자: 선이 1차에서 다이했으면 선 다음 좌석의 남은 사람.
|
||
- [ ] `dealMode=oneRound`: 베팅 1회 후 바로 쇼다운.
|
||
- [ ] 3장 섯다: 선택 전 다른 사람 `view`에 선택 결과 없음, 버린 카드는 쇼다운 후에도 어떤 `view`·이벤트에도 없음.
|
||
- [ ] 3장 섯다 시간 초과 자동 선택: 1광·8광·4열끗 → 18광땡 조합 선택.
|
||
- [ ] 시간 초과: `opened=false`면 체크, 아니면 다이. 2연속 → `away`, 마감 5초.
|
||
- [ ] 연결 끊김 상태로 선 차례 → 마감 후 자동 체크/다이, 재접속 후 정상 행동.
|
||
- [ ] 비밀 누출: 매 단계 모든 시청자(플레이어·관전자) `view`와 이벤트 JSON에 남의 비공개 카드의 월·종류·id가 없음(무작위 시드 1,000판 속성 테스트).
|
||
- [ ] 다이로 끝난 판: 승자 패도 공개되지 않음.
|
||
- [ ] 리바이·탈락·점수: `hands` 점수 = 보유 금액 - 시작 금액 × 리바이, `lastStanding` 동시 탈락 순위.
|
||
- [ ] 금액 보존 불변식: `Σ스택 + Σ팟 + Σ이번 라운드 기여 = 초기 금액 합 + 리바이 합` (재경기 중에도).
|
||
- [ ] 재현성: 같은 시드 + 같은 액션 열 → 같은 상태 해시.
|
||
- [x] 한게임 방식 기본값: 2장 한 번에·베팅 1번, 원 단위(기본금 1만원 × 3명 = 판돈 3만원), 쿼터 없음.
|
||
- [x] 베팅 규칙 222: 선과 다음 사람은 하프·다이만, 그 뒤 자유. 111에서 선 시간 초과 → 다이.
|
||
- [x] 40장: 40장 모두 쓰고, 3장 섯다 10명까지. 시간 무제한: 베팅·고르기 마감 없음.
|
||
- [x] v1(칩) → v2(원) 옮기기: 금액 × 1000, 진행 중 규칙 유지.
|
||
- [x] 컴퓨터: 맞대결 승률이 직접 센 값과 같음(153가지), 1장 상태 하프에 다이하지 않음(20장 × 2~4명), 비싼 연속 올리기에는 약한 1장이 다이, 하프를 맞은 8끗은 체크를 본 8끗보다 승률이 낮음, 땡잡이는 상대가 세게 걸수록 승률이 오름.
|
||
|
||
## 11. 참고 자료
|
||
|
||
- 나무위키 "섯다": https://namu.wiki/w/섯다 (20장 구성, 족보 순서, 땡잡이 = 3월 광 + 7월 열끗, 암행어사 = 4월 열끗 + 7월 열끗로 13·18광땡만 잡음, 구사는 상대 최고패가 알리 이하일 때 판돈을 둔 채 재경기, 멍텅구리구사는 8땡까지 재경기·광땡은 불가·지역에 따라 장땡 차이, 다이한 사람이 구사 재경기에 참가하려면 판돈만큼 지불, 같은 족보는 판돈을 둔 채 재대결, 3장 섯다, 베팅 용어 정의)
|
||
- 한게임 포커 7포커 베팅 방법(공용 한국식 베팅 용어 정의): https://poker.hangame.com/gameguide/poker7/game_7poker2_1.html
|
||
- 포커 문서 `docs/games/poker.md` 5.2(한국식 베팅), 5.5(사이드 팟), 5.6(리바이).
|
||
- 한게임 섯다 게임방법(공식 안내, 2026-10-13 확인): https://gostop.hangame.com/gameGuide/gssudda/guide_gssudda01_01.html — 20장/40장, 3장 섯다는 2장 받고 베팅 → 1장 더 받고 베팅, 2장 섯다는 2장을 모두 받고 베팅, 족보·특수 족보(땡잡이 = 3월 + 7월로 9땡 이하를 잡음, 암행어사 = 열자리 4·7로 13·18광땡을 잡고 아니면 1끗, 구사는 알리 이하와 재경기, 멍텅구리 구사는 9땡 이하와 재경기), 베팅 버튼과 숫자 키(콜 7, 삥 4, 다이 8, 체크 5, 따당 1, 하프 0), 베팅룰 일반/111/222/333/444, 게임 화면(나의 패와 족보, 베팅 버튼, 족보도우미, 판돈).
|
||
- 화투 그림: Wikimedia Commons "Category:SVG Hwatu"(9.1).
|
||
|
||
출처 간 차이와 이 문서의 선택:
|
||
- 멍텅구리구사 범위: "8땡까지"가 기본 서술이고 지역에 따라 장땡까지 무승부로 보기도 한다 → `mungGusa` 옵션, 기본 8땡.
|
||
- 재경기 재참가 비용: 나무위키는 "판돈만큼"이라 하지만 지역마다 다르다 → 기본은 재참가 불가, 옵션으로 절반/전액.
|
||
- 구사가 이미 이기는 경우의 재경기 여부: 6.3 설계 결정 참고.
|
||
|
||
## 12. 메모 (상표·법적 주의 등)
|
||
|
||
- 놀이용 원만 사용한다. 방 전용이며 진짜 돈·유료 재화·광고 보상과 연결하지 않는다. 거래·선물·누적 랭킹을 만들지 않는다. 2026-10-13 사용자 요청으로 한게임 섯다처럼 "원"과 "판돈"이라는 말만 쓰기로 했다(`no-money-wording.test.ts`에서 섯다만 이 두 낱말 예외). ₩ 같은 화폐 기호, 현금·머니·골드, 충전·환전·결제·구매 같은 거래 낱말은 섯다에서도 쓰지 않는다. 옆 패널과 규칙에 "이 방 안에서만 쓰는 놀이용 숫자, 진짜 돈과는 상관없음"을 늘 보인다.
|
||
- 법적 검토 필요(사용자 확인):
|
||
- 형법 제246조(도박): 재물을 걸지 않는 구조라 해당하지 않도록 설계했지만, 외부 정산을 부추기는 기능은 넣지 않는다.
|
||
- 게임산업진흥법 등급분류: 공개 배포하는 게임물은 원칙적으로 등급분류 대상이고, 비영리 예외는 청소년이용불가 기준에 해당하는 내용을 포함하면 적용되지 않는다. 섯다·고스톱·포커 같은 웹보드 게임은 통상 청소년이용불가로 분류되므로 서비스 전 확인이 필요하다.
|
||
- 어린이 사용자가 있으므로 섯다는 기본 목록과 분리하거나(예: "어른용" 탭) 방장 확인 문구를 두는 방안을 검토한다.
|
||
- 화투 그림: 시판 화투나 다른 게임(한게임 포함)의 그림은 각 제작사의 저작물이라 가져오지 않는다. 대신 자유 라이선스(CC BY-SA 4.0)로 공개된 Wikimedia Commons 그림을 출처 표시와 함께 쓴다(9.1). 바꾼 그림을 다시 내보낼 때도 같은 라이선스로 둔다.
|
||
- 명칭: "섯다"는 일반 놀이 이름이라 상표 문제가 적다. 특정 서비스 이름(예: "한게임 섯다", "피망 섯다")은 화면에 쓰지 않는다(화면·흐름·용어만 본뜸, 문서에는 참고 출처로만 적음). 표시 이름 후보: "섯다"(기본), 어린이 노출을 줄이고 싶다면 "화투 족보 대결".
|