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
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
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 and Choice Adventure preferences have been omitted. Each of those has their own section.

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
blankOutUsed	0	Tracks current amount of active Blank-out
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		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
demonSummoned	false
expressCardUsed	false
extraRolloverAdventures	0
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
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
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.
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
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
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
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
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
unknownRecipe3542	true
unknownRecipe3543	true
unknownRecipe3544	true
unknownRecipe3545	true
unknownRecipe3546	true
unknownRecipe3547	true
unknownRecipe3548	true
unknownRecipe3749	true
unknownRecipe3751	true
unknownRecipe4172	true
unknownRecipe4173	true
unknownRecipe4174	true

Daily Variables

These per-account variables are reset to default value at the beginning of each day.

Variable Name	Default Value	Notes
_absintheDrops	0
_aguaDrops	0
_aprilShower	0
_astralDrops	0
_badlyRomanticArrows	0
_bagOfCandy	false
_bagOTricksUsed	false	Has the Bag of Tricks been used today?
_ballpit	false
_banderRunaways	0
_benettonsCasts	0
_bootStomps	0
_boxingGloveArrows	0
_brickoFights	Number of times Bricko monsters have been fought today
_cameraUsed	false
_candySummons	0
_carboLoaded	0
_chipBags	0
_companionshipCasts	false
_crimboTree	false
_deluxeKlawSummons	0
_distentionPillUsed	false
_donhosCasts	false
_elronsCasts	false
_fingertrapArrows	false
_gapBuffs	0	Greatest American Pants buffs
_gibbererAdv	0
_gongDrops	0
_hareAdv	0
_hipsterAdv	0
_hotTubSoaks	0
_iceballUses	0
_inigosCasts	false
_ironicMoustache	false
_klawSummons	0
_lastZomboEye	0
_leafblowerML	1
_legendaryBeat	false
_lookingGlass	false
_lunchBreak	false	Has the Lunch Break skill been used?
_madTeaParty	false
_mayflySummons	0	Mayfly summonings today
_navelRunaways	0
_pasteDrops	0	Number of times Stomping Boots have stomped (badly named)
_photocopyUsed	false
_pieDrops	0	Number of pies made by Knob Goblin Organ Grinder
_poisonArrows	0	Obtuse Angel ability
_poolGames	0
_poolGames	0
_precisionCasts	0
_riftletAdv	0
_sealFigurineUses	0
_sealsSummoned	0
_sexChanged	false
_skateBuff1	false	lutz
_skateBuff2	false	comet
_skateBuff3	false	band shell
_skateBuff4	false	skate eels
_skateBuff5	false	merry-go-round
_stinkyCheeseCount	0
_stressBallSqueezes	0
_syntheticDogHairPillUsed	0
_thingfinderCasts	0
_timeHelmetAdv	0
_toastSummons	0
_tokenDrops	0	Rogue Program drop
_transponderDrops	0
_userMods
_vmaskAdv	0
_zapCount	0

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()