Slippery slime to bind
Rotten plants turned to brimstone
The boom of exploding fireworks
A constellation of sparkles
Voyage of the Fireworks Festival

Made for the Stardew Valley Mod Jam January 2023

What Does This Mod Do?

• Adds a new festival, the Firework Festival, which takes place on Summer 20 between 8pm and midnight
• At this festival, you can buy fireworks, fruit, new foods, clothing, and even shop at the Traveling Cart
• You can also buy a fireworks manufacturing license, which comes with instructions on how to make fireworks 
• During the festival, there's a fireworks show
• The fireworks require a variety of ingredients to make them, which you can largely make with the Chemizer, a new machine you learn how to craft at Mining Level 6
  

How to Install This Mod

• Install Content Patcher
• Download this mod
• If you are updating the mod, please delete the old mod entirely first
• Unzip and place into Mods folder
  

Fireworks Crafting Details

Fireworks require:

• A metal salt (to give it color)
• Black powder (to make it go boom)
• Fiber (to package it all)
• Slime (to stick everything together)
  

There are 6 kinds of metal salts:

• Strontium salt makes red fireworks
• Limestone (calcium carbonate) makes orange fireworks
• Iron salt makes yellow fireworks
• Barium salt makes green fireworks
• Copper salt makes blue fireworks
• Iridium salt makes purple fireworks
• Magnesium salt makes white fireworks
  

These are mostly from real-life fireworks chemistry! (With the exception of iridium, which is clearly a much more versatile material in Stardew Valley than it is in real life.) To make these salts, you can place various items in the Chemizer, largely based on the real-life minerals and their chemical compositions. You can also place bone items to get Limestone, and eggs to get rotten eggs (because nothing good happens when you randomly jam eggs into a machine). Rotten plants, rotten eggs, and certain minerals make Brimstone. 

Black powder requires:

• Niter (also known as saltpeter or potassium nitrate, buy from Clint)
• Brimstone (also known as sulfur, made from sulfurous minerals, rotten eggs, or rotten plants)
• Coal
  

This is the classic recipe! In the real world, proportions matter, but in Stardew Valley you always get those just right on the first try.

Full crafting details: https://github.com/elizabethcd/FireworksFestival#full-crafting-details

Known Bugs

• None currently known
  
  

If you find a bug, please report it with a link to your log from smapi.io/log.

Translations
To translate this mod, there is exactly 1 file that must be translated. There is default.json in the i18n folder in the [CP] Fireworks Festival folder. Please do not translate anything in the content.json files or you may cause problems in the mod.

Mod Compatibility

• There is built-in NPC compatibility for: Jasper, Jessie and Juliet, Mister Ginger, Jean and Jorts. There is planned future compatibility for Always Raining in the Valley NPCs. If you have an NPC mod, you can look through the NPCcompat.json for examples of how to add your NPC to the map and add dialogue. The .tmx file for the map has red dots on the Paths layer where NPCs currently stand, and in the future it is planned to add the festival map to the Custom NPC Tiles spreadsheet.
• This should be generally compatible with other mods, including recolors
• Unless another mod adds a festival on Summer 20, you should be good to go (I checked the mods I know of that add festivals, Surfing Festival, Ridgeside, and SVE all seem to not have festivals on this day.) This does not seem to interfere with the new passive festival in 1.6, but bug reports are welcome if you notice issues. 
• This is compatible with multiplayer, but may not be compatible with splitscreen (untested)
  

Source code: https://github.com/elizabethcd/FireworksFestival
Big extra thanks to: atravita for helping me debug DGA and countless of my own silly mistakes, DaLion, kittycatcasey, Shockah, Misha for helping me test multiplayer, and everyone who helped me out on the Stardew Valley Discord. Thank you to Matt for running the mod jam!