API Query Culture culture

gm.query.culture

Endpoint: gm.query.culture

Syntax

gm.query.culture [search_terms] [main|bandit] [sort:field[:desc]]

Description

List all cultures in the game with optional filtering and sorting. Use this command to discover available cultures for hero generation, settlement management, and other culture-related commands. Cultures determine character names, appearance styles, equipment types, and faction associations.

Parameters

Parameter	Type	Required	Description
search_terms	string	No	Search text to filter cultures by name or ID
type	string	No	Culture type filter: 'main' for main faction cultures, 'bandit' for bandit cultures
sort	string	No	Sort parameter in format sort:field[:desc]. Fields: 'id' (default), 'name'. Add ':desc' for descending order

Examples

List All Cultures

gm.query.culture

Output:

Found 12 culture(s) matching all cultures:

StringId           Name               Type
--------           ----               ----
empire             Empire             Main
vlandia            Vlandia            Main
sturgia            Sturgia            Main
aserai             Aserai             Main
battania           Battania           Main
khuzait            Khuzait            Main
looters            Looters            Bandit
mountain_bandits   Mountain Bandits   Bandit
forest_bandits     Forest Bandits     Bandit
sea_raiders        Sea Raiders        Bandit
desert_bandits     Desert Bandits     Bandit
steppe_bandits     Steppe Bandits     Bandit

Filter by Type

# List only main cultures
gm.query.culture main

# List only bandit cultures
gm.query.culture bandit

Output (main):

Found 6 culture(s) matching type: main:

StringId           Name               Type
--------           ----               ----
empire             Empire             Main
vlandia            Vlandia            Main
sturgia            Sturgia            Main
aserai             Aserai             Main
battania           Battania           Main
khuzait            Khuzait            Main

Search for Specific Culture

# Search by name
gm.query.culture empire
gm.query.culture vland
gm.query.culture bandit

# Search with type filter
gm.query.culture mountain main

Output:

Found 1 culture(s) matching search: 'empire':

StringId           Name               Type
--------           ----               ----
empire             Empire             Main

Sorted Results

# Sort by name ascending
gm.query.culture sort:name

# Sort by name descending
gm.query.culture sort:name:desc

# Sort by ID descending
gm.query.culture sort:id:desc

# Combine with filters
gm.query.culture main sort:name

Output:

Found 6 culture(s) matching type: main, sort: name (asc):

StringId           Name               Type
--------           ----               ----
aserai             Aserai             Main
battania           Battania           Main
empire             Empire             Main
khuzait            Khuzait            Main
sturgia            Sturgia            Main
vlandia            Vlandia            Main

Usage Tips

Finding Cultures for Commands: Use this to discover culture IDs for use in other commands:

# Find available cultures
gm.query.culture

# Then use in hero generation
gm.hero.generate_lords 10 empire male
gm.hero.create_lord 'Lord Name' vlandia male

Culture Groups: In hero generation commands, you can use:

• main_cultures - All main faction cultures (empire, vlandia, sturgia, aserai, battania, khuzait)
• bandit_cultures - All bandit cultures
• all_cultures - Every culture in the game

Search Tips:

# Partial matching works
gm.query.culture emp        # Finds empire
gm.query.culture vla        # Finds vlandia

# Case insensitive
gm.query.culture EMPIRE
gm.query.culture Empire

Combining Parameters: You can combine search, type filter, and sorting:

# Search for specific type with sorting
gm.query.culture main sort:name
gm.query.culture bandit sort:name:desc

# Search term with type filter
gm.query.culture mountain bandit

Default Behavior: Without parameters, lists all cultures sorted by ID ascending.

Output Format

The command displays results in a formatted table with three columns:

• StringId: The culture's unique identifier (use this in commands)
• Name: The culture's display name
• Type: Culture category (Main, Bandit, or Minor)

Culture Types

Main Cultures: Major faction cultures with full name lists and equipment:

• Empire - Southern, Northern, and Western Empire factions
• Vlandia - Vlandian Kingdom
• Sturgia - Sturgian Kingdom
• Aserai - Aserai Sultanate
• Battania - Battanian Kingdom
• Khuzait - Khuzait Khanate

Bandit Cultures: Hostile non-faction cultures:

• Looters - Generic bandits
• Mountain Bandits - Highland bandits
• Forest Bandits - Woodland bandits
• Sea Raiders - Coastal raiders
• Desert Bandits - Desert raiders
• Steppe Bandits - Plains raiders

Minor Cultures: Smaller cultural groups (if present in your game)

Related Commands

• gm.query.culture_info - Get detailed culture information
• gm.hero.generate_lords - Generate lords with culture filter
• gm.hero.create_lord - Create lord with culture filter
• gm.settlement.spawn_wanderer - Spawn wanderer with culture filter
• gm.settlement.set_culture - Change settlement culture
• API-Query-Overview - All query commands

Notes

Use in Hero Commands: Culture IDs from this command can be used in:

• gm.hero.generate_lords for filtering lord templates
• gm.hero.create_lord for filtering lord templates
• gm.settlement.spawn_wanderer for filtering wanderer templates

Multiple Cultures in Commands: When using hero generation commands, you can specify multiple cultures separated by semicolons (no spaces):

gm.hero.generate_lords 10 vlandia;empire;battania male

Culture Effects: Culture determines:

• Available character names (male/female name lists)
• Character appearance styles
• Default equipment types
• Clan name lists
• Faction associations

Last Updated: 2025-12-20