Item commands

cmd.buy_item

Buys an item from the shop.

Remarks

If an item that costs ACs is being bought, a confirmation dialog will appear.

Auto mode may not be flawless and have edge cases. Report any issues!

Parameter	Type	Optional	Default	Description
shopId	number			The shop id.
item	string | number			The name or item id of the item to buy.
quantity	number			The quantity of the item to buy.
auto	boolean	✓	false	If true, will try to buy any required items first (if available in the merge shop).

cmd.deposit

Puts an item into the bank.

Parameter	Type	Description
item	string | number | (string | number)[]	The item to deposit. If provided an array, each item will be deposited.

cmd.enhance_item

Enhances an item with the specified enhancement.

Parameter	Type	Description
itemName	string	The name of the item to enhance.
enhancementName	string	The enhancement type (Lucky, Fighter, Wizard, etc.) or “Forge”.
procName	string?	Optional. Awe proc (Spiral Carve) or Forge proc (Valiance, Vainglory, Anima).

// Basic enhancement
cmd.enhance_item("Void Highlord", "Lucky")

// Awe enhancement (weapon only) - base type + Awe proc
cmd.enhance_item("Weapon", "Lucky", "Spiral Carve")
cmd.enhance_item("Weapon", "Fighter", "Awe Blast")

// Forge enhancement - item type is deduced from item name
cmd.enhance_item("Necrotic Sword", "Forge") // base Forge
cmd.enhance_item("Necrotic Sword", "Forge", "Valiance") // weapon Forge proc
cmd.enhance_item("Cape", "Forge", "Vainglory") // cape Forge special
cmd.enhance_item("Helm", "Forge", "Anima") // helm Forge special

cmd.equip_item

Parameter	Type	Description
item	string

cmd.equip_item_by_enhancement

Equips an item using its enhancement name.

Parameter	Type	Description
enhancementName	string	The enhancement name (Lucky, Fighter, etc.) or “Forge” for proc matching.
procOrItemType	string?	If the enhancement name is “Forge”, this should be the proc name. Otherwise, this should be the item type (weapon, helm, cape) or Awe proc if applicable.

// 1. forge + proc name
cmd.equip_item_by_enhancement("Forge", "Arcana's Concerto")
cmd.equip_item_by_enhancement("Forge", "arcanas")
cmd.equip_item_by_enhancement("Forge", "Penitence")
cmd.equip_item_by_enhancement("Forge", "Anima")

// 2. basic + awe proc (weapon)
cmd.equip_item_by_enhancement("Lucky", "Spiral Carve")
cmd.equip_item_by_enhancement("Fighter", "Awe Blast")

// 3. basic + item type filter
cmd.equip_item_by_enhancement("Lucky", "Weapon")
cmd.equip_item_by_enhancement("Fighter", "Cape")

// 4. basic only (first match)
cmd.equip_item_by_enhancement("Fighter")
cmd.equip_item_by_enhancement("Lucky")

cmd.get_map_item

Parameter	Type	Description
item	string | number

cmd.load_shop

Loads a shop.

Parameter	Type	Description
shopId	number	The shop id to load.

cmd.pickup

Picks up an item from the drop list.

Parameter	Type	Description
item	string | number	The name or item id of the item to pick up.

cmd.register_boost

Registers a consumable boost to use when available.

Parameter	Type	Description
item	string	The name of the item boost to use.

cmd.register_drop

Registers an item to be automatically picked up when possible.

Parameter	Type	Description
items	string | string[]	The name or item id of the item(s) to pick up.

cmd.reject

Rejects an item from the drop list.

Parameter	Type	Description
item	string | number	The name or item id of the item to reject.

cmd.sell_item

Sells an item.

Parameter	Type	Description
item	string	The name of the item to sell.

cmd.swap

Swaps an item from the bank with an item from the inventory.

Parameter	Type	Description
bankItem	string | number	The name or item id of the item to swap from the bank.
invItem	string | number	The name or item id of the item to swap from the inventory.

cmd.unregister_boost

Unregisters a consumable boost.

Parameter	Type	Description
item	string	The name of the item boost to unregister.

cmd.unregister_drop

Unregisters an item from the drop list.

Parameter	Type	Description
items	string | string[]	The name or item id of the item(s) to unregister.

cmd.withdraw

Takes out an item from the bank.

Parameter	Type	Description
item	string | number | (string | number)[]	The item to withdraw. If provided an array, each item will be withdrawn.