Adv1

2026-01-19T13:21:00Z

Cure8:

{{
#vardefine:name|adv1}}{{
#vardefine:return_type|boolean}}{{

FunctionPage|
name={{#var:name}}|

function1={{Function|
name={{#var:name}}|
aggregate={{#var:aggregate}}|
return_type={{#var:return_type}}|
return_also={{#var:return_also}}|
parameter1={{Param|location|place}}|
parameter2={{Param|int|turnsUsed}}|
parameter3={{Param|string|filterFunc}}|
p1desc={{Pspan|place}} is the adventuring location.|
p2desc={{Pspan|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.|
p3desc={{Pspan|filterFunc}} is a macro or 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.}}|

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

If {{Pspan|filter}} contains a semicolon it will use {{Pspan|filter}} as a macro.
This function returns <code>true</code> if KoLmafia adventured successfully. It will return <code>false</code> if it cannot adventure for any reason:

* Not enough adventures
* Location is unavailable
* You are falling-down drunk
* If the adventure was successful, but KoLmafia was put into a PENDING state. This indicates that we might be done adventuring in this location, and usually occurs because we successfully finished a quest-related action in that zone.


|code1={{CodeSample|
title=Code Sample|
description=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.|
code=
<syntaxhighlight>
adv1($location[slime tube], -1, "");
</syntaxhighlight>}}|

see_also={{SeeAlso|adventure|run_combat|run_choice}}|
cli_equiv=None - "adv" will always try adventuring again if an adventure took no turns. However, a slightly awkward workaround can be employed using the gCLI command [[ash_(CLI)|ash]], though it's not exactly the same result due to that command's printing of return values.|
}}

[[Category:Adventuring]]

Kolmafia - User contributions [en]

Adv1