API Item equip

equip

Endpoint: gm.item.equip

Syntax

gm.item.equip <item_query> <hero_query> [civilian]

Parameters

Parameter	Type	Required	Description
item_query	string	Yes	Item identifier (StringId or partial name match)
hero_query	string	Yes	Hero identifier (StringId or partial name match)
civilian	keyword	No	Add this keyword to equip to civilian equipment instead of battle equipment

Examples

gm.item.equip imperial_sword player

Output:

Equipped Imperial Sword to Player's battle equipment (slot: Weapon0).

gm.item.equip robe player civilian

Output:

Equipped Fine Robe to Player's civilian equipment (slot: Body).

gm.item.equip chainmail lord_1_1

Notes

NOTE: The system automatically detects the appropriate equipment slot based on item type.

NOTE: The item is equipped to the first appropriate slot. Weapons go to Weapon0, armor to appropriate armor slots.

TIP: Use gm.item.equip_slot for precise control over which slot to use.

Related Commands

• gm.item.unequip - Unequip specific item
• gm.item.equip_slot - Equip to specific slot

Last Updated: 2025-12-16