Ash Functions

Function Syntax

buffer run_choice( int choice, boolean? automate_fights = true )

Run the current choice adventure by selecting a choice number.

• choice: the number of the choice option you wish to take. Use -1 to automate the rest of the choice using the current choice adventure preferences.
• automate_fights: If true and the choice resunts in a combat, KoLmafia will automate the fight. If false, KoLmafia will stop when the fight begins.

buffer run_choice( int choice, string url_params )

Run the current choice adventure by selecting a choice number and specifying additional URL parameters.

• choice: the number of the choice option you wish to take. Use -1 to automate the rest of the choice using the current choice adventure preferences.
• url_params: URL parameter string to append when submitting the choice request.

Proceeds to run a choice by selecting the provided choice number. If the provided number is -1, KoLmafia will use your current choice adventure preferences. This function returns the HTML of the choice result page (not just what is displayed, but all markup). This is most commonly used to finish up choices started via visit_url().

The second form (with the url_params parameter) can be used to automate fights that require additional URL parameters. For example, if you are in choice adventure #1182 and call run_choice(1, "piece=1936"), KoLmafia will send a request to the server using choice.php?option=1&pwd=<pwd_hash>&whichchoice=1182&piece=1936. You can specify multiple parameters separated by ampersands (&).

A handy use for this function is to finish up choices that were started in the relay browser, or were interrupted (i.e. mafia aborted for you to manually make a choice selection). Typing ashq run_choice(choice) into the gCLI will finish up the choice for you using your selected choice. Note that ashq is necessary rather than ash to avoid spewing the entire choice results page into the gCLI.

The second form was added in r19537.

Code Samples

This is a personalized version of adv1() that is capable of returning information about which adventure is encountered so that you can look for a specific choice adventure. If a choice is encountered, it selects the appropriate choice per your settings for that choice adventure, and assigns the results to the page_text variable. (Effectively the same as using run_choice(-1)). If a combat is encountered instead of a choice adventure, run_combat() is used.

ASH

JavaScript

1 int run_adv( location place ) { 2 string page_text = to_url( place ).visit_url(); 3 string choiceAdventure = "-1"; 4 matcher m_choice = create_matcher( "whichchoice value=(\\d+)", page_text ); 5 while ( page_text.contains_text( "choice.php" ) ) { 6 m_choice.reset( page_text ); 7 m_choice.find(); 8 choiceAdventure = m_choice.group( 1 ); 9 string choice_num = get_property( "choiceAdventure" + choiceAdventure ); 10 11 if ( choice_num == "0" ) abort( "Manual control for " + choiceAdventure ); 12 if ( choice_num == "" ) abort( "Unsupported choice adventure!" ); 13 14 page_text = run_choice( choice_num ); 15 } 16 if ( page_text.contains_text( "Combat" ) ) 17 run_combat(); 18 return choiceAdventure.to_int(); 19 }

1 const {abort, getProperty, toUrl, visitUrl} = require("kolmafia"); 2 3 function runAdv(place) { 4 const pageText = visitUrl(toUrl(place)); 5 let choiceAdventure = -1; 6 while (pageText.includes("choice.php")) { 7 let match = pageText.match(/whichchoice value=(\d+)/); 8 choiceAdventure = parseInt(match[1]); 9 let choiceNum = Number(getProperty("choiceAdventure" + choiceAdventure)); 10 11 if (choiceNum === 0) abort("Manual control for " + choiceAdventure); 12 if (Number.isNaN(choiceNum)) abort("Unsupported choice adventure!"); 13 14 pageText = runChoice(choiceNum); 15 } 16 if (pageText.includes("Combat")) 17 runCombat(); 18 return choiceAdventure; 19 }

CLI Equivalent

The CLI command choice works similarly.

See Also

adventure() | adv1() | visit_url() | run_combat() | run_turn()