API Hero load_development

gm.hero.load_development

Endpoint: gm.hero.load_development

Syntax

gm.hero.load_development <hero> <filename>

Parameters

Parameter	Type	Required	Position	Description
hero	string	Yes	0	Hero name, StringId, or player
filename	string	Yes	1	Name of the save file (without .json extension)

Description

Loads a hero's full development state from a previously saved JSON file and applies it to the target hero. The loaded data includes all skills and their levels, attributes and their points, selected perks, focus point allocations, total XP, and level.

After loading, the hero's level is recalculated to ensure it correctly matches the loaded skill levels.

Use gm.hero.list_developments to see all available saved files, and gm.hero.save_development to create them.

Examples

Load by Partial Name

gm.hero.load_development derthert derthert_build

Output:

[gm.hero.load_development] hero: Derthert | filename: derthert_build.json
SUCCESS: Loaded development onto Derthert from derthert_build.json

Load Multi-Word Hero Name

gm.hero.load_development 'Ira of the Aserai' warrior_build

Using Named Arguments

gm.hero.load_development hero:derthert filename:king_build

Load onto Player

gm.hero.load_development player my_build

Usage Tips

Standard Development Transfer Workflow:

# 1. Check what development files are available
gm.hero.list_developments

# 2. Load the desired build onto your target hero
gm.hero.load_development derthert elite_cavalry_build

Applying a Build to Multiple Heroes:

# Save once from a well-built hero
gm.hero.save_development derthert elite_cavalry_build

# Apply to multiple heroes
gm.hero.load_development 'Ira of the Aserai' elite_cavalry_build
gm.hero.load_development meroc elite_cavalry_build

Error Handling

Hero Not Found:

Error: No hero found matching '{query}'.

Solution: Use gm.query.hero to verify the hero name or StringId.

File Not Found:

Error: Development file not found: '{filename}.json'

Solution: Use gm.hero.list_developments to see available files.

Filename Empty:

Error: Filename cannot be empty.

Solution: Provide a valid filename as the second argument.

Related Commands

• gm.hero.save_development - Save a hero's development to a file
• gm.hero.list_developments - List all saved development files
• gm.hero.load_appearance - Load hero appearance
• gm.hero.load_traits - Load hero traits
• gm.hero.load_character - Load full character data (appearance + development + traits + equipment)
• API-Hero-Overview - All hero commands

Notes

Level Recalculation: After loading, the hero's level is automatically recalculated to match the loaded skill levels. This ensures the hero does not have mismatched level vs. skill values that could cause inconsistent gameplay.

Complete State Applied: All 18 skills, attribute points, every selected perk, all focus assignments, total XP, and unspent points are applied from the saved file.

Perk Compatibility: Perks that exist in the saved file but are not found in the current game session (e.g., perks from an unloaded mod) are skipped gracefully.

Immediate Effect: The development change takes effect immediately without requiring a save/reload.

Single Quotes Required: The TaleWorlds console requires SINGLE QUOTES (not double quotes) for multi-word arguments.

Named and Positional Arguments: Both named (hero:value) and positional arguments are supported. Named arguments use the format argName:value with no spaces around the colon.

Last Updated: 3/3/2026