View source for Adventuring

== Part 5 - Adventuring ==
<p><em>Go get &#8216;em, tiger!</em></p>

<p><strong>boolean adventure( int visits, [[%28ASHRM%29_Datatype_Constants#.24location.5Bconstant.5D|location place]] )</strong><br />
Visits the desired place the number of times that you wish.<br />
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_4:_Hedging|Hedging]]</p>

<p><strong>void add_item_condition( int quantity, [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Specifies adventuring conditions.  With conditions in place, adventure(&#8230;) will successfully complete before using all the specified adventures if the conditions are all met.<br />
See the [http://kolmafia.sourceforge.net/scripting.html CLI manual] for additional condition programming.</p>

<p><strong>void council()</strong><br />
Visits the Council of Loathing.</p>

<p><strong>item guardians()</strong><br />
Climbs the Naughty Sorceress&#8217; Tower and passes the challenges that it can.  If it completes the challenge, it returns $item[none].  Otherwise, it returns the item that is needed to pass the next stage.</p>

<p><strong>boolean guild()<br />
boolean gourd()<br />
int tavern()<br />
boolean nemesis()<br />
boolean entryway()<br />
boolean hedgemaze()<br />
boolean chamber()</strong><br />
Attempts to perform the associated tasks. The return value indicates the success.<br />
See the [http://kolmafia.sourceforge.net/scripting.html CLI manual] for more details.<br />
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_4:_Hedging|Hedging]]</p>

<p><strong>boolean train_familiar( int nGoal, string sGoal )</strong><br />
Trains your currently-equipped familiar.  sGoal can be either &#8220;base&#8221;, &#8220;buffed&#8221;, or &#8220;turns&#8221;, and nGoal is either the target weight or desired number of battles.</p>

<p><strong>location my_location()</strong><br />
Returns the location where you last adventured.  </p>

<p><strong>void refresh_status()</strong><br />
Grabs a fresh copy of your sidebar, so that information on your health, effects, and such will be guaranteed accurate.  In theory, this is not necessary unless you are attempting to script your own custom combat function.</p>

<p><strong>monster [int] get_monsters( [[%28ASHRM%29_Datatype_Constants#.24location.5Bconstant.5D|location place]] )</strong><br />
returns an integer indexed map of potential monsters in the given location.</p>

<p><strong>int monster_base_attack( [[%28ASHRM%29_Datatype_Constants#.24monster.5Bconstant.5D|monster eek]] )<br />
int monster_base_defense( [[%28ASHRM%29_Datatype_Constants#.24monster.5Bconstant.5D|monster eek]] )<br />
int monster_base_hp( [[%28ASHRM%29_Datatype_Constants#.24monster.5Bconstant.5D|monster eek]] )</strong><br />
Returns the stats for the given monster.  </p>

<p>spiceloop is a verified kolmafia ash function however the parameters and return type are speculation. This needs verified.<br />
<strong>void spiceloop( int count )</strong><br />
Executes kolmafia&#8217;s internal spiceloop for the specified number of adventures.</p>

<strong>element monster_attack_element( monster )</strong><br />
<strong>element monster_defense_element( monster )</strong><br />
Returns the given monsters attack element and element which it can defend against.