With this mod, when you interact with your mailbox, a menu with all new and old mail will pop up.

Old mail can be filtered by sender.

Alone, this mod displays every mail envelope using a generic icon. You can change the generic icon, or use custom icons for individual letters or senders using Content Patcher.

Custom envelope packs include:

Note: for now, modded mail using Mail Framework Mod will be displayed as vanilla rather than through the menu, as I'm not able to access that mod's functionality.

Content Patcher

There are two dictionaries that keep track of mail data: one for NPCs and one for individual letters. The Content Patcher paths are:

aedenthorn.MailboxMenu/npcs
aedenthorn.MailboxMenu/letters

The dictionary for NPCs can be used to specify a generic envelope icon for every letter sent by a specific sender (whether they are an actual NPC or not).

The dictionary for letters can be used to specify an envelope icon for specific mail IDs. It is also used to tell the mod the name of the sender of each letter (the mod has an internal list for all vanilla mail that it pre-adds to this dictionary, letting it know the name of the sender of each vanilla mail item).

Syntax for either list is the same, though the fields used depend on the data you're using:

{
<br />   "Format": "1.23.0",
<br />   "Changes": [
<br />      {
<br />         "Action": "EditData",
<br />         "Target": "aedenthorn.MailboxMenu/npcs",
<br />         "Entries": {
<br />
<br />            "Abigail": {
<br />               "texturePath": "aedenthorn.CPMBMEnvelopes/Abigail",
<br />               "scale": 1,
<br />               "frames": 1,
<br />               "frameWidth": 0,
<br />               "frameSeconds": 0
<br />            }
<br />         }
<br />      },
<br />      {
<br />         "Action": "EditData",
<br />         "Target": "aedenthorn.MailboxMenu/letters",
<br />         "Entries": {
<br />            "MyLetterFromAbigail": {
<br />               "sender": "Abigail"
<br />            },
<br />            "abbySpiritBoard": {
<br />               "texturePath": "aedenthorn.CPMBMEnvelopes/AbigailSpecial",
<br />               "scale": 1,
<br />               "frames": 1,
<br />               "frameWidth": 0,
<br />               "frameSeconds": 0
<br />            }
<br />         }
<br />      },
<br />      {
<br />         "Action": "Load",
<br />         "Target": "aedenthorn.CPMBMEnvelopes/Abigail",
<br />         "FromFile": "assets/Abigail.png"
<br />      },
<br />      {
<br />         "Action": "Load",
<br />         "Target": "aedenthorn.CPMBMEnvelopes/AbigailSpecial",
<br />         "FromFile": "assets/AbigailSpecial.png"
<br />      }
<br />   ]
<br />}

The above tells the mod that generic letters from Abigail should use the content pack's png file for the envelope; that the letter with the ID "MyLetterFromAbigail" is from Abigail, and that the letter with the ID abbySpiritBoard should use a special png file from the content pack.

You can omit the other fields unless you need them:

scale is for icons that are not 256 pixels wide (e.g. 64x64). This will scale the icon if set to anything besides 1.
frames is used for animated icons - place the frames horizontally on the png file.
frameWidth is how many pixels wide each animated frame is.
frameSeconds is how many seconds (or decimal part) each frame should last.

Config

You can edit the config.json file that is created when first running the game or use GMCM.

Technical

Requires SMAPI.

Implements a Generic Mod Config Menu interface to change config settings in-game.

Compatible with Mod Updater for automatic updates.

Code is at https://github.com/aedenthorn/StardewValleyMods.

If you want to complain or ask for help or help me test my mods, you can visit my Discord server.

A list of all my mods for Stardew Valley is available at https://www.nexusmods.com/stardewvalley/articles/895.

Mailbox Menu