Mod ramy poczty

Cel:
Uprość wysyłanie poczty do gracza, zapewniając sobie większą kontrolę nad tym, kiedy i co powinno zostać odebrane.
Dając również więcej opcji, nie można po prostu edytować plików danych, np. zmieniać kolor tekstu i tło listu na żądanie.

Instalacja:

• Zainstaluj najnowszą wersję SMAPI.
• Rozpakuj MailFrameworkModdo /Stardew Valley/Mods.
  

Dziennik zmian:

1.20.0

• Dodaje nowy niestandardowy element do gry. (DIGUS.MailFrameworkMod/MailData) Oznacza to, że listy MFM można teraz załadować za pomocą Content Patchera i korzystać ze wszystkich jego funkcji, takich jak tokeny. Obsługuje te same właściwości.
• Listy z pakietu zawartości są również ładowane do nowego niestandardowego zasobu i dlatego można je edytować za pomocą programu Content Patcher.
• Pakiety zawartości są teraz ładowane do pamięci podręcznej na początku gry, zamiast przeładowywać je przy każdym wczytaniu zapisu. Możesz wymusić przeładowanie pakietów zawartości za pomocą polecenia w konsoli.
• Właściwości tekstu i tytułu obsługują teraz ciągi tokenizowalne.
• Zasoby tekstur mogą teraz być zasobami gry, a nie tylko zasobami w folderze mod.
• Nowa właściwość GameStateQuery jako warunek dostarczenia listu.
  

1.19.0

• Nowa właściwość, która pozwala zachować ważność poczty, jeżeli wszystkie warunki zostały spełnione w danym dniu, ale poczta nie została przeczytana w tym dniu.
• Nowa funkcja obsługi losowo wybranych załączników
• Nowa właściwość ustawiająca liczbę elementów z listy załączników, które mają zostać wybrane do dostarczenia.
• Nowa właściwość umożliwiająca ustawienie „RandomGroup” dla załącznika, dzięki czemu będzie on wybierany z tej grupy, a nie z całej listy.
• Nowa właściwość umożliwiająca ustawienie „Wagi” dla danego załącznika wybieranego losowo.
• Nowa właściwość ustawiająca liczbę elementów, które mają zostać wybrane z danej grupy, zamiast używać wartości domyślnej.
• Nowa właściwość określająca, czy element z danej grupy można wybrać więcej niż raz.
• Nowy zestaw właściwości umożliwiający ustawienie wymogu MailReceived dla załączników i odpowiedzi
• Nowa właściwość umożliwiająca ustawienie opcji MailReceived, która będzie usuwana po przeczytaniu listu lub wybraniu opcji odpowiedzi.
• Nowa właściwość umożliwiająca ustawienie kosztu dla danej opcji odpowiedzi.
• Nowy typ elementu „Brak”. Zasadniczo służy do tego, gdy chcesz mieć szansę na losowe niedostarczenie elementu, bez generowania błędów/ostrzeżeń w logu.
  

1.18.0

• Nowa właściwość „Ids” zastępująca „Indeks” i „Nazwa” w CollectionConditions. Umożliwia agregację wielu elementów, sumując ich wartość w celu porównania z ilością.
• Nowa właściwość ReplyConfig, która dodaje zachowanie odpowiedzi. Możesz wyświetlić odtwarzaczowi opcję po przeczytaniu wiadomości e-mail, a on doda jeden lub więcej tekstów MailReceived w zależności od wybranej opcji. Na podstawie tego wyboru można zaimplementować dodatkową logikę modów.
• Naprawiono literę w przepisie, która nie obsługiwała właściwości CustomTextColorName.
• Naprawiono wyjątek odwołania zerowego, występujący w przypadku, gdy w grze ładowany był przedmiot o nazwie zerowej.
  

1.17.1

• Wiadomości e-mail z pakietem zawartości zawierającym właściwość „recipe” nie mogą zawierać załączników, aby mogły zostać ponownie dostarczone, jeśli przepis nie zostanie poznany. (właściwość „recipe” jest ignorowana, jeśli występują załączniki)
• Napraw przepisy kulinarne, stosując tę samą logikę, która była stosowana wcześniej do przepisów rzemieślniczych.
  

1.17.0

• Nowa właściwość do ustawienia jakości załącznika
• Jeśli nie uda się poznać przepisu, wiadomości e-mail zawierające pakiety treści powinny zostać dostarczone ponownie.
• Naprawiono ostrzeżenia dotyczące Slingshot w przypadku używania kwalifikowanego identyfikatora przedmiotu.
• Naprawiono dostarczanie przepisów na przedmioty rzemieślnicze, nawet jeśli przepis został już poznany.
• Ze względu na kwestie związane z dziedzictwem, jeśli identyfikator przepisu nie zostanie znaleziony w nauczonych przepisach, program będzie szukał przepisu, który utworzy element o nazwie identyfikatora przepisu.
  

1.16.1

• Naprawiono przetłumaczoną nazwę przepisu.
  

1.16.0

• Zaktualizowano mod, aby był kompatybilny ze Stardew Valley 1.6
• Nowe polecenie do ponownego ładowania pakietów zawartości
• Zmieniono nazwę MailDao na MailRepository. (Dotyczy tylko modów SMAPI, które z niej korzystają)
• Nowy typ przedmiotu „QualifiedItemId” dla załączników powinien działać dla każdego typu przedmiotu w grze, jeśli użyjesz właściwej kwalifikacji.
• Nowa nieruchomość na specjalne warunki dat. (Ślub i poród)
• Nowa właściwość CustomTextColor, stara uznana za przestarzałą.
• Nowa właściwość HasMods
• Nowa właściwość RequireAllMods
• Identyfikatory zdarzeń są teraz ciągami znaków. (Liczby powinny nadal działać)
• Usunięto przestarzałą logikę SV 1.6 zawartą w MFM.
• Naprawiono problem z wersji alfa, w wyniku którego list nie otwierał się na stronie zbierania poczty.
  

Aby moderatorzy mogli korzystać z pakietu treści:

• W folderze moda znajduje się szablon z instrukcjami i komentarzami opisującymi działanie każdej właściwości.
• Wszystkie funkcje listu, oprócz warunków i wywołań zwrotnych, są takie same jak w przypadku kodowania przy użyciu struktury.
• Warunki są ograniczone do tych zaimplementowanych, a funkcja zwrotna zawsze ustawia identyfikator litery jako otrzymany. Jeśli potrzebujesz zaawansowanych warunków, nadal powinieneś je zakodować. Możesz też uprzejmie zasugerować mi dodanie warunku do pakietu treści. Jeśli będzie to miało sens, mogę to dodać.
• Oto szablon dodany do pliku mod:
  

Aby Modder mógł korzystać z API:

• KopiaIMailFrameworkModApiinterfejs z metodą, której chcesz użyć z interfejsu MFM.
• KopiaListjeśli jedna z metod tego wymaga.
• Metody:
  
  • RegisterContentPack- UżywaćHelper.ContentPacks.CreateTemporaryAby załadować folder z moda zawierający plik mail.json i ewentualnie folder i18n na tłumaczenia. Manifest nie jest potrzebny, ponieważ można użyć tego parametru metody.
  • List rejestracyjny- Wypełnij iLetter potrzebnymi właściwościami. Do zarejestrowania listu wymagany jest również warunek. Zalecane jest wywołanie zwrotne, aby dodać przynajmniej identyfikator listu w postaci, w jakiej został odebrany. Zobacz przykłady poniżej, w sekcji „Aby modder mógł kodować z zależnością od MFM" sesja.
  • GetLetter- Otrzymasz obiekt ILetter dla identyfikatora listu.
  • Pobierz ciąg danych poczty- Otrzymasz ciąg danych adresowych dla identyfikatora listu. Ciąg danych adresowych to w zasadzie przetłumaczony tekst i przetłumaczony tytuł z separatorem [#].
    

Aby Modder mógł kodować z zależnością od MFM:

• Odwołaj się do pliku MailFrameworkMod.dll w swoim projekcie SMAPI.
  
  • Rejestrujesz swój List za pomocą MailRepository.SaveLetter(Letter)
  • Na początku każdego dnia moderator sprawdzi, czy listy osiągnęły już status umożliwiający doręczenie i doda je do skrzynki pocztowej.
  • Te listy zostaną otwarte jako pierwsze, gdy gracz sprawdzi skrzynkę pocztową.
  • Po otwarciu listu zostaje on wyjęty ze skrzynki pocztowej.
  • Warunek wywołania zwrotnego listu jest nazywany.
  • Pod koniec dnia list, który nadal znajduje się w skrzynce pocztowej, zostanie usunięty, więc gra nie zapisze go.
    
• Możesz traktować ten mod jako repozytorium swoich listów. Najlepiej działa, jeśli załadujesz wszystkie swoje listy podczas ładowania gry.
  

Przykłady:

Spoiler:

Pokazywać

Ładowanie prostego listu, który zostanie wyświetlony graczowi, jeśli nie zostanie wcześniej przeczytany, i nie zostanie dostarczony ponownie po otwarciu przez gracza:
MailRepository.SaveLetter(
nowy list(
„Unikalny Identyfikator Listu”
„Tekst niestandardowy listu”.
,(l)=>!Gra1.gracz.pocztaOtrzymana.Zawiera(l.Id)
,(l)=>Gra1.gracz.pocztaOtrzymana.Dodaj(l.Id)
)
);


Ładowanie prostego Listu jak poprzednio, ale z dołączonymi 5 Szmaragdami:
MailRepository.SaveLetter(
nowy list(
„Unikalny Identyfikator Listu”
„Tekst niestandardowy listu”.
,nowa lista { nowy StardewValley.Object(60,5) }
,(l)=>!Gra1.gracz.pocztaOtrzymana.Zawiera(l.Id)
,(l)=>Gra1.gracz.pocztaOtrzymana.Dodaj(l.Id)
  )
);

Gracz nie otrzyma tego samego przedmiotu, ale kopię zwróconą metodą getOne().

Wczytanie prostego listu, który nauczy gracza przepisu kulinarnego, zostanie dostarczone, jeśli gracz go nie zna. Mod automatycznie uczy przepisów po załadowaniu, nie ma potrzeby wywoływania zwrotnego:
MailRepository.SaveLetter(
nowy list(
„Unikalny Identyfikator Listu”
„Tekst niestandardowy listu”.
, "UnikalnaNazwaPrzepisu"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
);

Wartość „RecipeUniqueName” musi być taka sama jak ta zapisana w „Data//CookingRecipes” lub „Data//CraftingRecipes”.

Ładowanie prostego listu z innym tekstem i tłem:
MailRepository.SaveLetter(
nowy list(
„Unikalny Identyfikator Listu”
„Tekst niestandardowy listu”.
,(l)=>!Gra1.gracz.pocztaOtrzymana.Zawiera(l.Id)
,(l)=>Gra1.gracz.pocztaOtrzymana.Dodaj(l.Id)
1
){Kolor tekstu=8}
);


Ładowanie prostego listu z niestandardowym tłem:
MailRepository.SaveLetter(
nowy list(
„Unikalny Identyfikator Listu”
„Tekst niestandardowy listu”.
,(l)=>!Gra1.gracz.pocztaOtrzymana.Zawiera(l.Id)
,Gra1.gracz.pocztaOtrzymana.Dodaj(l.Id)
1
){
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,Kolor tekstu=4
  }
);
Gdzie CustomLetterBG.png to plik obrazu o takiej samej strukturze jak „LooseSprites//letterBG”

Ładowanie prostego listu z tłumaczeniem tekstu i tytułu.
MailRepository.SaveLetter(
nowy list(
„Unikalny Identyfikator Listu”
,,mojlist.klucz.tłumaczenia.tekst"
,(l)=>!Gra1.gracz.pocztaOtrzymana.Zawiera(l.Id)
,(l)=>Gra1.gracz.pocztaOtrzymana.Dodaj(l.Id)
){
Tytuł = "myletter.translation.key.title",
I18N = pomocnik.Tłumaczenie
    }
);



Moje inne mody:

• Mod Hodowla Zwierząt
• Moduł zatrzymujący wodę
• Niestandardowy moduł Crystalarium
• Mod do przeszczepu upraw
• Custom Cask Mod
  

• Niestandardowy mod do całowania
  

• Modyfikacja podłogi drewnianej bez obramowania
  

• Mod producenta niestandardowego
• Mod usług pocztowych
• Modyfikacja Arcane Table
• Modyfikacja słupów lampowych Gem
• Zaawansowany mod beczek