API Item save_equipment

save_equipment

Endpoint: gm.item.save_equipment

Syntax

gm.item.save_equipment <hero_query> <filename>

Parameters

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

Examples

gm.item.save_equipment player warrior_build

Output:

Saved Player's battle equipment to Documents\Mount and Blade II Bannerlord\Configs\GameMaster\HeroSets\warrior_build.json

gm.item.save_equipment lord_1_1 elite_loadout

File Location

Battle Equipment:

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

Notes

NOTE: Saves only the hero's battle equipment to a JSON file, including all item modifiers (quality levels).

NOTE: The .json extension is automatically added if not provided.

NOTE: Overwriting an existing filename will replace the previous file without warning.

TIP: Use this to create equipment templates that can be loaded onto other heroes with gm.item.load_equipment.

Related Commands

• gm.item.load_equipment - Load battle equipment from file
• gm.item.save_equipment_both - Save both equipment sets

Last Updated: 2025-12-16