Game Studio / Mod Guides / Characters
WPS Companion Progression
Replaces the player clan's tier-based companion cap with a smooth limit that rises by one companion every five player levels.
Player guide
Install, configure, and troubleshoot WPS Companion Progression.
Use the sections below for setup, requirements, settings, compatibility, removal, and troubleshooting.
Overview
WPS Companion Progression replaces Bannerlord's clan-tier companion cap with a smooth, level-based limit for the player clan.
Instead of receiving companion slots only at clan-tier milestones, the player gains one additional slot every five character levels.
AI clan companion limits are not changed. The current Nexus release is version 1.0.1 and is marked Warsails compatible.
Formula
Companion limit = 1 + (Player Level / 5), using integer division.
Levels below the next five-level threshold discard the remainder. For example, levels 10 through 14 all produce a limit of 3.
The formula continues beyond level 45; it is not capped at 10 companions.
Companion Limit Progression
| Player Level | Companion Limit |
|---|---|
| 1-4 | 1 |
| 5-9 | 2 |
| 10-14 | 3 |
| 15-19 | 4 |
| 20-24 | 5 |
| 25-29 | 6 |
| 30-34 | 7 |
| 35-39 | 8 |
| 40-44 | 9 |
| 45+ | 10+ |
Features
- Level-based companion cap for the player clan.
- One additional companion slot for every five player levels.
- AI clan limits remain unchanged.
- Designed for singleplayer campaigns and mid-campaign installation.
- Uses a focused Harmony patch and has no configuration screen.
Requirements
- Mount & Blade II: Bannerlord v1.3.0 or higher, as listed in the published requirements.
- The release package lists Lib.Harmony as included.
- Native, SandBoxCore, and Sandbox must be enabled.
- Singleplayer only.
Installation
- Download the current WPS Companion Progression file from Nexus Mods.
- Extract the WPS_CompanionLimit folder into Mount & Blade II Bannerlord\Modules\.
- Open the Bannerlord launcher and enable [WPS] Companion Limit in the Singleplayer Mods list.
- Place the module after Native, SandBoxCore, and Sandbox in the load order.
- Start a new campaign or load an existing save.
Load Order
- Native
- SandBoxCore
- Sandbox
- StoryMode, when used
- [WPS] Companion Limit
- Do not enable Companions No Limits or another companion-cap replacement at the same time.
Compatibility
- Compatible with mods that leave the player-clan companion-limit calculation available for this patch.
- May conflict with other mods that replace or override companion-limit calculations.
- Do not combine it with WPS Companions No Limits. Choose the level-based progression model or the fixed 2,500 limit, not both.
- The current Nexus release is marked compatible with the Warsails branch. Check the Nexus Files and Posts tabs for release-specific updates before changing game versions.
Save and Removal
The published release is designed to be added mid-campaign.
Before removal, make a backup save and reduce the active companion roster if it exceeds the limit that another mod or the base game will provide.
Disable [WPS] Companion Limit in the launcher and optionally delete WPS_CompanionLimit from the Modules directory.
After removal, the companion cap returns to the next active companion-limit calculation. Existing recruited heroes are not documented as being automatically dismissed.
Troubleshooting
If the displayed limit does not match the table, verify the player's current character level and apply integer division: only complete five-level blocks add a slot.
Confirm [WPS] Companion Limit is enabled after Native, SandBoxCore, and Sandbox.
Disable Companions No Limits and any other companion-cap mod while testing; two cap replacements can overwrite one another.
Confirm the extracted archive contains one WPS_CompanionLimit module folder directly under the Bannerlord Modules directory.
When reporting a reproducible issue on Nexus Mods, include the Bannerlord version, player level, displayed and expected limits, module version, Warsails state, and complete load order.
Credits
- Created and published by Wasted Potential Studios.
- Uses Harmony for the companion-limit patch.
- Thanks to TaleWorlds and the Bannerlord modding community.
Request support or a new idea
Having trouble with this release? Visit its Nexus page for downloads, bug reports, and player discussions. Have an idea for a new mod, feature, port, or compatibility update? Send WPS a gamer request.