ContentPatcher

Content Patcher is a Stardew Valley mod which loads content packs to change the game's data, images, and maps without replacing game files.

Contents

• For players
  • Install
  • Compatibility
  • Configure content packs
  • Multiplayer
• For mod authors
• See also

For players

Install

1. Install the latest version of SMAPI.
2. Install this mod from Nexus Mods.
3. Unzip any Content Patcher content packs into Mods to install them.
4. Run the game using SMAPI.

That's it! Content packs unzipped into Mods will be loaded and applied automatically.

Compatibility

Content Patcher is compatible with Stardew Valley 1.6+ on Linux/macOS/Windows, both single-player and multiplayer.

Configure content packs

Many content packs can be configured using a config.json file, which Content Patcher will create the first time you launch the game with that content pack installed. (If no config.json appears, the mod probably isn't configurable.)

If you have Generic Mod Config Menu installed, Content Patcher will automatically add configurable content packs to its in-game menu:

Multiplayer

Content Patcher works fine in multiplayer. It's best if all players have the same content packs, but not required. Here are the effects if some players don't have a content pack installed:

patch type	effect
visual	Only visible to players that have it installed.
maps	Only visible to players that have it installed. Players without the custom map will see the normal map and will be subject to the normal bounds (e.g. they may see other players walk through walls, but they won't be able to follow).
data	Only directly affects players that have it installed, but can indirectly affect other players. For example, if a content pack changes Data/Objects and you create a new object, other player will see that object's custom values even if their Data/Objects doesn't have those changes.

For mod authors

• To create content packs, see the author guide and its tokens subpage.
• To add custom Content Patcher tokens from a SMAPI mod, see the extensibility API.
• To use Content Patcher conditions and token strings in your own SMAPI mod, see the conditions API and token string API.

Configure

Content Patcher creates a config.json file in its mod folder the first time you run it. You can open that file in a text editor to configure the mod.

These are the available settings:

setting	what it affects
EnableDebugFeatures	Default false. Whether to enable debug features meant for content pack creators.
Controls	The configured controller, keyboard, and mouse buttons (see key bindings). The default button bindings are... F3 to show the debug overlay (if enabled); LeftControl and RightControl to switch textures in the debug overlay. You can separate bindings with commas (like B, LeftShoulder for either one), and set multi-key bindings with plus signs (like LeftShift + B).

See also

• Release notes
• Nexus mod
• Ask for help