새 게임 티츄: 4인 2:2 팀전(원작, 1,000점) 기본 + 4인 개인전·3인(더미)·6인 3:3 변형, 그랜드/스몰 티츄, 끼어드는 폭탄, 참새 소원, 파티 모드

- 엔진 packages/games/src/tichu/: combo.ts(조합 판정·봉황 가장 센 해석·폭탄 비교·소원 의무·조합 찾기, 화면도 @bg/games/tichu/combo로 같이 씀), index.ts(그랜드 → 교환 → 플레이 → 용 주기 → 라운드 결과 상태 기계), bot.ts
- 옵션 전부: mode(team/individual/threechu/tientsin), targetScore, threechuHands, grandTichu, direction, bombTiming + bombWindowSeconds("카드 모으는 중" 폭탄 창, 폭탄 유무와 상관없이 같은 대기), wishRule(enforce/penalty), trickHistory(last/all), party(두 배·점수 뒤집기·손패 돌리기·평범, 연속 없음), turnSeconds, exchangeSeconds
- 비공개: 남의 손패·남은 6장·교환 전 더미. 카드 ID가 라운드마다 다시 쓰여 새 라운드에 지난 play 기록을 지움. 탑 무늬 ID는 b(p2 같은 플레이어 id와 겹침 방지)
- 컴퓨터: 손패 나누기 비용으로 가장 약한 조합부터, 짝꿍 트릭은 패스, 폭탄·용은 상대가 곧 나갈 때, 티츄/그랜드 판단, 교환(짝꿍 좋은 카드·상대 개와 약한 낱장), 패널티 모드에서도 소원 지킴, 레벨 1~60
- 화면 apps/web/src/games/tichu/: 52장은 PlayingCard(4색), 참새·개·봉황·용은 직접 그린 SVG. PC 십자 배치·휴대폰 칩 줄, 손패 7장×2줄(320px), 고른 카드 실시간 "풀하우스(9) · 낼 수 있어요", 추천 조합 칩, 소원 시트, 폭탄 목록, 교환 칸 3개(추천대로 채우기·다시 고르기), 용 주기, 라운드 결과 표, 점수판·라운드 기록·직전 트릭·나온 카드 표, 소리·흔들림·배너, 도움말·30초 요약
- 등록: GAMES·BOT_STRATEGIES·BOT_GAMES·CATALOG·GAME_UI·GAME_ICON·카드·패 탭, docs/games/README.md, result-score 테스트에 300점 옵션, e2e/games.e2e.ts(PC + 휴대폰 3대, 1라운드 끝 → 2라운드)
- 문서 docs/games/tichu.md에 구현 메모(정한 것) 추가
- 검증: tichu 64개, web games 224개, server 240개, bots·result-score 161개, 타입 검사·웹 빌드, E2E_PORT=4603 bun e2e/games.e2e.ts tichu 통과

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-15 23:31:37 +09:00
parent 8620c82ca8
commit 4f69f19bf9
23 changed files with 5156 additions and 6 deletions

View File

@@ -47,6 +47,7 @@
| `liar` | 라이어 게임 | 3~10 | 2026-10 새 게임 |
| `magical-athlete` | 야단법석 달리기 | 2~6 | 2026-10 새 게임 |
| `blackjack` | 블랙잭 | 1~7 | 2026-10 새 게임 |
| `tichu` | 티츄 | 4 (변형 3·6) | 2026-10 새 게임 |
인원은 각 게임 문서에서 원작 기준으로 최종 확정한다(이 표와 다르면 게임 문서가 우선).

View File

@@ -27,7 +27,8 @@
| `exchangeSeconds` | 카드 교환 제한 시간 | 30 / 45 / 60 / 무제한(`null`) | 45 | 사이트 |
- 인원(`playersFor`): `team`·`individual` 4명, `threechu` 3명, `tientsin` 6명. 컴퓨터로 빈자리를 채울 수 있다.
- 구현 순서 제안: 1단계 = `team` + `targetScore`·`grandTichu`·`direction`·`bombTiming`·`bombWindowSeconds`·`trickHistory`·시간 옵션, `wishRule=enforce`. 2단계 = `individual`, `threechu`, `tientsin`, `wishRule=penalty`, `party`. 2단계 옵션은 구현 전까지 스키마에 넣지 않는다.
- 구현(2026-10-15): 표의 옵션을 모두 구현했다(나중으로 미룬 것 없음). `party`는 `team`·`individual`에서만 효과가 있고 다른 모드에서는 무시한다.
- 구현 순서 제안(참고): 1단계 = `team` + `targetScore`·`grandTichu`·`direction`·`bombTiming`·`bombWindowSeconds`·`trickHistory`·시간 옵션, `wishRule=enforce`. 2단계 = `individual`, `threechu`, `tientsin`, `wishRule=penalty`, `party`. 2단계 옵션은 구현 전까지 스키마에 넣지 않는다.
## 3. 구성물
- 56장.
@@ -45,7 +46,7 @@
| 나머지 | 0점 |
- 한 라운드 카드 점수 합은 언제나 100점이다(5×4 + 10×4 + 10×4 + 25 − 25).
- 엔진 카드 ID: 숫자 카드 `<무늬><숫자>`(무늬 `j`옥·`s`칼·`p`탑·`t`별, 숫자 2~14, J=11, Q=12, K=13, A=14). 예: `j2`, `t10`, `s14`. 특수 카드 `MJ`(참새), `DOG`(개), `PH`(봉황), `DR`(용).
- 엔진 카드 ID: 숫자 카드 `<무늬><숫자>`(무늬 `j`옥·`s`칼·`b`탑·`t`별 — 탑을 `p`로 하면 `p2` 같은 테스트 플레이어 id와 겹쳐 정보 유출 검사가 헛걸려서 `b`(파랑)로 정함, 숫자 2~14, J=11, Q=12, K=13, A=14). 예: `j2`, `t10`, `s14`. 특수 카드 `MJ`(참새), `DOG`(개), `PH`(봉황), `DR`(용).
## 4. 준비(셋업)
기본(`team`) 기준. 다른 모드의 차이는 §5.9.
@@ -462,3 +463,17 @@ interface TichuFinal {
- 6인전 손패 장수는 원작 룰북에 없다. 공개된 플레이 후기(9장, 2명 10장)를 따랐고, 규칙 화면에 "원작에 장수가 없어 이 사이트가 정한 방식"이라고 적는다.
- 파티 모드 효과와 `trickHistory`, `bombWindowSeconds`는 이 사이트가 정한 것이다. 규칙 화면에 "공식 아님" 표시를 붙인다.
- 돈, 칩을 쓰지 않는다. 점수는 방 안 결과 표시용이다.
## 13. 구현 메모 (2026-10-15)
- 규칙 모듈 `packages/games/src/tichu/`: `combo.ts`(판정·조합 찾기, 화면도 `@bg/games/tichu/combo`로 같이 씀), `index.ts`(상태 기계), `bot.ts`.
- 정한 것(문서에 없거나 애매했던 부분)
- 자리는 시계 방향 번호, 화면에서 내 왼쪽 = 자리+1. 교환 칸 이름(왼쪽 상대·짝꿍·오른쪽 상대)은 화면 자리 기준이라 `direction`과 상관없이 같다. 차례 방향은 바닥 화살표로 보여 준다.
- 3인: 딜러 자리 0, 더미는 맞은편 자리 2. 딜러는 차례 방향으로 다음 사람에게 넘어간다. 딜러와 더미 자리는 그랜드 단계를 자동으로 "안 함" 처리한다. 딜러의 행동에는 `seat`를 늘 붙인다.
- 6인 소원 위반 패널티: 원투가 없으므로 상대 팀 300점(트리플 빅토리와 같게).
- 그랜드·스몰 티츄와 용 주기의 마감은 `turnSeconds`를 따르고(무제한이면 없음), 교환은 `exchangeSeconds`, 라운드 결과는 10초.
- "카드 모으는 중"에 [폭탄 없음]을 누른 자리는 그 창이 끝날 때까지 폭탄을 낼 수 없다(누르면 확정). 이 창의 시간 초과는 자리 비움 횟수에 넣지 않는다.
- 모두 방을 나가면 게임을 `abandoned`로 끝낸다.
- 결과 요약은 이름 대신 "A팀(0·2번 자리)/B팀"으로 쓴다(규칙 모듈은 닉네임을 모름).
- 카드 ID가 라운드마다 다시 쓰이므로 새 라운드를 시작할 때 기록에서 지난 라운드의 `play` 줄을 지운다(정보 유출 방지).
- `legalActions`(테스트·컴퓨터용)는 그랜드·스몰 티츄를 "해 볼 만한 손패"(용3·봉황3·A2·K1·폭탄4 합이 6/7 이상)일 때만, 그리고 다른 할 일과 함께만 넣는다. 무작위 대국이 절반 확률로 선언해 점수가 끝없이 내려가는 것을 막기 위해서다. `validate`는 언제든 받는다. 컴퓨터는 선언을 스스로 만든다.
- 휴대폰 320px에서 손패는 7장씩 두 줄(카드 폭 약 38px, 높이 53px). 44px 너비는 320px에 7장이 들어가지 않아 높이로 탭 영역을 확보했다.