Difference between revisions of "Item Management"

From Kolmafia
Jump to navigation Jump to search
imported>StDoodle
m
imported>StDoodle
Line 25: Line 25:
 
{{Flink|boolean|put_closet|int|desc=Attempts to move meat from on-hand to your closet and reports success.}}
 
{{Flink|boolean|put_closet|int|desc=Attempts to move meat from on-hand to your closet and reports success.}}
 
{{Flink|boolean|put_shop|int|int|{{opt|int}}|item|desc=Puts items in your store (see page for details).}}
 
{{Flink|boolean|put_shop|int|int|{{opt|int}}|item|desc=Puts items in your store (see page for details).}}
{{Flink|boolean|buy|int|item|desc=Attempts to buy the specified item, checking NPC stores first, then mall if available, and reports success.}}
+
{{Flink|boolean|buy|int|item}}
{{Flink|int|buy|int|item|int|desc=Tries to buy the given amount of items at or below your specified price, and returns the number purchased.}}
+
{{Flink|int|buy|int|item|int|desc=Tries to purchase the specified items (see page for details).}}
'''boolean [[buy()|buy( int quantity, item it )]]''' - tries to buy the specified [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|items]].  First preference is given to NPC stores that you have access to and then, if possible, will buy the cheapest available items from the mall.  When passing 0 or a negative number to the buy function, KoLmafia does nothing and automatically returns true.<br />
+
{{Flink|boolean|autosell|int|item|desc=Attempts to autosell the given items and reports success.}}
'''int [[buy()|buy( int quantity, item it, int price_limit )]]''' - tries to buy the specified number of [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|items]] at or below the specified price.  Returns the number of items successfully purchased, which may be 0 if your limit is too low.
+
{{Flink|int|autosell_price|item|desc=Returns the autosell price of the item, or a negative value if it cannot be autosold.}}
 
+
{{Flink|boolean|mall_price|item|desc=Returns the current (lowest) mall price of the given item.}}
'''boolean [[autosell()|autosell( int quantity, item it )]]''' - autosells the given [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|items]].
+
{{Flink|boolean|retrieve_item|int|item|desc=Uses KoLmafia internal logic to gather items (see page for details).}}
 
+
{{Flink|boolean|hermit|int|item|desc=Trades worthless items (adventuring in the sewer if needed) to the hermit for specified items (see page for details).}}
'''int [[autosell_price()|autosell_price( item it )]]''' - returns the autosell price of the [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|item]].  Non-discardable items return a negative value.
+
{{Flink|boolean|use|int|item|desc=Attempts to use items as specified and reports success.}}
 
+
{{Flink|boolean|eat|int|item|desc=Attempts to eat items as specified and reports success.}}
'''boolean [[mall_price()|mall_price( item it )]]''' - returns the current mall price of the given [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|item]].
+
{{Flink|boolean|drink|int|item|desc=Attempts to drink items as specified and reports success.}}
 
+
{{Flink|boolean|create|int|item|desc=Attempts to create the specified items, following your KoLmafia settings regarding purchases to gather ingredients & require boxen.}}
'''boolean [[retrieve_item()|retrieve_item( int quantity, item it )]]''' - uses KoLmafia internal logic to gather the [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|items]] in the least destructive manner. See the &#8220;acquire&#8221; documentation in [http://kolmafia.sourceforge.net/scripting.html the CLI manual] for more details.
+
{{Flink|int|creatable_amount|item|desc=Returns the amount of the item that you are capable of creating given your current inventory and skills.}}
 
+
{{Flink|int [item]|get_ingredients|item|desc=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.}}
'''boolean [[hermit()|hermit( int quantity, item it )]]'''<br />
+
{{Flink|int [item]|get_related|item|string|desc=Returns associated items in a zap or fold group (see page for details).}}
Buys the appropriate number of the given [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|item]] from the Hermit, buying hermit permits and adventuring in the sewer for more worthless items if necessary.
+
{{Flink|void|refresh_stash|desc=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.}}
 
+
{{Flink|boolean|is_tradeable|item|desc=Returns whether the item can be placed in the mall.}}
'''boolean [[use()|use( int quantity, item it )]]'''<br />
+
{{Flink|boolean|is_giftable|item|desc=Returns whether the item can be traded in a gift package.}}
'''boolean [[eat()|eat( int quantity, item it )]]'''<br />
+
{{Flink|boolean|is_displayable|item|desc=Returns whether the item can be put in a display case (true for all but quest items).}}
'''boolean [[drink()|drink( int quantity, item it )]]'''<br />
+
{{Flink|boolean|is_npc_item|item|desc=Returns whether the item can be bought from an NPC store.}}
Consumes the given [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|items]].  These are not interchangeable - food must be consumed with eat(), booze with drink(), and non-foods with use().
 
 
 
'''boolean [[create()|create( int quantity, item it )]]''' - attempts to create the specified [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|items]].  Depending on your in-game settings and conditions, this may involve buying ingredients for the items or servants to create the items for you.
 
 
 
'''int [[creatable_amount()|creatable_amount( item it )]]''' - returns the amount of the [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|item]] that you are capable of creating with your current inventory and skills.
 
 
 
'''int [item] [[get_ingredients()|get_ingredients( item it )]]''' - returns a map where each item key is a known ingredient and each int value is the number of that ingredient required. If you do not have the relevant skill to create the item from the ingredients, returns an empty map.
 
 
 
'''int [item] [[get_related|get_related( item it , string type )]]''' - type can be either "zap" or "fold". "zap" returns the zap group that the item is part of. The integer values in the map are meaningless in this case, and the item itself isn't included. "fold" returns the fold group that the item is part of. The integer is the position in the fold sequence (1..N), and the item itself IS included, so you can determine its position. Retrieves some variable-length internal data that isn't readily readable via file_to_map().
 
 
 
'''void [[refresh_stash()]]''' - takes a new look at the contents of your clan stash. Crucial if your clanmates have been manipulating the contents during your session.
 
 
 
'''boolean [[is_tradeable|is_tradeable( item it )]]''' - returns true if the item can be placed in the mall
 
 
 
'''boolean [[is_giftable|is_giftable( item it )]]''' - returns true for tradeable items and gift items like stuffies
 
 
 
'''boolean [[is_displayable|is_displayable( item it )]]''' - returns true for all items that can be put in a display case (all items but quest items)
 
 
 
'''boolean [[is_npc_item|is_npc_item( item it )]]''' - returns true for all items that can be bought from an NPC store
 

Revision as of 23:53, 2 March 2010

int my_meat()

Returns the amount of meat you have on hand.

int my_closet_meat()

Returns the amount of meat you have in your Colossal Closet.

int pulls_remaining()

Returns the number of pulls you can make from storage, or 0 if not applicable.

boolean have_chef()

Returns true if you have a chef-boxen at your campground.

boolean have_bartender()

Returns true if you have a bartender-boxen at your campground.

int [item] get_campground()

Returns a map of your campground items.

boolean have_mushroom_plot()

Returns true if and only if you've purchased a mushroom plot this run.

int stills_available()

Returns the number of Nash Crosby's Still uses left for the day (0 if not accessible).

int item_amount( item )

int closet_amount( item )

int display_amount( item )

int equipped_amount( item )

int shop_amount( item )

int stash_amount( item )

int storage_amount( item )

These 7 functions return the total number available of a given item in the respective section of your inventory.

int available_amount( item )

Returns the total number available of a given item in all inventory sections accessible to your character based on current restrictions.

boolean take_storage( int, item )

boolean take_closet( int, item )

boolean take_stash( int, item )

boolean take_display( int, item )

boolean put_coset( int, item )

boolean put_stash( int, item )

boolean put_display( int, item )

Attempts to take or put the specified item in the appropriate section of your inventory, and returns its success.

boolean take_closet( int )

Attempts to move meat from your closet to on-hand and reports success.

boolean put_closet( int )

Attempts to move meat from on-hand to your closet and reports success.

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

Puts items in your store (see page for details).

boolean buy( int, item )

int buy( int, item, int )

Tries to purchase the specified items (see page for details).

boolean autosell( int, item )

Attempts to autosell the given items and reports success.

int autosell_price( item )

Returns the autosell price of the item, or a negative value if it cannot be autosold.

boolean mall_price( item )

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

boolean retrieve_item( int, item )

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

boolean hermit( int, item )

Trades worthless items (adventuring in the sewer 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 eat( int, item )

Attempts to eat items as specified and reports success.

boolean drink( int, item )

Attempts to drink items as specified and reports success.

boolean create( int, item )

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

int creatable_amount( item )

Returns the amount of the item that you are capable of creating given your current inventory and skills.

int [item] get_ingredients( item )

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.

int [item] get_related( item, string )

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

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.

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_npc_item( item )

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