Skip to content

SolWayward/Bannerlord.GameMaster

Repository files navigation

Bannerlord.GameMaster (BLGM)

BLGM provides the ability to create and manage kingdoms, heroes, wanderers, clans, and tools to control, upgrade, and change ownership of settlements. Easily add members to your clan, or clans to your kingdom and way more. A powerful query system is also included, allowing you to easily add items, modifiers, and troops as well. Edit any hero's appearance, modify any clan's banner, or change any kingdom's colors.

User Command Documentation
Documentation for players using BLGM to enhance their gameplay

Developer API Reference
API Reference for mod developers using BLGM as a framework or helper for developing mods


Latest Update v1.3.14.8

Updated BLGM for Commander initial release

Fixed error when generating clans

Added trait randomization to new heroes
Added relation randomization to new clans and kingdoms

Previous Updates:
Added command gm.hero.edit_party
Added command gm.hero.start_conversation
   
Added optional age and level args to hero creation commands

Added new commands:
   gm.hero.marry
   gm.hero.divorce
   gm.hero.impregnate
   gm.kingdom.rename
Added all 229 possible colors the custom banner editor

Added commands 
   gm.clan.edit.banner
   gm.hero.edit_apperance
   m.hero.open_inventory
Improved settlement renaming to immediately update name on map

Overview

BLGM extends Bannerlord's console with powerful commands for managing heroes, clans, kingdoms, items, and game state. This mod is useful for taking control of your game, testing things out, fixing saves, or whatever other reason you may need to take control of your game. Add family members or companions to your clan, add clans to your kingdom, edit the appearance of your wife, modify the banner of a clan in your kingdom, change Vlandia's kingdom colors from red to white, create clan parties exceeding your party limit, quickly add troops or items, instantly upgrade all buildings in a settlement or raise the settlement's prosperity, change the culture of a settlement, hero, clan, or even kingdom, rename a settlement or even take ownership of a settlement, and much more. The user command documentation wiki lists and explains every command and their usage.


Key Features

  • Create new NPC Kingdoms, Clans, Heroes
  • Create new Heroes for your clan or add existing heroes to your clan
  • Create new Clans for your kingdom or add existing clans to your kingdom
  • Edit any Clan banner or change any kingdom's colors
  • Modify the appearance of any hero with the visual hero editor
  • Change the culture of any settlement, kingdom, clan, or hero
  • Upgrade settlement buildings, or modify any values such as prosperity, loyalty and more
  • Rename settlements or change ownership of any settlement
  • Save and load equipment sets to easily equip different heroes
  • Add items or item modifiers to heroes
  • Add troops or heroes to any party
  • Upgrade troops in parties
  • Specify objects by names, partial names, or stringIds
  • Look up objects with powerful query commands
  • "player" is always short for player hero/clan/kingdom
  • And much, much more

Quick Start

BLGM is easy to use.

To open the console, press **Alt + ~** (Alt + tilde)

Typing gm. into the console will show every command category. Typing gm.hero will show all hero commands. Commands are as easy as gm.hero.generate_lords 10

Optional arguments can be used with commands as well such as gm.hero.generate_lords 10 culture:vlandia gender:female clan:player

Typing any command without any args will show help for the command with info on how to use the command, required/optional arguments, and examples. Alternatively, you can use the BLGM Command Documentation to view detailed info about all commands.

Arguments can either be specified using positional arguments or named arguments. Any argument with spaces such as names must use single quotes: 'Arg with Spaces'

Command Structure

gm.<category>.<command> [parameters]

Example Commands

gm.hero.create_hero Maximus
gm.hero.edit_appearance derthert
gm.clan.edit_banner 'dey meroc'
gm.clan.generate_clans 5
gm.kingdom.create_kingdom Poros
gm.kingdom.generate_kingdoms 5
gm.troops.upgrade_troops player
gm.item.add imperial_sword 5 player
gm.item.save_equipment_both player my_loadout
gm.settlement.set_culture 'Ocs Hall' sturgia
gm.settlement.rename Galend 'Kings Landing'
gm.settlement.upgrade_buildings Charas 3
gm.settlement.set_owner Sargot player
gm.query.hero empire lord female
gm.query.item sword tier5 sort:value:desc
gm.item.add Justicier count:1 player
gm.item.set_equipped_modifier player legendary
gm.item.save_equipment_both derthert my_loadout
gm.item.load_equipment_both derthert my_loadout
gm.kingdom.declare_war empire battania
gm.kingdom.declare_alliance empire battania

And many more commands - over 114 commands as of v1.3.14.1


Unblocking DLLs

Remember to unblock DLLs as BLGM uses multiple DLL and not just one singular DLL file. Open PowerShell inside the root modules folder and run command dir -r | unblock-file

The below commands will unblock every DLL for every mod in the modules folder. Your modules folder location may vary, but I included examples for standard Steam and Windows install locations.

PowerShell for standard Steam install directory:

cd "C:\Program Files (x86)\Steam\steamapps\common\Mount & Blade II Bannerlord\Modules"
dir -r | unblock-file

PowerShell for standard Windows install directory:

cd "C:\Program Files (x86)\Mount & Blade II Bannerlord\Modules"
dir -r | unblock-file

Note from developer

I would much prefer anyone who wants to make use of my code to reference BLGM in their project instead of taking snippets of code from the repo. I am leaving this open source to help anyone out, But I have noticed my code starting to appear in many other mods line for line, a large pecentage of which is probably from AI.