This wiki is a read-only version of the Stardew Valley Wiki. The official editable wiki maintained by ConcernedApe can be found at stardewvalleywiki.com
Do you want to create Content Patcher packs for Stardew Valley? This guide is for you! '''{{nexus modFor using mods, see [[Modding:Player Guide/Getting Started|1915|Content Patcher}}Modding:Player Guide]].''' is a SMAPI mod which lets you change the game's images, dialogue, data, etc without replacing XNB files. No programming is needed.
==FAQsIntro=====How does it workWhat is Content Patcher?===With {{nexus mod|1915|Content Patcher, you create }} is a [[Modding:Content packs|content pack]] SMAPI mod which contains your changes and a JSON file lets you change the game assets (that's just a text formatimages, dialogue, data, and maps)without replacing game files or writing code. Players install You use it by unzipping it into <tt>Mods</tt>, just like creating a SMAPI modcontent pack (basically a folder with certain files) with a couple of JSON files. Just by editing the a JSON file, you can...
* replace one image file;
* make seasonal changes;
* make dialogue that changes based on the weather, date, your relationships with other NPCs, etc;
* make very specific changes (like coffee is more expensive in on winter weekends when it's snowing on after you've completed the weekendJojaMart);
* and much more.
===Content Patcher vs XNB mods===
If you're familiar with creating XNB mods, Content Patcher supports everything XNB mods supported. Here's a quick comparison:
{| class="wikitable"
|-
!
! XNB mod
! Content Patcher
|-
| easy to create
| ✘ need to unpack/repack files
| ✓ edit JSON files
|-
| easy to install
| ✘ different for every mod
| ✓ drop into <tt>Mods</tt>
|-
| easy to uninstall
| ✘ manually restore files
| ✓ remove from Mods
|-
| update checks
| ✘ no
| ✓ yes (via SMAPI)
|-
| compatibility checks
| ✘ no
| ✓ yes (via SMAPI DB)
|-
| mod compatibility
| ✘ very poor
| (each file can only be changed by one mod)
|-
| ✓ high
| (mods only conflict if they edit the same part of a file)
| game compatibility
|-
| ✘ break in most updates
| ✓ only affected if the part they edited changes
|-
| easy to troubleshoot
| ✘ no record of changes
| ✓ SMAPI log + Content Patcher validation
|}
===Content Patcher vs other mods===
Content Patcher supports all game assets with some very powerful features, but it's a generalistgeneral framework. More specialised frameworks might be better for specific things. You should considerwhether one of these would work for you:
* {{nexus mod|2270|Advanced Location Loader}} for complex changes to add and maps. (For simple changes, see ''[[/Edit maps|edit maps]]''.)
* {{nexus mod|991|Custom Farming Redux}} to add machines.
* {{nexus mod|1254|Custom Furniture}} to add furniture.
* {{nexus mod|1607|CustomNPC}} to add NPCs.
* {{nexus mod|2416|Custom Shirts}} to add shirts.
* {{nexus mod|1720|Json Assets}} to add items and , crafting recipes, crops, fruit trees, hats, and weapons. (For a comparison with legacy XNB mods, see ''[[Modding:Using XNB mods|using XNB mods]]''.) ===Content Patcher vs SMAPI===SMAPI is the modding API used to add mods to the game (Content Patcher itself is a SMAPI mod). If the mod you want to create is possible with Content Patcher, that's recommended since it's easier to maintain and update. However, you can also program a mod using SMAPI directly if you want; see [[Modding:Modder Guide/Get Started|creating SMAPI mods]] for more info.