Changes

Most times a static, predefined letter will suffice, whether you are including an attachment (i.e. object, money, etc.) or not.  "Static" simply means you do not need to change the text once it is typed before sending the letter.  A "static" letter will always be available in the game (unless you remove it from the mod or the mod is removed by the player) so that means the letter is still available if the player quits with your letter still in the mailbox and then returns to play later.  This can be an issue with "dynamic" letters, as explained in more detail in that section, so use "static" content whenever possible.

Most times a static, predefined letter will suffice, whether you are including an attachment (i.e. object, money, etc.) or not.  "Static" simply means you do not need to change the text once it is typed before sending the letter.  A "static" letter will always be available in the game (unless you remove it from the mod or the mod is removed by the player) so that means the letter is still available if the player quits with your letter still in the mailbox and then returns to play later.  This can be an issue with "dynamic" letters, as explained in more detail in that section, so use "static" content whenever possible.

You can softly reference the player's name, using "@", but other replace codes that may work in dialog texts, like %pet or %farm, do not work in static mail content at this time.  However, you can make use of some special characters that display an icon in the letter, such as "=", which will display a purple star, "<", which will display a pink heart, the "$", which will be replaced with a gold coin the "@", which will display a left arrow, ">", which will display a right arrow, the "`", which will display an up arrow, and the "+", which will display a head riding a skateboard (maybe?).  There may be additional special cases as well that are not yet documented.

You can softly reference the player's name, using "@", but other replace codes that may work in dialog texts, like %pet or %farm, do not work in static mail content at this time.  However, you can make use of some special characters that display an icon in the letter, such as "=", which will display a purple star, "<", which will display a pink heart, the "$", which will be replaced with a gold coin, the ">", which will display a right arrow, the "`", which will display an up arrow, and the "+", which will display a head riding a skateboard (maybe?).  There may be additional special cases as well that are not yet documented.

The example below adds 3 letters into the mail data collection.  Note, that the code below does not send any letters to the player, but simply makes them available to Stardew Valley game so they can be sent.

The example below adds 3 letters into the mail data collection.  Note, that the code below does not send any letters to the player, but simply makes them available to Stardew Valley game so they can be sent.

             data["MyModMail1"] = "Hello @... ^A single carat is a new line ^^Two carats will double space.";

             data["MyModMail1"] = "Hello @... ^A single carat is a new line ^^Two carats will double space.";

             data["MyModMail2"] = "This is how you send an existing item via email! %item object 388 50 %%";

             data["MyModMail2"] = "This is how you send an existing item via email! %item object 388 50 %%";

             data["MyModMail3"] = "Coin $  Star =  Heart <  Dude +   Left Arrow @   Up Arrow `";

             data["MyModMail3"] = "Coin $  Star =  Heart <  Dude + Right Arrow >   Up Arrow `";

             data["MyWizardMail"] = "Include Wizard in the mail Id to use the special background on a letter";

             data["MyWizardMail"] = "Include Wizard in the mail Id to use the special background on a letter";

         }

         }