We are in the process of transferring the hosting and maintenance responsibilities of the wiki from Chucklefish to ConcernedApe, which is why the wiki will temporarily be hosted at stardewcommunitywiki.com. Soon the official wiki will resume at stardewvalleywiki.com and will be hosted going forward by ConcernedApe. Prior to the transfer to ConcernedApe we will update this site with the date on which the transfer will occur.
A content pack is a collection of files loaded by a specific content pack framework (essentially a sub-mod). Content packs can contain any files, but usually consist of JSON files and images.
If you want to use a content pack, install it just like a SMAPI mod (see player guide). Make sure you install the mod it needs too.
Create a content pack
- Decide which content pack framework you'll use (each framework defines the particular files you need).
- Install SMAPI.
- Create the generic content pack format (identical for all frameworks):
- Add the files needed by the content pack framework (see its mod page for details).
- Launch the game, and make sure your new content pack appears under "Loaded X content packs" in the SMAPI console.
Release your content pack
- Add an update key to your manifest (if you haven't already).
- Update the Version field in the manifest. (Increase it for each release! SMAPI will use it for update and compatibility checks.)
- Create a .zip file containing the content pack's folder.
- Upload that file to Nexus Mods.
In your mod description, providing clear install steps will help reduce support questions. Example BBCode:
[size=5]Install[/size] [list=1] [*][url=https://smapi.io]Install the latest version of SMAPI[/url]. [*][url=<url of required mod>]Install <name of required mod>[/url]. [*]Download this mod and unzip it into [font=Courier New]Stardew Valley/Mods[/font]. [*]Run the game using SMAPI. [/list]
Consume a content pack
If you're writing a SMAPI mod which will read content packs, see Modding:Modder Guide/APIs/Content Packs.
These are recommended practices, but they're not required.
The folder name should use upper camel case with a prefix showing which mod it's for. For example, a folder named
[CP] SampleName is a content pack for Content Patcher.
Here are some common prefixes:
||Animal Husbandry Mod|
||Better Artisan Goods Icons|
||Better Farm Animal Variety|
||Custom Farming Redux|
||Farm Type Manager|
||Mail Framework Mod|
||More Than Necessary|
||Producer Framework Mod|
||Shop Tile Framework|
The folder should contain your
content.json (or the correct json for your framework), and an
assets folder that contains any other files your mod uses. This may include pngs, other json files, or tbin files, among others. The assets folder may use further subfolders if you wish, though it is not required.