Home

Bannerlord GameMaster User Command Wiki

Version: v1.3.14.11 Game Version: v1.3.14 Last Updated: 3/3/2026

This wiki is for players using BLGM to enhance their gameplay and contains documentation for the console commands provided by blgm

If you are looking for the developer Api reference, instead use the below link
Developer API Reference

System Console

BLGM includes an optional system console that displays additional debug information alongside the game console. To enable the system console:

In-Game Command:

gm.show_system_console

Command Line Launch Option:

/systemconsole

The system console is optional - all commands work in both the game console and system console. The system console additionally shows:

• Debug output and logging
• Detailed command execution information
• System messages and warnings

---

Command Syntax Guidelines

Single Quotes for Multi-Word Arguments

The TaleWorlds console requires SINGLE QUOTES for multi-word arguments:

# Correct
gm.hero.create_lord 'Sir John Smith' vlandia

# Incorrect (will not work)
gm.hero.create_lord "Sir John Smith" vlandia

Named Arguments

Use argName:value notation with no spaces:

# Correct
gm.hero.generate_lords count:10 gender:female

# Incorrect (spaces break parsing)
gm.hero.generate_lords count: 10 gender: female

# Positional arguments still work and can be mixed with named arguments

Culture Separators

Use commas without spaces for multiple cultures:

# Correct
gm.hero.generate_lords 10 vlandia,battania,sturgia

# Incorrect (semicolons treated as command separators)
gm.hero.generate_lords 10 vlandia;battania;sturgia

# Incorrect (spaces break parsing)
gm.hero.generate_lords 10 vlandia, battania, sturgia

Full Command Syntax Guide

---

Quick Links

Section	Description	Commands
API Reference	Complete command reference	139 commands
Hero Management	Manage characters and relationships	40 commands
Clan Management	Control clans and memberships	18 commands
Kingdom Management	Build kingdoms and manage diplomacy	17 commands
Settlement Management	Control settlements and properties	19 commands
Bandit Management	Control bandit parties and hideouts	4 commands
Caravan Management	Create and manage trade caravans	8 commands
Troop Management	Add and manage troops	7 commands
Item Management	Inventory and equipment control	20 commands
Query Commands	Search and filter entities	18 commands

---

Recent Updates

Version 1.3.14.11 (2026-03-03)

Added Hero Serialization & Character Set Commands

• gm.hero.save_appearance - Save a hero's appearance (face, hair, tattoos, body shape, height) to a JSON file
• gm.hero.load_appearance - Load a saved appearance onto any hero (gender-matched by default, use force:true to override)
• gm.hero.list_appearances - List all saved appearance files
• gm.hero.save_development - Save a hero's full development state (skills, attributes, perks, focus, XP, level) to a JSON file
• gm.hero.load_development - Load a saved development state onto any hero (level recalculated after load)
• gm.hero.list_developments - List all saved development files
• gm.hero.save_traits - Save all of a hero's traits to a JSON file (includes modded traits)
• gm.hero.load_traits - Load saved traits onto any hero (missing mod traits are skipped gracefully)
• gm.hero.list_traits - List all saved trait files
• gm.hero.export_character - Export a hero's complete character data (appearance + development + traits + equipment) to a single file
• gm.hero.load_character - Load a character set onto an existing hero (preserves name, gender, StringId, MBGUID, occupation)
• gm.hero.import_character - Create a brand new hero from a character set file with a fresh identity
• gm.hero.list_characters - List all saved character set files

Version 1.3.14.10 (2026-03-01)

Added Pregnancy Management Commands

• gm.hero.give_birth - Force immediate birth for a pregnant hero with optional father and child gender
• gm.hero.abort_pregnancy - Terminate a hero's pregnancy without delivering a child

Version 1.3.14.5 (2026-02-17)

Added party editor command and optional level/age arguments to hero generation commands

• gm.hero.edit_party - Open the native party editor for any hero's party with troop transfer or discard mode

Added optional level and age arguments to hero generation commands

• gm.hero.create_lord - Now supports optional level (1-62) and age (18+) parameters
• gm.hero.generate_lords - Now supports optional level (1-62) and age (18+) parameters
• gm.hero.create_companions - Now supports optional level (1-62) and age (18+) parameters

Version 1.3.14.4 (2026-02-13)

Added Hero Relationship Commands and Kingdom Rename

• gm.hero.marry - Marry two heroes with optional force marriage and clan join control
• gm.hero.divorce - Divorce a hero from their current spouse
• gm.hero.impregnate - Make a female hero pregnant with optional father specification
• gm.kingdom.rename - Rename any kingdom

Version 1.3.14.3 (2026-02-10)

Added Banner Sync Commands

• gm.kingdom.sync_vassal_banners - Sync all vassal clan banner colors to the kingdom's ruling clan banner colors
• gm.kingdom.edit_banner - Shortcut to open the banner editor for a kingdom's ruling clan
• gm.clan.sync_kingdom_colors - Sync a single clan's banner colors to match the kingdom colors

Version 1.3.14.2 (2026-02-06)

Added Hero Inventory Management

• gm.hero.open_inventory - Open the native inventory screen for any hero
• View and transfer items between any two heroes' party inventories
• Equip items on any hero regardless of clan affiliation
• Supports hero-vs-hero inventory with synthetic roster support for cross-clan heroes

Version 1.3.14.1 (2026-02-05)

Added Hero Appearance Editor

• gm.hero.edit_appearance - Open the native face generator UI to edit any hero's appearance
• Full customization of facial features, hair, beard, and body properties
• Works with any hero including lords, companions, wanderers, and notables

Version 1.3.13.17 (2026-02-04)

Added Banner Editor and Culture Selection

• gm.clan.edit_banner - Open the native banner editor for any clan
• When editing a ruling clan's banner, the kingdom banner is also updated
• Banner changes affect all vassal clans in the kingdom
• gm.clan.create_clan now supports optional culture parameter for auto-generated leaders
• Culture parameter accepts single cultures, multiple comma-separated cultures, or culture groups
• Default culture is main_cultures if not specified

Version 1.3.13.16 (2026-02-02)

Added Equipment Commands for Heroes, Clans, and Kingdoms

• gm.hero.equip_hero - Equip hero with skill-based equipment
• gm.clan.equip_heroes - Equip all heroes in clan
• gm.kingdom.equip_heroes - Equip all heroes in kingdom
• Equipment system analyzes hero skills to determine optimal weapon loadout
• Automatically selects culturally appropriate equipment
• Tier can be specified or auto-calculated from hero level
• Optional includeNativeHeroes parameter to preserve native character appearances

Version 1.3.13.4 (2026-01-10)

Added Settlement commands to change which settlement a village is bound to

• gm.settlement.set_village_bound_settlement
• gm.settlement.set_village_trade_bound_settlement

Fixed Several Minor Hero Issues

• Fixed generated heroes not showing their troop influence and captain perks in battle deployment
• Fixed generated heroes being level 10 with enough xp to go way beyond level 10 causing them to level up 10+ levels after one or two battles
• Fixed some heroes being generated at age 16 instead of as an adult
• Generated Heroes leading parties will no longer prefer to upgrade troops to cavalry, and will now upgrade troops more evenly
• Generated Heroes now get assigned a random date to die based on them reaching a random age of 55-92 years old

Version 1.3.13.3 (2026-01-07)

Fixed settlement.set_culture

• Changes now persist when saving / loading
• notables are automatically set to new culture, ensuring recruits are proper culture
• Added optional parameter, passing true will also change any bound villages

Caravans

• Added several commands to clear caravan parties
• Moved caravan creation commands from settlement to caravan command group

Version 1.3.13.2 (2026-01-06)

• gm.bandit.count - Display counts of all bandit parties and hideouts
• gm.bandit.destroy_bandit_parties - Destroy bandit parties by type
• gm.bandit.clear_hideouts - Clear bandit hideouts by type
• gm.bandit.remove_all - Remove all bandit parties and hideouts

Version 1.3.13.1 (2025-12-27)

• gm.troops.upgrade_troops - Upgrade all troops to specified tier with ratio control
• gm.troops.give_xp - Add experience points to all troops in party

Version 1.3.11.7 (2025-12-25)

• gm.kingdom.create_kingdom - Create new kingdoms with specified settlements
• gm.kingdom.generate_kingdoms - Generate multiple kingdoms at once

Version 1.3.11.6 (2025-12-23)

• gm.kingdom.declare_alliance - Form alliances between kingdoms
• gm.kingdom.call_ally_to_war - Call allies to join wars
• gm.kingdom.trade_agreement - Establish trade agreements
• gm.kingdom.pay_tribute - Set up tribute payments
• gm.kingdom.get_tribute_info - Query tribute arrangements

Version 1.3.10.5 (2025-12-22)

• Added named argument notation support
• Changed culture separator from semicolon to comma
• Revamped clan generation system
• Added new hero, clan, and troop commands
• Enhanced party creation logic
• Extended custom name pools
• Fixed issues with hero and clan creation

Version 1.0.0 (2025-12-16)

• Complete wiki restructuring with hierarchical organization
• Added comprehensive command documentation
• Implemented advanced query system
• Added equipment save/load functionality
• Enhanced item management with quality modifiers
• Expanded troop management capabilities

---