Cara Membuat Mod Stardew Valley: Membuat Paket Dialog Pertama Anda dengan Content Patcher

Buat paket kecil untuk mengubah dialog pertemuan pertama Abigail menggunakan SMAPI dan Content Patcher di seri Stardew Valley PC 1.6. Pelajari prinsip perubahan data menggunakan dua file JSON tanpa DLL C#. Bandingkan penerapan dan pembatalannya di penyimpanan uji baru tanpa menimpa file XNB game secara langsung.

1. Persiapan SMAPI dan Content Patcher

Konfirmasikan bahwa game asli berjalan dalam kondisi normal dan buat cadangan penyimpanan serta folder Mods. Instal SMAPI untuk game saat ini dari situs pembuatnya lalu ambil Content Patcher dari sumber aslinya. Periksa versi yang didukung dan Persyaratan dari setiap file. Jalankan game sekali dengan SMAPI untuk memeriksa apakah peluncur dan Content Patcher ditampilkan secara normal lalu keluar. Menonaktifkan paket modifikasi dialog lain untuk sementara pada pengujian pertama akan memudahkan identifikasi penyebabnya.

2. Membuat folder paket

Buat folder [CP] TroubleMakerHello tepat di bawah Mods game. Periksa lokasi manifest.json saat mengekstrak zip agar folder dengan nama yang sama tidak tumpang tindih dua kali. Di Windows, aktifkan tampilan ekstensi dan berhati-hatilah agar tidak menyimpannya sebagai .json.txt.

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

3. Menulis manifest.json

Atur UniqueID dalam bentuk pembuat.namapaket yang tidak bertentangan dengan paket lain. UniqueID dari ContentPackFor bukanlah ID paket yang Anda buat melainkan ID Content Patcher. Konten di bawah ini adalah manifest lengkap dari contoh ini. Simpan sebagai UTF-8 di editor teks.

{
  "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. Mengubah satu dialog dengan content.json

EditData memodifikasi kunci yang ditentukan dari data yang ada. Masukkan dialog Anda sendiri ke dalam kunci Introduction dari Characters/Dialogue/Abigail. Paket Format 2.0.0 adalah format contoh paket Content Patcher untuk seri game 1.6, dan versi aktual yang diperlukan dari SMAPI serta Content Patcher diperiksa pada petunjuk alat yang diinstal. Contoh ini tidak mengubah dialog harian normal melainkan hanya dialog perkenalan pertama.

{
  "Format": "2.0.0",
  "Changes": [
    {
      "Action": "EditData",
      "Target": "Characters/Dialogue/Abigail",
      "Entries": {
        "Introduction": "Halo! Kamu adalah pemilik pertanian yang baru. Mari sering-sering bertemu di desa!"
      }
    }
  ]
}

5. Konfirmasi penerapan pada penyimpanan baru

1. Jalankan dengan SMAPI dan periksa apakah TroubleMaker Hello Dialogue terbaca di konsol.
2. Buat pertanian uji baru dan ajak Abigail berbicara untuk pertama kalinya saat Anda belum pernah menemuinya.
3. Jika dialog perkenalan yang ditulis muncul, kunci dan jalur telah diterapkan secara normal. Jika Anda sudah melakukan percakapan perkenalan pada penyimpanan yang ada, kalimat yang sama mungkin tidak akan muncul lagi.
4. Jika dialog tidak berubah, periksa paket dan status patch dengan patch summary di konsol SMAPI.
5. Setelah keluar dari game, ubah content.json dan jalankan ulang untuk membandingkan. Periksa dokumentasi Content Patcher yang terpasang untuk cara menggunakan patch reload di konsol selama pengembangan.
6. Setelah memindahkan paket pembuatan ke luar Mods dan menjalankannya kembali, konfirmasikan di pertanian uji terpisah apakah paket tersebut kembali ke dialog perkenalan default.

6. Mengatasi kesalahan dan konflik JSON

Koma yang hilang, kesalahan tanda kutip, dan salah ketik nama kunci adalah hal yang umum. JSON tidak menggunakan koma yang tidak perlu setelah item terakhir. Saat menyimpan dengan editor default, periksa apakah itu berubah menjadi tanda kutip cerdas. Jika ada paket lain yang mengubah kunci Abigail Introduction yang sama, hasilnya mungkin berbeda tergantung pada urutan pemuatan aktual. Setelah berhasil dengan hanya satu paket yang aktif, tambahkan konfigurasi yang ada satu per satu dan bandingkan log. Ketika data yang dimuat berubah tergantung pada bahasa game, lanjutkan memeriksa ketentuan khusus bahasa dan fungsi i18n di dokumen asli.

7. Penghapusan, Manajemen Versi, dan Distribusi

Paket ini hanya memodifikasi data dialog. Anda dapat menghapusnya dengan keluar dari game dan menghapus folder paket yang sesuai, dan risikonya berbeda dari penghapusan mod ekspansi peta dan item. Letakkan folder paket di bagian atas ZIP distribusi dan buat dua JSON terlihat langsung di dalamnya. Tulis di README deskripsi dan kondisi pengujian bahwa PC 1.6, SMAPI, dan Content Patcher diperlukan, dan hanya dialog perkenalan pertama yang diubah. Verifikasi bahwa dialog dan gambar adalah karya Anda sendiri dan jangan sertakan teks atau potret pembuat lain tanpa izin.

Dokumen Asli dan Kriteria Konfirmasi

Ini adalah panduan pengantar yang ditulis oleh tim operasi TroubleMaker dengan memeriksa dokumentasi pembuat dan alat resmi pada 7 Oktober 2026. Kode dan diagram adalah contoh kami sendiri untuk penjelasan dan bukan hasil verifikasi permainan aktual dari game ini di server ini. Konfirmasikan dalam penyimpanan uji terpisah dengan versi yang ditentukan dalam teks dan distribusikan. Versi terbaru dan dependensi per alat dicocokkan dari aslinya di bawah ini.

Content Patcher 제작자 가이드

Stardew 콘텐츠 팩 문서

Content Patcher 모딩 문서

SMAPI 원본