API Hero edit_appearance

Hero edit_appearance

Endpoint: gm.hero.edit_appearance

Syntax

gm.hero.edit_appearance <hero>

Parameters

Parameter	Type	Required	Description
hero	string	Yes	Hero identifier (StringId or partial name match)

Description

Opens the native face generator UI to edit the specified hero's appearance. This allows full customization of facial features, hair, beard, and body properties for any hero in the game, not just the player character.

The face generator provides access to all appearance options including:

• Facial structure (eyes, nose, mouth, jaw, etc.)
• Hair style and color
• Beard style (for male characters)
• Skin tone and aging
• Body proportions

Examples

Basic Usage:

gm.hero.edit_appearance lord_1_1

Using Hero Name:

gm.hero.edit_appearance hero:'Derthert'

Using Partial Name:

gm.hero.edit_appearance raganvad

Output:

Opened appearance editor for 'Hero Name' (ID: hero_string_id)

Notes

• The face generator must be enabled in the current campaign
• Changes are applied immediately when closing the editor
• Works with any hero including lords, companions, wanderers, and notables
• Cannot be used if face generation is disabled in campaign settings

Related Commands

• API-Hero-heal - Heal a hero
• API-Hero-set_age - Set hero age
• API-Hero-rename - Rename a hero
• API-Hero-Overview - Hero command overview

Last Updated: 2026-02-05