Comprehensive Mail Flag List
Last edited by Abagaianye on 2025-09-13 06:31:55
This is a list of all vanilla mail flags in the game that can be found by searching the game code.
WIP 1.6 Section
Currently working to ferret out where all these flags are added from
Community Center
| Mail Flag | Raise Condition | Usage |
|---|---|---|
| ccDoorUnlock | During the Town event where Lewis talks about the Community Center. Raised before skip button appears, so the event can be safely skipped. |
|
| canReadJunimoText | During the WizardHouse event after trying to read the Junimo Note in the Community Center. Raised when skipping the event and during the animation after drinking the potion. |
|
| ccBoilerRoom | Completing all the Boiler Room bundles or purchasing the Minecarts on the Community Development Form. | |
| ccBulletin | Completing all the Bulletin Board bundles. | |
| ccCraftsRoom | Completing all the Crafts Room bundles or purchasing the Bridge on the Community Development Form. | |
| ccFishTank | Completing all the Fish Tank Bundles or purchasing Panning on the Community Development Form. | |
| ccPantry | Completing all the Pantry bundles or purchasing the Greenhouse on the Community Development Form. | |
| ccVault | Completing all the Vault bundles or purchasing the Bus on the Community Development Form. | |
| ccIsComplete | When Junimo returns to hut to retrieve star when all other Community Center areas are complete. | |
| abandonedJojaMartAccessible | ||
| ccMovieTheater |
JojaMart
| Mail Flag | Raise Condition | Usage |
|---|---|---|
| JojaMember | Buying the JojaMart membership from Morris. | |
| jojaBoilerRoom | Purchasing Minecarts on the Community Development Form. | |
| jojaCraftsRoom | Purchasing the Bridge on the Community Development Form. | |
| jojaFishTank | Purchasing Panning on the Community Development Form. | |
| jojaPantry | Purchasing the Greenhouse on the Community Development Form. | |
| jojaVault | Purchasing the Bus on the Community Development Form. | |
| ccMovieTheaterJoja |
Quests
| Mail Flag | Raise Condition | Usage |
|---|---|---|
| Gil_<monsterSlayerQuestID> | ||
| birdieQuestFinished | Raised after completing Birdie's quest | |
| birdieQuestBegun | Raised after starting Birdie's quest | |
| gotBirdieReward | ||
| henchmanGone | Raised when finishing the quest Goblin Problem. |
Farmhouse
| Mail Flag | Raise Condition | Usage |
|---|---|---|
| FirstPurchase_build_crib | The player has used Robin's renovation menu to build the crib in the Farmhouse again for the first time after removing it - note that it is NOT raised simply by upgrading the farmhouse to level 2, even though the crib is present. Unlike with other renovations, this is the only mail flag for building the crib and therefore only the first instance of rebuilding it can be tracked. This flag persists even if the crib is removed again. | |
| FirstPurchase_remove_crib | The player has used Robin's renovation menu to remove the crib from the Farmhouse for the first time. As with FirstPurchase_remove_crib, only the first instance of rebuilding the crib can be tracked as there are no mail flags to track the crib's current state. This flag persists even if the crib is built again. | |
| FirstPurchase_Attic | The player has used Robin's renovation menu to build the attic for the first time. This flag persists even if the attic is removed. | |
| FirstPurchase_BedroomWall | The player has used Robin's renovation menu to open the bedroom wall for the first time. This flag persists even if the bedroom is closed again. | |
| FirstPurchase_Corner | The player has used Robin's renovation menu to build the top right corner room for the first time. This flag persists even if the corner room is removed. | |
| FirstPurchase_Cubby | The player has used Robin's renovation menu to build the cubby for the first time. This flag persists even if the cubby is removed. | |
| FirstPurchase_Dining | The player has used Robin's renovation menu to build the dining room for the first time. This flag persists even if the dining room is removed. | |
| FirstPurchase_DiningRoomWall | The player has used Robin's renovation menu to remove the wall between the dining room and the kitchen for the first time. This flag persists even if the dining room is closed again. | |
| FirstPurchase_ExtendedCorner | The player has used Robin's renovation menu to extend the size of the corner room for the first time. This flag persists even if the player shrinks the corner room again. | |
| FirstPurchase_Southern | The player has used Robin's renovation menu to build the southern room for the first time. This flag persists even if the southern room is removed. | |
| renovation_bedroom_open | The player has used Robin's renovation menu to open the bedroom wall and it is still open. This flag is removed if the bedroom is closed again. | |
| renovation_corner_open | The player has used Robin's renovation menu to build the corner room. This flag is removed if the corner room is removed. | |
| renovation_cubby_open | The player has used Robin's renovation menu to build the cubby. This flag is removed if the cubby is removed. | |
| renovation_dining_open | The player has used Robin's renovation menu to build the dining room. This flag is removed if the dining room is removed. | |
| renovation_diningroomwall_open | The player has used Robin's renovation menu to remove the wall between the dining room and the kitchen. This flag is removed if the dining room is closed again. | |
| renovation_farupperroom_open | The player has used Robin's renovation menu to build the attic. This flag is removed if the attic is removed. Note the change in name compared to FirstPurchase_Attic. | |
| renovation_extendedcorner_open | The player has used Robin's renovation menu to extend the size of the corner room for the first time. This flag is removed if the player shrinks the corner room again. | |
| renovation_southern_open | The player has used Robin's renovation menu to build the southern room for the first time. This flag is removed if the southern room is removed. |
Uncategorized
| Mail Flag | Raise Condition | Usage |
|---|---|---|
| leoMoved | After viewing or skipping Leo's 6 heart event. | |
| voidBookDropped | ||
| cursed_doll | ||
| GotPerfectionStatue | ||
| read_a_book | ||
| gotGoldenScythe | ||
| OpenedSewer | ||
| willyHours | ||
| MarniePetAdoption | ||
| MarniePetRejectedAdoption | ||
| GotSquidFestReward_<year>_<dayOfMonth>_<#> | Raised when the player has received the specific Squid Fest reward <index #>(0-3) for the specific year and day(12/13) | |
| GotCrabbingBook | ||
| sawQiPlane | ||
| rejectedPet | ||
| numbersEgg1 | ||
| numbersEgg2 | ||
| numbersEgg3 | ||
| numbersEgg1.5 | ||
| numbersEgg7 | ||
| Jas_IceCream_DF_<year> | ||
| FizzFirstDialogue | ||
| DefenseBookDropped | ||
| qiCave | ||
| gotFirstBillboardPrizeTicket | ||
| Got_Capsule | ||
| gotMaxStamina | ||
| petLoveMessage | ||
| GotMysteryBook | ||
| checkedMonsterBoard | ||
| spring_2_1 | ||
| NightMarketYear<year>Day<dayOfNightMarket>_paintingSold | Raised when purchasing the painting offered on the specific year and day(15-17), raised in multiplayer to limit shop stock to once per year | |
| willyBoatFixed | ||
| CalderaTreasure | ||
| gotCAMask | ||
| Y<year>_Cactus | ||
| Desert_Festival_Shady_Guy | Raised after first talking to the Suspicious Guy at the Desert Festival | |
| Desert_Festival_Marlon | Raised after first talking to Marlon at the Desert Festival | |
| Y<year>_Scholar | ||
| DF_Gil_Hat | Raised after receiving Gil's Hat from the Desert Festival Skull Cavern challenge | |
| Checked_DF_Mine_Explanation | ||
| CF_Spouse | Raised after receiving star fruit from spouse | |
| pennyQuilt0 | ||
| pennyQuilt1 | ||
| pennyQuilt2 | ||
| pennyRefurbished | ||
| willyBackRoomInvitation | ||
| seenRaccoonFinishEvent | ||
| raccoonMovedIn | ||
| wizardJunimoNote | ||
| checkedRaccoonStump | ||
| Island_Turtle | ||
| lb_<id> | ||
| museumCollectedReward<dataType>_<itemID>_1 | ||
| artifactFound | ||
| <MuseumRewardsDataID> | ||
| gotPearl | ||
| guildMember | ||
| witchStatueGone | ||
| summit_cheat_event | ||
| Broken_Capsule | ||
| SecretNote20_done | ||
| checkedBulletinOnce | ||
| NOQUEST_<questID> | ||
| NOSPECIALORDER_<specialOrderID> | ||
| activatedJungleJunimo | ||
| sawSecretSanta<year> | ||
| savedFriends | ||
| destroyedPods | ||
| killedSkeleton | ||
| slimeHutchBuilt | ||
| Gil_Telephone | ||
| Gil_FlameSpirits | ||
| WizardCatalogue | ||
| JojaThriveTerms | ||
| CookiePresent_year<year> | ||
| MilkPresent_year<year> | ||
| pamNewChannel | ||
| completedFirstBillboardQuest | ||
| skullCave | ||
| bouncerGone | ||
| beenToWoods | ||
| Visited_Island | ||
| Island_FirstParrot | ||
| islandNorthCaveOpened | ||
| reachedCaldera | ||
| Island_UpgradeHouse | ||
| Island_Resort | ||
| ClintReward | ||
| ClintReward2 | ||
| junimoPlush | ||
| GiantQiFruitMessage | ||
| GotWoodcuttingBook | ||
| roeBookDropped | ||
| CF_Fair | ||
| CF_Fish | ||
| CF_Sewer | ||
| CF_Mines | ||
| CF_Statue | ||
| museumComplete | ||
| Egg Festival | Raised when beating the egg hunt for the first time | |
| Ice Festival | Raised when beating the Ice Fishing Contest for the first time | |
| grandpaPerfect | ||
| button_tut_2 | ||
| geodeFound | ||
| BackpackTip | ||
| gotMasteryHint | ||
| TH_LumberPile | ||
| TH_SandDragon | ||
| TH_Railroad | ||
| TH_Tunnel | ||
| Henchman1 | ||
| FullCrabPond | ||
| button_tut_1 | ||
| SecretNote18_done | ||
| safariGuyIntro | ||
| JojaGreeting | ||
| somethingToDonate | ||
| somethingWasDonated | ||
| TH_MayorFridge | ||
| AbigailInMineFirst | ||
| SecretNote16_done | ||
| Summit_event | ||
| SecretNote17_done | ||
| SecretNote19_done | ||
| QiChat1 | ||
| QiChat2 | ||
| apeChat1 | ||
| hasSeenAbandonedJunimoNote | ||
| seenJunimoNote | ||
| emilyFiber | ||
| secretNote21_done | ||
| ReturnScepter | ||
| addedParrotBoy | ||
| hasSeenGrandpaNote | ||
| PierreStocklist | ||
| incubator | ||
| ISLAND_NORTH_DIGSITE_LOAD | ||
| landslideDone | ||
| lostWalnutFound | ||
| lostBookFound | ||
| ectoplasmDrop | ||
| prismaticJellyDrop | ||
| gotMissingStocklist | ||
| gotFirstJunimoChest | ||
| clothFound | ||
| robinWell | ||
| copperFound | ||
| Bouquet | ||
| SeaAmulet | ||
| pierreBackpack | ||
| foundLostTools | ||
| ccBulletinThankYou | ||
| transferredObjectsPamHouse | ||
| transferredObjectsJojaMart | ||
| hatter | ||
| MarlonRecovery | ||
| gotMummifiedFrog | ||
| quest35 | ||
| quest10 | ||
| <npcName>Cooking | ||
| <npcName>Crafting | ||
| activateGoldenParrotsTonight | ||
| willyBoatTicketMachine | ||
| willyBoatAnchor | ||
| willyBoatHull | ||
| seenBoatJourney | ||
| volcanoShortcutUnlocked | ||
| talkedToGourmand | ||
| sawParrotBoyIntro | ||
| Island_N_BuriedTreasure | ||
| Island_UpgradeBridge | ||
| Island_UpgradeTrader | ||
| Saw_Flame_Sprite_North_South | ||
| Saw_Flame_Sprite_North_North | ||
| Island_Secret_BuriedTreasureNut | ||
| Island_Secret_BuriedTreasure | ||
| Saw_Flame_Sprite_South | ||
| Island_W_Obelisk | ||
| Island_UpgradeHouse_Mailbox | ||
| Island_UpgradeParrotPlatform | ||
| tigerSlimeNut | ||
| Island_W_BuriedTreasure | ||
| Island_W_BuriedTreasure2 | ||
| guildQuest | ||
| QiChallengeComplete | ||
| VisitedQuarryMine | ||
| reachedBottomOfHardMines | ||
| carolinesNecklace | ||
| Island_VolcanoBridge | ||
| Island_VolcanoShortcutOut | ||
| Saw_Flame_Sprite_Volcano | ||
| marnieAutoGrabber | ||
| fishing2 | ||
| fishing6 | ||
| Beat_PK | ||
| JunimoKart | ||
| RarecrowSociety | ||
| GreenRainGus | ||
| lewisStatue | ||
| fieldOfficeFinale | ||
| robinKitchenLetter | ||
| DesertFestival | ||
| <season>_<day>_<year> | ||
| <season>_<day> | ||
| galaxySword | ||
| doorUnlock<NPC>[NPC2] | Raised when interacting with a NPC room door while having more than 2 hearts with the <NPC> or optionally [NPC2]. | |
| krobusUnseal | Raised when Krobus unseals the Mutant Bug Lair. | |
| communityUpgradeShortcuts | Raised on day update on the day the community shortcuts community upgrade is finished. | |
| hasPickedUpMagicInk | Raised when picking up the Magic Ink off the table in the Witch's Hut. | |
| hasActivatedForestPylon | Raised after interacting with the Forest Pylon in the Wizard's basement while having the Far Away Stone. | |
| FizzIntro | Raised after interacting with the Perfection Tracker in Qi's Walnut Room for the first time. | |
| pamHouseUpgrade | Raised on day update on the day the Pam's house community upgrade is finished. | |
| HasUnlockedSkullDoor | Raised after interacting with the Skull Door while having the skull key and not on a Desert Festival day. | |
| HasTownKey | Raised after purchasing the Key To The Town from Qi's Walnut Room. | |
| HasSpecialCharm | Raised when picking up the Special Charm, found by having and solving Secret Note #20. | |
| HasSkullKey | Raised when picking up the Skull Key in the Mines. | |
| HasRustyKey | Raised after receiving the Rusty Key from Gunther during the event where he gives it to the player. | |
| HasMagnifyingGlass | Raised after talking to the Shadow Person that gives the Magnifying Glass in Winter. | |
| HasMagicInk | Raised when picking up the Magic Ink off the table in the Witch's Hut. | |
| HasDarkTalisman | Raised when picking up the Dark Talisman in the Mutant Bug Lair. | |
| HasClubCard | When interacting with the lumber pile during Mr. Qi's quest line. | |
| HasDwarvishTranslationGuide | When any player gets the Dwarvish Translation Guide. | |
| Farm_Eternal_Parrots | When entering the Farm map the day after achieving Perfection. | |
| Farm_Eternal | When sleeping after achieving Perfection. | |
| fortuneTeller | After getting fortune told each year at the Stardew Valley Fair.<year> is the year number, example: fortuneTeller1 for year 1. |
|
| raccoonTreeFallen | When the wind storm Sound In The Night Event triggers. | |
| Capsule_Broken | When the Strange Capsule becomes the Empty Capsule. |
Original 1.5 Section
Please note that this is just what I was able to pull from the source code so far. I have no idea what some of these are, especially for the 1.5 content. Any fixing, additions, or further explanation is welcome
pamHouseUpgrade - When Host Player has bought the upgrade to Pam's House
pamHouseUpgradeAsked - connected to pamHouseUpgrade somehow. It's a yes or no response to see if you can have the next upgrade, I think
leoMoved - Flag raised after Leo's Six heart event, as far as I can tell. Seems to be used for adding Leo to festivals. Any further elucidation on this would be welcome
Farm_Eternal - achieved perfection
slimeHutchBuilt - Self explanatory
abandonedJojaMartAccessible - self explanatory. For after CC is done but ccMovieTheater has not been received
willyBoatTicketMachine - something to do with island unlock quest
willyBoatHull - something to do with island unlock quest
willyBoatAnchor - something to do with island unlock quest
willyBoatFixed - something to do with island unock quest
addedParrotBoy - Leo is now an accessible NPC
communityUpgradeShortcuts - Host player has bought the community shortcuts
checkedBulletinOnce - checked the special order board
witchStatueGone - the statue for the Wizard's Ink quest is gone from the railroad
Island_Turtle - I have no earthly idea
Ice Festival - flag for the ice festival. Probably not needed in most cases, since most frameworks can target this in other ways
Egg Festival - flag for the egg festival
qiCave - player has drank the iridium milk
museum5 - player has donated five items
museum10 - player has donated ten items
museum15 - player has donated fifteen items
museum20 - player has donated twenty items
museum25 - player has donated twenty-five items
museum30 - player has donated thirty items
museum40 - player has donated fourty items
museum50 - player has donated fifty items
museum70 - player has donated seventy items
museum80 - player has donated eighty items
museum90 - player has donated ninety items
museumComplete - completed the museum collection (gets u a stardrop)
CF_Fair - Bought the stardrop at the stardew Valley fair
CF_Spouse - Spouse has given you a stardrop
CF_Statue - given Master Canolli his Sweet Gem Berry
CF_Sewer - bought the stardrop from Krobus
CF_Fish - gotten the stardrop from Willy for the Master Angler Achievement
CF_Mines - gotten the stardrop in the mines
gotMaxStamina - found all the stardrops
TH_Tunnel - put the battery in the breaker box
TH_Railroad - put the shell in the railroad box
TH_MayorFridge - has put beets in the mayor's fridge
TH_SandDragon - fed the sand dragon a solar essence
TH_LumberPile - gotten the club card
gotPearl - got a pearl from the Mermaid Show? (that's what the code seems to indicate)
Summit_event - marks your first time at the summit after gaining perfection
hasSeenGrandpaNote - self explanatory
Farm_Eternal_Parrots - Farm_Eternal, but after an event involving parrots? code seems to point to Grandpa's candles too
Summit_event - likely the event that unlocks the summit? I have not played enough 1.5 to know
BackpackTip - it's... it's a mail flag... directly connected to another mail flag for Pierre sending you mail about his backpacks for sale. I can't for the life of me figure out why it needs two.
henchmanGone - you have made the henchman leave the swamp (U could use this for a friendable Henchman mod)
hasPickedUpMagicInk - self explanatory
krobusUnseal - Krobus unseals the bug dungeon
galaxySword - you've found the Galaxy Sword
cursed_doll - You've doved your kids
eric's_prank_1 - it's for catching the doll on the Four-Corners farm
willyHours - ??? Something to do with willy?
gotGoldenScythe - Got the golden scythe
GotPerfectionStatue - got the perfection statue; specific to host player
ccDoorUnlock - can enter the Community Center
ccPantry - Did all pantry boxes
ccBoilerRoom - did all boiler room boxes
ccCraftsRoom - did all crafts room boxes
ccFishTank - did all of the fish tank boxes
ccVault - did all the vault boxes
ccBulletin - did all of the bulletin board boxes
ccIsComplete - did all of the rooms
jojaCraftsRoom - complete crafts room as a Joja member
jojaVault - complete the vault as a Joja member
jojaFishTank - complete the fish tank as a Joja member
jojaBoilerRoom - complete the boiler room as a Joja member
jojaPantry - complete the pantry as a Joja member
JojaMember - bought the membership
artifactFound - has found at least one artifactFound
guntherBones - related to his special order, I'm not sure on the specifics
rejectedPet - if you rejected the pet when Marnie offers it to you
guildMember - has joined the adventure guildMember
checkedMonsterBoard - has checked the Monster Board
Gil_Slime Charmer Ring - recieved this item from Gil
Gil_Savage Ring - recieved this item from Gil
Gil_Skeleton Mask - recieved this item from Gil
Gil_Insect Head - recieved this item from Gil
Gil_Vampire Ring - recieved this item from Gil
Gil_Hard Hat - recieved this item from Gil
Gil_Burglar's Ring - recieved this item from Gil
Gil_Crabshell Ring - recieved this item from Gil
Gil_Arcane Hat - recieved this item from Gil
Gil_Knight's Helmet - recieved this item from Gil
Gil_Napalm Ring - recieved this item from Gil
Gil_Telephone - recieved this item from Gil
spring_2_1 - a special flag pertaining to this date. Specifically used to keep Willy away until this date
this.paintingMailKey - 'this' is a class, so it likely pertains to the painting. I'm not sure on the specifics here, other than it having to do with Night Market sales
Capsule_Broken - Something to do with the Broken Capsule item
Broken_Capsule - something to do with the broken capsule item
CalderaTreasure - Specifically determines whether the caldera treasure box is there or not based on whether you've opened it or not
gotCAMask - got the Concerned Ape mask
pennyRedecorating - penny is redecorating your house, as per the 14 heart event
pennyQuilt0 - you picked Forest and Moon theme
pennyQuilt1 - you picked Strawberry Home theme
pennyQuilt2 - you picked Pirate theme
pennyRefurbished - Penny has finished redecorating
willyBackRoomInvitation - you are allowed in the boat tunnel
wizardJunimoNote - unlocks the wizard's house if you've seen the note
gotSpaFishing - gotten the item from fishing at the bathhouse pond
caughtIridiumKrobus - gotten the iridium Krobus statue
JojaGreeting - I have no idea. Morris greeting you as a jojamart member?
somethingToDonate - player currently has something in their inventory to donate (pretty sure this just resets every time)
somethingWasDonated - player has donated something (pretty sure this just resets every time)
AbigailInMineFirst - triggered Abigail's ten heart event
ClintReward - has gotten the mail for helping Clint with his special order
beenToWoods - has been to the woods. used in the map so it's not ??? anymore
QiChat1 - Just determines which of a set of chats you'll get from chatting with Qi (Is done by using in-game chat box)
QiChat2 - Just determines which of a set of chats you'll get from chatting with Qi (Is done by using in-game chat box)
QiChat3 - Just determines which of a set of chats you'll get from chatting with Qi (Is done by using in-game chat box)
apeChat1 - Determines whether CA talks to you or not. He'll ignore you and keep working if you've talked to him more than once (Is done by using in-game chat box)
savedFriends - used in the board game with Seb for determining score
destroyedPods - used in the board game with Seb for determining score
killedSkeleton - used in the board game with Seb for determining score
Henchman1 - used for talking to Henchman; triggers the game to load up Henchman's dialogue from strings/characters
stardropName - not sure? Seems to have something to do with recieving the spouse and mine stardrops
pamNewChannel - adds a fishing channel hosted by Pam
junimoPlush - has recieved the junimo plush
SecretNote16_done - marks if you've completed the task from secret note 16
SecretNote18_done - marks if you've completed the task from secret note 18
SecretNote19_done - marks if you've completed the task from secret note 19
SecretNote20_done - marks if you've completed the task from secret note 20
secretNote21_done - marks if you've completed the task from secret note 21
WillyTropicalFish - seems to be something for adding a new fish tank to Willy's shop
FullCrabPond - Crab pond is full. Triggers Willy to give a pearl
petLoveMessage - your pet adores you
canReadJunimoText - player can read junimo text
MarlonRecovery - refreshed every time you die in the mines
renovation_bedroom_open - marks the current state of your bedroom
renovation_southern_open - marks the current state of the southern room
renovation_corner_open - marks the current state of the corner room
seenJunimoNote - you've read the note in the pantry
hasSeenAbandonedJunimoNote - seems to be the same as seenJunimoNote
emilyFiber - Player has started Emily's 14 heart quest
ReturnScepter - you own the return scepter
Got_Capsule - the alien event to bury the capsule on your farmland has occured
goldenCoconutHat - you recieved the golden coconut hat
geodeFound - you found a geodeFound
safariGuyIntro - you've seen the island field office intro event
gotSecretIslandNPainting - got a painting on the north part of the island
gotSecretIslandNSquirrel - found a squirrel on the north part of the island
birdieQuestBegun - you've begun Birdie's quest
birdieQuestFinished - you've finished Birdie's quest
OpenedSewer - you've used the rusty key on the sewer gate
CalderaPainting - you've gotten the Caldera painting
gotBirdieReward - unlocks Fairy Dust for everyone
lostWalnutFound - you've found a lost walnut
Bouquet - unlocks the bouquet at pierre's shop
SeaAmulet - unlocks the Mermaid pendant with the Ol Mariner
lostBookFound - found a lost book
foundLostTools - puts missing tools in the lost and found
Island_VolcanoShortcutOut - the volcano shortcut is out
Island_VolcanoBridge - something about the volcano bridge?
skullCave - skull door has been unlocked
reachedCaldera - self explanatory
islandNorthCaveOpened - The cave on island north has been opened
Island_UpgradeTrader - the island trader has been unlocked