Files
joke-app/packages/shared/src/bots.ts
EJClaw 13a89a645e 새 게임 블랙잭: 딜러(하우스) 상대 1~7명·놀이용 칩. 공식 규칙(6벌 S17·블랙잭 3:2·A/10 peek·아무 두 장 더블·DAS·4손패 스플릿·에이스 한 장)을 기본값으로, 한국 하우스 룰(5·6카드 찰리, 7-7-7 보너스 3:1, 배당 6:5·2:1·1:1, H17, 더블 9~11·10~11, 에이스 자유 히트·다시 스플릿, 레이트 서렌더, 인슈어런스)을 방 설정으로
- 엔진 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>
2026-10-14 05:45:41 +09:00

103 lines
3.9 KiB
TypeScript

/** Computer players for solo practice (docs/06-lobby-rooms.md §12). Shared by server and web (no runtime deps). */
import type { PublicUser } from './types';
/** Bot user ids look like `bot:<n>:<ulid>`; real user ids are plain ULIDs, so they can never collide. */
export const BOT_PREFIX = 'bot:';
export const isBotId = (id: string): boolean => id.startsWith(BOT_PREFIX);
export const makeBotId = (n: number, unique: string): string => `${BOT_PREFIX}${n}:${unique}`;
/** Number shown in the bot's name ("컴퓨터 2"). */
export function botNumber(id: string): number | null {
if (!isBotId(id)) return null;
const n = Number(id.slice(BOT_PREFIX.length).split(':')[0]);
return Number.isInteger(n) && n > 0 ? n : null;
}
/** Public profile of a bot id, or null for anything else. */
export function botProfile(id: string): PublicUser | null {
const n = botNumber(id);
return n === null ? null : { id, nickname: `컴퓨터 ${n}`, avatar: null, kind: 'bot' };
}
/**
* Games that offer computer players. Real-time and drawing games (도블, 할리갈리, 그림 맞히기) don't: a bot there is
* either unbeatable or meaningless. 마피아 has talking computers (2026-10-11). 사과 게임 is a race where everyone solves
* their own copy of the board, so a computer simply races too at its level's speed (2026-10-12). 라이어 게임 has
* talking computers like 마피아 (2026-10-12).
*/
export const BOT_GAMES: readonly string[] = [
'omok',
'othello',
'chess',
'janggi',
'baduk',
'seotda',
'poker',
'yacht',
'yut',
'one-card',
'rummikub',
'gostop',
'bang',
'davinci-code',
'mahjong',
'marble',
'dalmuti',
'splendor',
'quoridor',
'las-vegas',
'cockroach-poker',
'ninety-nine',
'old-maid',
'mafia',
'apple',
'clue',
'connect-four',
'uno',
'liar',
'magical-athlete',
'blackjack',
];
/** Players a practice room starts with when the minimum makes a thin game (마피아 4명 = 마피아 1, 경찰, 의사, 시민 1; 라이어 게임 3명). */
export const PRACTICE_PLAYERS: Readonly<Record<string, number>> = { mafia: 6, liar: 5 };
export const botsAllowed = (gameId: string): boolean => BOT_GAMES.includes(gameId);
/**
* Games where computers must talk to play at all (마피아 토론, 라이어 게임 설명·토론): their computers always speak, whatever the room's
* "컴퓨터 채팅" setting says. In every other game the computers' small talk is off unless the host turns it on.
*/
export const BOT_CHAT_REQUIRED: readonly string[] = ['mafia', 'liar'];
export const botChatRequired = (gameId: string): boolean => BOT_CHAT_REQUIRED.includes(gameId);
/**
* Computer levels 1~60 (docs/09-game-engine.md §9.1): 1~20 쉬움, 21~40 보통, 41~60 어려움. The host can pick a band
* for each computer after adding it; the exact level inside the band is drawn at random and stays hidden until the
* game is over (fairness check).
*/
export const BOT_LEVEL_MAX = 60;
export type BotBand = 'easy' | 'normal' | 'hard';
export type BotPick = 'random' | BotBand;
export const BOT_PICKS: readonly BotPick[] = ['random', 'easy', 'normal', 'hard'];
export const BOT_BANDS: Readonly<Record<BotBand, readonly [number, number]>> = { easy: [1, 20], normal: [21, 40], hard: [41, 60] };
export const BOT_PICK_LABEL: Readonly<Record<BotPick, string>> = { random: '랜덤', easy: '쉬움', normal: '보통', hard: '어려움' };
export function bandOf(level: number): BotBand {
return level <= BOT_BANDS.easy[1] ? 'easy' : level <= BOT_BANDS.normal[1] ? 'normal' : 'hard';
}
/**
* Luck in [-1, 1] as people read it. A computer's luck decides how many shuffles the server tries before a game and
* whether it keeps the best or the worst one for that computer (docs/04-stability-security.md §5.1).
*/
export function luckLabel(luck: number): string {
if (luck <= -0.6) return '아주 나쁨';
if (luck <= -0.2) return '나쁨';
if (luck < 0.2) return '보통';
return luck < 0.6 ? '좋음' : '아주 좋음';
}