Wie man Stardew Valley-Mods erstellt: Das erste Dialogpaket mit dem Content Patcher erstellen

Erstelle ein kleines Paket für die Stardew Valley PC-Version 1.6 mit SMAPI und Content Patcher, um den ersten Begegnungsdialog von Abigail zu ändern. Du lernst das Prinzip der Datenänderung anhand von zwei JSON-Dateien ohne C#-DLLs. Überschreibe nicht direkt die XNB-Dateien des Spiels, sondern vergleiche das Anwenden und Deaktivieren in einem neuen Testspielstand.

1. Vorbereitung von SMAPI und Content Patcher

Stelle sicher, dass das Originalspiel im Standardzustand läuft, und sichere deine Spielstände sowie den Mods-Ordner. Installiere die passende SMAPI-Version für das aktuelle Spiel von der Website des Erstellers und lade den Content Patcher von der Originalquelle herunter. Überprüfe die unterstützten Versionen und Anforderungen der jeweiligen Dateien. Starte das Spiel einmal mit SMAPI, um zu überprüfen, ob Loader und Content Patcher korrekt angezeigt werden, und beende es dann. Das vorübergehende Ausschalten anderer Dialog-Mods beim ersten Test erleichtert die Fehlersuche.

2. Erstellen des Paketordners

Erstelle direkt im Mods-Ordner des Spiels den Ordner [CP] TroubleMakerHello. Achte beim Entpacken darauf, dass sich Ordner gleichen Namens nicht doppelt verschachteln, und überprüfe den Speicherort von manifest.json. Schalte unter Windows die Dateierweiterungen ein und passe auf, dass die Datei nicht als .json.txt gespeichert wird.

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

3. Schreiben der manifest.json

Die UniqueID wird im Format Ersteller.Paketname vergeben, um Konflikte mit anderen Paketen zu vermeiden. Die UniqueID von ContentPackFor ist nicht deine erstellte Paket-ID, sondern die ID des Content Patchers. Der folgende Inhalt ist das vollständige Manifest für dieses Beispiel. Speichere es in einem Texteditor als UTF-8.

{
  "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. Ändern eines Dialogs mit content.json

EditData bearbeitet festgelegte Schlüssel bestehender Daten. Füge deinen eigenen Dialog in den Schlüssel Introduction unter Characters/Dialogue/Abigail ein. Das Paketformat Format 2.0.0 ist das Format für Content-Patcher-Paketbeispiele der Spielserie 1.6; die tatsächlich benötigten Versionen von SMAPI und Content Patcher entnimmst du den Anleitungen der installierten Tools. Dieses Beispiel ändert nur den ersten Begrüßungsdialog und keine normalen täglichen Dialoge.

{
  "Format": "2.0.0",
  "Changes": [
    {
      "Action": "EditData",
      "Target": "Characters/Dialogue/Abigail",
      "Entries": {
        "Introduction": "Hallo! Du musst also der neue Farmbesitzer sein. Lass uns im Dorf oft treffen!"
      }
    }
  ]
}

5. Überprüfung der Anwendung in einem neuen Spielstand

1. Starte das Spiel mit SMAPI und überprüfe in der Konsole, ob TroubleMaker Hello Dialogue geladen wurde.
2. Erstelle eine neue Testfarm und sprich zum ersten Mal mit Abigail, ohne sie vorher getroffen zu haben.
3. Wenn der geschriebene Einleitungsdialog erscheint, wurden Schlüssel und Pfad korrekt angewendet. Falls du das Einführungsgespräch in einem älteren Spielstand bereits geführt hast, erscheint derselbe Satz möglicherweise nicht noch einmal.
4. Wenn sich der Dialog nicht ändert, überprüfe den Paket- und Patch-Status mit patch summary in der SMAPI-Konsole.
5. Beende das Spiel, bearbeite content.json und starte es zum Vergleich neu. Wie du patch reload in der Konsole während der Entwicklung verwendest, erfährst du in der dokumentierten Anleitung des Content Patchers.
6. Verschiebe das erstellte Paket aus dem Mods-Ordner heraus und starte das Spiel auf einer separaten Testfarm neu, um zu sehen, ob es zum standardmäßigen Begrüßungsdialog zurückkehrt.

6. Beheben von JSON-Fehlern und Konflikten

Fehlende Kommas, Anführungszeichenfehler und Tippfehler bei Schlüsseln sind häufig. JSON verwendet kein unnötiges Komma nach dem letzten Element. Achte beim Speichern mit einem Standardeditor darauf, dass keine intelligenten Anführungszeichen (Smart Quotes) verwendet wurden. Wenn ein anderes Paket denselben Schlüssel Abigail Introduction ändert, kann das Ergebnis je nach tatsächlicher Ladeinfolge variieren. Sobald es mit einem einzigen aktivierten Paket geklappt hat, füge bestehende Konfigurationen nacheinander hinzu und vergleiche die Protokolle (Logs). Wenn geladene Daten von der Sprache des Spiels abhängen, überprüfe sprachspezifische Bedingungen und i18n-Funktionen in der Originaldokumentation.

7. Deinstallation, Versionsverwaltung und Verteilung

Dieses Paket ändert ausschließlich Dialogdaten. Du kannst es deinstallieren, indem du das Spiel beendest und den entsprechenden Paketordner löschst. Dies birgt andere Risiken als das Entfernen von Karten- oder Item-Erweiterungsmods. Platziere den Paketordner ganz oben im Verteiler-ZIP, sodass die beiden JSON-Dateien direkt darin sichtbar sind. Schreibe in die README, dass PC 1.6, SMAPI und der Content Patcher erforderlich sind, erkläre, dass nur der erste Begrüßungsdialog geändert wird, und nenne die Testbedingungen. Stelle sicher, dass die Dialoge und Bilder von dir erstellt wurden, und füge keine Texte oder Porträts anderer Ersteller ohne Erlaubnis hinzu.

Originaldokumentation und Prüfkriterien

Dies ist eine Einführung von dem TroubleMaker-Betriebsteam, verfasst nach Überprüfung der offiziellen Tool-Dokumentation und Ersteller-Anleitungen am 7. Oktober 2026. Code und Diagramme sind eigene Beispiele zur Erläuterung und stellen keine Verifizierung des echten Gameplays dieses Spiels auf diesem Server dar. Überprüfe das Spiel vor der Verteilung mit der im Text angegebenen Version in einem separaten Testspielstand. Gleiche die neuesten Versionen und Abhängigkeiten der jeweiligen Tools mit den untenstehenden Originalquellen ab.

Content Patcher 제작자 가이드

Stardew 콘텐츠 팩 문서

Content Patcher 모딩 문서

SMAPI 원본