- 엔진 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>
79 lines
12 KiB
Markdown
79 lines
12 KiB
Markdown
# 13. 사용자 결정이 필요한 항목
|
||
|
||
아래 항목은 사용자 확인이 필요하다. **답이 없으면 "기본안"으로 진행**하고, 나중에 바꿀 수 있게 옵션으로 만들어 둔다.
|
||
|
||
## 0. 확정된 결정 (2026-10-04)
|
||
- 도메인: **game.tkrmagid.kr** 고정. 모든 기능을 완성한 뒤 연결한다.
|
||
- 상표명: 친구끼리 쓰는 사이트라 **원래 이름을 그대로 사용**한다.
|
||
- 관리자 사이트 추가. 슈퍼어드민은 `SUPERADMIN_DISCORD_IDS`의 디스코드 ID, 어드민은 디스코드 ID로 추가(`14-admin.md`).
|
||
- 화면은 **PC 버전 중심**으로 만든다(휴대폰은 접어서 지원).
|
||
- 게임 규칙 기본값은 관리자 사이트에서 모두 바꿀 수 있으므로, 3절의 기본안은 "처음 값"이다.
|
||
|
||
## 0-1. 확정된 결정 (2026-10-06)
|
||
- 일반 이름으로 만들었던 게임 4개를 원래 이름으로: 보석 상인 → **스플렌더**, 벽 쌓기 길찾기 → **쿼리도**, 숫자 타일 → **루미큐브**, 주사위 땅따먹기 → **부루마불**.
|
||
- 스플렌더 카드 수치: 원작 그대로.
|
||
- 구십구: 공식 규칙이 있으면 그것으로, 없으면 알아서. → 코리아보드게임즈 공식 상품 페이지의 규칙 설명 이미지로 맞춤. 공개되지 않은 특수 카드 장수는 각 4장으로 정함(`games/ninety-nine.md` §1).
|
||
- 서버: **.5 Docker 호스트**(192.168.10.5:2970), 앞단은 기존 NPMplus(192.168.10.3)가 HTTPS를 맡는다(`11-deployment-ops.md` 7절).
|
||
- 디스코드 앱 생성 완료(Client ID `1557009917641105499`). Secret은 서버 `.env`와 호스트 비밀 저장소에만 둔다.
|
||
|
||
## 0-2. 확정된 결정 (2026-10-13)
|
||
- 소리·움직임: 모든 게임. 화면 정보(view) 변화에만 반응해 한 번씩 울리고, 처음 들어올 때·다시 접속·무르기는 조용하다. 승패 소리는 방 화면만 낸다. 숨은 정보는 소리·배너로도 드러내지 않는다. 오디오 파일 없이 합성음만 쓴다. 사이트 음량 0~100(기본 50, 기기별).
|
||
- 시간 "무제한": 시간 제한이 있는 모든 게임에 둔다. 무제한이면 마감·시간 초과가 없고, 연결이 끊긴 사람은 방의 유예 시간 뒤 그 사람 몫만 자동 처리한다. 자리 비움 짧은 마감은 그대로. 마피아·라이어는 단계별로 고르고 모두 마치면 넘어간다(마피아 밤은 직업을 숨기려고 생존자 모두 "밤 마치기"). 그림 맞히기 무제한은 출제자가 정답 공개하고 넘긴다. 판 결과 화면 시간은 무제한 대상이 아니다.
|
||
- 원카드: 카드 내기와 [원카드!] 외치기는 따로다(자동 외치기 옵션만 예외). 1장 남은 뒤 2초(1~3초 옵션)는 본인만 누를 수 있고, 그 뒤엔 누구나 잡는다. 컴퓨터는 실력별로 늦게 외치고, 남의 깜빡임은 확률로만 알아챈다. "외치면 다른 사람이 1장씩 먹기" 하우스 룰(기본 끔)도 있다.
|
||
- 섯다: 한게임 섯다 방식(2장 한 번에 받기 기본, 20/40장, 베팅 규칙 일반/111~444, 땡잡이 3·7 아무 패, 멍텅구리구사 9땡까지, 쿼터 기본 끔, 숫자 키 베팅). 금액은 "원", 모인 돈은 "판돈"(섯다만 예외, 화폐 기호·현금·머니·충전·환전 같은 낱말은 계속 금지, 놀이용 안내 항상 표시). 예전 칩 방은 ×1000으로 옮긴다. 컴퓨터는 남은 패를 CPU로 전부 세어(크면 표본 3,000판) 기댓값으로 고른다. GPU는 쓰지 않는다(경우의 수가 작아 CPU로 정확히 계산됨, 판단 1번 수 ms).
|
||
- 화투 그림: Wikimedia Commons "SVG Hwatu"(Marcus Richert·Spenĉjo, CC BY-SA 4.0). 섯다·고스톱 규칙 화면과 `components/cards/hwatu/ATTRIBUTION.txt`에 출처 표시.
|
||
- 컴퓨터 채팅: 이름("컴퓨터 1", "컴1", "1번")·이어 말하기면 매번 대답, 모델이 2.5초 넘거나 없으면 내장 대답, 한 사람당 1분 8번까지. 혼잣말은 눈에 띈 수에만(방 40초·컴퓨터 90초 간격), 시작 인사·사람 대화 끼어들기 없음. 수와 어긋난 말(센 베팅에 "쫄" 등)은 수 종류별 내장 한마디로 바꾼다.
|
||
|
||
## 0-3. 확정된 결정 (2026-10-14)
|
||
- 게임 속도: 전체가 빠르다는 요청으로 1배에서도 애니메이션·연출과 컴퓨터 생각 시간을 예전의 1.5배로 늘렸다. 관리자 사이트 설정 "게임 속도 배율"(1/16~16배, 기본 1배)로 둘 다 나눠서 조절하고, 저장하면 열린 방에도 바로 적용한다. 턴 제한 시간·결과 화면 대기 같은 규칙 시간과 반응 경쟁(원카드 외치기, 할리갈리·도블 판정)은 공정성 때문에 배율과 무관하다.
|
||
- 루미큐브: 사용자 요청("루미큐브 앱 규칙으로", "드래그해서 화면에 놔두고 합치는 방식, 모두한테 보이게")으로 루미큐브 앱(Rummikub® 공식 앱) 방식을 기본으로 바꿨다. ① 바닥은 칸(20×12) 판이고, 받침대·바닥의 타일을 끌어다 아무 칸에나 놓으며 한 줄에 나란히 붙은 타일이 한 묶음이다(눌러 고르고 빈 칸 누르기도 됨). ② 차례인 사람이 옮기는 바닥은 모두(관전자 포함)에게 바로 보이고, 끄는 중인 타일도 초당 5번 미리 보기로 보인다(받침대에서 아직 안 내려놓은 타일은 뒷면). ③ [되돌리기]는 한 단계가 아니라 차례 시작 상태로 통째로 돌린다(앱의 Undo). ④ 시간이 다 되면 [완료]를 안 누른 배치는 올발라도 처음으로 돌아가고 1장을 가져온다(앱: 리뷰 "your entire turn is reset and you are penalized another tile"). 종이 규칙서의 "미완성 3장"·"자동 완료"는 옵션으로 남김. ⑤ 한 차례 시간에 앱의 30초를 더함(기본 1분 유지). 106장·14장·첫 등록 30점(받침대 타일만)·조커 회수 뒤 같은 차례 재사용·첫 등록 전 조커 회수 불가·풀 소진 뒤 아무도 못 내면 끝·점수 계산은 그대로(종이 규칙서와 같음). 근거: 공식 규칙서 https://rummikub.com/wp-content/uploads/2019/12/2600-English-1.pdf , 앱 설명 https://apps.apple.com/us/app/rummikub/id1015322991 , 앱 리뷰 https://apps.apple.com/us/app/rummikub/id973113361?see-all=reviews&platform=iphone , 앱 사용자 정리 https://game-solver.com/rummikub-2/ (자세히: `games/rummikub.md` §2, §5.6~§5.7, §13).
|
||
|
||
## 1. 운영 (진행에 꼭 필요)
|
||
| # | 항목 | 기본안 | 필요한 것 |
|
||
|---|---|---|---|
|
||
| 1 | 서버 위치 | **결정됨(2026-10-06)**: .5 Docker 호스트 + NPMplus | DNS에 `game` 레코드 추가(사용자) |
|
||
| 2 | 디스코드 로그인 | **결정됨(2026-10-06)**: 앱 생성, 서버 `.env`에 반영. **관리자 사이트는 디스코드 로그인이 있어야 들어갈 수 있다** | 개발자 포털 OAuth2 → Redirects에 `https://game.tkrmagid.kr/api/auth/discord/callback` 등록 확인 |
|
||
|
||
## 2. 정책
|
||
| # | 항목 | 기본안 |
|
||
|---|---|---|
|
||
| 4 | 포커·섯다·고스톱 같은 웹보드 게임 | 친구끼리 쓰는 비공개 사이트이므로 별도 연령 확인 없이 일반 게임과 같이 둔다. 칩·점수(섯다는 놀이용 "원")는 방 안에서만 쓰고 충전·환전은 없다. 관리자 사이트에서 게임별로 끌 수 있다 |
|
||
| 5 | 스플렌더 카드 수치 | 원작과 같은 수치를 별도 데이터 파일에 둔다(친구끼리 쓰는 사이트라 그대로 사용) |
|
||
|
||
## 3. 게임 규칙 기본값 (자세한 내용은 각 게임 문서)
|
||
| 게임 | 기본안 | 바꿀 수 있는 옵션 |
|
||
|---|---|---|
|
||
| 오목 | 한국식(흑백 모두 쌍삼 금지, 6목은 승리 아님) | 렌주룰, 자유룰(5목 이상 승 / 정확히 5목) |
|
||
| 바둑 | 위치 기준 슈퍼코, 덤 6.5(계가) | 삼패 무승부, 중국식 계가(덤 7.5) |
|
||
| 체스 | 3회 반복·50수는 자동 무승부, 수 생성은 자체 구현(perft·chess.js 비교로 검증, chess.js는 테스트 전용) | 엄격한 FIDE 신청 방식, 체스960(첫 줄 무작위) |
|
||
| 장기 | 점수 판정·빅장 사용, 같은 국면 4번째 금지 | 동시 비공개 상차림 |
|
||
| 포커 | 7포커 베팅은 하프까지, 백스트레이트는 마운틴 다음, 하이로우의 로우는 한게임 방식 | 풀 베팅, 넷마블식 로우, 8탑 제한 |
|
||
| 섯다 | 한게임 방식(2026-10-13): 2장 섯다는 2장 한 번에(한게임 안내 "2장을 모두 받은 다음 베팅"), 땡잡이는 3월+7월 아무 패, 동점은 재경기, 다음 선은 승자. 3장 섯다는 2장 받고 공개패 1장 → 1구 베팅 → 1장 더 → 2구 베팅 → 3장 중 2장 고르기 | 1장씩 받기(전통), 나눠 갖기, 시계 방향 선, 20/40장, 베팅 규칙 111~444, 쿼터, 3장 섯다 공개패 끄기·베팅 전 고르기 |
|
||
| 마작 | 반장전, 25000점 시작, 붉은 5 세 장, 쿠이탕 허용 | 동풍전, 3인 산마 |
|
||
| 고스톱 | 맞고 7점·고스톱 3점에 고/스톱, 3고부터 2배씩 | 피 0장 피박 인정, 멍박 |
|
||
| 윷놀이 | 빽도 사용, 참먹이를 지나야 나감, 윷가락 실제 확률(0.6). 지역 룰 기본: 말 없을 때 빽도는 버림, 낙이어도 모은 결과 유지, 결과는 아무 순서로, 무조건 업기, 늘 지름길 | 50:50 공정 윷, 낙, 지역 룰(2026-10-13): 말 없을 때 빽도 다시 던지기·날윷에 새 말, 낙이면 차례 끝, 던진 순서대로 쓰기, 업을지 고르기, 갈 길 고르기 |
|
||
| 원카드 | 2→2장, A→3장, ♠A→5장, 조커 5/7장, 20장이면 파산, 원카드 외치기는 따로 누름(보호 2초) | 색깔 카드 모드, 자동 외치기, 보호 1~3초 |
|
||
| 할리갈리 | 마지막 1명 남을 때까지(10분 제한) | 원작 종료 규칙 |
|
||
| 그림 맞히기 | 한 턴에 여러 명이 맞힐 수 있음(먼저 맞힐수록 높은 점수) | 한 명만 맞히기 |
|
||
| 구십구 | 코리아보드게임즈 공식 규칙(5장씩, 인원별 시작 숫자, 0 카드는 방향 유지·반대 선택). 특수 카드 장수만 추정(각 4장) | 클래식 99 규칙, 목숨(하우스 룰) |
|
||
| 사과 게임 (2026-10-12) | 17×10 같은 판을 각자 푸는 경주, 2분, 1~8명(혼자 가능), 합 10이 아니면 그냥 무효(감점 없음) | 1분·3분 |
|
||
| 클루 (2026-10-12) | 원작처럼 주사위 2개로 복도 이동, 차례 60초, 카드 보여 주기 20초 | 빠르게(아무 방이나 바로), 30·45·90초 |
|
||
| 커넥트 포 (2026-10-12) | 7×6, 한 수 30초(시간 초과 2번까지 자동 두기) | 8×7·9×7, 피셔 시간, 시간패 |
|
||
| 도둑잡기 (2026-10-12) | 조커 1장, 짝은 자동으로 버림, 한 번 뽑기 20초 | 10·30·60초 |
|
||
| 우노 (2026-10-12) | 공식 규칙(한 판 점수, 와일드 드로우4 도전) | 500점 먼저, 쉬운 드로우4, 드로우 쌓기·낼 때까지 뽑기(하우스 룰) |
|
||
| 라이어 게임 (2026-10-12) | 라이어 1명, 설명 1바퀴, 동점은 한 번 더 투표 후 또 동점이면 라이어 승, 정답은 직접 적기 | 주제, 바보 모드, 2바퀴, 목록에서 고르기, 단계별 시간 |
|
||
| 루미큐브 (2026-10-14) | 루미큐브 앱 방식: 칸 판에 끌어다 놓기, 옮기는 타일 모두에게 보이기, 되돌리기 = 차례 처음으로, 시간 초과는 무조건 되돌리고 1장, 틀린 완료는 알려 주고 계속 | 종이 규칙서(시간 초과 3장·올바른 배치 자동 완료), 옮기는 타일 비공개, 인원수만큼 판, 첫 등록 0·20·50점, 조커 50점 |
|
||
| 야단법석 달리기 (2026-10-13) | 4~6명은 선수 4명(경주마다 1명), 2~3명은 8명(둘씩), 경주 4번·1등 3점 2등 1점, 원작 선수 36명 중 24명 | 순한 판·거친 판, 뒤로 갈수록 커지는 점수표 |
|
||
| 블랙잭 (2026-10-14) | 카지노 공식: 6벌 슈, 딜러 S17, 블랙잭 3:2, 아무 두 장 더블·DAS 허용, 4손패까지 스플릿(에이스는 한 장만), 서렌더 없음, 인슈어런스 제공, 딜러 A/10 peek, 10판·놀이용 칩 1,000 | 덱 1~8, H17, 배당 6:5·2:1·1:1, 더블 9~11·10~11·없음, 에이스 자유 히트·다시 스플릿, 레이트 서렌더, 5·6카드 찰리, 7-7-7 보너스(3:1), 최후 1인 |
|
||
|
||
## 게임 그림 출처 (2026-10-13)
|
||
|
||
실제 그림이 자유 라이선스로 있는 것은 그것을 쓰고(파일 옆 ATTRIBUTION.txt, 규칙 화면 맨 아래 출처 한 줄), 상표 그림(우노·뱅!·스플렌더·도블 등)은 직접 그린다.
|
||
|
||
| 대상 | 그림 | 라이선스 |
|
||
|---|---|---|
|
||
| 화투(섯다·고스톱) | Wikimedia Commons 화투 SVG | CC BY-SA 4.0 |
|
||
| 체스 기물 | Cburnett (Commons) | CC BY-SA 3.0 (GFDL·BSD·GPL 중 선택) |
|
||
| 마작패 | Shizhao 컬러 세트 (Commons) | 퍼블릭 도메인(서풍 CC0), 일부 파일에 GPL 표기도 같이 있음 |
|
||
| 트럼프 J·Q·K·조커 | Dmitry Fomin English pattern·Atlas joker (Commons) | CC0 |
|