API Kingdom equip_heroes

gm.kingdom.equip_heroes

Endpoint: gm.kingdom.equip_heroes

Syntax

gm.kingdom.equip_heroes <kingdom> [tier] [civilian] [includeNativeHeroes]

Parameters

Parameter	Type	Required	Description
kingdom	string	Yes	Kingdom identifier (StringId or partial name match)
tier	integer	No	Equipment tier (0+). Native items are tier 0-6, mods may add higher. Defaults to auto-calculated from hero level
civilian	boolean	No	Also replace civilian equipment (true/false). Defaults to false
includeNativeHeroes	boolean	No	If true, equips all heroes; if false, only BLGM-created heroes (true/false). Defaults to false

Description

Equips all heroes in a kingdom with level-appropriate equipment based on their combat skills. This command processes all clans in the kingdom and equips their heroes. The system analyzes each hero's skills to determine optimal weapon loadout and automatically selects culturally appropriate equipment.

The includeNativeHeroes parameter provides control over which heroes are equipped:

• false (default): Only equips heroes created by BLGM (via hero generation commands)
• true: Equips all heroes in the kingdom, including original game characters

This allows you to equip custom-generated heroes across an entire kingdom without modifying the equipment of native Bannerlord characters.

Supports named arguments: kingdom:vlandia tier:5 civilian:true includeNativeHeroes:false

Examples

Example 1: Basic Usage

Equip BLGM heroes in a kingdom with auto-calculated tier:

gm.kingdom.equip_heroes vlandia

Output:

Equipped {count} heroes across {clan_count} clans in {Kingdom Name} with tier {tier} equipment.

Example 2: Specific Tier

Equip kingdom heroes with tier 5 equipment:

gm.kingdom.equip_heroes kingdom:vlandia tier:5

Example 3: Multi-Word Kingdom Name

gm.kingdom.equip_heroes 'Northern Empire' tier:4 civilian:true

Example 4: Include All Heroes

Equip all heroes in kingdom, including native game characters:

gm.kingdom.equip_heroes kingdom:empire_w includeNativeHeroes:true

Example 5: Full Options

gm.kingdom.equip_heroes kingdom:battania tier:6 civilian:true includeNativeHeroes:false

Notes

• Only living heroes are equipped
• Dead heroes are automatically skipped
• Equipment is culturally appropriate to each hero's culture
• Weapon loadout is automatically derived from each hero's skills
• If tier is not specified, it's calculated per hero based on their level
• Processes all clans in the kingdom, including the ruling clan
• By default, only BLGM-created heroes are equipped to preserve native character appearances
• Large kingdoms may take a moment to process

Related Commands

• API-Hero-equip_hero - Equip a single hero
• API-Clan-equip_heroes - Equip all heroes in a clan
• API-Kingdom-Overview - Kingdom command overview

Last Updated: 2026-02-02