Mail Framework Mod

⭐ ⭐⭐⭐⭐ (85,959 endorsements) 📥 4.5M downloads 📌 v1.20.0 📅 10/9/2017
🟠 Updated over a year ago

By Digus · Modding Tools

⬇ Download Mod Source: Nexus Mods 📅 Updated: 3/28/2025 📅 Created: 10/9/2017
⚠️ Install Order · 2 steps
1🛠️ SMAPI — Stardew Modding API Download ↗
2🛠️ Content Patcher — Content Patcher (framework) Download ↗

Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.

🔍 Analysis

  • 👍 1.9% endorsement rate — high engagement, a strong quality signal
  • 🏆 #10 of 119 Modding Tools mods in this game by downloads

📋 About This Mod

Objective:

Simplify the send of mail to the player, giving more control over when and what should be received.

Also giving more options not possible just editing the data files, like changing the text color and background of the letter at will.

Installation:

  • []Install the latest version of SMAPI.

    []Unzip the MailFrameworkMod into /Stardew Valley/Mods.

    Change Log:

    • []Adds a new custom asset to the game. (DIGUS. MailFrameworkMod/MailData) That means MFM letters can now be loaded with Content Patcher and take use of all its features like tokens. It supports the same properties.

      []Content Pack letters are also loaded into the new custom asset and therefore can be edited with Content Patcher.

      []Content Packs are now being loaded into a cache at the game start, instead of reloaded every time the save is loaded. You can force the reloaded of content packs with the console command.

      []Text and Title properties now supports Tokenizable string.

      []Texture assets can now be a game asset, not just an asset in the mod folder.

      []New GameStateQuery property as condition a condition to deliver a letter.

    1. 19. 0

    • []New property to keep a mail valid once all conditions have been met for a day but the mail was not read on that day.

      []New feature to handle Randoly Chosen Attachment

      []New property to set how much items from the attachment list should be chosen to delivery.

      []New property to set a "RandomGroup" to an Attachment, so its pick from that group instead of from the whole list.

      []New property to set a "Weight" for a given attachment, when being picked randomly.

      []New property to set how many items should be pick from a given group, instead of using the default value.

      [] New property to say if an item from a given group can chosen more than once.

      []New set of property to set a MailReceived requirement for attachments and replies

      []New property to set a MailReceived to be removed when a letter is read or when a reply option is chicked.

      []New property to set a cost for a given reply option.

      []New ItemType "None". It basically to be used when you want a random chance of not delivering a item, without triggering error/warns in the log.

    1. 18. 0

    []New Ids property to replace Index and Name for CollectionConditions. It can aggregate multiple items count, summing their value to compare against the amount.

    []New ReplyConfig property to add a reply behavior. You can show some option to the player after reading a mail and it will add one or more MailReceived text based on the option chosen. Additional mod logic can be implemented based on that choice.

    []Fix to letter with recipe not supporting CustomTextColorName prope

🤖 AI-enhanced — based on mod data

Mail Framework Mod is a modding tool that enables the use of the in-game mailbox, offering console commands to adjust mail and providing code and content pack interfaces. With 85,959 endorsements and 4.5 million downloads, it's a highly popular framework for modders and players seeking mailbox functionality.

✨ Key Features

Framework to use the in-game mailbox
Console commands to adjust the mail
Code and Content Pack interfaces

📊 Pros & Cons

✅ Pros

  • Massive community trust with 85,959 endorsements
  • 4.5 million downloads prove it's a staple for many mod setups
  • Opens up mailbox functionality for modders and players alike

⚠️ Cons

  • As a framework, it's not a standalone gameplay addition; you'll need other mods to make use of it
  • Last updated March 2025—check compatibility with your current game version
🎯 Is This For You?
For modders and players who want to integrate mailbox features into their game. If you're a mod author looking to add mail mechanics, this is essential. Skip if you just want a simple mailbox mod without extra setup.
📦 Install:Medium· 5-10 minutes

💡 Beginner Tips

  • Since it's a framework, look for content packs that use it to see what it can do.
  • Use the console commands to test mail adjustments in-game before building your own content.
  • Check the mod's forum or Discord for examples and community-made content packs.

📊 Mod Details

Game
Stardew Valley Mods
Author
Digus
Version
1.20.0
Downloads
4,541,060
Endorsements
85,959
Category
Modding Tools
Created
10/9/2017
Updated
3/28/2025

🧩 Commonly Used Together

Users add these mods to the same collections — a real compatibility signal, not an AI guess.

🔧 How to Install Stardew Valley Mods

Download from Nexus.

📖 Full step-by-step install guide for Stardew Valley →

Visit the official mod page for specific installation instructions for this mod.

🎮 Need cheat codes or console commands? Check ur gaming wiki for Stardew Valley commands, item IDs, and more.

Keep browsing — more Stardew Valley mods await

📋 All Stardew Valley Mods 🏆 Top 25 📂 More Modding Tools 👤 More by Digus 🔎 Similar Mods 🌐 Best Modding Tools (All Games) ⚠️ Fix Crashes & Errors 🔀 Check Compatibility ⚖️ Compare Mods 🆕 New Mods