真实马鞍包

真·鞍囊 / Real Saddlebags

当前版本 / Current Version：v1.0.0

中文介绍

让马铠真正成为骑兵的弹药储备。

进入战斗时，Mod 会读取每名骑手自己的进场装备，自动选择最强的弹药与投掷武器，并将完整堆叠复制到马铠提供的虚拟储备格中。储备不会消耗背包物品，也不占用原版武器栏，内容在进场时固定。

骑乘时优先消耗马背储备，储备用尽后才会消耗骑手自身弹药。下马会暂停使用，重新骑回同一匹马后继续使用剩余储备。

主要功能

• 1～2 阶马铠提供 2 格，3～4 阶提供 3 格，5～6 阶提供 4 格
• 支持箭矢、弩矢、标枪、飞斧、飞刀及兼具近战/投掷用法的武器
• 按“投射伤害 → 物品阶级 → 堆叠数量”自动选择最强装备
• 同时携带弹药和投掷武器时，2 格分配为 1+1，3 格为 2+1，4 格为 2+2
• 只有一类合格物品时，全部格子都会复制该类型
• 物品和品质词条必须完全一致，不会把不同箭矢、弩矢或投掷武器互相转换

界面与外观

• 装备页面在马铠旁显示 2×2 只读预览，直接显示物品图标和数量
• 战斗 HUD 根据当前武器显示对应储备的“剩余量/初始量”
• 切换武器、下马、空手或使用近战武器时自动更新或隐藏
• 马背外观直接复用原版箭袋和投掷武器模型，不包含新模型或贴图
• 玩家、领主、同伴和其他英雄 NPC 显示马背挂件
• 普通士兵同样使用储备机制，但不生成额外模型，以降低大型战斗的性能消耗

储备规则

储备属于马，而不是骑手。更换骑手不会刷新内容；新骑手只有装备完全相同的物品与品质词条才能继续使用。坐骑死亡后，剩余储备也会丢失。

适用范围与存档

支持战役和沙盒中的真实 3D 地图战斗，不支持联机、自定义战斗、竞技场、锦标赛、教程、特殊脚本任务和自动结算。

全部储备与外观都是单场战斗内存数据，不向战役存档写入额外内容。安装或移除 Mod 不需要新建战役。

当前限制

• 特殊体型的坐骑或马铠可能出现轻微穿模
• 如果 Mod 物品没有可复用的 Holster 模型，机制仍会生效，但马背上可能没有对应外观

English Description

Turn horse harnesses into real ammunition reserves.

At battle entry, the mod reads each rider’s own equipment, selects their strongest ammunition and throwing weapon, and copies full stacks into virtual reserve slots provided by the horse harness. These reserves do not consume inventory items, occupy vanilla weapon slots, or refresh during battle.

While mounted, the horse reserve is consumed first. The rider’s personal ammunition is only used after the reserve is depleted. Dismounting pauses reserve use, while mounting the same horse resumes from its remaining amount.

Main Features

• Tier 1–2 harnesses provide 2 slots, Tier 3–4 provide 3, and Tier 5–6 provide 4
• Supports arrows, bolts, javelins, throwing axes, throwing knives, and mixed melee/throwing weapons
• Automatically selects the strongest item by projectile damage, item tier, then stack size
• With both categories equipped: 2 slots use a 1+1 split, 3 slots use 2+1, and 4 slots use 2+2
• If only one category is available, every slot copies that category
• Items and modifiers must match exactly; different ammunition or quality modifiers are never converted

Interface and Visuals

• A read-only 2×2 preview beside the horse harness displays item icons and copied amounts
• The battle HUD shows “remaining/initial” for the reserve matching the active weapon
• The HUD updates or hides when switching weapons, dismounting, becoming unarmed, or using melee
• Mounted attachments reuse vanilla quiver and throwing-weapon holster meshes
• Player, lord, companion, and other hero horses display the additional models
• Regular troops still use the full reserve mechanic but do not generate extra models, reducing performance cost in large battles

Reserve Ownership

The reserve belongs to the horse, not the rider. Changing riders does not refresh it, and a new rider can only use reserves matching the exact item and modifier. If the horse dies, its remaining reserve is lost.

Scope and Save Safety

Works in real 3D Campaign and Sandbox map battles. Multiplayer, Custom Battle, arenas, tournaments, tutorials, scripted missions, and auto-resolve are not supported.

All reserves and visuals exist only in battle memory. The mod does not write additional gameplay data into campaign saves, so installing or removing it does not require a new campaign.

Current Limitations

• Unusually shaped horses or harnesses may show minor clipping
• A modded item without a reusable holster mesh will still work mechanically, but may have no mounted visual