In versions 1.1.10 and later, when launching the game and entering the grand map, you may experience brief lagging lasting from a few seconds to about ten seconds. This is considered normal. Please be patient and wait a few seconds to ten seconds, and the lag will resolve itself automatically.

Armory System

• Soldiers no longer magically receive new equipment upon leveling up.
• Parties now have dynamic armory. Equipment from defeated non-hero enemy units is added to this armory.
• Each soldier's equipment is no longer fixed; instead, they select the most suitable gear from the army's armory when entering the battlefield, and return it to the armory upon leaving the battlefield or falling in battle.
• Newly recruited soldiers contribute their initial gear to the armory.
• The armory can be accessed and managed from the town menus.
  

Equipment Distribution Logic

• Before battle, the armory evaluates each soldier's equipment slots. It then equips them with the highest quality weapon available that matches their original equipment from the vanilla game.
• Weapon matching and distribution occur in four distinct rounds:
  
  • 1st Round: Requires an exact match in weapon type and function. For example, a one-handed sword only for slashing can only be matched with another one-handed sword of the same type. A one-handed sword that can both stab and slash, or a one-handed sword that is slash-only but can also be wielded with two hands, does not qualify for a match. In this round, when allocating polearms to cavalry, only lances specifically for mounted combat are considered, and infantry will not be assigned such lances.
  • 2nd Round: Subtype matching. For instance, a weapon that can be used as a one-handed polearm can be matched with another that functions as a one-handed polearm, even if the latter can also be used as a two-handed polearm, or if one is for slashing and the other for stabbing. Throwing weapons and melee weapons are not regarded as the same category.
  • 3rd Round: Broad type matching (e.g., both are “one-handed weapons”). For example, a one-handed sword can be matched with a one-handed axe. In this round, when allocating polearms to cavalry, only lances specifically for mounted combat are considered, and infantry will not be assigned such lances.
  • 4th Round: Broad type matching (e.g., both are “one-handed weapons”).
  • Each round only fills slots left empty from the previous round.
    
• Soldiers without weapons are allocated a random melee weapon.
• Higher-tier soldiers are prioritized.
• Surplus arrows, shields, throwing weapons, and two-handed/polearms are allocated based on existing equipment.
• Mounted units, including archers, won't receive weapons unsuitable for use on horseback.
  

Functionality for AI Parties

• AI parties led by heroes will have access to an armory mechanism.
• Upon creation, AI parties receive original equipment consistent with the soldiers in their party, similar to when the player recruits new troops.
• AI parties can loot enemy armories through battle.
• Daily, AI parties receive random equipment, as detailed below:
  
  • They obtain equipment that their soldiers would normally have in the vanilla game, with the quantity depending on the total number of troops in the party.
  • They randomly receive equipment matching their clan's culture. The quantity is influenced by the clan tier, which also serves as the upper limit for the level of equipment received.
  • Equipment is received based on their fiefs, with each town, castle, or village providing one piece of equipment daily, aligned with the culture of the settlement. The tier of equipment provided is capped by the settlement's prosperity level.
    

Additional Mechanics

• Consumable weapons (arrows, bolts, throwing weapons) are only recoverable if not completely used up.
• Cavalry upgrades do not require horses.
• Soldiers are limited to using weapons within their skill level.
• Broken shields and used ammunition are not collected.
• Armor receiving fatal or critical hits may not be salvageable.
• After defeating an enemy army with an armory, the standard loot system is replaced with the remaining contents of the enemy's armory.
• Upon the initial launch of this mod, a blacklist.json file will be generated in the mod folder. You can edit the item blacklist within this file. When editing, you can use either regular expressions or exact matching to filter items, based on their stringId and localized name. Items that meet these matching criteria will not appear randomly in the game or be lootable.
  

Compatibility and Requirements

• Should be compatible with mods not introducing new equipment types.
  
  • Tested and confirmed compatibility with RBM, OSA, DRM, and BannerKings.
    
• Note that there may be bugs related to equipment crafting.
• Recommended to use the BLSE launcher for optimal performance.
• Requires Harmony, UIExtenderEx, ButterLib and MCM.
  

FAQ

Q: Why is my army naked?

A: If you load a save that wasn't previously using this mod, your armory will be empty. You need to manually purchase weapons and put them in the armory for your soldiers. Ensure your soldiers have enough equipment; otherwise, they will appear naked or unarmed.

Q: My equipment is missing!

A: Armor that protects a fatally or critically hit area can be damaged when soldiers are killed or knocked out. If multiple armors protect the same area, one is randomly chosen to be damaged based on their protection value.
Used arrows, bolts, throwing weapons, and damaged shields are also not recoverable.
If you use mods that cause weapons to drop (like RBM) or other mods leading to soldiers discarding their weapons, dropped weapons won't be collected unless picked up again by soldiers.
When equipment is assigned from or returned to the armory, its modifier (prefix) is removed. Consequently, your equipment with prefixes may no longer exist as distinct items after a battle; instead, they merge with the unmodified versions of that same equipment.
Additionally, two known bugs can lead to equipment loss:
first, allowing cavalry to participate in hideout battles may result in the loss of their mounts and horse harnesses, so avoid using cavalry in hideout battles;
second, soldiers carrying banners may lose weapons replaced by banners.
If your case doesn't fit any of these scenarios, please let me know.

Q: I've encountered a bug!

A: Head to the bug report section here. When reporting, please follow these guidelines:

• Description of the Bug: Briefly describe the issue you're experiencing.
• Context and Conditions: Explain where and under what conditions the bug occurs. Include information on the bug's frequency (always, often, sometimes, or rarely).
• Expected vs. Actual Behavior: Describe what you expected to happen and how it differed from what actually occurred.
• Crash Reports: If the bug results in a crash, please attach the complete crash report.
• Steps to Reproduce: If the bug can be reliably reproduced, enable 'Debug Mode' in the mod's settings menu before the bug occurs. After the bug happens, send me the log.txt file located in Mount & Blade II Bannerlord\Modules\Bannerlord.DynamicTroop\bin\Win64_Shipping_Client.
• Other Mods: List any other mods you are using, as this can help identify potential conflicts.
  

Credits

• Russian localization: UmarKot
• German localization: pandory
  

Links

• Steam Workshop
• GitHub Repository
• Discord
• 骑砍中文站
• QQ Group: 698615206