Files
joke-app/docs/games/gemblo.md
EJClaw b02c9870cf 새 게임 젬블로: 육각 보석 블록 땅따먹기(2~6명), 원작 인원별 구역·시작점과 5인 장애물, 변형 규칙을 방 설정으로
- 엔진 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>
2026-10-15 19:40:45 +09:00

40 KiB
Raw Permalink Blame History

젬블로 (gemblo)

마일스톤: 2026-10 새 게임 · 인원: 최소 2 ~ 최대 6명 · 예상 시간: 약 2030분 · 난이도: 쉬움보통

1. 개요

  • 육각형 칸 1~5개로 된 보석 블록 18개를 육각형 판에 하나씩 올려놓는 땅따먹기 게임. 같은 색 블록끼리는 절대 닿으면 안 되고, 이미 놓은 내 블록의 꼭짓점에서 "선을 따라 한 칸 떨어진 곳"에만 이어 놓을 수 있다. 남의 블록으로 내 길이 막히기도 하고, 서로 다른 색 블록 두 개가 맞닿은 틈은 뚫고 지나갈 수 있어서 "빈틈 찾기"가 재미의 핵심이다. 더 놓을 수 없으면 끝나고, 못 놓은 블록의 칸 수가 가장 적은 사람이 이긴다.
  • 한국 게임: 오준원(Justin Oh) 디자인, 2002년 개발·2003년 출시(박스 "Since 2003"), 젬블로(현 젬블로컴퍼니) 출판, 코리아보드게임즈 유통. 박스에 "국내 판매 1위 추상전략 보드게임"이라고 적혀 있고, 학교·방과후 수업 교구로도 많이 쓰인다. 블로커스(Blokus, 2000)와 비슷하지만 디자이너는 블로커스를 모르고 만들었다고 밝혔다(나무위키, Gough 2017).
  • 인원 근거: 원작 26명(혼자 하는 퍼즐 모드 포함 16명). 인원마다 쓰는 판 범위와 시작점이 정해져 있다(4장). minPlayers = 2, maxPlayers = 6.
  • 완전 정보 게임. view에서 뺄 것은 RNG 상태뿐.
  • 원작 규칙서에 없거나 애매한 부분은 "서비스 규칙"이라고 따로 적었다. 원작 그대로인 것은 "원작", 다른 곳에서 가져온 재미 규칙은 "변형"으로 표시한다.

2. 모드와 옵션

옵션 키 설명 선택지 기본값
seatOrder 자리(시작점)와 순서 random / joinOrder random
twoPlayerMode 2명일 때 방식 twoColors(원작: 2색씩, 4인 구역) / threeColors(원작: 3색씩, 판 전체) / duo(변형: 1색씩, 작은 판, 가운데 가까운 시작점) twoColors
threePlayerMode 3명일 때 방식 oneColor(원작: 1색씩, 3인 구역) / twoColors(변형: 2색씩 판 전체, Gough 2017) oneColor
fivePlayerObstacles 5명일 때 남는 1색 블록으로 장애물 놓기 auto(원작 조건대로 자동 배치, 서비스 기본) / draft(원작 그대로: 3개씩 골라서 각자 배치) / none(변형: 장애물 없음) auto
bridgeRule 이음선(4.3)이 막히는 조건 official(원작: 한 블록이 사이 두 칸을 다 덮으면 막힘) / free(변형: 안 막힘, 초보용) official
allowFlip 블록 뒤집기 허용 true / false true (12장 확인 필요 항목)
scoring 점수 방식 remaining(원작: 남은 칸 수가 적을수록 좋음) / blokusBonus(변형: 남은 칸 −1점씩, 다 놓으면 +15, 마지막이 한 칸 블록이면 +20) remaining
teams 팀전 off / pairs(4명: 마주 보는 2명씩 2팀, 6명: 마주 보는 2명씩 3팀) / triples(6명: 한 칸 건너 3명씩 2팀) off
neutralBlocks 시작 전 판 가운데 쪽에 무작위로 깔아 두는 금색 방해 블록 수(변형: 킥스타터판 "골드 조각") 0 / 3 / 6 0
showHints 내가 이을 수 있는 자리(이음점) 점으로 표시 true / false true
timeControl.kind 시간 방식 none / perMove / fischer perMove
timeControl.perMoveSec 한 번(한 색 차례)당 제한 30 / 60 / 90 / 120 60
timeControl.baseSec / incSec 전체 시간 / 한 번마다 추가 5분+5초, 10분+5초 10분+5초
timeoutPolicy perMove 시간 초과 처리 autoPlace(놓을 수 있는 블록 중 큰 것 자동 배치) / pass(이번 차례만 넘김) / retire(그 색은 더 안 놓음) autoPlace
autoMoveLimit 연속 자동 처리 허용 횟수(넘으면 그 사람의 색 모두 retire) 0~5 2
undo 무르기(1인당, 다른 모든 사람 동의) off / 1 / 3 off
  • 구현(2026-10-15): 위 표의 옵션을 모두 방 설정으로 넣었다(나중으로 미룬 것 없음). neutralBlocks·perMoveSec·baseSec는 표의 값만 고를 수 있고, incSec는 0~30초(기본 5초).
  • 모든 항목에 .meta({ title, labels })를 붙인다(09 §2). 인원과 맞지 않는 옵션(예: 4명인데 twoPlayerMode)은 무시한다. teams=triples는 6명, pairs는 4·6명일 때만 받고 아니면 setup에서 "팀전은 4명 또는 6명일 때만 돼요"로 거부.
  • 연결 끊김 유예는 방 설정(graceSec)을 따른다.

3. 구성물

3.1 블록 (색마다 18개, 72칸)

  • 색: 빨강·노랑·초록·파랑·보라·주황(현재 국내판 6색). 방해 블록은 금색.
  • 한 색 18개 = 5칸 8개 + 4칸 5개 + 3칸 3개 + 2칸 1개 + 1칸 1개, 합계 72칸, 6색 108개·432칸. 3칸 이하는 가능한 모양을 모두 넣었고, 4칸은 7가지 중 5가지, 5칸은 22가지 중 8가지다.
  • 모양은 아래 좌표(3.2의 축 좌표)로 정의한다. 출처: Gough 2017 그림 2(18개 그림)를 칸 단위로 옮기고, 국내 디럭스판 사진·국내 설명서 구성표(5칸 8·4칸 5·3칸 3·2칸 1·1칸 1)로 개수와 모양을 맞춰 봤다.
id 이름 칸 기준 좌표 (q, r) 방향 수(안 뒤집음 / 뒤집기 포함)
p1 한 칸 1 (0,0) 1 / 1
p2 두 칸 2 (0,0) (0,1) 3 / 3
i3 일자 3 3 (0,0) (0,1) (0,2) 3 / 3
a3 삼각 3 3 (0,0) (0,1) (1,0) 2 / 2
c3 꺾인 3 3 (0,0) (0,1) (1,1) 6 / 6
i4 일자 4 4 (0,0) (0,1) (0,2) (0,3) 3 / 3
o4 마름모 4 4 (0,0) (0,1) (1,0) (1,1) 3 / 3
s4 S자 4 4 (0,0) (0,1) (1,1) (1,2) 3 / 6
u4 아치 4 4 (0,0) (0,1) (1,1) (2,0) 6 / 6
y4 바람개비 4 4 (0,1) (1,1) (1,2) (2,0) 2 / 2
i5 일자 5 5 (0,0) (0,1) (0,2) (0,3) (0,4) 3 / 3
v5 좁은 V 5 (두 팔 60°) 5 (0,0) (0,1) (0,2) (1,0) (2,0) 6 / 6
l5 넓은 V 5 (두 팔 120°) 5 (0,0) (0,1) (0,2) (1,2) (2,2) 6 / 6
j5 번개 5 (3칸+2칸 어긋남) 5 (0,0) (0,1) (0,2) (1,2) (1,3) 6 / 12
f5 갈고리 5 5 (0,0) (0,1) (1,1) (1,2) (2,0) 6 / 12
w5 계단 5 5 (0,0) (0,1) (1,1) (1,2) (2,2) 6 / 6
n5 N자 5 5 (0,0) (0,1) (1,1) (2,1) (2,2) 3 / 6
t5 긴 Y 5 5 (0,1) (1,1) (1,2) (1,3) (2,0) 6 / 6
  • 서로 다른 방향 합계: 안 뒤집으면 74개, 뒤집기 포함 92개(거울상이 다른 블록은 s4 j5 f5 n5 넷뿐).

3.2 좌표계 (축 좌표, 납작한 육각형)

  • 칸은 위·아래가 평평한 육각형(실물 판과 같은 방향). 칸 (q, r)의 화면 중심(칸 반지름 s, 아래로 갈수록 y 증가): x = 1.5·s·q, y = √3·s·(r + q/2).
  • 이웃 6방향(변을 맞댐): (0,-1) 위, (1,-1) 오른쪽 위, (1,0) 오른쪽 아래, (0,1) 아래, (-1,1) 왼쪽 아래, (-1,0) 왼쪽 위.
  • 회전(화면에서 시계 방향 60°): R(q, r) = (−r, q + r). 좌우 뒤집기: M(q, r) = (−q, q + r).
  • 방향 번호 o(0~11): k = o % 6, flip = o >= 6, 변환 T = R^k ∘ (flip ? M : 그대로). 블록 좌표에 T를 적용한 뒤 평행 이동해 놓는다(8.2). 대칭인 블록은 서로 다른 o가 같은 모양이 된다(문제 없음, 합법 수 목록에서는 중복 제거).

3.3 판 (실물과 같은 모양)

  • 실물 판은 칸 방향과 30° 어긋난 큰 육각형이라 가장자리가 톱니처럼 들쭉날쭉하다. 한 변에 판 끝선에 닿는 칸이 8개(사이사이 한 칸 들어간 칸 7개)다(Gough 2017 "한 변 8칸"). 엔진 정의:
    • 판 전체(6인 판): max(|2q+r|, |q+2r|, |q−r|) ≤ 21 → 463칸. 블록 432칸이 판의 93%(디자이너가 "블록 칸 수가 판의 90% 중반일 때 가장 재미있었다"고 한 비율과 맞음, IT동아 2015).
    • 3인 구역(원작 빨간 선 안, 작은 육각형): max(|2q+r|, |q+2r|, |q−r|) ≤ 15 → 241칸(한 변 6칸, 블록 216칸 = 90%).
    • 4인 구역(원작 파란 선 안, 가로로 조금 긴 직사각형): 판 전체 ∩ |q| ≤ 9 ∩ |q+2r| ≤ 15 → 295칸(블록 288칸 = 98%). 2인 twoColors도 이 구역.
    • duo(변형): max(...) ≤ 12 → 157칸(2색 144칸 = 92%).
  • 판의 6꼭짓점 칸(시계 방향, 왼쪽 위부터): (−7,−7) 왼쪽 위, (7,−14) 오른쪽 위, (14,−7) 오른쪽, (7,7) 오른쪽 아래, (−7,14) 왼쪽 아래, (−14,7) 왼쪽.
  • 화면에는 판 전체를 그리고, 이번 판에서 안 쓰는 칸은 흐리게 칠한다(놓을 수 없음).
  • 주의: 실물 판의 칸 수는 사진·그림으로 잰 값이다(12장).

4. 준비(셋업)

  1. 인원과 옵션으로 "모드"를 정한다. 색 하나가 시작점 하나를 가진다. 차례는 색 단위로 시계 방향.
인원 / 모드 판 색 배분 시작점(차례 순서대로)
6명 판 전체 1색씩 6꼭짓점: (−7,−7) (7,−14) (14,−7) (7,7) (−7,14) (−14,7)
5명 판 전체 + 장애물 15개 1색씩(남는 1색은 장애물) 5인 표시 칸: (−10,−1) (4,−12) (14,−7) (4,8) (−10,11)
4명 4인 구역 1색씩 4인 구역의 네 모서리: (−9,−3) 왼쪽 위, (9,−12) 오른쪽 위, (9,3) 오른쪽 아래, (−9,12) 왼쪽 아래
3명 oneColor 3인 구역 1색씩 3인 구역 꼭짓점 하나 건너 셋: (−5,−5) 왼쪽 위, (10,−5) 오른쪽, (−5,10) 왼쪽 아래
3명 twoColors(변형) 판 전체 2색씩 6꼭짓점, 1→2→3→1→2→3 (각자 마주 보는 두 꼭짓점)
2명 twoColors 4인 구역 2색씩 4인 모서리, A(1번)→B(2번)→C(1번)→D(2번) (각자 대각선 두 모서리)
2명 threeColors 판 전체 3색씩 6꼭짓점, 1→2→1→2→1→2
2명 duo(변형) 듀오 판 1색씩 (−4,2), (4,−2) (판 가운데와 모서리 중간, 블로커스 듀오처럼 일찍 부딪힘)
  • 원작 근거: 6명 판 전체·꼭짓점 시작(규칙서 그림 1의 초록 화살표, Gough), 4명 파란 선·F 표시, 3명 빨간 선·빨간 화살표, 2명 두 방식(규칙서), 5명 장애물(규칙서 그림 2의 "5" 표시). 위 좌표는 그 그림을 엔진 좌표로 옮긴 것이다. 5인 표시 칸은 그림에서 잰 각도(약 0°·72°·140°·209°·289°)에 가장 가까운 바깥 칸이다.
  1. seatOrder=random이면 RNG로 자리(시작점 묶음)를 정한다. 팀전이면 같은 팀이 4명은 대각선 모서리, 6명 pairs는 마주 보는 꼭짓점, triples는 한 칸 건너 꼭짓점에 앉도록 자리를 맞춘다.
  2. 5명 장애물(fivePlayerObstacles):
    • 원작: 남는 1색에서 한 칸·두 칸·삼각 3(p1 p2 a3)을 빼고, 남은 15개를 각자 차례로 3개씩 고른다. 그다음 차례로 하나씩 판에 놓는다. 조건: (가) 맨 바깥 칸에는 못 놓는다, (나) 바깥에서 두 번째 줄 칸을 하나 이상 덮어야 한다, (다) 블록이 판 가운데 쪽으로 뻗어야 한다, (라) 이웃한 두 5인 시작점 사이에 장애물은 3개까지. 장애물을 마지막에 놓은 사람이 게임을 시작한다.
    • 엔진 해석(서비스 규칙): "맨 바깥 칸" = 판 밖과 변을 맞댄 칸(84칸). "두 번째 줄" = 맨 바깥 칸과 맞댄 나머지 칸(72칸). (다)는 "블록 칸들의 무게 중심이 덮은 두 번째 줄 칸들의 무게 중심보다 판 가운데에 더 가깝다". (라)의 "사이"는 시작점 각도로 나눈 5구역, 두 번째 줄 칸의 각도로 구역을 정한다(15개 ÷ 5구역 = 구역마다 정확히 3개). 장애물끼리 겹치면 안 되고 닿는 것은 된다.
    • auto: RNG로 15개를 섞어 구역마다 3개씩, 조건을 지키는 위치·방향 중 무작위(최대 200번 시도, 실패하면 그 블록은 뺌 — 테스트로 실패가 없음을 확인). 시작 플레이어는 RNG.
    • draft: 8.2의 pickObstacle / placeObstacle 단계를 거친다(고르기는 자리 순서로 한 바퀴씩 3바퀴).
    • none: 장애물 없이 판 전체(360칸 / 463칸 = 78%, 넓게 노는 판).
  3. neutralBlocks(변형): 금색 블록 N개(p1 p2 i3 a3 c3 중 RNG)를 판 가운데에서 거리 7 이내 빈칸에 무작위 방향으로 놓는다. 서로 맞닿지 않게, 시작점에서 거리 6 이상.
  4. 첫 차례는 차례 순서의 첫 색(5명 draft는 장애물을 마지막에 놓은 사람의 색).

5. 진행 규칙

5.1 차례

  • 차례인 색의 주인은 그 색의 안 쓴 블록 하나를 골라 돌리거나(뒤집기 옵션) 해서 판에 놓는다. 한 차례에 블록 하나. 놓을 수 있으면 반드시 놓아야 한다(스스로 넘기기 없음, 원작 "놓을 수 있는 사람은 계속 놓는다").
  • 이미 놓은 블록은 옮기거나 뺄 수 없다.

5.2 공통 조건 (모든 블록)

  1. 블록의 모든 칸이 이번 판에서 쓰는 구역 안이고 비어 있다(겹쳐 쌓기 금지).
  2. 블록의 어느 칸도 같은 색 칸과 변을 맞대지 않는다. 다른 색·금색 블록과는 마음대로 닿아도 된다. (육각형은 꼭짓점만 닿는 일이 없으므로 "변을 안 맞댄다" = "안 닿는다".)

5.3 첫 블록

  • 그 색의 시작점 칸을 덮어야 한다. 이음선 조건은 없다.
  • 시작점이 이미 다른 블록에 덮여 있으면(인원·옵션상 일어나지 않게 시작점을 정했지만 만일을 위해) 그 색은 놓을 곳이 없는 것으로 처리한다.

5.4 두 번째 블록부터: 이음선

  • 새 블록의 칸 B 하나와 이미 놓은 같은 색 칸 A 하나가 아래 "대각 위치"이고, 둘 사이의 이음선이 열려 있어야 한다. 이런 짝이 하나 이상 있으면 된다(여러 개여도 됨).
  • 대각 위치 = A의 꼭짓점에서 판의 선을 따라 한 칸 길이만큼 나간 끝에 꼭짓점이 닿는 칸. 축 좌표로 B − A가 아래 6가지 중 하나. A와 B 사이에는 두 칸 m1, m2가 끼어 있고, 이음선은 m1과 m2가 맞댄 변이다.
B − A 사이 칸 m1 (A +) 사이 칸 m2 (A +) 화면 방향
(2,−1) (1,0) (1,−1) 오른쪽
(1,−2) (1,−1) (0,−1) 오른쪽 위
(−1,−1) (0,−1) (−1,0) 왼쪽 위
(−2,1) (−1,0) (−1,1) 왼쪽
(−1,2) (−1,1) (0,1) 왼쪽 아래
(1,1) (0,1) (1,0) 오른쪽 아래
  • 이음선이 막히는 경우(bridgeRule=official): m1과 m2가 같은 블록 하나에 함께 덮여 있을 때. 서로 다른 블록 두 개(색이 달라도, 금색 장애물 두 개여도)가 맞댄 틈은 지나갈 수 있다. 한쪽만 덮였거나 둘 다 비었거나 구역 밖이면 열려 있다.
    • 근거: 규칙서 "다른 색 블록에 막히지 않았다면", 그림(노란 블록 하나가 두 칸을 덮어 막힘 / 노랑·초록이 한 칸씩이면 통과), 국내 설명 "서로 다른 색의 블록 사이는 뚫고 지나가는 것이 가능", Gough "다른 사람 블록을 가로지를 수는 없지만 두 블록이 맞댄 틈은 지날 수 있다".
    • 같은 색 블록끼리는 절대 닿지 않으므로, 1인 1색에서는 "같은 블록" = "같은 색 두 칸"과 같다. 장애물(금색)처럼 서로 닿을 수 있는 블록이 있어서 블록 단위로 판단한다.
    • m1 또는 m2가 내 색이면 B가 내 블록과 닿게 되므로 이미 5.2에서 걸린다.
  • bridgeRule=free(변형): 사이 칸은 보지 않는다(대각 위치만 맞으면 됨).
  • 이음점(hint): "그 색이 지금 블록 한 칸을 놓을 수 있는 칸" = 어떤 같은 색 칸 A의 대각 위치이면서, 이음선이 열려 있고, 비어 있고, 구역 안이고, 같은 색 칸과 맞닿지 않는 칸. 모든 합법 배치는 이음점을 적어도 한 칸 덮는다.

5.5 놓을 수 없을 때와 끝

  • 차례가 온 색이 놓을 수 있는 배치가 하나도 없으면 그 색은 "끝남"이 되고 이후 차례에서 빠진다(이벤트 colorOut). 판은 채워지기만 하므로 한 번 놓을 곳이 없으면 다시 생기지 않는다(그래서 영구 제외가 원작과 같은 결과).
  • 18개를 다 놓은 색도 끝남.
  • 모든 색이 끝나면 게임 종료.

6. 승패와 점수 계산

  • scoring=remaining(원작): 각 색의 남은 블록 칸 수 합. 여러 색을 가진 사람은 자기 색 합계. 적을수록 높은 순위.
    • 예: 2명 twoColors, 1번(빨강 남은 6칸 + 노랑 남은 3칸 = 9), 2번(초록 0 + 파랑 11 = 11) → 1번 승.
  • scoring=blokusBonus(변형, 블로커스 점수 방식): 색마다 −(남은 칸 수), 18개를 다 놓았으면 +15, 그중 마지막으로 놓은 블록이 p1이면 +20(+15 대신). 높을수록 높은 순위. 결과 화면에 원작 방식(남은 칸)도 함께 보여 준다.
  • 팀전: 팀원 점수 합으로 팀 순위, 팀원은 같은 순위.
  • 동점: 같은 순위(공동). 원작 규칙서에 동점 처리 규칙이 따로 있다고 하나(Gough) 내용을 확인하지 못해 서비스 규칙으로 공동 순위를 쓴다(12장).
  • 기권·시간패로 빠진 사람: 그 사람의 색은 바로 끝남 처리하고 남은 칸으로 점수는 계산하되, 순위는 끝까지 한 사람들 아래(먼저 빠진 사람이 더 아래). 2명에서 한 명이 기권하면 상대 승.
  • scoreText: remaining은 "남은 7칸"(0칸이면 "모두 놓음"), blokusBonus는 "+20점"/"−7점".

7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)

  • 원작에 있는 선택: 2명 twoColors/threeColors, 5명 장애물. 장애물 고르기·놓기는 시간이 길어 서비스 기본은 auto(원작 조건 그대로 자동).
  • 변형(다른 자료에서 가져옴, 기본 꺼짐 또는 원작 기본 유지):
    • 3명 2색씩 판 전체(threePlayerMode=twoColors): Gough 2017이 제안한 3인 대안(쓸 판은 적혀 있지 않아 6색이 다 들어가는 판 전체로 정함).
    • 듀오(twoPlayerMode=duo): 블로커스 듀오(2인 전용 작은 판, 가운데 가까운 시작점)를 젬블로 판에 옮긴 것. 1색씩이라 규칙이 가장 단순하고 빨리 부딪힌다.
    • 블로커스 점수(scoring=blokusBonus): 다 놓기·마지막 한 칸 보너스.
    • 팀전(teams): 블로커스 4인 팀전(마주 보는 두 사람이 한 팀)을 4·6인에 적용.
    • 금색 방해 블록(neutralBlocks): 킥스타터판에 들어 있던 금색 조각 3개("고급 규칙용"이라고만 적혀 있음)를 판에 미리 까는 방식으로 해석.
    • 느슨한 이음선(bridgeRule=free): 체코공대(CTU) 과제판 젬블로처럼 남의 블록에 이음선이 막히지 않음. 처음 하는 사람·어린이용.
    • 뒤집기 금지(allowFlip=false): 보석 모양 디럭스 블록은 뒤집어 놓기 어렵고 CTU 과제판도 뒤집기 금지. 거울상 블록 4개의 쓰임이 줄어 조금 어려워진다.
  • 넣지 않는 것: 젬블로Q(사각형+삼각형 칸, Q포인트 규칙)는 다른 게임이라 별도 검토. 1인 퍼즐북(그림 맞추기)은 추후 후보. 블로커스식 "꼭짓점만 닿기" 규칙은 육각형에서는 성립하지 않는다(육각형은 꼭짓점만 닿을 수 없음).

8. 엔진 설계

8.1 상태(State)

type PieceId = 'p1' | 'p2' | 'i3' | 'a3' | 'c3' | 'i4' | 'o4' | 's4' | 'u4' | 'y4'
  | 'i5' | 'v5' | 'l5' | 'j5' | 'f5' | 'w5' | 'n5' | 't5';
type ColorId = 'red' | 'yellow' | 'green' | 'blue' | 'purple' | 'orange';
type Layout = 'full' | 'four' | 'three' | 'duo';
type Hex = { q: number; r: number };

interface GembloColor {
  color: ColorId;
  owner: PlayerId;
  start: Hex;
  left: PieceId[];                  // 안 쓴 블록
  done: boolean;                    // 더 놓을 곳 없음 / 다 놓음 / 기권·시간패
  lastPiece: PieceId | null;        // blokusBonus용
  autoStreak: number;
}

interface GembloPlacement {          // 판 위 블록 하나 (장애물·금색 포함)
  seq: number;                      // 0부터, 칸 점유의 블록 번호
  color: ColorId | 'gold';
  pieceId: PieceId;
  orient: number;                   // 0~11
  cells: number[];                  // 칸 번호(아래 layout 칸 목록의 인덱스)
  auto: boolean;
}

interface GembloState {
  options: GembloOptions;
  layout: Layout;                   // 쓰는 구역
  board: number[];                  // 판 전체 463칸, -1 = 빔, 그 외 = GembloPlacement.seq
  placements: GembloPlacement[];
  colors: GembloColor[];            // 차례 순서
  turn: number;                     // colors 인덱스
  phase: 'obstacleDraft' | 'obstaclePlace' | 'playing' | 'finished';
  obstacle: { pool: PieceId[]; hands: Record<PlayerId, PieceId[]>; sectorCount: number[]; seatTurn: number } | null;
  teams: PlayerId[][] | null;
  turnStartedAt: number;
  clock: { remainingMs: Record<PlayerId, number> };
  undo: { usedBy: Record<PlayerId, number>; pending: { by: PlayerId; accepted: PlayerId[] } | null };
  out: { playerId: PlayerId; reason: 'resign' | 'timeLoss'; at: number }[];
  result: GembloResult | null;
}
  • 칸 번호: 판 전체 463칸을 r, 그다음 q 오름차순으로 번호를 매긴 고정 목록(모듈 상수). 구역 포함 여부, 이웃 6칸, 대각 6칸과 사이 칸(m1, m2) 번호를 모듈을 읽을 때 한 번 계산해 표로 둔다(상태에는 안 넣음, JSON 규칙 지킴).

8.2 액션

type payload 누가 / 언제 검증 조건
place { pieceId, orient, q, r } 차례인 색의 주인, playing 그 색에 블록이 남아 있음, orient 011(allowFlip=false면 05), 칸 = {(q,r) + T(c) − T(c₀)}(c₀ = 블록 기준 좌표 첫 칸). 5.2~5.4. 사유 예: "판 밖이에요", "다른 블록과 겹쳐요", "같은 색 블록과 닿으면 안 돼요", "첫 블록은 시작점을 덮어야 해요", "내 블록에서 선으로 이어지는 곳이 아니에요", "이 선은 다른 블록에 막혀 있어요"
pickObstacle { pieceId } draft의 고르기 차례 사람 남은 15개 중에 있음
placeObstacle { pieceId, orient, q, r } draft의 놓기 차례 사람 자기가 고른 블록, 4장 3.의 (가)~(라), 겹침 없음
requestUndo / respondUndo {} / { accept } 방금 놓은 사람 / 나머지 전원 undo 횟수 남음, 다음 색이 아직 안 놓았을 때만. 전원 수락 → 그 배치 하나와 그 뒤 자동 colorOut을 되돌림
resign {} 남아 있는 사람 6장 처리
timeout {} 시스템 8.5
  • 한 사람이 2색 이상이면 place는 "지금 차례인 색"에만 적용된다(어느 색인지는 상태가 정함).
  • place 처리 후: 다음 색으로 넘기며, 넘겨받은 색이 끝남이 아니면 hasAnyPlacement를 검사해 없으면 colorOut을 기록하고 다시 다음 색으로. 남은 색이 없으면 종료.
  • 이벤트: placed(색, 블록, 칸 목록 — 애니메이션용), colorOut(색, 남은 칸 수), obstaclePlaced, playerOut, gameEnded.
  • 테스트·컴퓨터용 legalActions(state, p): 지금 차례 색의 모든 합법 place(같은 칸 집합은 하나만). 첫 블록은 6인 꼭짓점 (14,−7) 기준 56개(뒤집기 금지면 45개), 4인 모서리 (−9,−3) 44개, 3인 꼭짓점 (−5,−5) 56개.

합법 배치 찾기(성능)

  • 모듈을 읽을 때 블록마다 서로 다른 방향 목록(뒤집기 포함 92개, 안 하면 74개)을 정규화해 둔다.
  • 차례 색의 이음점을 구한다: 그 색 칸마다 대각 6칸을 보고 5.4 조건을 만족하는 칸만(중복 제거). 첫 블록이면 이음점 = 시작점 하나.
  • 이음점 P × 남은 블록 × 방향 × 블록의 각 칸을 P에 맞추는 평행 이동 → 5.2 검사(구역·빈칸·같은 색 이웃). 칸 집합 문자열로 중복 제거. 최악(이음점 100개, 블록 18개 전부)도 약 4만 6천 배치 × 5칸 검사로 수 ms. hasAnyPlacement는 하나 찾으면 바로 멈춘다.
  • 같은 색 이웃 검사는 "그 색 칸과 맞닿은 칸" 표시 배열을 그때그때 만들어 쓴다(463칸, 싸다).

8.3 공개/비공개 정보 (view)

  • 모두 공개: 판(칸마다 색·블록 번호), 배치 기록, 색마다 남은 블록·남은 칸 수·끝남 여부, 차례 색과 주인, 팀, 시계, deadline, 대기 중인 무르기, 결과, 마지막 배치.
  • 차례인 사람에게만: legal: { bridgePoints: Hex[]; placeable: PieceId[] }(이음점, 놓을 수 있는 블록). 화면의 미리보기 판정은 모듈이 내보내는 순수 함수 checkPlacement(view, color, pieceId, orient, q, r)로 클라이언트에서 바로 하고(규칙과 같은 코드), 최종 판단은 서버 validate.
  • 제외: rng. secretsOf는 빈 목록(숨길 정보 없음).

8.4 랜덤 요소 (시드 RNG 사용 지점)

  1. seatOrder=random 자리 배정, 5명 auto의 시작 플레이어.
  2. 5명 auto 장애물 순서·위치·방향.
  3. neutralBlocks 금색 블록 종류·위치·방향.
  4. autoPlace 시간 초과 배치에서 같은 점수 후보 고르기.

8.5 타이머·시간 초과·연결 끊김 시 자동 행동

  • deadline(state): perMove → turnStartedAt + perMoveSec·1000, fischer → turnStartedAt + remainingMs[주인], none → null, obstacleDraft/obstaclePlace → turnStartedAt + 60초(고정), 종료 → null.
  • onTimeout(state, player) → { type: 'timeout' }. apply:
    • obstacleDraft/obstaclePlace: 남은 것 중 RNG로 고르기·조건 맞는 무작위 위치에 놓기.
    • perMove + autoPlace: 합법 배치 중 칸 수가 가장 큰 블록 → 그중 새 이음점이 가장 많이 생기는 배치(같으면 RNG). auto: true, 그 색 autoStreak + 1. 사람 기준으로 연속 autoMoveLimit회를 넘기면 그 사람의 모든 색을 끝남 처리(timeLoss).
    • perMove + pass: 이번 차례만 넘김(색은 그대로 남음), streak + 1.
    • perMove + retire 또는 fischer 시간 다 씀: 그 사람의 색 모두 끝남(timeLoss).
  • 사람이 직접 놓으면 그 사람 streak 0.
  • 연결 끊김: 끊긴 사람의 색 차례에 min(deadline, 끊김 + graceSec)에 onTimeout. 무르기 응답 대기 중 끊긴 사람은 30초 뒤 거절로 처리.
  • onLeave: 기권과 같음.

8.6 종료 조건과 결과(GameResult)

interface GembloResult {
  ranking: PlayerId[][];                       // 공동 순위 허용
  scores: Record<PlayerId, number>;            // remaining: 남은 칸(적을수록 좋음), blokusBonus: 점수
  scoreText: Record<PlayerId, string>;         // "남은 7칸", "모두 놓음", "+20점"
  perColor: { color: ColorId; owner: PlayerId; leftCells: number; leftPieces: PieceId[]; allPlaced: boolean }[];
  teams?: { members: PlayerId[]; total: number }[];
  summary: string;                             // "빨강(철수) 승리 — 남은 칸 0"
  reason: 'normal' | 'resign' | 'timeout';
}
  • 종료: 모든 색 끝남, 또는 남은 사람이 0~1명(2명에서 한 명 기권 등).

8.7 컴퓨터 상대 (gemblo/bot.ts)

  • 입력: view, legal(= legalActions, 합법 배치 전체). 배치마다 점수:
    • 10 × 칸 수 (큰 블록 먼저: 원작 공략 "초반엔 5칸 블록으로 자리를 넓히고 끝에 작은 블록")
    • + 3 × (놓은 뒤 내 이음점 수 − 놓기 전) (길을 많이 열어 둠)
    • + 4 × (상대 색들의 이음점이 줄어든 수) (막기)
    • + 2 × (판 가운데 쪽으로 나아간 정도) (처음 4수만)
    • − 8 이 배치가 내 다른 이음점을 스스로 막으면(내 블록이 내 이음점 칸을 덮음)
  • 계산을 줄이려고 먼저 칸 수 + 가운데 거리로 상위 80개만 골라 이음점 변화를 계산한다(합법 배치 수천 개여도 한 수 50ms 이내 목표).
  • 단계(1~60): humanBest(09 §9.1)를 쓴다. 기준 small = 10(블록 한 칸 차이), critical은 없음(놓치면 바로 지는 수가 없는 게임). 낮은 단계일수록 작은 블록을 일찍 쓰고 막기를 덜 본다.

9. UI/UX

  • 화면 배치(PC): 왼쪽 판(SVG, 납작한 육각형 칸, 실물처럼 금빛 판 위 반투명 보석), 오른쪽 패널에 차례 순서(색·주인·남은 칸 막대), 지금 차례 색의 블록 트레이(18칸 격자, 쓴 블록은 흐리게, 놓을 수 없는 블록은 회색+자물쇠), 기록, 채팅.
  • 모바일 세로(320px 이상): 위에 차례 띠(색 점 + "파랑 차례 · 남은 34칸"), 가운데 판(폭 100%), 아래 블록 트레이(가로로 밀어 보는 한 줄, 칸마다 44px 이상), 그 아래 버튼 줄 [⟲] [⟳] [뒤집기] [취소] [놓기](각 44px 이상).
    • 판 전체 463칸을 320px에 그리면 칸 폭이 약 14px라 손가락으로 집기 어렵다. 그래서 기본은 "내 블록 근처 2배 확대"로 보여 주고, 두 손가락 확대·이동, [전체 보기] 단추로 전환. 3인 구역(241칸)·4인 구역(295칸)은 그 구역만 꽉 차게 맞춘다.
  • 놓는 방법:
    • PC: 트레이에서 블록 클릭 → 마우스를 따라다니는 반투명 미리보기(잡은 칸이 커서 칸에 맞춰짐) → 휠·R 키로 회전, F 키로 뒤집기 → 놓을 수 있으면 내 색으로 밝게, 안 되면 빨갛게 + 이유 글(예: "같은 색과 닿아요") → 클릭으로 놓기. Esc 취소.
    • 모바일: 블록 탭 → 판의 칸을 탭하면 그 칸에 미리보기가 생김 → 끌어서 옮기기, 버튼으로 회전·뒤집기 → [놓기](놓을 수 있을 때만 켜짐). 이음점(작은 내 색 점)을 탭하면 "그 점을 덮는 합법 배치"가 바로 나오고, 같은 점을 다시 탭하면 다음 합법 배치로 바뀐다(작은 화면에서 돌리기 없이 고르기).
  • 도움말 표시(showHints): 내 이음점 = 내 색 작은 점, 미리보기 중 연결되는 이음선 = 내 블록 꼭짓점에서 뻗는 짧은 선(원작 그림의 화살표처럼). 막힌 이음선을 가리키면 그 선 위에 작은 ✕.
  • 움직임: 블록이 위에서 살짝 내려앉으며 보석이 한 번 반짝, 놓은 블록은 다음 배치 전까지 가는 테두리로 표시. 색이 끝나면 그 색 트레이가 접히고 "초록은 더 놓을 곳이 없어요(남은 9칸)" 토스트. 끝나면 남은 블록을 색별로 판 옆에 펼쳐 보여 줌(원작 사진처럼).
  • 효과음(사이트 음량): 놓기 "딸깍"(보석 소리), 안 되는 자리 작고 낮은 소리, 색 끝남 짧게 내려가는 소리, 다 놓음 반짝이는 소리.
  • 색약 배려: 색마다 보석 안에 다른 무늬(점·줄·별 등)도 넣고, 차례 띠·결과에 색 이름을 글로 함께 쓴다.
  • 규칙 보기: ① 시작점 덮기 ② "선으로 한 칸 떨어져 잇기"(원작 화살표 그림) ③ 한 블록이 사이를 막으면 못 감 / 두 블록 틈은 지나감 ④ 끝과 점수. 각 1장씩 그림.

10. 테스트 체크리스트

  • 판·구역 칸 수: 전체 463, 3인 241, 4인 295, 듀오 157. 6꼭짓점·4인 모서리·3인 꼭짓점·5인 시작 칸이 모두 해당 구역 안이고 맨 바깥 칸.
  • 블록 18개 칸 수 합 72, 서로 다른 방향 수 표(3.1)와 같음(합 74 / 92). R을 6번 하면 제자리, M을 2번 하면 제자리.
  • 인원·모드별 색 배분과 차례 순서(4장 표), 팀전 자리 맞춤, 팀전 인원 불일치 거부.
  • 첫 블록: 시작점 안 덮으면 거부, 덮으면 허용. 첫 블록 합법 수 개수(8.2: 56 / 45 / 44 / 56).
  • 같은 색 변 맞댐 거부, 다른 색과 맞댐 허용.
  • 이음선 6방향 각각 허용. 대각 위치가 아닌 곳(예: B − A = (2,0) 직선 두 칸)은 거부("선으로 이어지는 곳이 아니에요").
  • 막힘: 사이 두 칸을 다른 색 블록 하나가 덮으면 거부, 다른 색 블록 두 개가 한 칸씩이면 허용, 한 칸만 덮였으면 허용, 금색 장애물 두 개가 맞댄 틈은 허용, 같은 장애물 하나면 거부. free에서는 모두 허용.
  • 구역 밖 칸(4인·3인)은 놓을 수 없고, 사이 칸이 구역 밖이면 열린 것으로 봄.
  • 놓을 곳 없는 색 자동 colorOut, 이후 차례에서 빠짐, 모든 색 끝나면 종료. 2색 가진 사람의 한 색만 끝난 경우 다른 색은 계속.
  • 점수: 남은 칸 합, 공동 순위, blokusBonus(다 놓음 +15, 마지막 p1 +20), 팀 합계.
  • 5명 auto: 장애물 15개, 맨 바깥 칸 없음, 두 번째 줄 1칸 이상, 구역마다 3개, 겹침 없음. 시드 1,000개에서 배치 실패 없음.
  • 5명 draft: 고르기 3바퀴·놓기 순서, 조건 위반 거부, 마지막에 놓은 사람이 시작.
  • neutralBlocks: 개수, 시작점과 거리, 서로 안 닿음.
  • allowFlip=false: orient 6~11 거부, 거울상 블록 방향 수 절반.
  • 시간 초과: autoPlace가 가장 큰 블록을 합법하게 놓음, 같은 시드 같은 결과, 연속 한도 넘으면 그 사람 색 모두 끝남. pass는 색 유지. fischer 시간패.
  • 무르기: 전원 수락 시 배치·자동 colorOut 함께 복원, 다음 색이 놓은 뒤에는 요청 불가.
  • 기권: 색 끝남 처리, 순위 맨 아래, 2명이면 상대 승.
  • 정보: 차례 아닌 사람·관전자 view에 legal 없음, 모든 view에 rng 없음. checkPlacement(클라이언트)와 validate 결과가 무작위 배치 1만 개에서 같음.
  • 성능: 무작위 대국에서 legalActions 최악 10ms 이내, apply 5ms 이내. 2~6명 모든 모드 무작위 대국이 끝까지 감(상한: 색 수 × 18 + 색 수 차례).

11. 참고 자료

12. 메모 (상표·법적 주의 등)

  • 표시 이름: 친구끼리 쓰는 사이트라 원래 이름 "젬블로"를 쓴다(13-decisions.md 0절과 같은 원칙). "젬블로(Gemblo)"는 젬블로컴퍼니의 상표이므로 공개 서비스로 바꿀 때는 "보석 잇기" 같은 일반 이름 후보를 검토. 박스·로고·판 그림은 쓰지 않고 직접 그린다.
  • 확인하지 못한 것(구현 전에 실물·규칙서로 확인하면 좋음):
    • 실물 판 칸 수: 463칸은 "한 변 8칸"(Gough)과 판 그림·사진에서 잰 크기, 디자이너가 말한 비율로 정한 값이다. 4인 구역(295칸)·3인 구역(241칸)·5인 시작 칸은 규칙서 그림을 재서 옮긴 값이라 실물과 한두 줄 다를 수 있다.
    • 6인 시작점: 규칙서·Gough는 "꼭짓점", 2015년판 사진의 초록 표시는 꼭짓점에서 2칸쯤 비켜난 바람개비 모양으로 보인다. 엔진은 꼭짓점으로 정했다.
    • 뒤집기: 규칙서 번역본에 언급이 없다. 평평한 일반판 블록은 뒤집을 수 있고 디럭스 보석 블록은 사실상 못 뒤집는다. 기본 true로 두고 사용자 확인 필요.
    • 동점 처리: 원작에 규칙이 있다고만 알려져 있어 공동 순위로 둠.
    • 블록 모양 18개: Gough 그림 기준, 디럭스판 사진과 개수·종류가 맞음(사진이 비스듬해 5칸 블록 일부는 그림으로만 확정).
  • 금전·베팅 요소 없음.

13. 구현하면서 정한 것 (2026-10-15)

  • 코드: 규칙 packages/games/src/gemblo/(board.ts 판·블록·판정, index.ts 규칙, bot.ts 컴퓨터), 화면 apps/web/src/games/gemblo/. 브라우저 미리보기는 @bg/games/gemblo/board의 placementRefusal(서버 validate와 같은 코드)로 바로 판정한다.
  • 팀은 자리로 정한다: 4명은 1·3번 자리 대 2·4번 자리(대각선 모서리), 6명 pairs는 1·4 / 2·5 / 3·6번, triples는 1·3·5 대 2·4·6번. seatOrder=random이면 팀도 무작위, joinOrder면 방의 자리 순서대로(방장이 자리를 바꿔 팀을 맞춘다).
  • 팀전 순위: 남은 사람이 있는 팀끼리 합계로, 모두 빠진 팀은 그 아래(늦게 빠진 팀이 위). "남은 사람이 1명 이하"로 끝나는 조건은 팀전에서 "남은 팀이 1개 이하".
  • 5명 auto 장애물: 200번 무작위 시도 대신, 그 구역에 놓을 수 있는 자리를 모두 세어 RNG로 하나 고른다(실패 없음, 시드 1,000개 테스트). 장애물과 금색 블록은 모두 gold로 저장하고 kind(obstacle / neutral)로 구분한다.
  • 5명 draft: 고르기는 자리 순서 0→4로 3바퀴, 놓기는 0번 자리부터 한 개씩. 손에 든 블록이 더 놓일 곳이 없으면 그 블록들은 빠진다(기록에 "빠짐"). 고르는 중에 기권하면 고른 블록은 다시 더미로, 놓는 중에 기권하면 그 사람 블록은 빠진다. 장애물 차례는 시간 방식과 상관없이 60초.
  • 금색 블록: 시작점과 거리 6 이상인 자리가 없으면(듀오 판은 시작점이 가운데에서 4칸) 5 → 4 → 3으로 줄여 놓는다.
  • 연속 자동 처리 횟수는 색이 아니라 사람 단위(streak)로 센다. pass도 자동 처리로 센다. 시간 제한 없음(none)에서도 연결 끊김 유예가 끝나면 timeoutPolicy대로 처리한다.
  • 무르기: 다른 사람이 답하지 않아도 다음 색이 놓으면 요청은 사라진다(별도 30초 거절 타이머 없음). 요청한 사람은 [요청 취소]로 거둘 수 있다(cancelUndo). 자동 배치는 무를 수 없다.
  • view의 legal.bridgePoints는 칸 번호(CELLS 인덱스) 목록이다.
  • 화면: 블록 트레이와 버튼은 PC에서도 판 아래에 둔다(오른쪽 패널은 사람·시계·기록·채팅). PC는 18개 격자(쓴 블록 흐리게, 놓을 곳 없으면 🔒), 휴대폰은 남은 블록만 한 줄로 밀어 본다. 휴대폰은 칸을 누르면 미리보기, 같은 칸을 한 번 더 누르거나 [놓기]로 놓는다. 이음점을 누르면 그 점을 덮는 합법 배치를 큰 블록부터 차례로 보여 준다(같은 점을 다시 누르면 다음). [🔍 확대]/[🔍 전체] 단추는 판 위 줄에 둔다(판 안에 두면 칸을 가린다). 키보드: 방향키 이동, R(Shift+R) 돌리기, F 뒤집기, [ ] 블록 바꾸기, N 이음점의 놓는 방법 차례로, Enter 놓기, Esc 취소.
  • 컴퓨터: 판이 공개 정보뿐이라 운(04 §5.1)은 쓰지 않는다(NO_LUCK).