Please switch to BLSE if possible! Heavily extends the native launcher. Adds support for community used metadata that fixes sorting issues with mod load order! It will sort correctly Harmony, UIExtender, ButterLib and MCM. Also automatically unblocks .dll files if enabled.
Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou must get permission from me before you are allowed to modify my files to improve it
Conversion permissionYou are not allowed to convert this file to work on other games under any circumstances
Asset use permissionYou must get permission from me before you are allowed to use any of the assets in this file
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are not allowed to earn Donation Points for your mods if they use my assets
Author notes
This author has not provided any additional notes regarding file permissions
File credits
This author has not credited anyone else in this file
Donation Points system
This mod is opted-in to receive Donation Points
Changelogs
Version v1.22.0
Switched minimal supported version to v1.1.0
Version v1.21.3
Added Portugues (BR) translation
Version v1.21.2
Fixed another empty mods issue
Added Turkish translation
Version v1.21.1
Fixed launch
Version v1.21.0
Added support for displaying Chinese, Japanese and Korean logograms
Added Simplified Chinese translation
Version v1.20.3
Fixed launcher messages
Version v1.20.2
Fixed the Russian language issue?
Fixed an Options crash
Version v1.20.1
Unicode aware input
Version v1.20.0
Added localization support
Added Russian language
Version v1.19.5
Fixed crash with duplicate module ids and names
Version v1.19.4
Fixed a case when the module list could be empty
Version v1.19.3
When MO2 is used, module folders will be opened via explorer++
Version v1.19.2
Fixed Widget name conflict, fixes the bet issue
Version v1.19.1
Fixed Compact List visual issues
Version v1.19.0
Added import/export of saves load order
Saves tab improvements
Version v1.18.1
Fixed Options and Saves in v1.0.0 and v1.0.1
Version v1.18.0
Added Big Mode in options, will make the launcher bigger in height
Fixed Launcher Options saving
UI cleanup
Version v1.17.3
Added search in Mods and Saves
Version v1.17.2
Minor newline improvements in Hints
Version v1.17.1
Added directory buttons in Mods (opens mods folder) and Saves (opens folder with save file)
Version v1.17.0
Restored v1.12.x sorting algorithm, disable Beta Sorting in the Launcher Options for it to work
Added dialog that asks whether the load order should be imported if there's a version difference
Fixed TextBox crash and any other in-game crashes, cleanup was incorrect
Version v1.15.0
Added experimental options for Game and Engine, plus buttons to restore the originals
Added hints for launcher options
Added button to unblock all files immediately
Version v1.14.7
Fixed crash when module id was not present
Version v1.14.6
Added export of the Load Order to a Novus Preset
Version v1.14.5
Added 'BUTRLoader_lasterror.log' file that will contain the error when the launcher is crashing
Version v1.14.4
Added support for loading Novus Presets
Removed Enable Extended Mod Sorting option
Renamed to Import\Export of a Load Order
Version v1.14.3
Build fix
Version v1.14.2
Build fix
Version v1.14.1
.config file was not present in the output
Version v1.14.0
Added the ability to import load order from a save file
Should have fixed the load order sorting and persistence
Version v1.13.4
Added hints that will explain why the load order was reordered at launch
Added hints that will explain why a mod can't be reordered in an illegal position when dragging
Version v1.13.3
Fixed Import/Export
Version v1.13.2
Toggle all mods was not working correctly
Fixed sorting edgecases with non valid modules
Version v1.13.1
Selected modules were not properly sent to the game
Version v1.13.0
Rewrote the UI part, less code, more stability
Added cyclic dependencies detection
Version v1.12.2
Force sorting won't reset enabled/disabled mods, only re-sort them
Official mods are now on top when sorting
Version v1.12.1
Restored Compact Mode functionality
Moved the rider image
Added an option to hide the rider random image
Version v1.12.0
Digital Companion update
Removed legacy code from EA
Version v1.11.2
Fast fix of the update
Version v1.11.1
Stealth Game update fix. We hope the devs will announce further updates!
Version v1.11.0
Added warning when module is installed in /Modules and subscribed on Workshop at the same time
Version v1.10.4
Improved the obfuscation check
Version v1.10.3
Added detection of obfuscated mods
We will maintain BUTRLoader as long as it's possible. We do encourage to switch to BLSE!
Features BUTRLoader consists of two parts- BUTRLoader itself and LauncherEx.
BUTRLoader expands the game launch with the following features:
Interceptor - BUTRLoader checks if the is a class with a custom attribute named BUTRLoaderInterceptorAttribute. If it's found it checks if there are the following signatures:
void OnInitializeSubModulesPrefix() - will execute just before the game starts to initialize the SubModules. This gives us the ability to add SubModules declared in other programming languages like Python and Lua
void OnLoadSubModulesPostfix() - will execute just after all SubModules were initialized
LauncherEx is the UI module. It expands the native launcher with the following features:
Option Tab - provides Game and Engine options, plus the following Launcher options:
Extended Sorting - the launcher now respects the community metadata when sorting. Enabled by default.
Compact Module List - allows a more compact display of the Module List. Disabled by default.
Fix Common Issues - the launcher checks if 0Harmony.dll is present in the main /bin folder. If there is one, will prompt the user whether to delete it.
File Unblocking - the launcher will unblock the .dll's if they are locked itself. Enabled by default.
Beta Sorting - uses the new algoritm for sorting modules. Tries to respect existing load order when applying a new load order.
Big Mode - extends the height of the Native Launcher window.
Save Sub Tab - shows all available saves, some metadata, plus their load order. Allows to continue a specific save and to import/export a save's load order.
Scrollbar - the launcher before e1.7.2 didn't had a way to scroll without the mouse wheel. We added a scrollbar to fix this.
Enable/Disable All Mods Checkbox - added the ability to enable and disable all mods with one click.
Resort Modules Button - will forcefully reset the module list and force the raw loaded list to be sorted.
Expanded Dependencies Hint - added our community metadata to be displayed in the Hints added in e1.7.0.
Issue Hint System - the launcher displays an arrow that when expanded, will display why a mod can't be enabled. The issue can be a wrong dependency module version, binary incompatibility with the current game version
Binary Compatibility Check - the launcher will check whether the are ABI issues in the module with the current game version. ABI issues mean the module won't work in the game and will need a new updated version.
Import/Export Mod List - provides a way to export and import Mod Lists with the correct load order and module versions. If a module version is incorrect, with highlight that.
Supports Mod Organizer 2 - full support for MO2 with its virtual FS
Installation Download the file and extract it's contents into the game's root folder (e.g. C:\Program Files (x86)\Steam\steamapps\common\Mount & Blade II Bannerlord). Uninstallation Remove Bannerlord.BUTRLoader.dll, Bannerlord.BUTRLoader.pdb and TaleWorlds.MountAndBlade.Launcher.exe.config
Troubleshooting Unblocking DLL's You may need to right click on Bannerlord.BUTRLoader.dll file, click Properties, and click Unblock if you extracted the zip file with Windows Explorer or other programs that try to secure extracted files.
For Translators The translation files are hardcoded into BUTRLoader! We use Crowdin, so you can contribute there!
For Modders BUTRLoader adds support for a new tag DependedModuleMetadatas that allows you to better define your load order, see the example below <DependedModuleMetadatas> <!-- order: [ "LoadBeforeThis", "LoadAfterThis" ] --> <!-- optional: [ "true", "false" ] --> <!-- version: [ "e1.0.0.0", "e1.*", "e1.0.*", "e1.0.0.*" ] --> <!-- incompatible: [ "true", "false" ] -->