- 서버: 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>
9.9 KiB
9.9 KiB
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.md7절). - 디스코드 앱 생성 완료(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배)로 둘 다 나눠서 조절하고, 저장하면 열린 방에도 바로 적용한다. 턴 제한 시간·결과 화면 대기 같은 규칙 시간과 반응 경쟁(원카드 외치기, 할리갈리·도블 판정)은 공정성 때문에 배율과 무관하다.
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-13) | 4 |
순한 판·거친 판, 뒤로 갈수록 커지는 점수표 |
게임 그림 출처 (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 |