Item Management

Returns a map where each key is one of the required ingredients, with the integer value the number required. If you don't have the skills needed to make the item, it will return an empty map.

string craft_type( item )

Returns a string identifying how an item is crafted and any other requirements for creating it.

int [item] get_inventory()

Returns a map where each key is an item in your inventory, with the integer value its quantity.

int [item] get_related( item, string )

Returns associated items in a zap or fold group (see page for details).

You can categorize items in KoL using is_tradeable(), is_giftable(), and is_displayable().

boolean is_tradeable( item )

Returns whether the item can be placed in the mall.

boolean is_giftable( item )

Returns whether the item can be traded in a gift package.

boolean is_displayable( item )

Returns whether the item can be put in a display case (true for all but quest items).

boolean is_discardable( item )

Returns whether the item can be discarded or autosold.

boolean have_shop()

Returns whether you have a mall store.

boolean have_display()

Returns whether you have a display case.

boolean is_npc_item( item )

Returns whether the item can be bought from an NPC store.

void refresh_stash()

Takes a new look at the contents of your clan stash, as that section of inventory cannot be internally tracked due to access by others.

void refresh_shop()

Takes a new look at the contents of your mall store, as that section of inventory cannot be internally tracked due to access by others.

int shop_price( item )

Returns the current price for the given item if it is present in your mall store.

int npc_price( item )

Returns the current price of the given item if it can currently be bought from an NPC store.

int autosell_price( item )

Returns the autosell price of the item (0 for items that cannot be autosold).

int get_power( item )

Returns the power of the item (0 for items that don't have a power).

string to_plural( item )

Returns the plural of an item as a string.

int meat_drop( [monster] )

Returns a certain monster's base meat drop.

int [item] item_drops( [monster] )

Returns an array of a certain monster's base item drops, keying item to drop rate. Has certain limitations detailed on individual page.

record [int] item_drops_array( [monster] )

Returns an array of records holding information regarding a certain monster's base item drops.

Mall Prices

float historical_age( item )

Returns the age of the price returned by historical_age() in days.

int historical_price( item )

Returns the most recently seen mall price of an item without making a server request.

int mall_price( item )

Returns the current (lowest) mall price of an item.

int mall_prices( string, string? )

Updates the mall price for a category of items, and returns the number of items searched.

int mall_prices( boolean [item] )

Updates the mall price for a set of items, and returns the number of items searched.

Moving Items Around

boolean empty_closet()

Remove every item from the closet in a single server hit.

boolean put_closet( int, [item] )

boolean put_display( int, item )

boolean put_stash( int, item )

boolean take_closet( int, [item] )

boolean take_display( int, item )

boolean take_stash( int, item )

boolean take_storage( int, item )

Attempts to take or put the specified item in the appropriate section of your inventory, and returns its success.
If the item parameter is omitted from put_closet() or take_closet(), meat is transferred instead of an item.

boolean put_shop( int, int, [int], item )

boolean take_shop( [int], item )

Adds or removes items in your store and returns success.

Acquiring & Using Items

boolean autosell( int, item )

Attempts to autosell the given items and reports success.

boolean buy( [coinmaster], int, item )

int buy( int, item, int )

Tries to purchase the specified items.

boolean buy_using_storage( int, item )

int buy_using_storage( int, item, int )

Tries to purchase the specified items using meat in Hangks.

boolean create( int, item )

Attempts to create the specified items, following your KoLmafia settings regarding purchases to gather ingredients & require boxen.

boolean drink( int, item )

Attempts to drink items as specified and reports success.

boolean eat( int, item )

Attempts to eat items as specified and reports success.

boolean eatsilent( int, item )

Attempts to eat items as specified.

boolean chew( int, item )

Attempts to chew spleen items as specified and reports success.

boolean hermit( int, item )

Trades worthless items (buying and using chewing gum if needed) to the hermit for specified items (see page for details).

boolean use( int, item )

Attempts to use items as specified and reports success.

boolean overdrink( int, item )

boolean overdrink( item, int? )

Attempts to drink a given number of item(s), suppressing overdrinking warnings.

boolean retrieve_item( int, item )

Uses KoLmafia internal logic to gather items (see page for details).

int craft( string, int, item, item )

Raw crafting that obeys KoLmafia settings (see page for details).

string last_item_message()

Returns message that KoL reports in the event of error.

Coinmaster Control

Some items can be bought from or sold to various "coinmasters" which are like shops that deal in a currency other than meat. These coinmasters include the Dimemaster and Quartermaster during the Island War, the Hermit, the Mr. Store and many others. Some relevant information can be found in proxy records for the item and coinmaster data types. The rest is controlled by the following functions.