Skip to content

About

Mount & Blade II: Bannerlord mod. AI lords grow their skills, buy their own gear and rob their prisoners.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

399 Commits

Folders and files

Repository files navigation

Heroes Evolve

A Mount & Blade II: Bannerlord mod. In vanilla, AI lords keep the equipment they were made with until they die. Here they develop: they grow by their age and talent, buy their own gear in town markets, and take it off each other after a battle.

Overview

What it does

System In one line
Starting kit Lords who come of age with nothing — a known TaleWorlds bug — get a plain kit matched to culture, role and age.
Their own way Now and then a lord comes of age armed for what he is good at, within what his culture's troops actually field.
Skills grow Three hidden talents — combat, management, seafaring — decide how fast each hero learns and where they stop. The game's own growth can be chosen instead.
Shopping Lords buy better versions of what they already carry, with their clan's money, capped by their skills.
Caravans A caravan master arms himself from a commission you set.
Robbery Captors may strip their prisoners, on a roll weighted by character. A robbed man comes back in basic gear of the same kinds he carried, and his clan swears vengeance: it strips the robber's people in return when it captures one.

Skill growth is a choice in the options. Heroes Evolve's, the default, turns off the daily experience Bannerlord v1.5.7 added; the game's own leaves it running and the mod's off. The two cannot run together: the game's would undo the age curve within a decade.

The full description, with every figure, is in docs/store-description.bbcode. The diagrams are in docs/gallery.

Install

Subscribe on the Steam Workshop, or copy the HeroesEvolve folder from a release into Mount & Blade II Bannerlord/Modules/ and tick it in the launcher. Load order sorts itself: the module declares what it depends on.

Build from source

You need:

  • Windows and PowerShell 7
  • Visual Studio 2022 Build Tools, for its Roslyn csc.exe, and .NET Framework 4
  • Bannerlord v1.5.7 installed. The build references the game's own assemblies, which are not part of this repository.

Two paths can be overridden with environment variables:

Variable Default
BANNERLORD_PATH D:\SteamLibrary\steamapps\common\Mount & Blade II Bannerlord
CSC_PATH C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\Roslyn\csc.exe
pwsh build/build-tests.ps1    # the pure-rule tests; the game need not be installed
pwsh build/build-mod.ps1      # compiles and deploys into the game's Modules folder
pwsh build/verify-api.ps1     # checks that every game member the DLL uses exists in the installed game
pwsh build/pack-release.ps1   # builds a release zip in .tmp/

Layout:

  • src/Core — the rules, free of TaleWorlds types, and covered by tests/
  • src/Game — everything that touches the game
  • ModuleData/Languages — translations: German, French, Russian, Spanish, Turkish, Chinese (Simplified and Traditional)

Console commands

The developer console only opens with cheat_mode = 1 in engine_config.txt.

Command What it does
hev.census Writes a survey of every lord in the campaign to the log
hev.dry_run <hero> Shows what the mod would do for a hero, without changing anything
hev.market <hero> Shows what a hero would buy in the town you are in
hev.feud [hero] Shows how likely a lord is to strip you, what is sworn between your houses and what stripping him would cost; the census lines for every house with no name given
hev.test_repair <hero> Reproduces the come-of-age bug on a hero, then repairs it
hev.test_robbery [hero] Robs a hero, or one lord of every culture with no name given
hev.test_oath <hero> Puts a lord on record as having stripped you, so that your clan is owed
hev.test_plan Prints the console lines that stage the robbery tests, with names from the campaign you have loaded
hev.test_release Shows the notice a freed player gets
hev.api_probe Listens to the events below the way another mod would and logs every one; run again to stop

The test_ commands change the campaign. Use a throwaway save.

The log is at %LOCALAPPDATA%\Mount and Blade II Bannerlord\logs\hev.log.

Events for other mods

Heroes Evolve saves nothing, so what it does leaves no record a mod could read afterwards. It raises public events instead, from HeroesEvolve.Api.HeroesEvolveEvents:

Event When Argument
HeroRobbed A prisoner was stripped: by a lord, a band, the player in conversation, or of the player HeroRobbedArgs: Robber (null for bandits), RobberParty, RobberPartyName, RobberClan, Victim, Motive ("character", "justice", "vengeance", "bandits"), Pieces (each with Item, ItemId, Slot, Value), TotalValue, NearestSettlement, CollectedOath, SworeOath
OathSworn A robbed man swore vengeance on his robber; during that robbery, before its HeroRobbed OathSwornArgs: Swearer, Against
OathCollected A house collected an oath by stripping someone of the house it was sworn against; before that robbery's HeroRobbed OathCollectedArgs: Swearer, Against, Collector, Payer
StolenPieceWorn A lord put on a piece he had just taken off a prisoner; after that robbery's HeroRobbed StolenPieceWornArgs: Wearer, Item, Slot, PreviousOwner
GearBought A hero bought battle gear in a town (lords, companions, caravan masters; frequent) GearBoughtArgs: Buyer, Item, Slot, Replaced, Price, Town, Tier, ReplacedTier (1 to 6, 0 for none)

What you can rely on:

  • Names never change. New data arrives as new properties, and ApiVersion (an int constant, now 1) goes up when anything is added.
  • Every event is raised once what it reports is complete, synchronously, so CampaignTime.Now is when it happened.
  • Each subscriber is called on its own. One that throws costs only its own notice; the failure is written to hev.log.
  • The player is treated like anybody else.

You do not need to reference this mod. Subscribe by reflection with a method that takes object, and read the properties by name:

Type events = Type.GetType("HeroesEvolve.Api.HeroesEvolveEvents, HeroesEvolve");
if (events != null)
{
    EventInfo robbed = events.GetEvent("HeroRobbed");
    MethodInfo handler = typeof(MyBridge).GetMethod("OnHeroRobbed");   // public static void OnHeroRobbed(object e)
    robbed.AddEventHandler(null, Delegate.CreateDelegate(robbed.EventHandlerType, handler));
}

hev.api_probe subscribes exactly this way and logs what each event carries.

License

MIT — see LICENSE.

About

Mount & Blade II: Bannerlord mod. AI lords grow their skills, buy their own gear and rob their prisoners.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages