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.
Other KoLmafia-based preferences
This is going to be a limited survey of the more interesting of the settings that you can control.
battleAction - This specifies the strategy that you will use in battle. The sorts of values that you might select here are “attack” for normal attacking, “custom” to use the Custom Combat Scripts, “item dictionary” when you’re adventuring in the Valley beyond Orc Chasm, or “skill thrust smack” to use TS during the entire battle.
hpAutoRecovery - This is a float value that specifies the percentage of your HP at which the autohealer kicks in. I haven’t tried it, but I think you’d be generally unhappy if you set it to something other than a multiple of 0.1.
hpAutoRecoveryTarget - A companion to the above, this is the target that the autohealer will aspire to achieve.
As before, feel free to peruse the .kcs file to see all of the values. The names aren’t very subtle, so you should be able to guess what they’re all for.
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).
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 https://kolmafia.svn.sourceforge.net/svnroot/kolmafia/src/data/defaults.txt).
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
| Variable Name | Default Value | Notes |
|---|---|---|
| autoAbortThreshold | -0.05 | |
| autoAntidote | 0 | |
| autoBuyPriceLimit | 20000 | |
| autoEntangle | false | |
| autoManaRestore | true | |
| autoOlfact | ||
| autoPotionID | false | |
| autoPutty | ||
| autoRepairBoxServants | true | |
| autoSphereID | false | |
| autoSteal | true | |
| autostartGalaktikQuest | true | |
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| _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 |