API Hero equip_hero

Hero equip_hero

Endpoint: gm.hero.equip_hero

Syntax

gm.hero.equip_hero <hero> [tier] [civilian]

Parameters

Parameter	Type	Required	Description
hero	string	Yes	Hero identifier (StringId or partial name match). Use 'player' for main character
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

Description

Equips a hero with level-appropriate equipment based on their combat skills. The system analyzes the hero's skills to determine optimal weapon loadout and automatically selects culturally appropriate equipment for the hero's tier level.

The tier parameter determines equipment quality:

• Tier 0-6: Native Bannerlord equipment tiers (0=lowest, 6=highest)
• Auto (default): Automatically calculated from hero level
• Mods: Some mods may add equipment beyond tier 6

The system derives weapon preferences from hero skills:

• One-Handed: Based on One Handed skill
• Two-Handed: Based on Two Handed skill
• Polearm: Based on Polearm skill
• Bow: Based on Bow skill
• Crossbow: Based on Crossbow skill
• Throwing: Based on Throwing skill
• Shield: Added for appropriate builds

Supports named arguments: hero:player tier:5 civilian:true

Examples

Example 1: Basic Usage

Equip the player with auto-calculated tier equipment:

gm.hero.equip_hero player

Output:

Equipped {Hero Name} with tier {calculated_tier} equipment.
Derived loadout: One-Handed, Shield, Bow
Hero Level: {level}, Culture: {culture}

Example 2: Specific Tier

Equip a hero with tier 5 equipment:

gm.hero.equip_hero hero:player tier:5

Example 3: Multi-Word Name with Tier

gm.hero.equip_hero 'Lucon of the Empire' tier:4

Example 4: Including Civilian Equipment

Replace both battle and civilian equipment:

gm.hero.equip_hero hero:'Garios of the Empire' tier:6 civilian:true

Example 5: Named Arguments

gm.hero.equip_hero hero:player tier:5 civilian:true

Notes

• Cannot equip dead heroes - hero must be alive
• Equipment is culturally appropriate to the hero's culture
• Weapon loadout is automatically derived from hero's skills
• If tier is not specified, it's calculated based on hero level
• Civilian equipment is only replaced if explicitly set to true

Related Commands

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

Last Updated: 2026-02-02