Mail Framework Modı

Amaç:
Oyuncuya gönderilen postayı basitleştirin, böylece ne zaman ve neyin alınacağı konusunda daha fazla kontrol sahibi olun.
Ayrıca veri dosyalarını düzenlemekle mümkün olmayan daha fazla seçenek sunmak, örneğin mektupların yazı rengini ve arka planını isteğe göre değiştirmek gibi.

Kurulum:

• SMAPI'nin en son sürümünü yükleyin.
• MailFrameworkMod'u açın/Stardew Valley/Mods'a.
  

Değişiklik Günlüğü:

1.20.0

• Oyuna yeni bir özel varlık ekler. (DIGUS.MailFrameworkMod/MailData) Bu, MFM harflerinin artık Content Patcher ile yüklenebileceği ve belirteçler gibi tüm özelliklerinden yararlanabileceği anlamına gelir. Aynı özellikleri destekler.
• İçerik Paketi harfleri de yeni özel varlığa yüklenir ve bu nedenle İçerik Yama Aracı ile düzenlenebilir.
• İçerik Paketleri artık oyun başlangıcında önbelleğe yükleniyor, kayıt her yüklendiğinde yeniden yüklenmiyor. İçerik paketlerinin yeniden yüklenmesini konsol komutuyla zorlayabilirsiniz.
• Metin ve Başlık özellikleri artık Tokenize edilebilir dizeyi destekliyor.
• Doku varlıkları artık mod klasöründeki bir varlık değil, bir oyun varlığı olabilir.
• Yeni GameStateQuery özelliği, bir mektubu teslim etme koşulu olarak.
  

1.19.0

• Tüm koşullar sağlandıktan sonra bir postanın geçerliliğini korumak için yeni bir özellik, ancak posta o gün okunmadı.
• Rastgele Seçilen Ek'i işlemek için yeni özellik
• Ekli listeden teslimat için ne kadar öğenin seçileceğini ayarlamak için yeni özellik.
• Bir Eklentiye "RandomGroup" atamak için yeni özellik, böylece tüm listeden seçmek yerine o gruptan seçim yapılabilir.
• Rastgele seçildiğinde belirli bir eklenti için "Ağırlık" ayarlamaya yarayan yeni özellik.
• Varsayılan değeri kullanmak yerine, belirli bir gruptan kaç öğenin seçileceğini ayarlamak için yeni özellik.
• Belirli bir gruptaki bir öğenin birden fazla seçilebileceğini söyleyen yeni özellik.
• Ekler ve yanıtlar için MailReceived gereksinimini belirlemek üzere yeni özellik kümesi
• Bir mektup okunduğunda veya bir cevap seçeneği işaretlendiğinde MailReceived'ın kaldırılmasını sağlayan yeni özellik.
• Belirli bir yanıt seçeneği için maliyet belirlemeye yönelik yeni özellik.
• Yeni ItemType "None". Temel olarak, günlükte hata/uyarı tetiklemeden, bir öğenin teslim edilememe olasılığını rastgele belirlemek istediğinizde kullanılır.
  

1.18.0

• CollectionConditions için Index ve Name'in yerini alacak yeni Ids özelliği. Birden fazla öğenin sayısını toplayabilir ve değerlerini tutarla karşılaştırmak için toplayabilir.
• Yanıtlama davranışı eklemek için yeni ReplyConfig özelliği. Bir e-postayı okuduktan sonra oyuncuya bazı seçenekler gösterebilirsiniz ve seçilen seçeneğe bağlı olarak bir veya daha fazla MailReceived metni eklenecektir. Bu seçime bağlı olarak ek mod mantığı uygulanabilir.
• CustomTextColorName özelliğini desteklemeyen tarifli harfe düzeltme.
• Oyun içerisinde null isimli bir öğe yüklenirken oluşan null referans istisnası düzeltildi.
  

1.17.1

• Tarif özelliği olan içerik paketi maillerinin, tarif öğrenilmediği takdirde tekrar iletilebilmesi için ek içermemesi gerekmektedir. (Ek varsa tarif özelliği göz ardı edilir)
• Yemek tariflerini, daha önce tarif hazırlamada uygulanan mantığın aynısıyla düzeltin.
  

1.17.0

• Eklentinin kalitesini ayarlamak için yeni özellik
• Tarif içeren içerik paketi mailleri, tarif öğrenilmediği takdirde tekrar iletilmelidir.
• Nitelikli öğe kimliğinin kullanılması durumunda Slingshot ile ilgili uyarılar düzeltildi.
• Tarifler daha önceden öğrenilmiş olsa bile, üretilebilir ürünlerin tariflerinin teslim edilmesi düzeltildi.
• Eski nedenlerden dolayı, eğer öğrenilen tariflerde tarif kimliği bulunamazsa, tarif kimliğinin adıyla bir öğe oluşturan bir tarif arayacaktır.
  

1.16.1

• Tarifin çevrilmiş adına düzeltme.
  

1.16.0

• Modun Stardew Valley 1.6 ile uyumlu olması için güncelleme yapıldı
• İçerik paketlerini yeniden yüklemek için yeni komut
• MailDao adı MailRepository olarak değiştirildi. (Sadece bunu kullanan SMAPI modlarını etkiler)
• Eklentiler için yeni Öğe Türü 'QualifiedItemId', doğru nitelendirmeyi kullanırsanız oyundaki her tür öğe için çalışmalıdır.
• Özel günler için yeni mülk koşulları. (Düğün ve Doğum)
• CustomTextColor için yeni özellik, eski özellik kullanımdan kaldırıldı.
• Yeni HasMods özelliği
• Yeni RequireAllMods özelliği
• Olay kimlikleri artık dizelerdir. (sayılar hala işe yaramalıdır)
• MFM'den eski mantık SV 1.6 kaldırıldı.
• Alfa sürümünde e-posta toplama sayfasında mektubun açılmaması sorunu düzeltildi.
  

Modcuların içerik paketini kullanabilmesi için:

• Mod klasörünün içerisinde her özelliğin ne işe yaradığını açıklayan açıklamalı talimatlar içeren bir şablon bulunmaktadır.
• Tüm harf özellikleri, ancak koşullar ve geri çağırma, framework ile kodlama ile aynıdır.
• Koşullar uygulananlarla sınırlıdır ve geri arama, mektup kimliğini her zaman alınan olarak ayarlar. Gelişmiş koşullara ihtiyacınız varsa, bunları yine de kodlamanız gerekir. Ya da içerik paketine bir koşul eklememi nazikçe önerebilirsiniz; mantıklı bir şeyse, ekleyebilirim.
• Mod dosyasına eklenen şablon şu şekilde:
  

Modder'ın API'yi kullanabilmesi için:

• KopyalaIMailFrameworkModApiMFM arayüzünden kullanmak istediğiniz yöntemle arayüz oluşturun.
• KopyalaMektupEğer yöntemlerden biri buna ihtiyaç duyarsa.
• Yöntemler:
  
  • RegisterContentPack- KullanmakYardımcı.İçerikPaketleri.GeçiciOluşturModunuzdan mail.json ve olası çeviriler için i18n klasörünü içeren bir klasörü yüklemek için. Bu metot parametresini kullanabildiğiniz için Manifest'e gerek yoktur.
  • Kayıt Mektubu- İhtiyacınız olan özelliklerle bir ILetter doldurun. Bir mektubu kaydetmek için bir koşul da gereklidir. En azından alındığı şekliyle mektup kimliğini eklemek için bir geri arama önerilir. Aşağıdaki örneklere bakın, "Modder'ın MFM bağımlılığıyla kod yazması için" oturum.
  • Mektup Al- Harf ID'si için ILetter nesnesini alacaksınız.
  • PostaVeriDizesiniAl- Mektup ID'si için posta veri dizesini alacaksınız. Posta veri dizesi temel olarak çevrilmiş metin ve çevrilmiş başlığın [#] ayracı ile eklenmesiyle oluşur.
    

Modder'ın MFM bağımlılığıyla kod yazabilmesi için:

• SMAPI projenizde MailFrameworkMod.dll dosyasına başvurun.
  
  • Mektubunuzu MailRepository.SaveLetter(Letter) kullanarak kaydedin.
  • Moderatör her günün başında teslim edilme durumuna ulaşan mektupları kontrol edecek ve posta kutunuza ekleyecektir.
  • Bu mektuplar, oyuncu posta kutusunu kontrol ettiğinde ilk açılacak olan mektuplardır.
  • Mektup açıldığında posta kutusundan çıkarılır.
  • Mektubun geri çağırma koşulu onlara denir.
  • Günün sonunda posta kutunuzda kalan mektuplar kaldırılacak, dolayısıyla oyun tarafından kaydedilmeyecektir.
    
• Bu modu, mektuplarınız için bir depo olarak düşünebilirsiniz. Oyun yüklenirken tüm mektuplarınızı yüklerseniz daha iyi çalışır.
  

Örnekler:

Spoiler:

Göstermek

Oyuncu tarafından daha önce okunmamışsa gösterilecek ve oyuncu tarafından açıldıktan sonra tekrar iletilmeyecek basit bir Mektup yükleme:
MailRepository.MektubuKaydet(
yeni Mektup(
"HarfBenzersizKimliği"
"Mektup özel metni."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Oyun1.oyuncu.postaAlındı.Ekle(l.Kimlik)
)
);


Daha önce olduğu gibi basit bir Mektup yükleniyor, ancak 5 Zümrüt eklenmiş:
MailRepository.MektubuKaydet(
yeni Mektup(
"HarfBenzersizKimliği"
"Mektup özel metni."
,yeni Liste<Öğe> { yeni StardewValley.Object(60,5) }
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Oyun1.oyuncu.postaAlındı.Ekle(l.Kimlik)
  )
);

Oyuncu aynı öğeyi almayacak, ancak getOne() metodundan döndürülen bir kopyayı alacaktır.

Yemek tarifi öğretecek basit bir mektup yüklendiğinde, oyuncu tarifi bilmiyorsa bu mektup iletilecektir. Mod, oyuncu yüklediğinde tarifleri otomatik olarak öğretir, burada geri çağırmaya gerek yoktur:
MailRepository.MektubuKaydet(
yeni Mektup(
"HarfBenzersizKimliği"
, "Mektup özel metni."
, "TarifBenzersizAdı"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
);

"RecipeUniqueName", "Data//CookingRecipes" veya "Data//CraftingRecipes" üzerinde saklanan adla aynı olmalıdır.

Farklı metin ve arka plan içeren basit bir Mektup yükleme:
MailRepository.MektubuKaydet(
yeni Mektup(
"HarfBenzersizKimliği"
"Mektup özel metni."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Oyun1.oyuncu.postaAlındı.Ekle(l.Kimlik)
1
){MetinRengi=8}
);


Loading a simple Letter with custom background:
MailRepository.SaveLetter(
  new Letter(
"LetterUniqueId"
,"Letter custom text."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
  ){
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,TextColor=4
  }
);
Where CustomLetterBG.png is a image file that follows the same structure as "LooseSprites//letterBG"

Loading a simple Letter with translation for text and title.
MailRepository.SaveLetter(
new Letter(
"LetterUniqueId"
,"mektubum.çeviri.anahtar.metin"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Oyun1.oyuncu.postaAlındı.Ekle(l.Kimlik)
){
Başlık = "myletter.çeviri.anahtar.başlık",
I18N = yardımcı.Çeviri
    }
);



Diğer Modlarım:

• Hayvancılık Modu
• Su Tutma Saha Modu
• Özel Crystalarium Modu
• Bitki Nakli Modu
• Özel Fıçı Modu
  

• Özel Öpüşme Modu
  

• Sınırsız Ahşap Zemin Modu
  

• Özel Üretici Modu
• Posta Hizmetleri Modu
• Arcane Table Modu
• Gem Lamba Direkleri Modu
• Gelişmiş Fıçılar Modu