Kerangka Mail Mod

Tujuan:
Sederhanakan pengiriman surat ke pemain, berikan kontrol lebih besar atas kapan dan apa yang harus diterima.
Juga memberikan lebih banyak pilihan yang tidak mungkin dilakukan hanya dengan mengedit berkas data, seperti mengubah warna teks dan latar belakang surat sesuka hati.

Instalasi:

• Instal SMAPI versi terbaru.
• Ekstrak MailFrameworkModke /Stardew Valley/Mods.
  

Catatan Perubahan:

1.20.0

• Menambahkan aset kustom baru ke dalam game. (DIGUS.MailFrameworkMod/MailData) Artinya, huruf MFM kini dapat dimuat dengan Content Patcher dan menggunakan semua fiturnya seperti token. Properti yang sama juga didukung.
• Huruf-huruf Paket Konten juga dimuat ke dalam aset kustom baru dan karenanya dapat diedit dengan Content Patcher.
• Paket Konten kini dimuat ke dalam cache saat permainan dimulai, alih-alih dimuat ulang setiap kali penyimpanan dimuat. Anda dapat memaksa pemuatan ulang paket konten dengan perintah konsol.
• Properti Teks dan Judul sekarang mendukung string yang dapat dijadikan Token.
• Aset tekstur sekarang dapat menjadi aset game, bukan hanya aset dalam folder mod.
• Properti GameStateQuery baru sebagai kondisi untuk mengirimkan surat.
  

1.19.0

• Properti baru untuk menjaga surat tetap valid setelah semua ketentuan terpenuhi selama suatu hari tetapi surat tersebut tidak dibaca pada hari itu.
• Fitur baru untuk menangani Lampiran yang Dipilih Secara Acak
• Properti baru untuk menetapkan berapa banyak item dari daftar lampiran yang harus dipilih untuk pengiriman.
• Properti baru untuk menetapkan "RandomGroup" ke Lampiran, sehingga memilih dari grup tersebut, bukan dari keseluruhan daftar.
• Properti baru untuk menetapkan "Bobot" untuk lampiran tertentu, saat dipilih secara acak.
• Properti baru untuk menetapkan berapa banyak item yang harus diambil dari grup tertentu, alih-alih menggunakan nilai default.
• Properti baru untuk mengatakan apakah suatu item dari grup tertentu dapat dipilih lebih dari satu kali.
• Kumpulan properti baru untuk menetapkan persyaratan MailReceived untuk lampiran dan balasan
• Properti baru untuk mengatur MailReceived agar dihapus saat surat dibaca atau saat opsi balasan ditekan.
• Properti baru untuk menetapkan biaya untuk opsi balasan tertentu.
• Tipe Item Baru "None". Pada dasarnya, ini digunakan ketika Anda menginginkan kemungkinan acak untuk tidak mengirimkan item, tanpa memicu kesalahan/peringatan di log.
  

1.18.0

• Properti Ids baru menggantikan Index dan Name untuk CollectionConditions. Properti ini dapat mengagregasi beberapa item, menjumlahkan nilainya untuk dibandingkan dengan jumlahnya.
• Properti ReplyConfig baru untuk menambahkan perilaku balasan. Anda dapat menampilkan beberapa opsi kepada pemain setelah membaca email, dan pemain akan menambahkan satu atau beberapa teks MailReceived berdasarkan opsi yang dipilih. Logika mod tambahan dapat diimplementasikan berdasarkan pilihan tersebut.
• Perbaikan pada huruf dengan resep yang tidak mendukung properti CustomTextColorName.
• Memperbaiki pengecualian referensi nol saat item dengan nama nol dimuat dalam permainan.
  

1.17.1

• Email paket konten dengan properti resep tidak boleh disertai lampiran agar dapat dikirim ulang jika resepnya tidak dipelajari. (properti resep diabaikan jika ada lampiran)
• Memperbaiki resep masakan dengan logika yang sama yang diterapkan untuk membuat resep sebelumnya.
  

1.17.0

• Properti baru untuk mengatur kualitas lampiran
• Paket konten yang disertai resep harus dikirim ulang jika resepnya tidak dipelajari.
• Perbaiki peringatan tentang Slingshot jika menggunakan ID item yang memenuhi syarat.
• Memperbaiki resep untuk barang kerajinan yang telah dikirimkan meskipun resepnya sudah dipelajari.
• Karena alasan warisan, jika id resep tidak ditemukan dalam resep yang dipelajari, ia akan mencari resep yang membuat item dengan nama id resep.
  

1.16.1

• Perbaikan pada nama terjemahan resep.
  

1.16.0

• Perbarui mod agar kompatibel dengan Stardew Valley 1.6
• Perintah baru untuk memuat ulang paket konten
• Mengubah nama MailDao menjadi MailRepository. (Hanya memengaruhi mod SMAPI yang menggunakannya)
• Jenis Item Baru 'QualifiedItemId' untuk lampiran, seharusnya berfungsi untuk setiap jenis item dalam permainan jika Anda menggunakan kualifikasi yang tepat.
• Properti baru untuk kondisi tanggal khusus. (Pernikahan dan Melahirkan)
• Properti baru untuk CustomTextColor, yang lama tidak digunakan lagi.
• Properti HasMods baru
• Properti RequireAllMods baru
• ID acara sekarang berupa string. (angka seharusnya masih berfungsi)
• Menghapus logika usang SV 1.6 yang disertakan dalam MFM.
• Memperbaiki masalah dari versi alfa di mana surat tidak dapat dibuka di halaman pengumpulan surat.
  

Bagi Modder untuk menggunakan paket konten:

• Ada templat di dalam folder mod dengan instruksi yang diberi komentar tentang fungsi setiap properti.
• Semua fitur huruf kecuali kondisi dan panggilan balik sama seperti pengkodean dengan kerangka kerja.
• Kondisi terbatas pada kondisi yang diimplementasikan, dan panggilan balik selalu menetapkan ID huruf sebagai kondisi yang diterima. Jika Anda membutuhkan kondisi lanjutan, Anda tetap harus mengodekannya. Atau Anda bisa dengan sopan menyarankan saya untuk menambahkan kondisi ke paket konten. Jika kondisinya masuk akal, saya mungkin akan menambahkannya.
• Berikut ini adalah templat sebagaimana yang ditambahkan dalam berkas mod:
  

Agar Modder dapat menggunakan API:

• MenyalinIMailFrameworkModApiantarmuka dengan metode yang ingin Anda gunakan dari antarmuka MFM.
• MenyalinSuratjika salah satu metode membutuhkannya.
• Metode:
  
  • DaftarKontenPaket- MenggunakanHelper.ContentPacks.CreateTemporaryuntuk memuat folder dari mod Anda yang berisi mail.json dan kemungkinan folder i18n untuk terjemahan. Manifest tidak diperlukan karena Anda dapat menggunakan parameter metode tersebut.
  • RegisterSurat- Isi ILetter dengan properti yang Anda butuhkan. Kondisi juga diperlukan untuk mendaftarkan surat. Disarankan untuk menggunakan callback, setidaknya untuk menambahkan ID surat yang diterima. Lihat contoh di bawah ini, pada "Untuk Modder untuk membuat kode dengan dependensi MFM" sesi.
  • DapatkanSurat- Anda akan mendapatkan objek ILetter untuk ID huruf.
  • DapatkanStringDataEmailAnda akan mendapatkan string data email untuk ID surat. String data email pada dasarnya adalah teks terjemahan ditambah judul terjemahan dengan pemisah [#].
    

Agar Modder dapat membuat kode dengan dependensi MFM:

• Referensikan MailFrameworkMod.dll pada proyek SMAPI Anda.
  
  • Anda mendaftarkan Surat Anda menggunakan MailRepository.SaveLetter(Letter)
  • Pada awal setiap hari, mod akan memeriksa Surat yang telah mencapai kondisi pengiriman dan menambahkannya ke kotak surat.
  • Surat ini akan dibuka pertama kali saat pemain memeriksa kotak surat.
  • Ketika Surat dibuka, surat itu dikeluarkan dari kotak surat.
  • Kondisi panggilan balik dari surat itulah yang disebut.
  • Pada akhir hari Surat yang masih ada di kotak surat akan dihapus, jadi surat tersebut tidak disimpan oleh permainan.
    
• Anggap saja mod ini sebagai repositori untuk surat-suratmu. Mod ini akan berfungsi paling baik jika kamu memuat semua suratmu saat game dimuat.
  

Contoh:

Bocoran:

Menunjukkan

Memuat Surat sederhana yang akan ditampilkan kepada pemain jika belum dibaca sebelumnya, dan tidak akan dikirimkan lagi setelah dibuka oleh pemain:
MailRepository.SimpanSurat(
Surat baru(
"Id Unik Surat"
,"Surat teks khusus."
,(l)=>!Game1.pemain.mailDiterima.Berisi(l.Id)
,(l)=>Game1.pemain.mailDiterima.Tambah(l.Id)
)
);


Memuat Surat sederhana seperti sebelumnya, tetapi dengan 5 Zamrud terlampir:
MailRepository.SimpanSurat(
Surat baru(
"Id Unik Surat"
,"Surat teks khusus."
,new List { new StardewValley.Object(60,5) }
,(l)=>!Game1.pemain.mailDiterima.Berisi(l.Id)
,(l)=>Game1.pemain.mailDiterima.Tambah(l.Id)
  )
);

Pemain tidak akan menerima item yang sama, tetapi salinan yang dikembalikan dari metode getOne().

Memuat Surat sederhana yang akan mengajarkan resep memasak, akan dikirimkan jika pemain tidak tahu resepnya. Mod akan otomatis mengajarkan resep saat pemain memuat, tanpa perlu panggilan balik di sini:
MailRepository.SimpanSurat(
Surat baru(
"Id Unik Surat"
, "Surat teks khusus."
, "NamaResepUnik"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
);

"RecipeUniqueName" harus sama dengan yang disimpan pada "Data//CookingRecipes" atau "Data//CraftingRecipes".

Memuat Surat sederhana dengan teks dan latar belakang berbeda:
MailRepository.SimpanSurat(
Surat baru(
"Id Unik Surat"
,"Surat teks khusus."
,(l)=>!Game1.pemain.mailDiterima.Berisi(l.Id)
,(l)=>Game1.pemain.mailDiterima.Tambah(l.Id)
1
){WarnaTeks=8}
);


Memuat Surat sederhana dengan latar belakang khusus:
MailRepository.SimpanSurat(
Surat baru(
"Id Unik Surat"
,"Surat teks khusus."
,(l)=>!Game1.pemain.mailDiterima.Berisi(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
){
Tekstur Huruf=helper.Konten.Muat("CustomLetterBG.png")
,WarnaTeks=4
  }
);
Dimana CustomLetterBG.png adalah file gambar yang mengikuti struktur yang sama dengan "LooseSprites//letterBG"

Memuat Surat sederhana dengan terjemahan untuk teks dan judul.
MailRepository.SimpanSurat(
Surat baru(
"Id Unik Surat"
,"hurufku.kunci.terjemahan.teks"
,(l)=>!Game1.pemain.mailDiterima.Berisi(l.Id)
,(l)=>Game1.pemain.mailDiterima.Tambah(l.Id)
){
Judul = "kunci.terjemahan.suratku.judul",
I18N = pembantu.Terjemahan
    }
);



Mod Saya Lainnya:

• Mod Peternakan Hewan
• Mod Lapangan Penahan Air
• Mod Kristalarium Kustom
• Mod Transplantasi Tanaman
• Mod Cask Kustom
  

• Mod Ciuman Kustom
  

• Mod Lantai Kayu Tanpa Batas
  

• Mod Produsen Kustom
• Mod Layanan Surat
• Mod Meja Arcane
• Mod Tiang Lampu Permata
• Mod Casks Lanjutan