中国象棋【v2.0.25】适用于v1.4.8

中国象棋 Xiangqi  —  《骑马与砍杀2：霸主》MOD
版本  v2.0.25（09-15 大改）   更新 2026-09-15
====================================================================
作者：维庸化石，小乌龟

维庸化石只是一位编程零基础的小白，所以只是用DSH跑完还行，才放上来。而小乌龟同志不以化石卑鄙，修改贴图，已提高视觉，故化石万分感谢！小乌龟推出不同文化的不同棋盘。

化石于此再次感谢小乌龟之奉献。

一、文化棋盘
帝国、阿塞莱、瓦兰迪亚、斯特吉亚、巴旦尼亚、库赛特和诺德各有自己的棋具风格。帝国各城市按固定分配使用本土、进口或镶嵌款式，每次进入不会重新随机。
酒馆默认使用整盘做旧的陈旧棋具：有褪色、积垢、磨亮区、木纹裂缝、缺口或皮面折痕，保留棋子磕损；大厅继续使用原有豪华棋具，品质名称升为御制。
先前仅做局部破损的棋盘完整保留，修复棋子磕损后列为普通。先前普通款升为精工，先前精工款升为御制。原有商品ID和重量不变，价格按品质统一。
带中文题铭的棋具以原装为名称前缀，保留繁体棋盘文字；对话仍用简体。
进入酒馆和大厅后默认展示象棋。原版小游戏入口仍保留，用户可自行选择，棋盘显示随玩法切换。
蜡烛仅在正式象棋对弈时启用，结束后熄灭隐藏。

二、商店购买棋具
目前共45款：陈旧10款、普通10款、精工10款、御制15款。传世与绝代暂未推出。
帝国城镇销售全部文化款式，其他文化城镇销售本地款式；按每七个游戏日补货规则供应。商店使用按文化区分盒盖题铭的轻量木质棋盒，原装盒写中文“象棋”，实际对弈时展开所选棋盘。
购买后把棋具放在主队伍行囊中，与酒馆赌客或领主选择自己带了棋的对话，即可挑选所拥有的款式对弈。商品较多时可翻页。
对弈不会消耗棋具；已卖出或未随身携带的棋具无法选用。退出后恢复主人的桌面棋具。
已有存档可以继续使用，无需重新开档；原有35件商品保留，品质名称按上述规则调整，另新增10件陈旧棋具。

三、品质价格（基础价值）
陈旧100、普通300、精工1500、御制15000、传世45000、绝代75000第纳尔。实际成交价受游戏经济和交易技能影响。
传世、绝代尚无商品；今后也不加入商店自动生成或补货库存，包括帝国城镇。

四、2.0.16资源精简
清理旧版文化贴图和开发残留；保留2048主纹理及独立做旧外观，优化做旧法线并共享同类低光泽贴图。45款棋具、棋字、价格与玩法保持不变。

五、2.0.17原版入口与入座
原版小游戏入口继续保留。选择原版玩法后按原版提示入座，继续难度、下注和开局流程。
象棋对手现在使用原版寻路和入座行为；请坐到棋桌的玩家座位上，双方坐好后才开局。等待时按X可以取消，无法入座时不会开始或扣除赌注。

六、2.0.18进场加载优化
棋盘纹理和模型改为分帧准备，完成后统一显示，减少进酒馆或大厅时集中加载导致的停顿。画质与棋盘款式不变。首次贴图解码仍有开销，不保证完全消除所有场景卡顿。

七、2.0.19棋盒题铭与材质
棋盒沿用各文化棋盘题铭：帝国拉丁文、瓦兰迪亚法文、斯特吉亚西里尔文字、巴旦尼亚爱尔兰文、库赛特传统蒙古文、诺德古诺尔斯风格文字；原装（含帝国进口款）用中文。商品名称与品质仍以中文显示。
校正三通道PNG底色与法线的导入次序，四通道反光图保持原次序；修复旧着色开关与当前原版PBR定义不一致，恢复正常木色和材质表现。棋盘仅改善表面凹凸和反光，保留全部款式、文字、底色、污渍和破损。共享小纹理控制体积。可继续旧存档，无需重新购买现有棋具。

八、2.0.20玩法入口修复
与领主、贵族交谈时，先邀请对弈，再选择象棋或本地原版棋。酒馆赌客直接询问玩哪种棋。
选择象棋后才显示象棋介绍、借用对方棋盘、自带棋盘、先后手和彩头等对应选项；象棋来历介绍仍仅由酒馆赌客讲述。
选择本地棋后沿用原版规则、入座检查、难度、赌注、开局和再战流程。站着交谈时，原版赌客会先请你入座；坐好后再交谈选择本地棋即可。
修正返回菜单和重复交谈时的入口状态；切换原版棋不再强制显示隐藏棋子、提示标记，也不由象棋接管原版的鼠标。
本次未修改45款棋盘、棋子和棋盒资源。不需要开新档。

九、2.0.21首次造访对话修复
修正大地图造访领主后，首次交谈仍出现旧下棋台词、需要取消再交谈的问题。
原版入口调整在所有战役对话完成注册后执行；首次邀请支持补装，不再漏掉原版邀请。
玩法菜单不再等待棋盘美术资源加载完成；先选择玩法，再配置对局。只有真正开局时才检查棋盘是否摆好，资源尚未就绪会留在菜单内提示稍候。
保持分帧加载，不增加进场同步加载；原版入座与开局规则不变。不需要开新档。

十、2.0.22重复进场缓存优化
最近3种棋盘款式的模型和绑定材质在本次游戏中保留，重复进入相同酒馆/大厅时复用；超过上限淘汰最久未使用的款式，重新载入战役时清空。
相同棋子复用模型，位置和显示状态各自独立；首次棋子生成按表面和字形分步处理，保持主线程分帧加载。
这是模型与材质复用，不修改游戏或显卡的全局着色器缓存设置。首次遇到新款式仍需加载贴图，不能完全消除首次加载停顿。
所有棋盘样式、棋字、破损、贴图和商品保持不变。不需要开新档。

十一、2.0.24商店品质与稀有度修正
每家商店按品质合计限量：陈旧4副、普通2副、精工1副、御制1副。不是每个款式各有这么多；帝国可售全部文化，但共用相同品质上限。
首次出现概率：陈旧50%、普通20%、精工5%、御制1%。每7个游戏日补货概率：陈旧100%、普通50%、精工10%、御制1%。
每个缺货品质只抽一次，成功后从该城文化可售款式随机补足差额。传世、绝代不自动入库；重复进城和读取已结算存档不能重抽。
升级后无需新档：旧版商店棋盘库存一次性重新生成，清除按每款大量发货的错误。旧库存没有来源记录，包含此前玩家卖入商店的棋盘；背包和个人仓库不受影响。此后不清除玩家卖入商品，超额库存停止补货。

十二、2.0.25恢复分帧创建
取消2.0.22加入的跨场景棋盘/棋子模型缓存，每次进酒馆或大厅重新分帧创建，不再复制缓存中的整套模型。
每帧最多推进2步，软时间预算2毫秒，贴图准备和棋子表面/刻字几何继续分步处理；单次引擎调用无法中途打断，不能保证每帧绝不超过2毫秒。
保留有界贴图与材质资源复用，整盘完成后统一显示，中途离场取消加载。商店品质、概率和现有棋盘款式不变，无需新档。

【2026-09-14 v1.0.5 繁体棋面修订】
红方：帥、仕、相、傌、俥、炮、兵；黑方：將、士、象、馬、車、砲、卒。
仅棋面使用繁体，游戏对话、棋谱和提示继续使用简体。
四个炮位、十个兵卒位增加标准折角定位标记，边线仅画内侧。
楚河漢界按参考图旋转并对向排列；两侧对向竖排「觀棋不語真君子」「起手無回大丈夫」。
原版固定相机与楷体凹刻保留。字形数据嵌入 DLL，无新增运行时字体或绘图库依赖。
通过编译、14 种棋子双朝向几何检查、繁简隔离检查、14 处定位标记检查、布局预览核对。


【2026-09-14 v1.0.5 统一配色与加宽外围】
棋盘线、兵炮位标记和题字改为贴图取色的深褐色，避免场景材质忽略顶点颜色时变白；棋子侧面改取木色，消除白边。
外围边距从约 30 毫米增至 64 毫米，浅木底面延伸到题字区域，外围保留 8 毫米深色边框。
标语向外移至 x=±242 毫米、字宽 16 毫米，距最外侧棋子边缘至少约 17.9 毫米。棋盘落点/棋子尺寸/规则不变。
低面数棋子结构保留（每枚 96 面）。编译、几何回归、标语净距检查和整盘排布预览通过；实际游戏材质效果待重启后确认。

【2026-09-14 v1.0.5 外层木材统一】
外围覆盖底板、窄边框与内部棋面使用相同浅暖木纹区域及材质；统一空间纹理坐标，消除内外纹理尺度差异和接缝。
不再使用原先深色外层木纹，棋盘/文字布局和低面数结构保持。编译通过；游戏内光照效果待重启确认。

【2026-09-14 v1.0.5 标语内移与取消额外补光】
两侧标语中心由 x=±242 毫米移至 ±234 毫米；与最外侧棋子边缘保留约 9.86 毫米间隔。
取消棋盘点光源及大厅额外补光，不再因切换象棋改变场景照明。旧补光配置值不再生效，设置页移除对应项目。
选中光圈、落子闪光、合法落点提示按用户澄清保留。原版场景灯光不受影响。
编译、标语净距和发布 DLL 检查通过；游戏内照明效果待重新进入场景确认。

【2026-09-14 v1.0.5 正常尺寸与整体抬高】
整副棋盘（棋子、文字、提示）统一缩放至 75%；取消按原版棋具占地扩展底板，成品外尺寸约 40.44 × 44.11 厘米。
在原有棋盘高度设置基础上整体额外抬高 15 毫米；保留固定原版相机，不通过拉远相机伪装缩小。
点击坐标已改用支持缩放的逆变换。实际游戏数学库检查 90 个落点、四种朝向和中心/近边缘位置，共 1080 例通过。
标语与边线棋子仍保留约 7.4 毫米间隔，取消额外补光的改动保持。
编译和安装哈希校验通过；实际游戏内尺寸与抬高效果待重新进入场景确认。

【2026-09-14 v1.0.5 恢复大小、裁短上下边与坐姿视角】
撤销 75% 的整体缩小，棋子和格距恢复 100%；左右标语留白保留，上下边距单独从 64 毫米减至 36 毫米。
底板仍不随原版棋具占地扩大，外尺寸约 53.92 × 53.21 厘米。额外抬高 15 毫米保留。
R 在原版相机与坐姿斜俯视相机间来回切换，复盘时也可切换；鼠标右键仍不能自由转动相机。
坐姿相机位于玩家一侧，朝棋盘中心约 61 度俯视；棋盘额外补光仍关闭。
编译通过；以游戏数学库验证全部 90 个落点、两方坐姿射线及 4:3/16:9/21:9 视野覆盖。实际游戏视觉效果待重启确认。

【2026-09-14 v1.0.5 酒馆赌客象棋介绍】
酒馆赌客的象棋开局菜单新增「象棋是什么？」选项，使用玩家提供的两段介绍原文。
提问和回答同时检查对话对象为 TavernGameHost 且当前地点为 tavern；其他 NPC、领主/同伴对话不添加此介绍。
介绍结束回到开局菜单，不改变先后手、赌注和开局状态。对话为简体，棋面繁体不变。
编译通过，25 条对话图检查无重复 ID、不可达节点或死路。


【这是什么】
在酒馆的棋桌上、或在领主的厅里，和 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 登录