地图封锁

英文名：MapBlockade 中文名：城池关隘 灵感来源：老玩匠番茄（Bilibili：BV1xHHQeKEoB） 作者：Huanzze（幻酌大大）、Wuyu（无欲）（群成员）

版本说明与前置要求

• 当前版本：v1.2.6（更新日志见文末）
• 需要“四大前置”（Harmony / ButterLib / UIExtenderEx / MBOptionScreen）
• 同时支持两种版本：安装了 Warsail DLC 和原版（无 DLC）。两种情况下所有关隘功能均可完整运行，内置地图数据会自动匹配所安装的版本
• 已测试与 1.4.x 兼容。不支持 1.3.x / 1.5.x。

社区与问题反馈 QQ 群： 658975856 — 免费加入。 Nexus：https://www.nexusmods.com/mountandblade2bannerlord/mods/13102

---

原版卡拉迪亚没有边界。城堡不过是插在地图上的一面旗帜——而不是一堵挡在任何人面前的墙。任何军队都能绕过你拥有的每一座城堡，直插你王国的心脏。MapBlockade 的存在只为做一件事：从战争的词典里删掉“绕道”这个词。

你的边界不该只是一个愿望

你花了三天打下一连串边境城堡，终于感到安全。第四天早上，斥候报告一支两千人的敌军绕过你崭新的城堡，直扑你的腹地——那里有你最好的村庄和一座战争机器般的城镇。你调头追击，它闪身避开继续推进。你分兵拦截，它总能找到你防线上的缺口。原版战争没有前线——只有无尽的追击，和永不停歇燃烧的村庄。

战役地图城池关隘的存在就是为了终结这一切。守住所辖城镇和城堡会形成真正的关隘：如果敌人要抵达某个目的地必须穿越你两座或更多所属城池的关隘，那条路对他而言就是死路——撞上关隘的部队会原地待命，在下一个整点决策时另寻他路，完全无需你操心。被阻止的是“穿越”，而不是“进攻”：敌人始终可以推进到城门下发起围城——这正是你想要的结果，因为如果他想要你的腹地，“硬打”就是唯一剩下的路：一座座攻下你的城池，一步步碾进来。

你甚至不需要一道完美的长城。任何被后方两座守城城池遮蔽的核心区域，都是他无法绕过的保险箱；而你攻下的每一条边境线终于有了防御意义——敌人要么在门前掉头，要么倾巢而出，选一座城，打一场你早已预料到的围城战。关隘只阻挡你的敌人：你自己的部队、友方军团，以及与你无冤无仇的路人，行动一如往常。

进攻从“点击进军”变成“攻破城门”

适用于敌人的规则同样适用于你——而这正是原版从未给予你的战略深度。入侵过去意味着在敌方腹地点选一座城，然后一路把沿途每座城堡当成风景般越过；敌人对你也一样，每场战争都只是一记笨拙的挥砍。如今两个王国之间的边境是一块真正可以博弈的棋盘。你先撬开哪道门？在哪里把他主力引诱到隘口决战？当这道门陷落时，他领土的哪一块会被切断与后方的联系？

而当你终于啃下一座挡路的城池时，它曾遮蔽的敌方领土在你面前豁然洞开——这是点选式征服从未有过的“破门”回报。

甚至连敌方 AI 也遵守同样的规则：被关隘隔开的家族部队不再被强行塞进军团名册，“追领主 → 在界线前卡住 → 再追”的仓鼠轮不再出现，集结也不会永远等待无法抵达的援军。所有人终于像是在为“真正到达”而战。

看得见的前线，可信赖的行军

新规则不该让你盯着地图一头雾水，所以模组自带了一层翻译层：

• 点击被敌方封锁的目的地时，光标会变成“禁止”图标；悬停其上会直接告诉你：“不可抵达——被敌方封锁”（MCM：Blocked Hover Hint）。规则可以被读到，而不只是一堵沉默的墙。[/*]
• 缩小视野鸟瞰全局，所有你无法前往的地方都会被染成深红色（MCM：Unreachable Region Overlay (Zoomed-Out View)）——包括敌方关隘线另一侧被切断的整片区域，以及敌方边境关隘带本身（只能前往攻击关隘所属聚落，不能穿行）。前线的真实形状一目了然；红色会随着宣战、议和或聚落易主实时更新，当一座关隘城池陷落时，它曾遮蔽的红色区域也随之消失。[/*]
• 需要绕行时，战役地图会画出你的部队实际走的绿色路线（MCM：Player Party Navigation Path），身后走过的路段会随行进消失——你始终知道要去哪里、还剩多远。[/*]
• 当你围攻被自身关隘带环绕的敌方城池时，你的军队会在关隘带外的集结点扎营，面向城门（Out-of-Band Siege Camping，与 Campaign-Map City Blockade 关联）——整场围城都在关隘带之外进行，城池陷落、围城解除或议和的那一刻，你原地出阵，永远不必跨越你刚刚为之奋战的那条线。[/*]
• 你的关隘线甚至会在战役地图上长出真正的城墙和塔楼（MCM：Campaign-Map Blockade Wall / Blockade Towers on Walls），风格由每座城池的文化和城墙等级决定，密度和规模可调。打开战略地图，你可以亲眼看到自己王国的边境——城镇和城堡都能守线，你也可以收紧防御只保留城堡。[/*]

快速上手

安装即玩：面向玩家的功能默认开启并实时生效——无需新开战役。任何你想微调的选项都在 MCM 的 MapBlockade 页面下，每个选项都有自己的提示说明。唯一的例外是“Enable Town Blockades”（城镇是否也形成关隘），它需要重载存档或开始新战役后才会应用。

致谢

城池关隘功能最初作为 MutliLittleFixes 的一大功能开发，现已成为独立的子项目。战役地图城池关隘的灵感与实现思路来自开发过程中老玩匠番茄的指导，在此一并致谢。

更新日志

v1.2.6

• 新功能：易主关隘宽限期——当关隘聚落改换王国时，其关隘带会在设定的游戏天数内停用（默认 3 天，可在 MCM 调整，0 = 禁用），所有阵营均可通行，让玩家有时间离开即将被切断的区域；宽限期结束后关隘自动恢复。仅由王国变更触发（内部封地重新分配不触发）。默认开启，实时生效。[/*]
• 改进：被封锁悬停提示现在会在宽限期内给出预警——当关隘聚落的易主宽限期生效时，悬停提示仍会在名义关隘下显示，内容为“About to become unreachable - Enemy Blockade”，提醒玩家该区域即将被关隘切断。[/*]

v1.2.5

• 改进：关隘绕行寻路大幅提速——关隘绕行规划现在复用池化的内存暂存区，不再每次规划都分配并初始化一整块寻路数据；当大量部队同时重新寻路或频繁绕行时，内存占用更低、地图更流畅，长距离绕行规划也更不容易卡顿。[/*]
• 改进调试：更精确的性能分析器报告——分析器的定期报告现在仅反映最近一个报告周期（此前为自开启以来累计），并新增各分支寻路计数器与规划结果计数器（成功 / 无路线 / 超出预算 / 数据未就绪等）、每次调用 A* 扩展面数的观测（计数 / 总计 / 峰值），以及 A* 核心与逐帧驱动的分别计时，便于定位性能热点。默认关闭。[/*]

v1.2.4

• 问题修复：重复点击同一目的地不再让部队穿过关隘带——修复了反复点击同一目的地坐标（例如双击）时，关隘绕行路线被原版寻路覆盖，可能导致玩家部队径直穿过关隘带、绿色导航路径线消失的问题。重复点击同一目的地现在会重新规划关隘绕行并保持路线显示；“追击移动目标”的节流仍然保留（此时保持现有绕行路线，而不是把控制权交还给原版寻路）。[/*]
• 改进：寻路失败不再静默穿过关隘——当关隘绕行无法规划时（关隘数据未就绪、无路线、超出寻路预算、路径链过短、内部错误，或执行层路段失败），部队现在会原地待命，而不是静默回退到原版寻路（可能穿过关隘带）；失败情况始终写入 Map Blockade 日志文件。MCM 调试组中可选的“Show Path Failure On-screen (Debug)”开关（默认关闭）会在左下角显示红色消息，指明部队、原因以及已原地停止——适用于地图上所有部队，不只是玩家。只有从未应用绕行的情况（原地 / 地图外 / 海上）仍正常寻路。[/*]
• 改进：修正了“Campaign Map Blockades”开关的说明——开关提示及相关文字现在写的是“仅无阵营部队（野生动物等）不受影响”，而不是旧的“中立部队和强盗（非王国）不受影响”，以匹配实际关隘覆盖范围（无家族家族、雇佣兵、强盗等均会被阻挡）。[/*]

v1.2.3

• 改进：不可抵达区域覆盖层现在有黑色轮廓——缩小时，深红色的不可抵达区域会获得一圈细黑轮廓，与可抵达领土清晰区分；降低“Unreachable Region Overlay Opacity”时轮廓不会淡出，始终保持清晰。[/*]
• 问题修复：玩家身处聚落内时入侵 NPC 无法发起围城——修复了 NPC 部队抵达关隘带外集结点、本应开始（或加入）围城时，因玩家身处聚落菜单（游戏暂停）而未触发的问题；NPC 部队是否发起围城现在与玩家的菜单 / 遭遇状态无关，玩家在聚落内等待时也会被正常围城。[/*]
• 改进：“Blocked Face Boundary Lines”开关从关隘设置组移至调试组——该开关会在被阻挡的格子周围绘制细黑边框（调试 / 排障工具，默认关闭）；将其移入调试组可让主设置更整洁。[/*]

v1.2.2

• 新功能：部队现在通过城门穿越关隘带——在战役地图上，任何被允许通过（己方 / 友方 / 中立关隘）关隘带的部队，其路线会自动改道经过每段城墙的城门位置，而不是直接穿过墙体中央，行军纵队真正“走城门”。[/*]
• 新功能：缩小时显示不可抵达区域（战略鸟瞰视图）——当你缩小战役地图时（在摄像机距离 50–200 之间淡入），深红色半透明覆盖层会标出玩家部队当前因敌方关隘而无法抵达的每一片区域：敌方关隘线另一侧被切断的整片区域（从部队当前位置不可抵达，必须穿越敌方关隘），以及敌方边境关隘带本身（只能前往攻击该关隘聚落，不能穿行）。己方 / 友方 / 中立领土保持无着色，没有敌方关隘切割地图时不会着色。红色区域在宣战 / 议和 / 聚落易主以及关隘城池陷落时立即更新；覆盖层几何在战役加载后缓存一次，并在每次重新进入地图视图时复用。默认开启，实时生效，不透明度可调（默认 0.5）。[/*]
• 改进：城门与塔楼布局——每段关隘城墙现在在几何正中设有一座城门楼（风格由聚落文化和城墙等级决定），塔楼重新排列为以该城门楼为中心、按设定间隔对称展开（复用“Blockade Tower Interval”设置），匹配城墙城市真实的“门—塔”结构。[/*]

v1.2.1

• 问题修复：长距离关隘绕行不再被寻路预算扼杀——关隘感知寻路的扩展面数预算已大幅提高，因此穿越卡拉迪亚另一端前往遥远目标的绕行路线可以正常规划，而不再因触及预算而被放弃（表现为关隘失效、不绘制路线）。[/*]
• 改进：关隘覆盖范围扩展至王国部队之外——战役地图关隘不再只拦截王国军队：无家族家族（普通部队 / 自立统治者 / 叛军 / 带地离开王国的领主）会被敌对其派系的城池阻挡，雇佣兵遵循其雇主王国的战争状态，强盗 / 海盗 / 逃兵会被地图上每一座关隘城池拦截（他们可以接近并攻击关隘城池本身，但不能穿过关隘）；只有无派系部队（野生动物等）仍可自由行动。[/*]
• 改进：路线现在使用自发光叠加材质——战役地图导航路径和关隘绕行线在夜间和深色地形上依然明亮清晰可见，不再受场景光照影响而变暗。[/*]

v1.2.0

• 新功能：Enable Town Blockades——新的 MCM 开关（默认开启）：启用时，城镇和城堡都会形成战役地图关隘；禁用时，只有城堡形成关隘，城镇关隘面重新并入可行走陆地并自由通行，关隘城墙 / 塔楼 / 面边界线仅适用于城堡。该变更需重载存档或开始新战役后生效（无需重启游戏）——当前战役仍按之前的设置运行。[/*]
• 改进：原版（无 Warsail DLC）支持——MapBlockade 不再需要 Warsail DLC；所有关隘功能在 DLC 和原版安装上均可完整运行，地图数据会自动匹配所安装的版本。旧的“缺少 DLC → 弹出提示并禁用功能”行为已移除。[/*]

v1.1.1

• 问题修复：玩家加入围攻城池的友方军团时不再滞留在关隘带内——“Out-of-Band Siege Camping”位置覆盖范围现在扩展至整支围城军队：玩家或任何作为军团成员围城的部队，整场围城期间也停留在关隘带外的集结点，城池陷落、围城解除或议和后即可原地出阵。[/*]
• 问题修复：关隘寻路不再被迫绕远路——修复了关隘地图数据中部分实际相邻的地图格子被误判为不相邻的遗留问题（导致关隘感知寻路绕行很远），并重新校准了内置地图数据，将面轮廓采样精度默认从 16 提高到 512；被阻挡格子的边界、可达性和绕行路线现在与真实地形相邻关系一致。[/*]

v1.1.0

• 新功能：Out-of-Band Siege Camping（关隘带外围城扎营）——攻击被自身关隘带环绕的敌方城池时，行军目的地会被改写为关隘带外的集结点，因此部队整场围城都待在关隘带外，攻下城池、解除围城或议和后即可立即从那里出阵；抵达时仍会触发正常的围城开始 / 敌城菜单流程。[/*]
• 新功能：Blockade Towers on Walls（城墙上的关隘塔楼）——堡垒塔楼按间隔放置在战役地图关隘城墙上，风格由聚落文化和城墙等级决定，并共用城墙比例；塔楼间隔可在 MCM 调整（默认每隔一段）。默认开启，实时生效。[/*]
• 新功能：Blocked Hover Hint（被封锁悬停提示）——当悬停在因敌方关隘而无法抵达的目的地上时，光标上方会出现简短文字，说明该目的地因关隘而不可抵达。默认开启，实时生效。[/*]
• 新功能：Player Party Navigation Path（玩家部队导航路径）——玩家部队当前的导航路线以细绿色折线绘制（仅执行层路径）；随着部队行进，走过的路段会从线的前端消失，直到抵达目的地后整条线消失。默认开启，实时生效。[/*]
• 改进：原“Show Blockade Detour Path”双层调试视图（绿色规划层 + 蓝色执行层，静态折线）已移至调试组；它与“Player Party Navigation Path”相互独立，两者可同时启用。[/*]
• 问题修复：攻击关隘城池不再被其自身关隘带错误阻挡——“穿过 1 个目标城池关隘 = 攻击该城池”的豁免现在在决策层和规划层均被遵守，玩家点击攻击和 AI 决策都能正常抵达城池。[/*]
• 问题修复：AI 领主组建军团时不再把被关隘带隔开的家族部队拉入招募列表；军团实力改为在实际可抵达的部队上重新评估。[/*]
• 问题修复：被关隘带隔开的营地外成员不再每小时循环“追赶军团领袖 → 在关隘处原地待命”。[/*]
• 问题修复：军团集结期间，已被征召但受关隘带阻挡、超过宽限期仍无法抵达的成员会自动从军团中移除，集结改为基于实际可抵达的实力推进，而不是永远等待。[/*]
• 问题修复：玩家招募家族部队时，被关隘带隔开的部队现在会在招募前判定为不合格，并显示原因。[/*]
• 新调试：Performance Profiler（性能分析器）——MCM 调试组新增“Performance Profiler”开关、报告间隔，以及“Dump Performance Snapshot Now”按钮，可将各阶段 CPU 消耗排名写入 Map Blockade 日志文件；还新增“Debug Log: Blocked Hover Hint”开关，用于排查悬停提示不出现的原因。默认关闭。[/*]

v1.0.0

• 初始发布：从 MutliLittleFixes 拆分出的独立模组——战役地图城池关隘、战役地图关隘城墙（包括缩放和格子边界线）、玩家部队关隘绕行路径可视化，以及王国可达性图像导出、地图拓扑 XML 导出、带采样点校正调试的专用关隘日志文件、村民部队生成调试等工具。所有开关实时生效；需要 Warsail DLC，未安装时功能会自动禁用并弹出提示。[/*]