21点牌局 araea/koishi-plugin-card-21-game

21 点

Koishi 插件：21 点，支持玩家对战、庄家模式与货币下注

安装

npm i koishi-plugin-card-21-game

启用插件，并安装 database 服务。货币下注还需 monetary 服务。

快速使用

发送 bj.来一局 开桌，加 -n 开启玩家对战。发送 bj.下注 入座，之后发送 bj.开始，或等待倒计时自动开始。指令前缀 bj 可写作 blackjack。

| 指令 | 裸词 | 说明 |
| bj | — | 查看指令列表 |
| bj.下注 | 下注 | 入座 |
| bj.开始 | 开始 | 发牌并进入下一阶段 |
| bj.要牌 | 要牌 / h | 要牌 |
| bj.停牌 | 停牌 / s | 停牌 |
| bj.加倍 | 加倍 / d | 首轮加倍 |
| bj.分牌 | 分牌 / p | 起手对子时分牌 |
| bj.投降 | 投降 | 仅投降阶段可用，只输一半注金 |
| bj.跳过 | 跳过 | 不买保险或不投降；全员表态后立即进入下一阶段 |
| bj.保险 | 保险 | 庄家明牌为 A 时购买保险 |
| bj.战绩 [@某人] | — | 查询战绩 |
| bj.排行榜 | — | 查看盈亏排行 |
| bj.结束 | — | 结束当前牌局 |
| bj.待核对 | — | 查看未确认入账记录（权限 3） |
| bj.确认入账 <编号> | — | 人工核对后标记，不执行转账（权限 3） |

目标是在不超过 21 点的前提下尽量接近 21。Blackjack 赔率为 3:2。庄家点数低于 17 时必须要牌。余额不足时，玩家每天可领取一次救济资金。

配置

| 配置项 | 类型 | 默认值 | 说明 |
| minBet | number | 10 | 最低起注金额 |
| deckCount | number | 4 | 牌靴副数，一副 52 张，范围 1–8 |
| playerTurnTimeout | number | 30 | 玩家操作超时（秒），超时自动停牌 |
| decisionTimeout | number | 10 | 保险与投降阶段的等待时间（秒） |
| joinPhaseTimeout | number | 45 | 加入阶段的等待时间（秒） |
| dealerHitSoft17 | boolean | false | 庄家在软 17（含被当作 11 的 A）时继续要牌 |
| enableDirectInput | boolean | true | 对局中直接发送「下注」「要牌」等动作即可 |
| quickMode | boolean | false | 快速模式，庄家的牌一次说完 |
| welfareEnabled | boolean | true | 余额见底时自动发放救济资金 |
| welfareAmount | number | 200 | 救济资金金额 |
| currency | monetary / bella | monetary | 使用的货币系统 |
| currencyName | string | default | monetary 的货币名称 |

限制 / 风险

货币模式必须安装 monetary 服务（或 bella-sign-in 插件），否则无法下注。

出现待核对提示时，管理员用 bj.待核对 查阅记录，再用 bj.确认入账 <编号> 标记。该标记不执行转账，状态不明时不要重复补发。

链接

- 设计系统
- MIT / Apache-2.0