Skip to content

Latest commit

 

History

History

ContentPatcher

README.md

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

  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

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