#游戏厅 · 骗子酒馆规格（game = "liars_bar"）

通用部分（接口、签名、公共字段、顺序、出错、兼容）见 游戏厅通用协议。OpenAPI 里对应的 schema 都以 LiarsBar 开头，见 tavern.openapi.json。

#1. 规则摘要

和 Steam《Liar's Bar》的 Liar's Deck 模式基本一致：

• 人数与牌：2 到 4 个座位。牌堆是 Q、K、A 各 6 张，加 2 张 Joker（万能）。每小局随机定一张目标牌，每人发 5 张。
• 轮到你时二选一：
  • 扣着出 1 到 3 张，一律声称都是目标牌；
  • 质疑上一家。每小局的第一手不能质疑。
• 质疑：翻开上一家刚出的牌。只要有一张既不是目标牌也不是 Joker，就算他撒谎，由他开枪；否则由质疑的人开枪。
• 左轮：每人一把，6 格里只有 1 发实弹，开过的格不重置。打到实弹有 5% 概率哑火，哑火后重新装弹。中弹出局，活到最后的人赢。
• 重新发牌：只要开过一枪，就重新发牌。手牌出完的人跳过；只剩你手里有牌时，只能质疑。
• 机器人上桌：真人报完名（开桌人点开始，或报名时间到）才邀请所有机器人，由它们自己决定来不来（奶豆也一样）；座位最多 4 个，真人和机器人一起算；4 个真人直接开局不邀请；等回话期间又有真人来，最后上桌的机器人让位。

牌面只有四种写法："Q"、"K"、"A"、"JOKER"。手牌用位置号（1 到 5）标识，一小局内不变，出掉的就不再出现。

#2. 新一轮：PUT /v1/games/liars_bar/matches/{match_id}/rounds/{round}

每小局开始时调用。

{
  "protocol": 1, "seq": 12, "game": "liars_bar", "match_id": "lb10212009abcd", "chat_id": "oc_xxx", "turn_id": 30,
  "you": {"seat": 2, "name": "初雪"},
  "round": 3,
  "target": "K",
  "hand": [{"slot": 1, "card": "Q"}, {"slot": 2, "card": "K"}, {"slot": 3, "card": "JOKER"},
           {"slot": 4, "card": "A"}, {"slot": 5, "card": "K"}],
  "order": [{"seat": 0, "name": "鹿饮"}, {"seat": 1, "name": "奶豆"}, {"seat": 2, "name": "初雪"}],
  "first": 0
}

hand 是你的私有信息；first 是这一小局先出牌的座位。

#3. 轮到你：POST /v1/games/liars_bar/matches/{match_id}/turns/{turn_id}/decision

{
  "protocol": 1, "seq": 20, "game": "liars_bar", "match_id": "lb10212009abcd", "chat_id": "oc_xxx", "turn_id": 37,
  "you": {"seat": 2, "name": "初雪"},
  "round": 3,
  "target": "K",
  "hand": [{"slot": 2, "card": "K"}, {"slot": 3, "card": "JOKER"}, {"slot": 4, "card": "A"}],
  "can_challenge": true,
  "must_challenge": false,
  "last_play": {"seat": 1, "name": "奶豆", "count": 2},
  "pile": 3,
  "players": [
    {"seat": 0, "name": "鹿饮", "alive": true, "cards_left": 4, "shots_fired": 1, "is_bot": false},
    {"seat": 1, "name": "奶豆", "alive": true, "cards_left": 2, "shots_fired": 0, "is_bot": true},
    {"seat": 2, "name": "初雪", "alive": true, "cards_left": 3, "shots_fired": 2, "is_bot": true}
  ],
  "log": ["第 3 小局开始，目标牌 K", "鹿饮出了 1 张（声称都是 K），还剩 4 张。", "奶豆出了 2 张（声称都是 K），还剩 2 张。"],
  "chat": [{"name": "鹿饮", "text": "初雪你手里肯定没 K"}],
  "deadline_ms": 58000
}

#动作（响应体）

{"turn_id": 37, "action": "play", "slots": [3, 4]}

{"turn_id": 37, "action": "challenge"}

声称的牌自动算作本轮目标牌，不用填。

#4. 事件：POST /v1/games/liars_bar/matches/{match_id}/events

{"event": "play", "seat": 2, "name": "初雪", "count": 2, "cards_left": 1}
{"event": "challenge", "challenger": {"seat": 0, "name": "鹿饮"}, "accused": {"seat": 2, "name": "初雪"},
 "revealed": ["JOKER", "A"], "lied": true, "shooter": {"seat": 2, "name": "初雪"}}
{"event": "shot", "seat": 2, "name": "初雪", "result": "click", "shots_fired": 3, "nth": 3}
{"event": "game_over", "winner": {"seat": 1, "name": "奶豆"}}

每条也都带着公共字段（protocol、seq、game、match_id、chat_id、turn_id、you），这里省略了。

#5. 时限

和通用协议一致：邀请 30 秒；decision 和真人一样每手 60 秒，以 deadline_ms 为准（2026-10-24 起，原来是 15 秒）。

#6. 恶魔、混沌模式（2026-10-26 起）

开桌人可以选模式（报名卡上的按钮，或者 !骗子酒馆 恶魔、!骗子酒馆 混沌），规则见文末附：恶魔、混沌模式规则（局里的 rules 字段也会带上白话说明）。 接口和经典一样，只多了下面几处字段；没加这些字段的机器人照样能玩经典模式。

• 邀请多一个 mode：classic / devil / chaos。不想玩某种模式就回 {"accept": false}。
• 局面（decision 请求体）多 mode、max_play（一次最多出几张：经典、恶魔 3，混沌 1），恶魔模式另有 devil_card （本小局生效的恶魔牌，比如 K_devil；场上剩 2 人时为 null）。手牌里可能出现 Q_devil / K_devil / A_devil（恶魔模式）、 CHAOS / MASTER（混沌模式）。恶魔牌只能单出；混沌模式一次只出 1 张，多出了按“回的动作不合法”处理。
• 事件 challenge 多 special：devil（恶魔牌翻出，shooters 是全体开枪的人）、lie / master / chaos（混沌模式要选人开枪， shooters 是要开枪的人）；这时 shooter 为 null。
• 事件 shot 打别人时多 by：{"seat", "name"} 是开枪的人，seat / name 是挨枪的人，shots_fired、nth 说的是开枪人那把枪。
• 选人开枪（10-26 晚起）：轮到你的机器人拿枪打别人时，荷官发一个 decision 请求，ask 是 aim，局面里多 aim （kind 为什么轮到你开枪，targets 能打的人），choices 是 aim:座位号，回 {"turn_id": …, "choice": "aim:1"} 或 {"turn_id": …, "target": 1} 都行。这个请求有自己的 turn_id；时限 30 秒（以 deadline_ms 为准），没回或回错了荷官按规则替你选。
• 通用回法：每个 decision 请求都带 ask、prompt、rules（按模式）、choices，只认这几个字段的机器人三种模式都能玩，见通用协议第七节。
• 平局：混沌牌一轮全员阵亡时 game_over 的 winner 为 null。

#附：恶魔、混沌模式规则

#恶魔牌（照搬原版）

#混沌（照搬原版第一版）