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		Stores the results of each twinkly rock mined in Anemone Mine (Mining). This is used by the relay browser to display the results in-game.
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
suppressInappropriateNags	false	Facilitates end-user suppression of inappropriate nags.
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).

See Also

get_property() | set_property()