About this mod
An underlying logic mod that rewrites the game's character development model,support 1.2.12
- Permissions and credits
- Donations
Author: Hahun
Supported Game Version: 1.2.12
---
Description
This mod overhauls the character progression system in Mount & Blade II: Bannerlord, allowing for virtually limitless growth. It utilizes a long integer (64-bit) for character experience to bypass vanilla limitations while maintaining stability.
In v2.3.2, the mod has been streamlined to rely entirely on the long experience system (TotalXpLong), completely removing the previous "Parallel Growth Mode". The experience synchronization mechanism has been optimized to improve the accuracy of the native UI display at lower experience values.
Configure levels, skills, attributes, and focus points via a simple text file. The mod now attempts to synchronize the long experience value to the native integer experience variable when it hasn't exceeded the integer limit (about 2.1 billion), helping the game's UI display experience bars and values more accurately at lower experience levels.
---
Key Features (v2.3.2)
- Enhanced Long Experience System:
• Based on 64-bit long integers, breaking the vanilla 2.1 billion XP cap for potentially thousands or even tens of thousands of levels.
• Optimized experience synchronization for better UI display at lower experience values.
• All level check logic (CheckLevelPatched) is now fully based on long experience and long experience requirements.
- Customizable Level Cap: Set your desired maximum character level via config.txt.
- Enhanced Skill System:
• Configure the skill proficiency cap (MaxSkillLevel).
• Uses an O(L^2) XP formula for skills, tunable via SkillXpGrowthFactor to better support high skill levels.
- Customizable Attributes & Focus: Define max attributes (MaxAttribute), attribute gain rate (LevelsPerAttributePoint), max focus per skill (MaxFocusPerSkill), and focus points per level (FocusPointsPerLevel).
- Powerful Alt+M Menu: Press Alt+M on the campaign map to access:
• Reflection Max: Silently sets the target hero's level, attributes, focus, and skills to configured maximums.
• View Details: Displays a detailed status report for the target hero, including true XP, level, unspent points, attributes, and skills. Supports pagination for easy skill browsing.
• Set Level: Sets a hero's level by simulating natural progression, letting the game handle attribute and focus point allocation.
• Force Sync (Int -> Long): Directly writes the integer experience values of all characters to their long experience values. Useful for first-time use with existing saves. Will overwrite current Long experience!
• Proportional Sync (Int -> Long): Sets long experience values for all characters based on their relative progress in the vanilla integer experience system (relative to int.MaxValue). Useful after changing configuration or for smoothly transitioning old saves.
- Standalone Configuration: All settings are managed through config.txt in the mod folder - no external dependency like MCM.
- Custom Save System: Includes a dedicated system to correctly save and load your long XP values.
---
IMPORTANT INSTALLATION NOTES:
• For Existing Saves: The mod works perfectly with existing saves!
• For New Games:
- Recommended method: Start a new game WITHOUT the mod checked, then save, exit, enable the mod, and continue.
- Reason: Directly starting a new game with the mod enabled will cause all NPCs to have 0 attributes.
- Note: If you don't mind NPCs starting with 0 attributes or actually want this for balance purposes, you can enable the mod when starting a new game.
ABOUT UI EXPERIENCE IN v2.3.2:
- When a character's TotalXpLong has not exceeded int.MaxValue (about 2.1 billion), the native UI (such as the experience bar and values in the character screen) can typically display character experience and level accurately, as the mod tries to synchronize the native int experience value.
- Only when a character's TotalXpLong exceeds int.MaxValue will the native UI display inaccurately (such as a full experience bar or negative numbers) due to integer overflow.
- At any time, you can use the "View Details" function in the Alt+M menu to view precise information calculated from long experience (including level, experience, upgrade progress, etc.).
---
What's New in v2.3.2
1. Removed Parallel Growth Mode:
- Completely removed the legacy parallel growth mechanism
- All core logic now fully relies on long experience (TotalXpLong)
- Simplified and more robust experience handling
2. Optimized Experience Synchronization:
- Adjusted the GainRawXp logic to sync native int experience when long experience hasn't exceeded the int limit
- Improved accuracy of native UI display at lower experience values
- Enhanced experience synchronization between different heroes
3. Strengthened Long XP Core:
- CheckLevel logic (CheckLevelPatched) fully based on long experience and requirements
- Robust handling of long experience calculations and level checks
4. Updated Alt+M Functions:
- Confirmed menu options match current features (Max Level, View Details, Level Adjustment, Force Sync, Proportional Sync)
- Improved detailed view with pagination for easier browsing
5. Code Cleanup and Robustness:
- Removed code related to parallel mode
- Enhanced logic robustness (e.g., negative experience handling)
- Improved error handling and data consistency checks
---
Game Experience Changes
• Continuous Growth: Characters continue to grow stronger in the late game, keeping long-term gameplay interesting.
• Battlefield Legends: Develop truly powerful heroes, experience the thrill of turning the tide of battle single-handedly.
• Ultimate Specialization: Invest resources in your favorite skill paths, reaching unprecedented heights.
• Team Enhancement: Family members and companions also benefit from the enhanced growth system.
• Enhanced Challenge: Enemies (lords/NPC heroes) follow the same growth rules, scaling with you to maintain challenge.
---
Deep Customization - config.txt Guide
After first loading the mod, a config.txt file will be automatically generated in Modules\CustomCharacterDevelopmentModel. Open it with a text editor to modify these parameters:
Basic Configuration Parameters:
• MaxLevel: Maximum character level
• MaxSkillLevel: Skill proficiency cap - Actual limit depends on experience gain rate
• SkillXpGrowthFactor: Controls skill XP growth speed, higher values = faster leveling
• MaxFocusPerSkill: Maximum focus points per skill
• FocusPointsPerLevel: Focus points gained per level
• MaxAttribute: Maximum attribute points
• LevelsPerAttributePoint: Levels required to gain 1 attribute point
• AttributePointsAtStart: Initial attribute points for character creation
• FocusPointsAtStart: Initial focus points for character creation
• InquiryExtraHeightPadding: Vertical padding for Alt+M dialog
• InquiryExtraWidthPadding: Horizontal padding for Alt+M dialog
Note: You MUST RESTART THE GAME after editing config.txt for changes to take full effect!
---
About UI Display in v2.3.2:
• When TotalXpLong < int.MaxValue: Native UI displays experience accurately
• When TotalXpLong > int.MaxValue: Native UI may show full bar or incorrect values
• Alt+M "View Details": Always shows accurate information based on long experience
---
Installation
1. Install Harmony first!
2. Download the mod archive.
3. Extract the CustomCharacterDevelopmentModel folder into your Mount & Blade II Bannerlord Modules directory.
4. Launch the game launcher.
5. In the "Mods" tab, check "Custom Character Development Model".
6. Ensure proper load order: MUST load AFTER Harmony, preferably after official modules.
7. Click "Play" to begin your unlimited growth journey!
8. IMPORTANT! For new games, see the "Important Installation Notes" section above!
---
Usage Tips
• Alt+M Menu: Ensure the game window is active. Press Alt+M to open the function selection box, then select a function and enter the hero name when prompted (leave blank for player). ALWAYS save manually before using max operations!
• Experience Synchronization: The mod attempts to keep native UI accurate until long experience exceeds int.MaxValue.
• Interface Improvements: The Alt+M detailed interface provides visual elements and precise experience display.
---
Compatibility (v2.3.2)
• Game Version: Developed and tested for v1.2.12.
• Mod Conflicts:
• WILL conflict with other mods that modify the CharacterDevelopmentModel.
• WILL conflict with mods that rely on directly accessing or modifying HeroDeveloper._totalXp field.
• WILL conflict with mods that intercept GetXpRequiredForLevel/TotalXpRequiredForLevel methods.
• Should be compatible with most mods that don't touch the core character XP/leveling system.
• Save Compatibility & Uninstall Risk:
• You can install this mod on existing saves.
• STRONG WARNING: Do not uninstall this mod while using a save that has been played with it! Uninstalling will cause experience data loss, character level regression, or possible save corruption!
---
FAQ (v2.3.2)
Q: How has the experience system changed in v2.3.2?
A: The mod now fully relies on the long experience system (TotalXpLong) and has removed the parallel growth mode. It attempts to synchronize the long experience to the native integer experience when possible for better UI display.
Q: Why does my XP bar start showing fixed values after a certain point?
A: This happens when your long experience exceeds int.MaxValue (about 2.1 billion). At that point, the native UI can't accurately display your experience due to integer overflow.
Q: When creating a new save, why do all NPCs have 0 attributes? Is this a bug?
A: This is due to a patch timing issue that interrupts vanilla NPC initialization. To avoid this, create a new save without the mod enabled, then enable it after saving once.
Q: How high can skills go? Why can't I reach the high MaxSkillLevel I set?
A: You can set very high limits through MaxSkillLevel, but how high you can actually go depends on SkillXpGrowthFactor and in-game skill XP gain efficiency. With the default factor (25), the theoretical maximum effective level is around 9268; beyond that, required XP will overflow the int limit.
Q: How do I quickly max out my character?
A: Press Alt+M in-game, select "Reflection Max", and follow the prompts. Remember to save first!
Q: Does this make the game too easy?
A: Your character becomes stronger than vanilla, but enemies also grow stronger. If it feels too easy, you can lower parameters in config.txt.
---
Planned Updates
• Introduce individual skill proficiency or focus limits configuration
• Add more attribute categories and development options for high levels
• Completely overhaul the vanilla skill tree to accommodate unlimited growth
• When creating new games, add option to choose whether NPCs start with 0 attributes
---
Support the Author
If you enjoy this mod and would like to support my development work, you can sponsor me through Afdian:
https://afdian.com/a/020912q
https://paypal.me/chy2025?country.x=C2&locale.x=en_US
Your support is greatly appreciated and motivates me to continue updating and improving the mod!
---
Support & Feedback
Please share suggestions or report bugs on Nexus Mods Posts tab.
---
Forge your ultimate legend in Calradia!