- 엔진 packages/games/src/gemblo/(board·options·types·index·bot): 463칸 판(3인 241·4인 295·듀오 157칸), 블록 18개 72칸(방향 74/뒤집기 포함 92개 미리 계산), 같은 색 변 맞댐 금지, 꼭짓점 이음선(한 블록이 사이 두 칸을 덮으면 막힘, 두 블록 틈은 통과), 놓을 곳 없는 색 자동 끝남, 남은 칸 점수·공동 순위
- 방 설정 §2 전부: 자리, 2명 2색/3색/듀오, 3명 1색/2색, 5명 장애물 자동/직접 고르기/없음, 이음선 막힘, 뒤집기(기본 허용), 점수(남은 칸/블로커스 보너스), 팀전(2명씩·3명씩), 금색 방해 블록 0/3/6, 이음점 표시, 시간(한 번당·피셔), 시간 초과 처리(자동 배치/넘김/끝), 연속 자동 한도, 무르기
- 합법 배치: 이음점 × 블록 × 방향 × 맞출 칸, (블록·방향·기준 칸) 도장으로 중복 제거, apply·legalActions 수 ms
- 컴퓨터: 큰 블록 + 내 이음점 늘리기 + 남의 이음점 막기 + 초반 가운데로, 상위 80개만 자세히, humanBest 1~60단계, 한 수 10ms 안팎
- 화면 apps/web/src/games/gemblo/: 납작한 육각 SVG 판(안 쓰는 칸 흐리게, 보석 색 + 색약용 무늬), 마우스 미리보기·휠/R 돌리기·F 뒤집기, 휴대폰 칸 누르기·끌어 옮기기·[놓기], 이음점을 누르면 그 점을 덮는 합법 배치를 차례로, 두 손가락 확대·이동과 [확대]/[전체], 키보드 조작, 5인 장애물 고르기·놓기, 무르기·기권, 끝나면 색별 남은 블록, 소리·애니메이션, 도움말·30초 요약
- 등록: GAMES·BOT_STRATEGIES·BOT_GAMES·CATALOG·GAME_UI·GAME_ICON·판·주사위 탭, 운 제외(NO_LUCK), docs/games/README.md, docs/games/gemblo.md(구현 결정 13장)
- 테스트: 규칙 30개(문서 §10 전부, 5인 장애물 시드 100개, 클라이언트 판정 = validate 1만 개, 무작위 대국 11가지 모드), 컴퓨터 4개, 도움말 2개, 방 통합 2개(연습 한 판, 5명 직접 고르기 + 시간 초과만 하는 사람), e2e games.e2e.ts gemblo
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 엔진 packages/games/src/blackjack/(options·types·rules·index·bot): 베팅→인슈어런스→플레이→딜러→결과 단계 상태 기계, 비공개는 딜러 홀 카드와 슈뿐(재셔플마다 카드 id 유일), 칩은 하우스 상대로 정산
- 컴퓨터: 기본 전략(S17 차트) + 레벨 1~60(쉬움은 딜러 흉내·인슈어런스 가끔, 어려움은 차트대로·인슈어런스 거절)
- 웹 apps/web/src/games/blackjack/: 초록 테이블·손패·단계별 버튼·방 설정 변형, 30초 요약·도움말, 표준 카드 아트 재사용
- 등록: GAMES·BOT_STRATEGIES·BOT_GAMES·CATALOG·GAME_UI·GAME_ICON·게임 탭, 문서(games/blackjack.md·README·로드맵·결정 사항), e2e/games.e2e.ts
- 검증: 엔진·봇 테스트, 무작위 플레이(여러 옵션) JSON 왕복·정보 누출 없음, 전체 테스트 2,611개·타입 검사·웹 빌드 통과, bun e2e/games.e2e.ts blackjack 통과
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- 할리갈리: 자리마다 뒷면 덱 더미(장수만큼 쌓임)와 펼친 더미를 나란히(펼친 쪽이 종 쪽), 뒤집으면 카드가 덱에서 들려 3D로 뒤집혀 내려앉음, 차례 말표·내 덱 들썩임(덱을 눌러도 뒤집기), 종 판정 때 친 사람 쪽에서 손바닥이 날아와 종을 때리고 파동(정답 노랑/오답 빨강), 정답자 금빛·"+N장", 오답 "-N장", 새 카드 뒷면, 말풍선은 종 바로 위
- 바퀴벌레 포커: 펠트 테이블(왼쪽)과 행동 칸(오른쪽, 휴대폰은 아래). 상대 자리 판(손패 뒷면 부채, 앞마당은 벌레별 실제 카드 더미+장수 배지·위험 테두리), 가운데 "건넨 사람 ➜ 받는 사람"·기울어 놓인 카드·주장 말풍선, 판정 때 카드가 3D로 뒤집히고 "진짜/거짓" 도장 → 앞면 카드가 가져가는 사람 앞마당으로 날아가 더미에 내려앉음, 내 손패 카드 부채
- 두 게임 30초 규칙 그림도 같은 테이블·카드 모양으로, 문서 §9 갱신
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 서버: SiteSettings.gameSpeed, /api/config에 노출, 컴퓨터 생각 시간(defaultBotDelay)과 마피아·라이어 컴퓨터가 살펴보는 간격에 BOT_SLOWDOWN(1.5)/배율. 게임이 정한 반응 시각(원카드 외치기)은 그대로
- 웹: lib/motion.ts — .game-layout 안 CSS 애니메이션·트랜지션은 useMotionScope가 playbackRate로, Web Animations는 fxAnim, 연출 타이머(배너 유지·다음 단계·복사본 정리·숫자 세기·다시 보기 한 칸)는 fxMs. 채팅·role="timer"·규칙 시간·꾹 눌러 보기는 제외
- 관리자 사이트 탭에 배율 버튼(1/16~16)과 직접 입력
- 테스트: 배율 검증(API 400/200, 열린 방 즉시 반영), 컴퓨터 생각 시간 배율, motion 단위 테스트, e2e/speed.e2e.ts(돌 애니메이션 재생 배율·컴퓨터 응답 시간), 관리자 e2e에 배율 저장
- 문서: 14-admin §5, 07-ui-ux, 06-lobby-rooms, 13-decisions, README
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 체스: 직접 그린 기물을 Wikimedia Commons Cburnett 12장(Chess_{k,q,r,b,n,p}{l,d}t45.svg)으로 바꿈.
최소화 SVG(합계 약 11 KB)를 chess/pieces/에 두고 art.ts의 pieceSrc()로 판 SVG 안 <image>로 그림
(Vite가 체스 청크에 data URL로 넣음). 미끄러짐·내려앉기·잡힘·끌기·키보드·aria는 그대로.
30초 규칙 요약 그림판도 같은 기물, 다크 모드에서 판 밖 흑 아이콘에 옅은 테두리. 규칙 화면에 출처 한 줄.
- 마작: 직접 그린 패 앞면을 Shizhao 컬러 세트 34장(MJ*.svg, PD-self / 서풍 CC0)으로 바꿈.
윤곽·흰 바탕을 지우고 svgo로 줄인 37장(적도라 5mr·5pr·5sr 포함, 약 120 KB)을 mahjong/tiles/에 둠.
패 몸통·뒷면·선택·흐림·애니메이션·aria는 그대로, 왼쪽 위에 숫자/한글(동·남·서·북·백·발·중)을 겹치고
작은 패(30px 미만)에서는 크게 써서 버림패·휴대폰 손패에서도 읽힘. 마작 청크에만 들어감. 규칙 화면에 출처 한 줄.
- 출처 파일 ATTRIBUTION.txt(각 폴더), docs/games/chess.md §9 "기물 그림", docs/games/mahjong.md §9.2 "패 그림".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 루미큐브: 옮긴 타일이 원래 자리에서 미끄러져 가고, 남이 바닥에 낸 타일은 그 사람 칸에서 날아옴. 가져온 타일은 남은 타일 더미에서 받침대로 날아오고, 남이 가져가면 뒤집힌 타일이 그 사람 칸으로 날아감. 배너를 공통 useBanner로 바꾸고 "루미큐브!"·"판 끝"·승리 배너 추가
- 마피아: 밤에는 화면이 남색으로 어두워지며 달, 아침에는 해가 떠오름. 득표 막대가 한 줄씩 자라고, 탈락한 사람 칸이 뒤집히며 흐려짐. 탈락·살았다·버텼다·조용한 밤·이긴 팀 배너를 차례로
- 라이어: 득표가 한 줄씩 나온 뒤 지목된 사람에게 스포트라이트와 흔들림, "잡았다!"/"헛다리!"·동점·정답/땡·승리 배너
- 바둑: 패스·계가 배너, 계가 때 집 표시가 차례로 나타나고 결과 점수가 0부터 올라감, 승리 배너
- 클루: 말과 흉기가 새 자리로 튀어 오르며 미끄러져 감, 추리한 세 장이 사건 봉투로 날아가고, 보여 준 카드는 뒤집히며(남에게는 뒷면 카드가 날아감)
- 오목: 금수 자리를 누르면 빨간 ✕와 "금수" 글자, 판이 흔들림(키보드 Enter도 같은 안내). "오목!"·승패 배너
- 포커: 쇼다운·인디언 이마 카드가 뒷면이 돌아간 뒤 앞면이 돌아 나오는 진짜 뒤집기로
- 모두 누구의 행동이든 화면 변화에 반응하고, 클릭을 막지 않으며, 동작 줄이기 설정을 따름. 게임 문서 UI 절에 반영
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 엔진: 공개패 단계(open)·액션, 공개패는 다른 사람 화면에 앞면, 최종 선택은 마지막 베팅 뒤(threePick=end), 옵션 threeOpen/threePick으로 예전 흐름 유지, 상태 v3(진행 중인 방은 예전 흐름)
- 컴퓨터: 광·4/7/9 열끗은 숨기고 평범한 패 공개, 상대 공개패를 패 범위에 반영
- 화면: 공개패 고르기 상자, 자리 표시·도움말·규칙·옵션
- 2장 섯다 기본(2장 한 번에)은 한게임 안내 그대로, 1장씩(전통)은 옵션
- E2E seotda3, 문서 §2·§5.2·§8
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
엔진: 경주 기록 줄에 화면용 mv(이동 출발·도착 칸)와 die(굴린 눈) 추가, mv만 따라가도 말 자리가 맞는지 무작위 대국 테스트.
화면: replay.ts(기록 → 주사위·걷기·효과 순서) + 테스트, 문서 §9·§10.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 모두 view 변화(기록·이전 view 비교)에 반응해서 컴퓨터·다른 사람 행동에도 소리와 움직임이 나옴, 처음 렌더·다시 보기는 건너뜀
- 뱅!: 총소리·개틀링·인디언·결투·판정 카드·다이너마이트·감옥·맥주·쓰러짐 배너
- 고스톱: 패 내기 "탁", 뒤집기, 먹기, 피 뺏기, 뻑·따닥·쪽·싹쓸이·폭탄·흔들기 배너, N고, 판 끝(마지막 판 승패 소리는 결과 창 하나만)
- 스플렌더: 보석·카드·귀족이 날아가고 보석 소리, 마지막 라운드 배너
- 바퀴벌레 포커: 건네기·판정 배너·앞마당으로 날아감·위험 경고음
- 구십구: 카드가 합계 다이얼로, 90 이상 두근, 바로 99 배너, 방향 바뀜, 목숨·탈락
- E2E: 구십구·바퀴벌레 포커를 무제한으로 진행하고 타이머가 안 보이는지 확인
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 던지기: 휙 + 가락 4개가 멍석에 떨어지는 딱딱 소리(떨어지는 순간에 맞춤), 윷·모 밝은 음, 빽도 내려가는 음, 낙 둔탁한 소리
- 가락마다 다르게 돌고 떨어진 뒤 한 번 튐, 결과 글자 튀어나옴(윷·모 빨강), 낙이면 가락 흔들림
- 말: 한 칸마다 작은 "콩"(튀는 움직임과 같은 때), 도착 시 잡기·업기·나기 소리와 고리(잡기 빨강, 나기 금색)
- 잡힌 말은 움직이는 말이 도착할 때까지 남아 있다가 튀어 오르며 사라짐
- 상대·컴퓨터 차례도 화면 변화로 같은 소리·움직임, 숨은 탭의 내 차례 소리는 방 화면에 맡겨 두 번 울리지 않게
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>