How to Make Stardew Valley Mods: Create Your First Dialogue Pack with Content Patcher

In Stardew Valley PC 1.6 series, create a small pack that changes Abigail's first meeting dialogue using SMAPI and Content Patcher. Learn the data-changing principle with two JSON files without C# DLLs. Instead of directly overwriting game XNB files, compare application and removal in a new test save.

1. Prepare SMAPI and Content Patcher

Make sure the vanilla game runs properly and back up your saves and Mods folder. Install the SMAPI version matching your current game from the creator's site, then get Content Patcher from the original source. Check the supported versions and requirements for each file. Run the game once with SMAPI to verify that the loader and Content Patcher display normally, then exit. Temporarily turning off other dialogue modification packs during the first test makes it easier to isolate the cause.

2. Create the Pack Folder

Create a [CP] TroubleMakerHello folder directly under the game's Mods directory. Check the location of manifest.json so that folders with the same name do not nest twice when extracted. On Windows, make sure file name extensions are visible so it is not saved as .json.txt.

Stardew Valley/
  Mods/
    ContentPatcher/
    [CP] TroubleMakerHello/
      manifest.json
      content.json

3. Write manifest.json

Specify UniqueID in the format Creator.PackName to avoid conflicts with other packs. The UniqueID in ContentPackFor is not your pack ID, but Content Patcher's ID. The content below is the full manifest for this example. Save as UTF-8 in a text editor.

{
  "Name": "TroubleMaker Hello Dialogue",
  "Author": "TroubleMaker",
  "Version": "1.0.0",
  "Description": "An original introduction dialogue example.",
  "UniqueID": "TroubleMaker.HelloDialogue",
  "MinimumApiVersion": "4.0.0",
  "ContentPackFor": {
    "UniqueID": "Pathoschild.ContentPatcher"
  }
}

4. Change a Dialogue with content.json

EditData modifies designated keys of existing data. Insert your own dialogue into the Introduction key of Characters/Dialogue/Abigail. Pack Format 2.0.0 is the format for Content Patcher pack examples for game 1.6 series, and actual required versions of SMAPI and Content Patcher should be checked in the installed tool guide. This example changes only the first introduction dialogue, not general daily dialogues.

{
  "Format": "2.0.0",
  "Changes": [
    {
      "Action": "EditData",
      "Target": "Characters/Dialogue/Abigail",
      "Entries": {
        "Introduction": "Hello! You must be the new farmer. Let's see each other often around town!"
      }
    }
  ]
}

5. Verify Application in a New Save

1. Run with SMAPI and check the console to see if TroubleMaker Hello Dialogue was loaded.
2. Create a new test farm and talk to Abigail for the first time before having met her yet.
3. If your written introduction dialogue appears, the key and path were applied correctly. If you already had the introduction dialogue in an existing save, the same sentence might not appear again.
4. If the dialogue does not change, check the pack and patch status with patch summary in the SMAPI console.
5. Exit the game, modify content.json, and re-run to compare. For how to use patch reload in the console during development, check the installed Content Patcher documentation.
6. Move the creation pack out of Mods and run again in a separate test farm to confirm it reverts to the default introduction dialogue.

6. Troubleshooting JSON Errors and Conflicts

Missing commas, quote errors, and key name typos are common. JSON does not use trailing commas after the last item. Make sure smart quotes were not substituted when saving with a default editor. If another pack changes the same Abigail Introduction key, results may vary depending on the actual loading order. Succeed with only one pack turned on, then add existing configurations one by one and compare logs. When data loaded depends on the game language, check language-specific conditions and i18n features in the original documentation.

7. Removal, Version Control, and Distribution

This pack only modifies dialogue data. You can uninstall it by exiting the game and removing the pack folder, which carries different risks than removing map or item expansion mods. Place the pack folder at the top level of the distribution ZIP and make both JSONs directly visible inside it. In the README, write that PC 1.6, SMAPI, and Content Patcher are required, explain that only the first introduction dialogue changes, and state the test conditions. Verify that dialogues and images are your own work and do not include text or portraits from other creators without permission.

Original Documentation and Verification Criteria

An introductory guide written by the TroubleMaker operations team, verified against creator and official tool documentation on October 7, 2026. Code and diagrams are custom examples for explanation purposes and do not represent actual gameplay verification of the game on this server. Verify and distribute in a separate test save with the versions specified in the text. Cross-reference the latest versions and dependencies for each tool from the sources below.

Content Patcher 제작자 가이드

Stardew 콘텐츠 팩 문서

Content Patcher 모딩 문서

SMAPI 원본