DUEL RENOWN - v1.3.0


Adds extra renown and a rare item drop on winning bandit boss duels during hideout missions.
This version introduces fully configurable options via ModLib. ModLib is now a requirement in order to use Duel Renown.


:: REQUIREMENTS
[ModLib version]
ModLib

[XML version]
None


:: INSTALLATION
***Don't forget to backup your itemlist.txt and renownconfig.xml files somewhere if you have changed them and are updating to a newer version of the mod or it may be overwritten.***
Simply extract the .zip file to your M&B Modules directory like any other mod. This is typically located at (...\Steam\steamapps\common\Mount & Blade II Bannerlord\Modules). Once the folder is there, go into DuelRenown -> bin -> Win64_Shipping_Client, and check both the Harmony and DuelRenown .dlls to make sure they are unblocked (see the internet for further instructions on unblocking .dlls for M&B). If you are using the ModLib version, make sure you also have ModLib installed and up to date. Run your preferred M&B launcher (either vanilla or mod version) and make sure that ModLib is listed *above* DuelRenown in the list, and that both are checked/activated.


:: CONFIG OPTIONS
[ModLib version]
Options are accessed via the game's main menu under "Mod Options". You should see Duel Renown listed with any other configurable mods you have installed. There are two main functionalities to this mod, adding additional renown, and adding additional loot item(s). Either may be enabled or disabled independently with the main checkboxes, Extra loot drop and Renown increase. See config details below.

[XML version]
Configuration file is located at "...\DuelRenown\ModuleData\Loadables\renownconfig.xml". The config file offers the same settings and functionality as the ModLib version. See details below.


[Extra loot drop options]

-Bonus loot items --> How many extra items you will get in addition to whatever loot you would have gotten by default.
-Dynamic Max Value (DMV) --> If this is enabled, the mod will calculate a value cap to use with the defined loot pool in order to balance the value of item drops. It uses the number of enemy troops in the hideout to increase the possible value of the drops.
***All values associated with DMV are item *base* values, which are 2-3x higher than what the item will show once it is in your inventory (depending on how high your trade skill is).***
DMV uses the following settings.
-DMV: Min troop cutoff --> Use this to set a lower limit for the calculation. Any hideout with this number or less enemies will simply use the set Base Value Cap.
-DMV: Base Value Cap --> This is where the lowest value cap starts. If you set it to 11000 for a hideout with no enemies (weirdly that can actually happen) to boost the cap, any extra loot drops you recieve will be worth at or below 11000 base value (which would be around 4-6k in your inventory).
-DMV: Value Cap Modifier --> This is how much the cap will increase from base for each enemy in the hideout. In the scenario above, if you have this set to 3000, then a hideout with 5 enemies would have an effective base value cap for loot of 26000 (= 11000 + (3000 * 5 enemies)). In other words, the extra loot drops will be worth at or below 26000 (which would be around 9-13k in your inventory).

>>>Example 1:
You have 2 Bonus loot items set. DMV is checked, with a min troop cutoff of 3, Base Value Cap of 15000, and a Value Cap Modifier of 6000. You do a hideout with 10 enemies and beat the boss in a duel. There are 7 enemies beyond the min troop cutoff which means your effective value cap will be 57000 (= 15000 + (6000 * 7 enemies)). Your two additional items will each be worth at or below 57000 base value (which would be between 19-28k in your inventory).

>>>Example 2:
You have 1 Bonus loot item set. DMV is unchecked. You will receive one additional loot item with no restrictions on its possible value. It could be anything from the mod's loot table, ~10k to ~70k (or from 3-5k to 25-35k in inventory).


[Renown increase options]

-Base increase --> This is a flat amount that will be applied.
-Dynamic increase --> Multiplier using the number of enemies to determine renown boost. Will be added to any Base increase you have specified.
(Keep in mind that the notification which pops up in game will round this number to the nearest integer, but the math behind the scenes will use the decimal places appropriately.)

>>>Example 1:
You have a Base increase of 2 set, and a Dynamic increase of 0.5 set. You complete a hideout with 10 enemies. You will receive 7 renown (2 + (10 * 0.5)).

>>>Example 2:
You have a Base increase of 0 set, and a Dynamic increase of 1 set. You complete a hideout with 12 enemies. You will receive 12 renown (0 + (12 * 1)).

>>>Example 3:
You have a Base increase of 5 set, and a Dynamic increase of 0 set. You complete a hideout with 30 enemies. You will receive 5 renown (5 + (30 * 0)).

:: CUSTOM ITEM LIST
You can customize which items you'd like to have as possible drops simply by editing the mod's itemlist.txt file. From your Modules folder navigate to ...\DuelRenown\ModuleData\Loadables\itemlist.txt. The file is simply a list of item IDs that you may add to or modify to your liking. In order to find item IDs for items in the game, from the Modules folder open the ..\SandBoxCore\ModuleData\spitems.xml file. You can do a quick text search for the common name of whatever item you would like to add (ex: searching "hickory crossbow" will find the name="{=CPI0wkaZ}Hickory Crossbow" field), then simply copy the id field (ex: id="crossbow_d") and paste it into the itemlist.txt file as a new line. If you have invalid item id's in the file, the mod will simply skip over them. If you don't have any item id's matching whatever criteria you have defined in the settings (e.g. nothing cheap enough to fall under the value cap), the mod will inform you that no additional treasure was discovered.

:: KNOWN ISSUES
This mod is aimed at compatibility with the current non-beta branch of the game. There may well be crashes when using any beta branches.