中国象棋

中国象棋 Xiangqi  —  《骑马与砍杀2：霸主》MOD
版本 v1.0.4（修订 65）   更新 2026-09-13
====================================================================

【这是什么】
在酒馆的棋桌上、或在领主的厅里，和 NPC 下一盘**完整的中国象棋**。

  · 规则完整：蹩马腿 / 塞象眼 / 炮架 / 过河兵 / 飞将 / 将杀 / 困毙
  · 三次重复局面按**中国规则**判：长将、一将一捉、长捉不变的一方判负（可关）
  · 电脑对手 6 档：新手 · 略懂 · 棋手 · 好手 · 高手 · 国手，带开局库与后台思考
  · 中文记谱：走子提示、完整棋谱（L）、复盘（O）、悔棋（U）
  · 和酒馆主持赌彩头；赢了领主加好感
  · 战绩统计（胜/负/和、金币净额）会存进存档

棋盘和棋子是**程序化生成**的：不使用任何外部模型文件，
并且会「借用」原版棋桌的位置、朝向和缩放，所以在不同文化的酒馆/大厅里都能摆正。


【安装】
1. 把整个 Xiangqi 文件夹放进：
     <游戏安装目录>\Modules\
   例：D:\steam\steamapps\common\Mount & Blade II Bannerlord\Modules\Xiangqi
2. 启动器（Launcher）里勾选 **Xiangqi**（Singleplayer）。
3. 版本要求：正式版 **1.4.8.x**（本 MOD 在 v1.4.8.119303 上开发与验证）。


【依赖】
必须（都在游戏自带模块里，SubModule.xml 已声明，不需要你手动装）：
  Native · SandBoxCore · Sandbox · CustomBattle · StoryMode

可选：
  MCM v5（Mod Configuration Menu，模块 id：Bannerlord.MBOptionScreen）
  → 装上才会出现本 MOD 的设置页面（"中国象棋"）。
  → 不装也能正常玩，所有选项使用下面的【默认值】。

无需：Harmony、任何前置 MOD、任何外部模型或贴图资源。

【与 AnimusForge 的联动（可选）】
如果你装了 **AnimusForge（AF）**，它有一个"盯着 NPC 看很久 → NPC 主动说话"的被动反应，
而那段话是 AI 生成的（消耗 token）。下棋时你必须长时间面对对手，会反复触发它。
配套模组 **XiangqiAnimusBridge** 就是为这件事写的：只在下棋期间把 AF 那个反应静音，
棋局结束立刻还原。本模组对 AF 一无所知、也不依赖它；装不装桥接都能正常下棋。
（本模组对外提供 `Xiangqi.BridgeApi`，桥接就是靠它知道"玩家正坐在棋盘前"。）


【怎么开始一局】
◆ 酒馆（可赌彩头）
  走到棋桌旁 → 和「棋局主持」交谈 → 「来一盘中国象棋。」
  → 选先手：「我来执红（电脑执黑）」或「电脑执红先走（我来执黑）」
  → 选彩头档位：可以「提高一档」「降低一档」，也可以「不赌钱，随便下下」
  → 「就按这个彩头开局。」

  彩头档位 = 100 × 难度 × {1,2,3,4,5}
    难度 3（默认）：300 / 600 / 900 / 1200 / 1500
    难度 5：        500 / 1000 / 1500 / 2000 / 2500
  钱不够时主持人会拒绝（「这点钱可不够押这个彩头，换个档位吧。」），
  但五个档位始终都点得动 —— 不会因为没钱而"消失"。

◆ 领主大厅（不赌钱）
  和领主交谈 → 「要不要来一盘中国象棋？我带了一副。」
  → 选先手 → 「好，摆棋。这局不赌钱，全看棋力。」
  赢了他加好感 **+1 ~ +5**（他的「算计/Calculating」性格越高，越敬重赢他的人）；
  同一个领主**每天只计一次**（避免靠反复重赛刷好感，棋本身还是随便下）。
  领主的棋力由他本人决定，不受 MCM 难度影响。

◆ 想玩原版棋：对主持说「还是玩你原来那些棋吧。」（本 MOD 不覆盖原版棋）


【快捷键】进入棋盘视角后
  鼠标左键       选子 / 落子（只显示合法落点）
  按住鼠标右键   拖动转视角（左右环绕、上下俯仰）
  小键盘 + / -   拉近 / 拉远（范围 0.42 ~ 1.60 米，步长可在 MCM 改）
  R              相机复位
  N              重开一局（同一对手、同一彩头）
  U              悔棋（退一整回合：自己那手 + 电脑的应招，被吃的子会回来）
  O              复盘（进入后：, 上一步 · . 下一步 · O 退出）
  X              认输（会弹确认框）
  L              棋谱（中文记谱 + 开局名称 + 战绩）
  T              切换摆放：酒馆棋桌 / 角色正前方（诊断用）


  鼠标滚轮**故意不参与**棋盘控制：它曾经在暂停菜单里误缩放棋盘，所以改成小键盘。


【MCM 设置项】（装了 MCM 才有；括号内为 默认值 / 可调范围）
▸ 对局
  电脑难度                            默认 3，范围 1~6
      1 新手 · 2 略懂 · 3 棋手 · 4 好手 · 5 高手 · 6 国手
      只影响酒馆棋局主持，同时决定彩头的基础倍数
  电脑思考停顿（毫秒）                默认 750，范围 0~2000
      你走子的滑动动画结束后，电脑还要"想"多久才应招
  使用开局库                          默认 开
      开局前十来个回合按主流开局应招（42 条可下线路 / 26 个开局名），
      开局定型时会告诉你这盘叫什么开局；关掉则每步都自己算
  后台思考（不卡顿）                  默认 开
      电脑在后台线程思考，最高难度也不会在落子前卡住画面；
      关掉则回到同步思考（档 5/6 会有约 1 秒停顿）
  长将长捉判负（中国规则）            默认 开
      重复局面时一直将军/一直追捉同子的那方判负；关掉则任何重复都判和
      （同方**连续 3 手**长将或长捉就先给一次警告，不会突然判负）

▸ 悔棋
  允许悔棋（U 键）                    默认 开
  每局悔棋次数上限                    默认 5，范围 0~20（0 = 完全不能悔）
  赌局中禁止悔棋                      默认 开
  有彩头的对局不能悔棋（否则可以靠悔棋躲掉输钱）；领主局不受影响

▸ 棋盘
  棋盘离桌高度（毫米）                默认 7，范围 0~30  ※修改后需要重启游戏
  棋盘悬在桌面上方的高度；如果棋盘被桌面吃掉一块，把它调大
  棋盘补光强度                        默认 12，范围 0~40
  棋盘上方一盏补光灯（酒馆的光只照桌子一侧，执黑会偏暗）
  大厅环境补光                        默认 26，范围 0~60
  领主大厅/城堡里没有灯，这盏更宽的灯只在非酒馆场景点亮
  缩放步长（毫米）                    默认 120，范围 40~300
  每按一次小键盘 +/- 改变多少相机距离

▸ 提示
  显示走子提示                        默认 开（左上角中文记谱）
  劣势时建议认输                      默认 开（只提醒一次，不反复打扰）

▸ 动画
  棋子滑动时长（毫秒）                默认 450，范围 0~600（0 = 瞬间到位）
  落子音效                            默认 开


【日志 / 反馈问题】
  <游戏目录>\Modules\Xiangqi\xiangqi_debug.log
  每局启动时重写。里面记录了：棋盘建在哪里（`board z:` 一行含桌面、
  外框、底垫三个高度）、材质加载、AI 选择、结算金额、战绩、异常堆栈
  （崩溃时还会附最近 30 条 first-chance 异常）。
  出问题请把这个文件发回来。


【会写存档吗】
  会往**当前存档**里写一小段数据，仅限：
    · 战绩统计（酒馆/领主 局数与胜数、负、和、金币净额）
    · "今天有没有赢过某个领主"（用于上面那条每天一次的限制）
  不修改任何原版文件、不改动游戏本体数据。卸载后这段数据留在存档里但不再被读取，
  无害；本 MOD 也不影响存档兼容性判定。


【兼容性】
  · 与原版棋共存：原版棋桌/原版棋的选项保持原样，本 MOD 只在原版问候语之外
    增加我们自己的入口；对局结束后原版棋盘自动摆回来
  · 支持不同文化的酒馆/内厅（阿塞莱等带缩放的棋桌也能正确摆放与点击）
  · 与 MCM 其它页面无冲突（本 MOD 的设置页 id 为 Xiangqi）


【已知限制】
  · 只有**酒馆**和**领主大厅/内厅**能下（需要场景里有棋桌）
  · 对手 NPC 不会真的坐到桌边（按需求保持现状）
  · 界面文本只有中文，暂不支持多人
  · 若把 MCM「棋盘离桌高度」设为 0，桌面会挡住棋盘和底垫 —— 这是该设置本身的后果
  · 长将/长捉判定刻意保守（只判明确的长将/追捉，避免误判）


【卸载 / 回退】
  删除 Modules\Xiangqi 整个文件夹即可（外加在启动器里取消勾选）。
  想回退到旧版：把备份的 Xiangqi.dll 覆盖回 bin\Win64_Shipping_Client\ 即可。

*总体评价	给总体评价评分
*点评	Smilies 登录