API Query Item modifiers

gm.query.modifiers

Endpoint: gm.query.modifiers

Syntax

gm.query.modifiers [search_terms...]

Description

List all available item quality modifiers with their effects. Modifiers can be applied to weapons and armor to enhance or reduce their stats and value. Use this command to discover available quality levels, their price multipliers, and stat effects.

Parameters

Parameter	Type	Required	Description
search_terms	string	No	Search text to filter modifiers by name or StringId (case-insensitive)

Examples

List All Modifiers

gm.query.modifiers

Output:

Found 10 modifier(s):

StringId              Name                  Price Factor
--------              ----                  ------------
bent                  Bent                  x0.50
chipped               Chipped               x0.75
crude                 Crude                 x0.90
fine                  Fine                  x1.50
flawless              Flawless              x2.00
masterwork            Masterwork            x2.50
legendary             Legendary             x5.00
rusty                 Rusty                 x0.60
sturdy                Sturdy                x1.25
tempered              Tempered              x1.75

Search for Specific Modifiers

# Search for positive modifiers
gm.query.modifiers fine
gm.query.modifiers masterwork
gm.query.modifiers legendary

# Search for negative modifiers
gm.query.modifiers bent
gm.query.modifiers chipped
gm.query.modifiers rusty

# Partial search
gm.query.modifiers temp        # Finds "tempered"
gm.query.modifiers master      # Finds "masterwork"

Output (fine):

Found 1 modifier(s):

StringId              Name                  Price Factor
--------              ----                  ------------
fine                  Fine                  x1.50

Multi-word Search

# Multiple words are combined
gm.query.modifiers fine sturdy

Usage Tips

Finding Modifiers for Item Commands: Use this to discover modifier IDs:

# List all modifiers
gm.query.modifiers

# Apply to equipped items
gm.item.set_equipped_modifier hero_id fine

# Apply to inventory items
gm.item.set_inventory_modifier hero_id item_id masterwork

Quality Tiers: Modifiers generally fall into categories:

# Negative (reduce stats and value)
gm.query.modifiers bent
gm.query.modifiers chipped
gm.query.modifiers crude
gm.query.modifiers rusty

# Basic positive (small improvements)
gm.query.modifiers sturdy

# Good quality (moderate improvements)
gm.query.modifiers fine
gm.query.modifiers tempered

# Excellent quality (major improvements)
gm.query.modifiers flawless
gm.query.modifiers masterwork

# Legendary (maximum improvements)
gm.query.modifiers legendary

Price Multipliers Guide:

• x0.50-0.90: Negative modifiers (damaged/poor quality)
• x1.00: Normal (no modifier)
• x1.25-1.75: Good quality (+25% to +75% value)
• x2.00-2.50: Excellent quality (+100% to +150% value)
• x5.00+: Legendary quality (+400%+ value)

Case Insensitive Search: Searches work regardless of capitalization:

gm.query.modifiers FINE
gm.query.modifiers Fine
gm.query.modifiers fine
# All return the same result

Sorted Output: Results are automatically sorted alphabetically by name for easy browsing.

Output Format

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

• StringId: The modifier's unique identifier (use this in commands)
• Name: The modifier's display name
• Price Factor: Value multiplier (e.g., x2.00 means item is worth twice as much)

Headers are properly aligned with the column data using dynamic column width calculation.

Modifier Categories

Negative Modifiers (Reduce value and stats):

• Bent: Minor damage, reduced effectiveness
• Chipped: Light damage, slightly reduced stats
• Crude: Poor craftsmanship, below average
• Rusty: Corroded, significantly reduced effectiveness

Positive Modifiers (Increase value and stats):

• Sturdy: Well-made, slightly improved
• Fine: High quality, moderately improved
• Tempered: Heat-treated, good improvements
• Flawless: Perfect craftsmanship, excellent stats
• Masterwork: Master craftsman work, superior stats
• Legendary: Mythical quality, maximum improvements

Related Commands

• gm.query.modifier_info - Get detailed modifier information with stat bonuses
• gm.item.set_equipped_modifier - Apply modifier to equipped items
• gm.item.set_inventory_modifier - Apply modifier to inventory items
• gm.item.remove_equipped_modifier - Remove modifiers from equipped items
• gm.query.item - Search for items
• gm.query.item_info - Get item details
• API-Query-Overview - All query commands

Notes

Application Scope: Modifiers can only be applied to weapons and armor using item management commands. They cannot be applied to other item types like trade goods or horses.

Stat Effects: While this command shows price multipliers, use gm.query.modifier_info to see detailed stat bonuses including damage, armor, speed, etc.

Visual Effects: Modifiers may affect the visual appearance and name display of items in the game (e.g., "Masterwork Imperial Sword").

Balance Consideration: Higher tier modifiers can significantly impact game balance. Legendary modifiers create extremely powerful items.

Last Updated: 2025-12-20