API Item add

add

Endpoint: gm.item.add

Syntax

gm.item.add <item_query> <count> <hero_query> [modifier]

Parameters

Parameter	Type	Required	Description
item_query	string	Yes	Item identifier (StringId or partial name match)
count	integer	Yes	Number of items to add (range: 1-10000)
hero_query	string	Yes	Hero identifier (StringId or partial name match)
modifier	string	No	Optional quality modifier (e.g., "fine", "masterwork", "legendary")

Examples

gm.item.add imperial_sword 5 player

Output:

Added 5x Imperial Sword to Player's party inventory.

gm.item.add imperial_sword 5 player masterwork

Output:

Added 5x Masterwork Imperial Sword to Player's party inventory.

gm.item.add axe 1 lord_1_1

Notes

NOTE: The hero must belong to a party. Items are added to the party's inventory, not directly to the hero.

NOTE: Use partial name matching for convenience - "sword" will match any item with "sword" in the name.

TIP: Use gm.query.item to search for items before adding them.

TIP: Use gm.query.modifiers to see available quality modifiers and their effects.

Related Commands

• gm.item.remove - Remove items from inventory
• gm.query.item - Search for items

Last Updated: 2025-12-16