- 엔진 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>
103 lines
3.9 KiB
TypeScript
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 ? '좋음' : '아주 좋음';
|
|
}
|