API Item load_equipment

load_equipment

Endpoint: gm.item.load_equipment

Syntax

gm.item.load_equipment <hero_query> <filename>

Parameters

Parameter	Type	Required	Description
hero_query	string	Yes	Hero identifier (StringId or partial name match)
filename	string	Yes	Name of the equipment file (without extension)

Examples

gm.item.load_equipment companion warrior_build

Output:

Loaded battle equipment for Companion from Documents\Mount and Blade II Bannerlord\Configs\GameMaster\HeroSets\warrior_build.json. Equipped 6 items.

gm.item.load_equipment player backup_loadout

File Location

Battle Equipment:

Documents\Mount and Blade II Bannerlord\Configs\GameMaster\HeroSets\{filename}.json

Notes

NOTE: Loads only the hero's battle equipment from a previously saved JSON file.

NOTE: If an item from the saved equipment doesn't exist in the current game, it will be skipped with a notification.

NOTE: Equipment quality modifiers are preserved during load.

TIP: Use this to quickly apply equipment templates to multiple heroes.

Related Commands

• gm.item.save_equipment - Save battle equipment to file
• gm.item.load_equipment_both - Load both equipment sets

Last Updated: 2025-12-16