器物框架扩展（Artifact Framework Extension）[适用于v1.4.x]

[霸主功能][原创][2026.10.02][Artifact Framework Extension][0.5.0]


更新日志：
2026.10.2
v0.5.0
- 界面美化；
- 优化信件数据结构，新增拆封功能，拆封后会标记已读，可为后续信件相关任务系统打基础；
- meta信息可以显示在物品的浮动属性小窗中；
- 现在击杀动物会掉落肉、兽皮等物品，且会被附近的人目击；（鸡神降临？）
- 左下角菜单栏新添加冒险菜单，以供后续功能和mod显示信息。
- 通过锻造页面可以打造开锁器，可以用来打开上锁的宝箱。
- 尸体的互动点位改为随尸体变动，而非被击杀的固定位置。
- mod游戏内文本改成软编码，以实现多语言本地化。
- 存档方式由外置存档改为内置存档，并在MCM菜单中加入卸载mod的按钮（有效性待验证）。
- 框架结构优化。


2026.9.2
v0.4.0
- 背包互动：实装随身背包的赠与、NPC消费、没收机制、动态金币；
- 动态背包：现在领主们的背包不再是一成不变的了，他们会从战利品中挑取有价值的装备放进背包中，也会没收俘虏的贵族的装备；
- 高价值宝物探索：现在城镇中会出现宝物情报贩子，从他那里可以购买高价值物品所藏匿的地点的情报；
- 容器机制：个别样式容器物品特征化；容器增加权限属性，后续可扩展开锁玩法；
- 修复物品meta信息的记录逻辑错误，优化部分逻辑；
- 将炼金mod中的效果下放到本mod中，作为接口以供上层mod统一调用；
- 底层框架优化。
- 细节微调。


2026.8.21
v0.3.5
- 世界容器实装，定居点中的木桶、箱子、麻袋皆可偷窃；
- 目击者系统实装，偷窃时被目击者看到，可花钱贿赂或者威胁来封口；
- 修复物品详情的文本显示问题。
- 细节微调。


一、MOD 简介


    器物框架扩展（Artifact Framework Extension）是一款为《骑马与砍杀2》注入“角色扮演”味道的物品扩展 MOD。
    它借鉴《上古卷轴5：天际》等知名 RPG 的玩法，让游戏里的每一件物品都不再只是冷冰冰的“数据”，而是有自己的来历——是谁的、从哪来、有没有被下毒或附魔、有没有夹着一封密信。围绕这些“身世”，MOD 带来偷窃销赃、随身背包、信件阅读与窃取等一系列更有沉浸感的场景冒险。
    更重要的是，它不只是做几样功能，而是为卡拉迪亚打下一套“可生长”的框架底座：以此为基础，未来能像老滚5那样，不断叠上新的互动、任务与玩法，让这个世界越来越像一个会呼吸的 RPG。


二、核心内容：物品的数据库扩展

每一件物品都能携带自己的故事，而且信息可以互相独立。
•        赃物：偷来的东西会带上“（赃物）”标记，记着失主、失窃的时间和地点；赃物不能摆上货架倒卖，只能找友好的帮派头目销赃洗白。
•        涂毒 / 附魔：武器装备具有涂毒与附魔的可拓展属性，以供后续开发者对接。
•        信件：某些 NPC 身上会藏着信件，你可以翻阅一探其中的情报。
•        描述：物品可以写入自定义描述，记下一个属于它的小故事（目前仅供开发者写入）。


三、现有玩法

目前本mod还处于早期开发阶段，已经能做这些事：

1. 随身背包：每位英雄拥有一个独立的随身背包，在库存界面点随身背包按钮即可打开；在场景中打开背包直接对应随身背包，与部队总背包区分开来；背太沉会触发超重惩罚。

2. 偷窃与销赃：场景中从背后靠近 NPC 蹲下按 Ctrl+F 触发偷窃面板，可偷取对方背包中的物品和金钱；偷来的物品会被打上赃物标记；如果偷窃过程中没有目击者，则不会增长犯罪值，如果有目击者，在离开场景的时候会增长犯罪值，可以通过与目击者对话，通过威胁、贿赂对他们进行封口（杀死也可以，不过需要别的能够杀死城镇NPC的mod）。因已经有mod实现了偷窃功能，所以本mod只做基础框架，不在此玩法上深挖。

3. 快捷栏：战斗或场景中按 Q 打开左下角快捷栏（10 格），把常用物品绑上去后，Ctrl+1…Ctrl+0 直接取用（相当于额外的武器槽位了）。

4. 世界储物容器：城镇与村庄的大部分箱子、木桶、袋子可走过去按 ctrl+F 翻看、偷窃物品；放太久会被当地店家收上货架；场景中击杀也会掉落装备；城镇场景内商人身后会生成他们的专有箱子，箱子内的物品和金钱与城镇的总库存总钱数挂钩，且双向对应。偷窃物品与金额总价值过高，会影响定居点繁荣度（功能待测试）。可以与城镇内的宝物情报贩子购买高价值物品信息。

5. 信件：NPC 身上会生成信件，按照世界的运转会有相应的内容，可在查看物品信息界面阅读。

6. 查看物品信息：带“（附魔）”“（涂毒）”“（赃物）”或描述的物品，都是独立于同类物品的，都能点开看更多细节。

7. 可搭配卡拉迪亚的炼金扩展Mod，以获得更好的游戏体验。

四、未来方向

•        完善框架接口，让 MOD 开发者能以此为基础开发更多RPG玩法；
•        Hero角色对自己随身背包内物品的动态操作逻辑（也希望大家能有好的建议）；
•        信件任务系统；
•        与已有的丰富场景中游戏体验的mod联动，获得更好的游戏体验；
•        更多基于框架的扩展玩法。


五、安装方法
1. 将 ArtifactFrameworkEx 整个文件夹复制到游戏目录：Mount & Blade II Bannerlord\Modules\；
2. 启动游戏，在启动器 → 模组中勾选“Artifact Framework Extension”；
3. 开始游戏，进入库存界面即可游玩该mod。


六、运行依赖与兼容性

游戏版本：v1.4.x(推荐1.4.8，因为开发是在这个版本上，大版本内应该都是兼容的)，兼容战帆；
须四前置。
不兼容对物品栏页面改动过多的mod。


七、鸣谢

感谢《生动的世界Npc》mod作者【仿圣泪滴】提供的技术支持。

意见与反馈：
由于本mod还处于早期开发阶段，不可避免地会存在很多问题，需要大家们的反馈与意见，欢迎大家的积极反馈！
【腾讯文档】《器物框架扩展》反馈
https://docs.qq.com/sheet/DY0FwdUxGUkV2RFpn?tab=BB08J2

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