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.)
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 | |
| chatBeep | false | Beep on private message in chat |
| 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 | |
| harvestGardenHardcore | none | The crop that breakfast will harvest, if in your garden. |
| harvestGardenSoftcore | none | The crop that breakfast will harvest, if in your garden. |
| hideServerDebugText | false | |
| highlightList | ||
| http.proxyHost | ||
| http.proxyPassword | ||
| http.proxyPort | ||
| http.proxyUser | ||
| initialDesktop | AdventureFrame,CommandDisplayFrame, MallSearchFrame,GearChangeFrame,SkillBuffFrame |
starting tab configuration |
| 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 | |
| showAnnouncements | true | Display special KoL announcements from the login page |
| 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
Daily Variables and Choice Adventures preferences have their own pages and are not listed here.
| 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 |
| autoCraft | true | Automatically spend 10 meat to create a badass belt or Bonerdagon necklace if the components are available |
| 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 | |
| basementMallPrices | 1 | |
| battleAction | attack with weapon | |
| betweenBattleScript | ||
| birdformCold | 0 | |
| birdformHot | 0 | |
| birdformRoc | 0 | |
| birdformSleaze | 0 | |
| birdformSpooky | 0 | |
| birdformStench | 0 | |
| blackPuddingsDefeated | 0 | |
| blankOutUsed | 0 | Tracks current amount of active Blank-out |
| buffBotCasting | ||
| buffBotMessageDisposal | 0 | |
| buffBotPhilanthropyType | 1 | |
| buyScript | ||
| cameraMonster | ||
| cellarLayout | 0 | |
| chatbotScript | ||
| chatbotScriptExecuted | false | |
| chosenTrip | ||
| cinderellaMinutesToMidnight | 0 | Time left while doing the stepmother section of the grimstone mask content |
| cinderellaScore | 0 | Current score while doing the stepmother section of the grimstone mask content |
| clanAttacksEnabled | false | |
| currentBountyItem | 0 | |
| currentFullness | 0 | |
| currentHippyStore | none | |
| currentJunkyardTool | ||
| currentJunkyardLocation | ||
| currentMood | default | |
| currentNunneryMeat | 0 | |
| currentSpleenUse | 0 | |
| currentWheelPosition | muscle | |
| customCombatScript | default | |
| defaultAutoAttack | 0 | |
| defaultFlowerLossMessage | ||
| defaultFlowerWinMessage | ||
| demonName1 | Name of demon that gives pies | |
| demonName2 | Name of demon that gives Preternatural Greed | |
| demonName3 | Name of demon that gives Fit To Be Tide | |
| demonName4 | Name of demon that gives Big Flaming Whip | |
| demonName5 | Name of demon that gives Demonic Taint | |
| demonName6 | Tatter | Name of demon that gives pile of smoking rags |
| demonName7 | Ak'gyxoth | Name of demon that gives drinks |
| demonName8 | Name of demon found in the Nemesis' Lair | |
| demonName9 | Name of demon that gives Burning, Man | |
| dnaSyringe | ||
| flyeredML | 0 | |
| fossilB | 0 | Number of bat teeth on the fossilized necklace |
| fossilD | 0 | Number of demon teeth on the fossilized necklace |
| fossilN | 0 | Number of baboon teeth on the fossilized necklace |
| fossilP | 0 | Number of spider teeth on the fossilized necklace |
| fossilS | 0 | Number of serpent teeth on the fossilized necklace |
| fossilW | 0 | Number of wyrm teeth on the fossilized necklace |
| fratboysDefeated | 0 | |
| gongPath | 0 | |
| gourdItemCount | 5 | |
| grimstoneCharge | 0 | Track combat turns with Grimstone Golem |
| guardTurtlesFreed | 0 | Number of times that guard turtles have been freed this ascension. |
| guyMadeOfBeesCount | 0 | |
| guyMadeOfBeesDefeated | false | |
| heroDonationBoris | 0 | Meat donated to Boris |
| heroDonationJarlsberg | 0 | Meat donated to Jarlsberg |
| heroDonationSneakyPete | 0 | Meat donated to Sneaky Pete |
| hiddenCityLayout | 0000000000000000000000000 | The map of the Hidden City |
| hiddenCitySquare | 0 | The last square explored in the Hidden City. This square will be auto-adventured. |
| 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. | |
| jarlsbergPoints | 0 | Number of bonus skill points earned by doing Avatar of Jarlsberg ascensions |
| kingLiberated | false | |
| knownAscensions | -1 | |
| lastAdventure | ||
| lastBangPotion819 | ||
| lastBangPotion820 | ||
| lastBangPotion821 | ||
| lastBangPotion822 | ||
| lastBangPotion823 | ||
| lastBangPotion824 | ||
| lastBangPotion825 | ||
| lastBangPotion826 | ||
| lastBangPotion827 | ||
| lastBangPotionReset | -1 | |
| lastBarrelSmashed | 0 | |
| lastBattlefieldReset | -1 | |
| lastBreakfast | -1 | |
| lastCellarReset | -1 | |
| lastChanceBurn | CLI command executed at lastChanceThreshold ("#" is replaced by the amount of MP to burn) | |
| lastChanceThreshold | 100 | amount of unburned MP at which alternatives to extending existing buffs will be considered |
| 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 | Number 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 | |
| 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 | |
| lightsOutAutomation | 1 | Highlights/automatically selects correct option during Lights Out Quest noncombats |
| louvreDesiredGoal | 7 | |
| louvreGoal | 0 | |
| louvreOverride | ||
| luckySewerAdventure | stolen accordion | |
| manaBurnSummonThreshold | 10 | |
| manaBurningThreshold | -0.05 | |
| maxManaBurn | 1000 | |
| 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 | |
| oceanAction | savecontinue | |
| oceanDestination | manual | |
| olfactedMonster | unknown | |
| pastamancerGhostExperience | 0 | |
| pastamancerGhostName | ||
| pastamancerGhostSummons | 0 | |
| pastamancerGhostType | ||
| plantingDate | ||
| plantingDay | -1 | |
| plantingLength | ||
| plantingScript | ||
| poolSharkCount | 0 | Number of times "Rack 'em up" was selected at A Shark's Chum |
| postAscensionScript | ||
| preAscensionScript | ||
| preBlackbirdFamiliar | ||
| pyramidPosition | 0 | |
| pyramidBombUsed | false | |
| raveCombo1 | Rave Concentration | |
| raveCombo2 | Rave Nirvana | |
| raveCombo3 | Rave Knockout | |
| raveCombo4 | Rave Bleeding | |
| raveCombo5 | Rave Steal | |
| raveCombo6 | Rave Substats | |
| 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 | |
| sleazeAirportAlways | false | Set to true if you use an airplane charter: Spring Break Beach |
| slimelingFullness | 0 | |
| sneakyPetePoints | 0 | Number of bonus skill points earned by doing Avatar of Sneaky Pete ascensions |
| sortByRoom | true | |
| spadingData | ||
| spookyPuttyMonster | ||
| stationaryButton1 | ||
| stationaryButton2 | ||
| stationaryButton3 | ||
| stationaryButton4 | ||
| stationaryButton5 | ||
| suppressPotentialMalware | false | If true, prevents the relay browser from connecting to known malware attack vectors. |
| tavernLayout | 0000000000000000000000000 | |
| telescope1 | ||
| telescope2 | ||
| telescope3 | ||
| telescope4 | ||
| telescope5 | ||
| telescope6 | ||
| telescope7 | ||
| telescopeUpgrades | 0 | |
| tempuraSummons | 0 | |
| thanksMessage | Thank you for the donation! | |
| trackLightsOut | false | Track Lights Out Quest. Can be set with "spookyraven" CLI command. |
| trapperOre | chrome ore | |
| uneffectWithHotTub | true | If true, during HC/ronin KoLmafia will spend a hot tub use to remove a negative effect instead of a soft green echo eyedrop antidote. Does not change casual/aftercore behavior. |
| 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 | |
| unknownRecipe3542 | true | |
| unknownRecipe3543 | true | |
| unknownRecipe3544 | true | |
| unknownRecipe3545 | true | |
| unknownRecipe3546 | true | |
| unknownRecipe3547 | true | |
| unknownRecipe3548 | true | |
| unknownRecipe3749 | true | |
| unknownRecipe3751 | true | |
| unknownRecipe4172 | true | |
| unknownRecipe4173 | true | |
| unknownRecipe4174 | true | |
| zeppelinProtestors | 0 | Counts protesters removed from A Mob of Zeppelin Protesters |
Daily Variables
See page Daily Variables
Choice Adventures
See page Choice Adventures
Quest Tracking
See page Quest Tracking Preferences
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).