API Hero create_lord

gm.hero.create_lord

Endpoint: gm.hero.create_lord

Syntax

gm.hero.create_lord <name> [cultures] [gender] [clan] [withParty] [settlement] [randomFactor] [level] [age]

Parameters

Parameter	Type	Required	Description
name	string	Yes	Display name for the new lord. Use SINGLE QUOTES for multi-word names
cultures	string	No	Culture filter(s). Use commas to separate multiple cultures (e.g., vlandia,battania). Can also use group keywords: main_cultures (default), bandit_cultures, all_cultures. Run gm.query.culture to see available cultures
gender	string	No	Gender filter: 'both'/'b' (default), 'male'/'m', or 'female'/'f'
clan	string	No	Clan identifier (StringId or partial name match). If not specified, lord goes to a random clan
withParty	bool	No	Whether to create a party for the lord. Defaults to true (only creates party if clan is below party limit)
settlement	string	No	Settlement for lord without party to reside in (only used if withParty is false). Settlement StringId or partial name match
randomFactor	float	No	Template randomization factor (0.0-1.0). Default is 0.5. Controls how much the template is randomized within its constraints (1 = more variety and still good looking, 0 = less variety, better looking)
level	integer	No	Target level for the lord (1-62). If not specified, a random level between 10-25 is assigned
age	integer	No	Age for the lord (minimum 18). If not specified, a random age between 18-30 is assigned

Named Arguments

This command supports named argument notation, allowing you to specify optional parameters in any order using the format argName:value (with a colon and no spaces).

Benefits:

• Specify optional parameters without providing all preceding parameters
• Arguments can be in any order when using named notation
• Mix positional and named arguments

Examples:

# Using named arguments to skip positional parameters
gm.hero.create_lord name:'Sir Percival' gender:female cultures:vlandia level:20 age:25

# Specify only the parameters you need
gm.hero.create_lord 'Lady Knight' gender:female clan:player_faction level:15

# Mix positional and named arguments
gm.hero.create_lord 'Lord Marcus' vlandia gender:male randomFactor:0.8 age:28

Description

Creates a single lord from random templates with good gear and decent stats. This command allows you to create a named lord with specific characteristics.

Each created lord receives:

• Custom Name: The name you specify
• Random Template: Selected from available lord templates matching culture and gender filters
• Level: 10-25 (randomly selected), or a specific level if provided
• Age: 18-30 (randomly selected), or a specific age if provided
• Equipment: High-tier armor and weapons matching their culture
• Occupation: Lord
• Status: Active and ready for duty
• Randomized Appearance: Face, hair, and body features randomized within template constraints

If no clan is specified, the lord is assigned to a random clan. If a specific clan is provided, the lord joins that clan.

Party Creation: The lord will only be made a party leader if the clan is not at their maximum allowed parties for their tier. Otherwise, the lord is created as a regular family member. You can create a party for them later using gm.hero.create_party. Set withParty:false to skip party creation entirely.

Examples

Basic Creation

gm.hero.create_lord 'Sir Percival'

Output:

Created lord 'Sir Percival' (ID: {lord_id})
[Detailed formatted output with hero information]

Creating with Culture and Gender

# Male Vlandian lord
gm.hero.create_lord Ragnar vlandia male

# Female Empire lord for player faction
gm.hero.create_lord 'Lady Elara' empire female player_faction

# Aserai male lord with specific randomization
gm.hero.create_lord Khalid aserai male 'dey Meroc' true null 0.8

Creating with Level and Age

# Create a lord at level 30
gm.hero.create_lord 'Sir Gallant' vlandia male level:30

# Create a lord at age 45
gm.hero.create_lord 'Elder Marcus' empire male age:45

# Create a lord at both specific level and age
gm.hero.create_lord 'Lady Sophia' battania female level:20 age:25

# Positional usage with level and age at the end
gm.hero.create_lord Khalid aserai male 'dey Meroc' true null 0.8 20 25

Multi-word Names

# Always use SINGLE QUOTES for multi-word names
gm.hero.create_lord 'Sir John Smith'
gm.hero.create_lord 'Lady Catherine of Vlandia' vlandia female
gm.hero.create_lord 'Lord Marshal' empire male player_faction

Culture-Specific Lords

# Vlandian lord
gm.hero.create_lord 'Count Roland' vlandia male

# Battanian female
gm.hero.create_lord 'Liath' battania female

# Aserai male
gm.hero.create_lord 'Emir Hassan' aserai male

Party and Settlement Control

# Create lord without a party, placed at a settlement
gm.hero.create_lord 'Lady Isolde' vlandia female withParty:false settlement:pen_cannoc

# Create lord with party (default)
gm.hero.create_lord 'Sir Aldric' empire male clan:player_faction withParty:true

Random Factor Control

# Default randomization (0.5)
gm.hero.create_lord 'Lord Marcus' empire

# Less randomization for template-like appearance (better looking)
gm.hero.create_lord 'Lady Sophia' vlandia female player_faction true null 0.3

# More randomization for unique appearance (more variety)
gm.hero.create_lord 'Khan Temujin' khuzait male randomFactor:1.0

Named Arguments - Full Control

# Specify everything using named arguments
gm.hero.create_lord name:'Lady Elara' cultures:empire gender:female clan:player_faction withParty:false settlement:pen_cannoc randomFactor:0.8 level:15 age:22

# Specify only what you need, skip everything else
gm.hero.create_lord name:'Sir Reginald' level:25 age:30 clan:player_faction

Usage Tips

Smart Argument Parsing: The command intelligently parses arguments:

# Gender keyword detected first, cultures defaults to main_cultures
gm.hero.create_lord 'Sir John' male

# Cultures specified, then gender
gm.hero.create_lord 'Lady Maria' vlandia female

# Cultures, gender, then clan
gm.hero.create_lord 'Lord Marcus' empire male player_faction

# Full specification with all optional parameters
gm.hero.create_lord 'Khan Boris' khuzait male player_faction true null 0.8 20 25

Culture Selection:

# Use predefined groups
gm.hero.create_lord 'Hero Name' main_cultures
gm.hero.create_lord 'Bandit Lord' bandit_cultures
gm.hero.create_lord 'Any Lord' all_cultures

# Specify individual culture
gm.hero.create_lord 'Vlandian Lord' vlandia
gm.hero.create_lord 'Empire Lady' empire female

Gender Filtering:

# Both genders (default - random selection)
gm.hero.create_lord 'Hero Name' main_cultures both
gm.hero.create_lord 'Hero Name' main_cultures b

# Male only
gm.hero.create_lord 'Sir Name' main_cultures male
gm.hero.create_lord 'Sir Name' main_cultures m

# Female only
gm.hero.create_lord 'Lady Name' main_cultures female
gm.hero.create_lord 'Lady Name' main_cultures f

Level and Age Control:

# Set specific level (1-62)
gm.hero.create_lord 'Veteran Lord' vlandia male level:40

# Set specific age (18+)
gm.hero.create_lord 'Young Knight' empire male age:18

# Set both level and age
gm.hero.create_lord 'Seasoned General' sturgia male level:50 age:55

# Default values when not specified:
# Level: Random between 10-25
# Age: Random between 18-30

Naming Conventions: Best practices for naming:

# Single-word names (no quotes needed)
gm.hero.create_lord Marcus empire male
gm.hero.create_lord Ragnar vlandia male

# Multi-word names (SINGLE QUOTES required)
gm.hero.create_lord 'Sir Marcus the Bold' empire male
gm.hero.create_lord 'Lady Catherine of Battania' battania female

Random Factor Guide:

• 0.0-0.3: Less variety, stays close to template (better looking, more uniform)
• 0.4-0.6: Balanced variety (default 0.5)
• 0.7-1.0: Maximum variety, unique appearances (still good looking, more diverse)

Clan Assignment:

# Player clan
gm.hero.create_lord 'My Lord' vlandia male player_faction

# Specific NPC clan by name
gm.hero.create_lord 'New Lord' aserai male 'dey Meroc'

# Random clan (omit clan parameter)
gm.hero.create_lord 'Random Lord' vlandia male

Query Available Cultures: Use culture query command to see all available options:

gm.query.culture              # List all cultures
gm.query.culture main         # List main cultures only
gm.query.culture bandit       # List bandit cultures only

Renaming After Creation: Use the rename command if you want to change the name later:

gm.hero.create_lord 'Initial Name' vlandia male
gm.hero.rename 'Initial Name' 'New Name'

Comparison with generate_lords

Use gm.hero.create_lord when you need:

• A single lord with custom name
• More control over naming
• Similar culture/gender filtering options
• Specific randomization control
• Control over party creation and settlement placement

Use gm.hero.generate_lords when you want:

• Multiple lords quickly
• Lords with random appropriate names
• Bulk population of clans
• Same culture/gender filtering capabilities

Related Commands

• API-Hero-Overview - All hero commands
• API-Hero-generate_lords - Generate multiple lords with random names
• API-Hero-create_companions - Create companions for a party
• API-Hero-rename - Rename existing heroes
• gm.hero.set_age - Adjust lord age
• gm.hero.set_clan - Change lord's clan
• gm.hero.add_gold - Give gold to lord
• gm.item.add - Add equipment to lord
• gm.item.equip - Equip items on lord
• gm.query.hero - Find heroes by name
• gm.query.culture - Query available cultures

Notes

Custom Naming: Unlike gm.hero.generate_lords, this command allows you to specify exact names for your lords, making it ideal for role-playing or creating specific characters.

Random Appearance: Each lord gets a randomized appearance (face features, hair style) based on their template's race and gender, controlled by the randomFactor parameter.

Template Selection: The command randomly selects from available lord templates matching the specified culture and gender filters. The template determines the lord's base culture and appearance characteristics.

Culture Filtering: The culture filter determines which templates can be selected, ensuring lords have appropriate appearance and equipment for their culture.

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

Party Assignment Logic: Lords are only made party leaders if their clan is below the maximum party count for their tier. Otherwise, they're created as clan members without parties. Use gm.hero.create_party to give them a party later. Use withParty:false to skip party creation entirely, and optionally specify a settlement for the lord to reside in.

Level Range: When specifying a level, valid values are 1-62. If not specified, a random level between 10-25 is assigned. Higher levels result in better skills and attributes.

Age Range: When specifying an age, the minimum is 18. If not specified, a random age between 18-30 is assigned. Age affects various game mechanics including death probability and attribute decay at very high ages.

Last Updated: 2026-02-16