API Query Item modifier_info

gm.query.modifier_info

Endpoint: gm.query.modifier_info

Syntax

gm.query.modifier_info <modifier_name>

Description

Get detailed information about a specific item modifier, including all stat bonuses and effects. This command displays comprehensive data about a modifier's impact on weapons and armor, helping you understand exactly how a modifier will affect item performance.

Parameters

Parameter	Type	Required	Description
modifier_name	string	Yes	Modifier name or StringId. Multi-word names are automatically joined

Examples

Get Fine Modifier Info

gm.query.modifier_info fine

Output:

Modifier Information:
StringId: fine
Name: Fine
Price Multiplier: x1.50
Damage Modifier: +2
Speed Modifier: +1
Missile Speed Modifier: +0
Armor Modifier: +5
Hit Points Modifier: +10
Stack Count Modifier: +0

Get Legendary Modifier Info

gm.query.modifier_info legendary

Output:

Modifier Information:
StringId: legendary
Name: Legendary
Price Multiplier: x5.00
Damage Modifier: +8
Speed Modifier: +4
Missile Speed Modifier: +3
Armor Modifier: +15
Hit Points Modifier: +25
Stack Count Modifier: +0

Get Negative Modifier Info

# Check damage reduction
gm.query.modifier_info bent
gm.query.modifier_info rusty
gm.query.modifier_info chipped

Output (bent):

Modifier Information:
StringId: bent
Name: Bent
Price Multiplier: x0.50
Damage Modifier: -3
Speed Modifier: -2
Missile Speed Modifier: -1
Armor Modifier: -8
Hit Points Modifier: -15
Stack Count Modifier: +0

Get Other Modifiers

gm.query.modifier_info masterwork
gm.query.modifier_info flawless
gm.query.modifier_info tempered
gm.query.modifier_info sturdy

Usage Tips

Finding Modifier Names: Use gm.query.modifiers first to see available options:

# List all modifiers
gm.query.modifiers

# Then get detailed info
gm.query.modifier_info fine

Understanding Stat Effects:

# Compare different quality tiers
gm.query.modifier_info fine        # +2 damage, +5 armor
gm.query.modifier_info flawless    # +5 damage, +10 armor
gm.query.modifier_info masterwork  # +7 damage, +12 armor
gm.query.modifier_info legendary   # +8 damage, +15 armor

Weapon vs Armor Effects: Different modifiers affect different item types:

• Damage: Affects weapons
• Speed: Affects weapon swing speed
• Missile Speed: Affects ranged weapons (bows, crossbows, throwing)
• Armor: Affects armor pieces
• Hit Points: Affects item durability for both weapons and armor

Planning Equipment Upgrades:

# Check modifier before applying
gm.query.modifier_info masterwork

# Then apply to hero's equipment
gm.item.set_equipped_modifier hero_id masterwork

Negative Modifiers: Review penalties before applying:

# Check how much a negative modifier reduces stats
gm.query.modifier_info bent
gm.query.modifier_info rusty

# Useful for creating challenging scenarios or weakened enemies

Multi-word Modifiers: If any multi-word modifiers exist, spaces are automatically joined:

# System handles multi-word automatically
gm.query.modifier_info fine quality

Output Fields

Field	Description
StringId	Modifier's unique identifier (use in commands)
Name	Modifier's display name
Price Multiplier	Value multiplication factor (e.g., x2.00 = double value)
Damage Modifier	Bonus/penalty to weapon damage
Speed Modifier	Bonus/penalty to weapon speed
Missile Speed Modifier	Bonus/penalty to projectile speed (ranged weapons)
Armor Modifier	Bonus/penalty to armor protection
Hit Points Modifier	Bonus/penalty to item durability
Stack Count Modifier	Bonus/penalty to stack size (usually +0)

Modifier Stat Comparison

Negative Modifiers:

• Bent: -3 damage, -8 armor, -15 HP, x0.50 price
• Chipped: -2 damage, -5 armor, -10 HP, x0.75 price
• Rusty: -4 damage, -10 armor, -20 HP, x0.60 price

Positive Modifiers:

• Sturdy: +1 damage, +3 armor, +5 HP, x1.25 price
• Fine: +2 damage, +5 armor, +10 HP, x1.50 price
• Tempered: +3 damage, +7 armor, +15 HP, x1.75 price
• Flawless: +5 damage, +10 armor, +20 HP, x2.00 price
• Masterwork: +7 damage, +12 armor, +22 HP, x2.50 price
• Legendary: +8 damage, +15 armor, +25 HP, x5.00 price

Note: Exact values may vary based on game version and configuration.

Error Handling

Modifier Not Found:

Error: Modifier '{modifier_name}' not found.

Solution: Use gm.query.modifiers to find valid modifier names.

No Parameter Provided:

Error: Please provide a modifier name.
Usage: gm.query.modifier_info <modifier_name>
Example: gm.query.modifier_info fine

Solution: Provide a modifier name as parameter.

Related Commands

• gm.query.modifiers - List all available modifiers
• 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

Stat Bonuses Apply Cumulatively: When a modifier is applied to an item, the bonuses add to the item's base stats. For example, a weapon with 30 base damage and a "fine" modifier (+2 damage) will have 32 total damage.

Price Effects: The price multiplier affects the item's base value. A 1000 denar sword with "masterwork" modifier (x2.50) becomes worth 2500 denars.

Zero Values: "+0" indicates the modifier doesn't affect that stat. For example, most modifiers have "+0" for Stack Count Modifier since they don't affect stackable quantities.

Weapon vs Armor: Some bonuses are more relevant to specific item types:

• Damage/Speed/Missile Speed primarily affect weapons
• Armor primarily affects armor pieces
• Hit Points affect all equipment types (durability)

Balance Consideration: Higher tier modifiers can dramatically increase item effectiveness. Legendary modifiers create extremely powerful equipment that may unbalance gameplay.

Last Updated: 2025-12-20