Retrieve item

needs(code_samples);

Function Syntax

boolean retrieve_item(int qty ,item get )

• qty is the quantity to acquire
• get is the item to acquire

Uses KoLmafia's internal logic to gather the items in the least destructive manner. Returns true if items are acquired as specified and false if not.

CLI Equivalent

The CLI command "acquire" works similarly.

See Also

buy()

Special

Unlike a few other ASH commands, retrieve_item() will still return false on attempts to acquire items that are not possible to get (such as a sparkly engagement ring).

Order of operations

This is the current order in which retrieval options are tried, as of about r8200. Note that this is an extremely condensed summary of several hundred lines of internal code, and that the details are subject to change

• items already in inventory
• items currently equipped
• items equipped on a non-current familiar
• retrieval of worthless items by using 31337 scrolls or sewering
• untinkering a dictionary to get the bridge
• items in closet, if enabled
• free pulls from Hagnk's
• items in storage, if no longer under ronin/HC restrictions (note that all of the item is pulled, not just the amount requested)
• items in the clan stash, if enabled
• item creation, up to the quantity creatable from ingredients on hand (this can be overriden by a buyScript)
• trading worthless items to the Hermit
• trading yeti furs to the Tr4pz0r
• NPC purchase (if enabled), or Mall purchase (if enabled, and no ingredients on hand)
• budgeted pulls from storage
• item creation, unless buying the item is enabled and appears to be cheaper than the cost of acquiring all the ingredients
• one final attempt at Mall purchase, if enabled and everything else has failed

Attention KoLmafia Experts!

We need your help; some details of this function's operation are unknown or unclear.

The following specific question has been raised:

• Are there exceptions to the info listed under Special?