Adv1: Difference between revisions

From Kolmafia
Jump to navigation Jump to search
imported>StDoodle
mNo edit summary
imported>Bale
mNo edit summary
Line 5: Line 5:
FunctionPage|
FunctionPage|
name={{#var:name}}|
name={{#var:name}}|
function_category=Adventuring|


function1={{Function|
function1={{Function|
Line 34: Line 33:
cli_equiv=None - "adv" will always try adventuring again if an adventure took no turns.|
cli_equiv=None - "adv" will always try adventuring again if an adventure took no turns.|
}}
}}
[[Category:Adventuring]]

Revision as of 22:17, 21 May 2010

Function Syntax

boolean adv1(location place ,int turnsUsed ,string filterFunc )

  • place is the adventuring location.
  • turnsUsed overrides the normal number of adventures that are expected to be consumed at this location, or -1 can be passed to use the default. Specifically, 0 will prevent any counters from triggering - of course, if an adventure actually is consumed, any counters that you kept from triggering will be lost.
  • filterFunc is the name of a combat filter function defined elsewhere in your script, with the same behavior as in the 3-paramater version of adventure(). An empty string can be passed to use your battle action or CCS as normal.

This will adventure exactly once in the specified place (even if it took no turns), although it will follow chained choice adventures for as long as you have preset options.

This function does not have to make use of its return value, but if you wish to do so, it will return true if all adventures were used, and false if it is unable to do so for any reason (not enough adventures, location unavailable, etc.).

Code Sample

Adventures 1 time at the Slime Tube. If an adventure takes no turns, possibly because the Gall Bladder was already squeezed, that adventure will still count. Counters will trigger as normal.

adv1($location[slime tube], -1, "");

CLI Equivalent

None - "adv" will always try adventuring again if an adventure took no turns.

See Also

adventure()