KoLmafia Properties
Inside your KoLmafia "settings" directory, you should find several files. KoLmafia properties are stored in the files that end with "_prefs.txt". One of these files will start with "GLOBAL"; the settings inside are shared by all characters using the program (and some of these properties are needed by KoLmafia even when no character is logged in). The other files ending with "_prefs.txt" will start with the name of a character, one for each who has been logged in to date. (Note: the names will all be converted to lowercase.)
Choice Adventures
A large number of the preferences saved by KoLmafia are used to determine the default behavior when a choice adventure is automated (either through auto-adventuring or use of the "auto" button in the relay browser). The number of choice adventures in KoL is too large and too often updated to list each individual preference here. Please consult the main wiki's Choice Adventures by Number page for a comprehensive list. Note that each preference follows the same numbering scheme as KoL itself. For example, the adventure "Minnesota Incorporeals" is number 77 in KoL, and its KoLmafia preference is "choiceAdventure77".
Each choiceAdventure is set to a number, which corresponds to which choice you want to make from the available options in KoL (or in the GUI, in the case that mafia provides more options than KoL). According to Holatuwol (here), the settings map to "X=pick the Xth Option" and "X+1=pick an item you don't have" (i.e., complete the outfit). Many preferences also have a "Show in [Mini] Browser" option, which corresponds to a setting of 0.
This is a list of all the Property variables included in KoLmafia. It was automatically generated from r7582. Note that, however, the latest (and most up-to-date) data is located in Mafia's internally-stored datafile defaults.txt (available for viewing at the SourceForge page).
Global Variables
| Variable Name | Default Value | Notes |
|---|---|---|
| addChatCommandLine | false | |
| addCreationQueue | true | |
| addStatusBarToFrames | false | |
| allowCloseableDesktopTabs | false | |
| allowNegativeTally | true | |
| allowNonMoodBurning | true | |
| alwaysGetBreakfast | false | |
| autoLogin | ||
| allowSocketTimeout | true | |
| autoHighlightOnFocus | true | |
| autoPlantHardcore | false | |
| autoPlantSoftcore | false | |
| autoSatisfyWithCloset | true | |
| autoSatisfyWithMall | true | |
| autoSatisfyWithNPCs | true | |
| autoSatisfyWithStash | false | |
| breakfastHardcore | Advanced Saucecrafting,Pastamastery,Advanced Cocktailcrafting | |
| breakfastSoftcore | Advanced Saucecrafting,Pastamastery,Advanced Cocktailcrafting | |
| browserBookmarks | ||
| cacheMallSearches | false | |
| charsheetDropdown | 1 | |
| chatFontSize | ||
| chatLinksUseRelay | false | |
| chatStyle | 0 | |
| cloverProtectActive | true | |
| combatHotkey0 | ||
| combatHotkey1 | ||
| combatHotkey2 | ||
| combatHotkey3 | ||
| combatHotkey4 | ||
| combatHotkey5 | ||
| combatHotkey6 | ||
| combatHotkey7 | ||
| combatHotkey8 | ||
| combatHotkey9 | ||
| commandLineNamespace | ||
| connectViaAddress | false | |
| cookies.inventory | ||
| copyAsHTML | false | |
| createHackerSummons | true | |
| customizedTabs | false | |
| debugPathnames | true | |
| defaultBorderColor | blue | |
| defaultDropdown1 | 0 | |
| defaultDropdown2 | 1 | |
| defaultDropdownSplit | 0 | |
| defaultLimit | 5 | |
| defaultLoginServer | 1 | |
| displayName | ||
| eSoluScriptType | 0 | |
| getBreakfast | ||
| grabCloversHardcore | false | |
| grabCloversSoftcore | true | |
| greenScreenProtection | false | |
| grimoireSkillsHardcore | none | |
| grimoireSkillsSoftcore | Summon Hilarious Objects | |
| guiUsesOneWindow | false | |
| hideServerDebugText | false | |
| highlightList | ||
| http.proxyHost | ||
| http.proxyPassword | ||
| http.proxyPort | ||
| http.proxyUser | ||
| initialDesktop | AdventureFrame,CommandDisplayFrame,MallSearchFrame,GearChangeFrame,SkillBuffFrame | |
| initialFrames | RecentEventsFrame | |
| innerChatColor | #ffa98c | |
| innerTabColor | #8ca9ff | |
| itemManagerIndex | 0 | |
| lastBuffRequestType | 0 | |
| lastRelayUpdate | ||
| lastRssUpdate | 0 | |
| lastRssVersion | ||
| lastUserAgent | ||
| lastUsername | ||
| libramSkillsHardcore | none | |
| libramSkillsSoftcore | none | |
| logAcquiredItems | true | |
| logBattleAction | true | |
| logBrowserInteractions | false | |
| logChatMessages | true | |
| logDecoratedResponses | false | |
| logFamiliarActions | false | |
| logGainMessages | true | |
| logReadableHTML | false | |
| loginRecoveryHardcore | false | |
| loginRecoverySoftcore | true | |
| loginScript | ||
| loginServerName | ||
| loginWindowLogo | lantern.jpg | |
| logMonsterHealth | false | |
| logoutScript | ||
| logReverseOrder | false | |
| logStatGains | true | |
| logStatusEffects | false | |
| logStatusOnLogin | false | |
| mementoListActive | false | |
| mergeHobopolisChat | false | |
| outerChatColor | #b4460f | |
| outerTabColor | #0f46b4 | |
| pathedSummonsHardcore | true | |
| pathedSummonsSoftcore | false | |
| preferredWebBrowser | ||
| previousNotifyList | <> | |
| previousUpdateVersion | ||
| protectAgainstOverdrink | true | |
| proxySet | false | |
| readManualHardcore | true | |
| readManualSoftcore | true | |
| relayAddsCustomCombat | true | |
| relayAddsGraphicalCLI | false | |
| relayAddsKoLSimulator | false | |
| relayAddsQuickScripts | false | |
| relayAddsRestoreLinks | true | |
| relayAddsRoundNumber | false | |
| relayAddsUpArrowLinks | true | |
| relayAddsUseLinks | true | |
| relayAddsWikiLinks | false | |
| relayAllowsOverrides | false | |
| relayBrowserOnly | false | |
| relayBrowserOnly | false | |
| relayFormatsChatText | true | |
| relayHidesJunkMallItems | true | |
| relayMaintainsEffects | false | |
| relayMaintainsHealth | true | |
| relayMaintainsMana | false | |
| relayTextualizesEffects | false | |
| relayTrimsZapList | true | |
| relayUsesCachedImages | false | |
| relayUsesInlineLinks | false | |
| relayUsesIntegratedChat | false | |
| relayViewsCustomItems | false | |
| removeMalignantEffects | true | |
| saveSettingsOnSet | true | |
| saveState | ||
| saveStateActive | ||
| scriptButtonPosition | 0 | |
| scriptList | restore mp | |
| showAllRequests | false | |
| stealthLogin | true | |
| swingLookAndFeel | ||
| switchEquipmentForBuffs | true | |
| tomeSkillsHardcore | Summon Snowcone | |
| tomeSkillsSoftcore | Summon Snowcone | |
| toolbarPosition | 1 | |
| useChatMonitor | false | |
| useChatToolbar | true | |
| useContactsFrame | true | |
| useCrimboToysHardcore | false | |
| useCrimboToysSoftcore | true | |
| useDecoratedTabs | ||
| useLastUserAgent | false | |
| useSeparateChannels | true | |
| useShinyTabbedChat | true | |
| useSystemTrayIcon | false | |
| useTabbedChatFrame | true | |
| useToolbars | true | |
| useZoneComboBox | false | |
| userAgent | ||
| visitLoungeHardcore | true | |
| visitLoungeSoftcore | true | |
| visitRumpusHardcore | true | |
| visitRumpusSoftcore | true |
Per-Account Variables
Choice adventure preferences have been omitted (see above).
| Variable Name | Default Value | Notes |
|---|---|---|
| autoAbortThreshold | -0.05 | Abort adventuring at this percentage of HP. (-0.05 means if HP restoration failed) |
| autoAntidote | 0 | Use antidotes in combat |
| autoBuyPriceLimit | 20000 | Don't auto purchase anything that costs more than this |
| autoEntangle | false | Use Entangling Noodles at the beginning of combat |
| autoManaRestore | true | Restore MP in combat |
| autoOlfact | Automatically cast Olfaction | |
| autoPotionID | false | Attempt to ID ! potions in combat |
| autoPutty | Automatically use Spooky Putty | |
| autoRepairBoxServants | true | Create in-a-boxen before cooking or mixing |
| autoSphereID | false | Attempt to ID spheres from the Hidden City |
| autoSteal | true | Attempt to pickpocket in combat |
| autostartGalaktikQuest | true | Get Doc Galaktik's Quest at the start of ascension |
| availableDimes | 0 | |
| availableLucre | 0 | |
| availableQuarters | 0 | |
| availableSandDollars | 0 | |
| barrelGoal | 1 | |
| barrelLayout | ????????? | |
| basementMallPrices | 1 | |
| battleAction | attack with weapon | |
| betweenBattleScript | ||
| birdformCold | 0 | |
| birdformHot | 0 | |
| birdformRoc | 0 | |
| birdformSleaze | 0 | |
| birdformSpooky | 0 | |
| birdformStench | 0 | |
| blackPuddingsDefeated | 0 | |
| breakfastCompleted | false | |
| buffBotCasting | ||
| buffBotMessageDisposal | 0 | |
| buffBotPhilanthropyType | 1 | |
| burrowgrubHiveUsed | false | |
| burrowgrubSummonsRemaining | 0 | |
| buyScript | ||
| cameraMonster | ||
| cellarLayout | 0 | |
| chatbotScript | ||
| chatbotScriptExecuted | false | |
| chosenTrip | ||
| clanAttacksEnabled | false | |
| cocktailSummons | 0 | |
| concertVisited | false | |
| currentBountyItem | 0 | |
| currentFullness | 0 | |
| currentHippyStore | none | |
| currentJunkyardTool | ||
| currentJunkyardLocation | ||
| currentMojoFilters | 0 | |
| currentMood | default | |
| currentNunneryMeat | 0 | |
| currentPvpVictories | ||
| currentSpleenUse | 0 | |
| currentWheelPosition | muscle | |
| customCombatScript | default | |
| dailyDungeonDone | false | |
| defaultAutoAttack | 0 | |
| defaultFlowerLossMessage | ||
| defaultFlowerWinMessage | ||
| demonName1 | ||
| demonName2 | ||
| demonName3 | ||
| demonName4 | ||
| demonName5 | ||
| demonName6 | Tatter | |
| demonName7 | Ak'gyxoth | |
| demonSummoned | false | |
| expressCardUsed | false | |
| extraRolloverAdventures | 0 | |
| flyeredML | 0 | |
| fratboysDefeated | 0 | |
| friarsBlessingReceived | false | |
| gongPath | 0 | |
| gourdItemCount | 5 | |
| grimoire1Summons | 0 | |
| grimoire2Summons | 0 | |
| guardTurtlesFreed | 0 | Number of times that guard turtles have been freed this ascension. |
| guyMadeOfBeesCount | 0 | |
| guyMadeOfBeesDefeated | false | |
| hiddenCityLayout | 0000000000000000000000000 | |
| hiddenCitySquare | 0 | |
| hippiesDefeated | 0 | |
| hpAutoRecovery | -0.05 | |
| hpAutoRecoveryItems | cannelloni cocoon;scroll of drastic healing;tongue of the walrus;lasagna bandages;doc galaktik's ailment ointment | |
| hpAutoRecoveryTarget | 1.0 | |
| invalidBuffMessage | You sent an amount which does not correspond to a valid buff amount. | |
| kingLiberated | false | |
| knownAscensions | -1 | |
| lastAdventure | ||
| lastBarrelSmashed | 0 | |
| lastBangPotion819 | ||
| lastBangPotion820 | ||
| lastBangPotion821 | ||
| lastBangPotion822 | ||
| lastBangPotion823 | ||
| lastBangPotion824 | ||
| lastBangPotion825 | ||
| lastBangPotion826 | ||
| lastBangPotion827 | ||
| lastBangPotionReset | -1 | |
| lastBarrelSmashed | 0 | |
| lastBattlefieldReset | -1 | |
| lastBreakfast | -1 | |
| lastCellarReset | -1 | |
| lastCouncilVisit | 0 | |
| lastCounterDay | -1 | |
| lastDustyBottle2271 | ||
| lastDustyBottle2272 | ||
| lastDustyBottle2273 | ||
| lastDustyBottle2274 | ||
| lastDustyBottle2275 | ||
| lastDustyBottle2276 | ||
| lastDustyBottleReset | -1 | |
| lastDwarfDiceRolls | ||
| lastDwarfDigitRunes | ------- | |
| lastDwarfEquipmentRunes | ||
| lastDwarfFactoryItem118 | ||
| lastDwarfFactoryItem119 | ||
| lastDwarfFactoryItem120 | ||
| lastDwarfFactoryItem360 | ||
| lastDwarfFactoryItem361 | ||
| lastDwarfFactoryItem362 | ||
| lastDwarfFactoryItem363 | ||
| lastDwarfFactoryItem364 | ||
| lastDwarfFactoryItem365 | ||
| lastDwarfFactoryItem910 | ||
| lastDwarfFactoryItem3199 | ||
| lastDwarfOfficeItem3208 | ||
| lastDwarfOfficeItem3209 | ||
| lastDwarfOfficeItem3210 | ||
| lastDwarfOfficeItem3211 | ||
| lastDwarfOfficeItem3212 | ||
| lastDwarfOfficeItem3213 | ||
| lastDwarfOfficeItem3214 | ||
| lastDwarfOreRunes | ||
| lastDwarfFactoryReset | -1 | |
| lastDwarfHopper1 | ||
| lastDwarfHopper2 | ||
| lastDwarfHopper3 | ||
| lastDwarfHopper4 | ||
| lastEVHelmetValue | 0 | |
| lastEVHelmetReset | -1 | |
| lastEmptiedStorage | -1 | Numer of the last ascension that Hangk's storage was emptied. |
| lastFilthClearance | -1 | |
| lastGalleryUnlock | -1 | |
| lastGuildStoreOpen | -1 | |
| lastGuyMadeOfBeesReset | -1 | |
| lastHiddenCityAscension | 0 | |
| lastFratboyCall | -1 | |
| lastHippyCall | -1 | |
| lastKingLiberation | -1 | |
| lastLouvreMap | 0 | |
| lastMessageId | ||
| lastMiningReset | -1 | |
| lastPaperStripReset | -1 | |
| lastPaperStrip3144 | ||
| lastPaperStrip4138 | ||
| lastPaperStrip4139 | ||
| lastPaperStrip4140 | ||
| lastPaperStrip4141 | ||
| lastPaperStrip4142 | ||
| lastPaperStrip4143 | ||
| lastPaperStrip4144 | ||
| lastPastamancerGhostReset | -1 | |
| lastPirateEphemera | ||
| lastPirateEphemeraReset | -1 | |
| lastPirateInsult1 | false | |
| lastPirateInsult2 | false | |
| lastPirateInsult3 | false | |
| lastPirateInsult4 | false | |
| lastPirateInsult5 | false | |
| lastPirateInsult6 | false | |
| lastPirateInsult7 | false | |
| lastPirateInsult8 | false | |
| lastPirateInsultReset | -1 | |
| lastPyramidReset | -1 | |
| lastQuartetAscension | -1 | |
| lastQuartetRequest | 0 | |
| lastSecondFloorUnlock | -1 | |
| lastSemirareReset | -1 | |
| lastStoneSphere2174 | ||
| lastStoneSphere2175 | ||
| lastStoneSphere2176 | ||
| lastStoneSphere2177 | ||
| lastStoneSphereReset | -1 | |
| lastTavernAscension | 0 | |
| lastTavernSquare | 0 | |
| lastTelescopeReset | -1 | |
| lastTowerClimb | -1 | |
| lastVioletFogMap | 0 | |
| lastZapperWand | 0 | |
| libramSummons | 0 | |
| libraryCardUsed | false | |
| louvreDesiredGoal | 7 | |
| louvreGoal | 0 | |
| louvreLayout | ||
| louvreOverride | ||
| luckySewerAdventure | stolen accordion | |
| manaBurnSummonThreshold | 10 | |
| manaBurningThreshold | -0.05 | |
| mayflyExperience | 0 | Uses of mayfly bait necklace. Reset each ascension. |
| mineLayout1 | ||
| mineLayout2 | ||
| mineLayout3 | ||
| moleTunnelLevel | 0 | |
| mpAutoRecovery | 0.0 | |
| mpAutoRecoveryItems | phonics down;knob goblin superseltzer;mountain stream soda;magical mystery juice;knob goblin seltzer;cherry cloaca cola;soda water | |
| mpAutoRecoveryTarget | 0.3 | |
| munchiesPillsUsed | 0 | |
| noodleSummons | 0 | |
| nunsVisits | 0 | |
| oceanAction | savecontinue | |
| oceanDestination | manual | |
| olfactedMonster | unknown | |
| oscusSodaUsed | false | |
| outrageousSombreroUsed | false | |
| pastamancerGhostExperience | 0 | |
| pastamancerGhostName | ||
| pastamancerGhostSummons | 0 | |
| pastamancerGhostType | ||
| plantingDate | ||
| plantingDay | -1 | |
| plantingLength | ||
| plantingScript | ||
| postAscensionScript | ||
| preAscensionScript | ||
| preBlackbirdFamiliar | ||
| prismaticSummons | 0 | |
| pyramidPosition | 0 | |
| pyramidBombUsed | false | |
| rageGlandVented | false | |
| reagentSummons | 0 | |
| recentLocations | 5 | |
| recoveryScript | ||
| relayCounters | ||
| requireBoxServants | false | |
| requireSewerTestItems | false | |
| retrieveContacts | true | |
| seaodesFound | 0 | |
| semirareCounter | 0 | |
| semirareLocation | ||
| serverAddsCustomCombat | false | |
| setAutoAttack | true | |
| showGainsPerUnit | false | |
| sideDefeated | neither | |
| sidequestArenaCompleted | none | |
| sidequestFarmCompleted | none | |
| sidequestJunkyardCompleted | none | |
| sidequestLighthouseCompleted | none | |
| sidequestNunsCompleted | none | |
| sidequestOrchardCompleted | none | |
| skillLevel46 | 2 | |
| skillLevel47 | 1 | |
| skillLevel48 | 2 | |
| slimelingFullness | 0 | |
| sortByRoom | true | |
| spadingData | ||
| spiceMelangeUsed | false | |
| spookyPuttyCopiesMade | 0 | |
| spookyPuttyMonster | ||
| stationaryButton1 | ||
| stationaryButton2 | ||
| stationaryButton3 | ||
| stationaryButton4 | ||
| stationaryButton5 | ||
| styxPixieVisited | false | |
| tavernLayout | 0000000000000000000000000 | |
| telescope1 | ||
| telescope2 | ||
| telescope3 | ||
| telescope4 | ||
| telescope5 | ||
| telescope6 | ||
| telescope7 | ||
| telescopeLookedHigh | false | |
| telescopeUpgrades | 0 | |
| tempuraSummons | 0 | |
| thanksMessage | Thank you for the donation! | |
| timesRested | 99 | |
| tomeSummons | 0 | |
| trapperOre | chrome ore | |
| usable1HWeapons | 3 | |
| usable1xAccs | 1 | |
| usable2HWeapons | 1 | |
| usable3HWeapons | 1 | |
| usableAccessories | 3 | |
| usableHats | 2 | |
| usableOffhands | 1 | |
| usableOther | 1 | |
| usablePants | 1 | |
| usableShirts | 1 | |
| violetFogGoal | 0 | |
| violetFogLayout | ||
| warProgress | unstarted | |
| welcomeBackAdv | 0 | |
| _absintheDrops | 0 | |
| _aguaDrops | 0 | |
| _astralDrops | 0 | |
| _banderRunaways | 0 | |
| _cameraUsed | false | |
| _gongDrops | 0 | |
| _hotTubSoaks | 0 | |
| _mayflySummons | 0 | Mayfly summonings today |
| _navelRunaways | 0 | |
| _sealsSummoned | 0 | |
| _skateBuff1 | false | lutz |
| _skateBuff2 | false | comet |
| _skateBuff3 | false | band shell |
| _skateBuff4 | false | skate eels |
| _skateBuff5 | false | merry-go-round |
| _userMods | ||
| unknownRecipe3542 | true | |
| unknownRecipe3543 | true | |
| unknownRecipe3544 | true | |
| unknownRecipe3545 | true | |
| unknownRecipe3546 | true | |
| unknownRecipe3547 | true | |
| unknownRecipe3548 | true | |
| unknownRecipe3749 | true | |
| unknownRecipe3751 | true | |
| unknownRecipe4172 | true | |
| unknownRecipe4173 | true | |
| unknownRecipe4174 | true |
User-defined variables
In addition to setting the variables that KoLmafia predefines, you can also create any others to cover any information you wish. As you do so, keep in mind that while you can clear a variable’s value to the null string, there is currently no way to delete a key (aside from editing the .txt file in the text processor of your choice and deleting the line that contains the key).