Help:Frequently Asked Questions

Running Mafia

What / where are daily builds?

Daily builds are revisions of KoLMafia that are released for testing new features and/or bugfixes. They can be found at http://builds.kolmafia.us/.

I found a bug! What should I do?

Please double-check for user-error first. (No offense intended, but it happens a lot.) If you're fairly sure that you have a "real" bug (reproducible, describable, and undesired), please post it in the Bug Report Forum. Make sure to list which version of KoLmafia you are using (which you can see by selecting the Help (menu) -> Copyright Notice). Also, list the operating system you are using, and a description of what to do to reproduce the bug, and any other helpful information.

How can I synchronize Mafia across multiple computers using the same counters, scripts, builds, etc?

The two most popular methods are to run it from a flash drive or use Dropbox. Please see our page about Dropbox.

Interface

How do I re-apply stickers?

Go to the Gear Changer tab in the main interface. See those bottom three dropdown menus?

How do I get mafia to reapply stickers automatically when they wear out?

Put it in your mood as described below. You can change the stickers command to indicate whichever stickers you want to keep active.

Trigger On: Unconditional trigger

Check For:

Command: stickers unicorn, unicorn, unicorn

Can I get Mafia to do something other than abort when my sugar equipment breaks?

Go to the Adventure tab in the main interface. At the bottom are some more tabs. Click on the Choice Advs tab. Now click on the Item tab on the left hand side. Change the Breakable Equipment setting as desired.

Is there a way to get mafia to stop auto-adventuring when a counter expires?

Mafia will stop automating on most counters. Note that purely informational counters like he-boulder rays and hippy windchimes will not stop automation.

Is there a way to get mafia to stop auto-adventuring when a hobo code or demon name is found?

KoLmafia auto-stops on these adventures whenever you do not have any conditions set. Just adventure in the zone without conditions and those hobo codes or demon names become your condition. Easy-peasy.

Scripts

How do I run an ASH script?

Download the ASH file to your /scripts directory. Either start mafia, or in the scripts menu at the top of the interface, click "refresh menu". Then select the script from the scripts menu.

How do I edit/create an ASH script?

Use a nonformatting text editor such as Notepad++ -- word processors like Microsoft Word will not work. When finished, save the file with the extension *.ash.

Where are these mafia directories to which I need to download scripts. They've names like /scripts and /data .

This varies depending on your operating system. Look for your system at mafia directories.

Help, my script aborts whenever [some function] returns false!

By default, whenever an ASH function returns false, everything will abort unless you somehow capture the return value (i.e. assigning it to a variable or enclosing it in a control structure). So, if you want to make use of, say, the hermit() function in a way that won't abort if the function returns false, you could:

Save the result as a boolean variable.

boolean fakeBool = hermit(1, $item[Ten-leaf clover]);

Capture the result in an if() conditional.

if(!hermit(1, $item[Ten-leaf clover])) print("Hermit looting failed: continuing on.");

An if() conditional doesn't even have to do anything.

if(hermit(1, $item[Ten-leaf clover])) {}

The most minimalistic method is to capture it with a not operator and parenthesis.

(!hermit(1, $item[Ten-leaf clover]));

I downloaded a script, but when I try to run it, it tells me that a function is undefined.

This almost always means that the script makes use of newer ASH functions that are not available in the version you're using. See the link for daily builds above, and grab a newer version.