Mail-Framework-Mod

Objektiv:
Vereinfachen Sie das Senden von E-Mails an den Spieler und geben Sie ihm mehr Kontrolle darüber, wann und was empfangen werden soll.
Außerdem stehen weitere Optionen zur Verfügung, die durch das bloße Bearbeiten der Datendateien nicht möglich sind, wie etwa das beliebige Ändern der Textfarbe und des Hintergrunds des Briefes.

Installation:

• Installieren Sie die neueste Version von SMAPI.
• Entpacken Sie das MailFrameworkModin /Stardew Valley/Mods.
  

Änderungsprotokoll:

1.20.0

• Fügt dem Spiel ein neues benutzerdefiniertes Asset hinzu. (DIGUS.MailFrameworkMod/MailData) Das bedeutet, dass MFM-Briefe jetzt mit Content Patcher geladen werden können und alle seine Funktionen wie Token nutzen. Es unterstützt dieselben Eigenschaften.
• Content Pack-Briefe werden auch in das neue benutzerdefinierte Asset geladen und können daher mit Content Patcher bearbeitet werden.
• Inhaltspakete werden nun beim Spielstart in einen Cache geladen, anstatt bei jedem Laden des Spielstands neu geladen zu werden. Sie können das Neuladen von Inhaltspaketen mit dem Konsolenbefehl erzwingen.
• Text- und Titeleigenschaften unterstützen jetzt tokenisierbare Zeichenfolgen.
• Textur-Assets können jetzt ein Spiel-Asset sein, nicht nur ein Asset im Mod-Ordner.
• Neue GameStateQuery-Eigenschaft als Bedingung für die Zustellung eines Briefes.
  

1.19.0

• Neue Eigenschaft, um eine E-Mail gültig zu halten, wenn alle Bedingungen für einen Tag erfüllt sind, die E-Mail an diesem Tag jedoch nicht gelesen wurde.
• Neue Funktion zur Handhabung zufällig ausgewählter Anhänge
• Neue Eigenschaft zum Festlegen, wie viele Elemente aus der Anhangsliste für die Zustellung ausgewählt werden sollen.
• Neue Eigenschaft zum Festlegen einer „RandomGroup“ für einen Anhang, sodass aus dieser Gruppe und nicht aus der gesamten Liste ausgewählt wird.
• Neue Eigenschaft zum Festlegen eines „Gewichts“ für einen bestimmten Anhang, wenn dieser zufällig ausgewählt wird.
• Neue Eigenschaft zum Festlegen, wie viele Elemente aus einer bestimmten Gruppe ausgewählt werden sollen, anstatt den Standardwert zu verwenden.
• Neue Eigenschaft, um anzugeben, ob ein Element aus einer bestimmten Gruppe mehr als einmal ausgewählt werden kann.
• Neuer Satz von Eigenschaften zum Festlegen einer MailReceived-Anforderung für Anhänge und Antworten
• Neue Eigenschaft zum Festlegen, dass eine empfangene E-Mail entfernt wird, wenn ein Brief gelesen oder eine Antwortoption aktiviert wird.
• Neue Eigenschaft zum Festlegen der Kosten für eine bestimmte Antwortoption.
• Neuer ItemType „Keine“. Dieser wird grundsätzlich verwendet, wenn Sie eine zufällige Chance haben möchten, dass ein Artikel nicht geliefert wird, ohne dass Fehler/Warnungen im Protokoll ausgelöst werden.
  

1.18.0

• Neue ID-Eigenschaft ersetzt Index und Name für CollectionConditions. Sie kann die Anzahl mehrerer Elemente aggregieren und ihren Wert summieren, um ihn mit der Menge zu vergleichen.
• Neue ReplyConfig-Eigenschaft zum Hinzufügen eines Antwortverhaltens. Sie können dem Spieler nach dem Lesen einer E-Mail eine Option anzeigen, die je nach gewählter Option einen oder mehrere MailReceived-Texte hinzufügt. Basierend auf dieser Auswahl kann zusätzliche Mod-Logik implementiert werden.
• Korrektur für Buchstaben mit Rezept, die die Eigenschaft „CustomTextColorName“ nicht unterstützen.
• Beheben Sie die Nullreferenzausnahme, wenn ein Element mit Nullnamen im Spiel geladen wurde.
  

1.17.1

• Content-Pack-E-Mails mit der Eigenschaft „Rezept“ dürfen keine Anhänge enthalten, um erneut zugestellt zu werden, wenn das Rezept nicht gelernt wurde. (Die Eigenschaft „Rezept“ wird ignoriert, wenn Anhänge vorhanden sind.)
• Korrigieren Sie Kochrezepte mit der gleichen Logik, die zuvor für Handwerksrezepte galt.
  

1.17.0

• Neue Eigenschaft zum Festlegen der Qualität des Anhangs
• Content-Pack-Mails mit Rezept sollten erneut zugestellt werden, wenn das Rezept nicht erlernt wird.
• Beheben Sie Warnungen zu Slingshot, wenn die qualifizierte Artikel-ID verwendet wird.
• Beheben Sie, dass Rezepte für Handwerksgegenstände geliefert wurden, auch wenn das Rezept bereits erlernt wurde.
• Aus Legacy-Gründen wird, wenn die Rezept-ID nicht in den erlernten Rezepten gefunden wird, nach einem Rezept gesucht, das ein Element mit dem Namen der Rezept-ID erstellt.
  

1.16.1

• Korrektur des übersetzten Rezeptnamens.
  

1.16.0

• Mod aktualisieren, um mit Stardew Valley 1.6 kompatibel zu sein
• Neuer Befehl zum Neuladen von Inhaltspaketen
• MailDao-Name in MailRepository geändert. (Betrifft nur SMAPI-Mods, die es verwenden)
• Neuer Artikeltyp „QualifiedItemId“ für Anhänge. Sollte für jeden Artikeltyp im Spiel funktionieren, wenn Sie die richtige Qualifikation verwenden.
• Neue Immobilie für besondere Terminkonditionen. (Hochzeit und Geburt)
• Neue Eigenschaft für CustomTextColor, alte veraltet.
• Neue HasMods-Eigenschaft
• Neue RequireAllMods-Eigenschaft
• Ereignis-IDs sind jetzt Zeichenfolgen. (Zahlen sollten weiterhin funktionieren)
• Veraltete Logik SV 1.6 aus MFM entfernt.
• Problem aus Alpha behoben, bei dem sich Briefe auf der E-Mail-Sammlungsseite nicht öffnen ließen.
  

Damit Modder das Inhaltspaket verwenden können:

• Im Mod-Ordner befindet sich eine Vorlage mit kommentierten Anweisungen zur Funktion der einzelnen Eigenschaften.
• Alle Buchstabenfunktionen außer den Bedingungen und dem Rückruf sind dieselben wie beim Codieren mit dem Framework.
• Die Bedingungen beschränken sich auf die implementierten, und der Rückruf setzt die Brief-ID immer als empfangen. Wenn Sie erweiterte Bedingungen benötigen, sollten Sie diese dennoch codieren. Oder Sie können mir höflich vorschlagen, dem Inhaltspaket eine Bedingung hinzuzufügen. Wenn es sinnvoll ist, werde ich sie möglicherweise hinzufügen.
• Hier ist die Vorlage, wie sie in der Mod-Datei hinzugefügt wurde:
  

Damit Modder die API verwenden können:

• KopieIMailFrameworkModApiSchnittstelle mit der Methode, die Sie von der MFM-Schnittstelle aus verwenden möchten.
• KopieILetterwenn eine der Methoden es benötigt.
• Methoden:
  
  • RegisterContentPack- VerwendenHelper.ContentPacks.CreateTemporaryum einen Ordner aus Ihrem Mod zu laden, der die Datei mail.json und einen möglichen i18n-Ordner für Übersetzungen enthält. Ein Manifest ist nicht erforderlich, da Sie diesen Methodenparameter verwenden können.
  • RegisterBrief- Füllen Sie einen ILetter mit den gewünschten Eigenschaften aus. Für die Registrierung eines Briefes ist außerdem eine Bedingung erforderlich. Ein Rückruf ist ratsam, um zumindest die empfangene Brief-ID hinzuzufügen. Siehe Beispiele unten, auf der Seite "Für Modder zum Coden mit MFM-Abhängigkeit" Sitzung.
  • Brief abrufen- Sie erhalten das ILetter-Objekt für die Brief-ID.
  • GetMailDataString- Sie erhalten die E-Mail-Datenzeichenfolge für die Brief-ID. Die E-Mail-Datenzeichenfolge besteht im Wesentlichen aus dem übersetzten Text plus dem übersetzten Titel mit einem [#]-Trennzeichen.
    

Damit Modder mit MFM-Abhängigkeit codieren können:

• Verweisen Sie in Ihrem SMAPI-Projekt auf die MailFrameworkMod.dll.
  
  • Sie registrieren Ihren Brief mit MailRepository.SaveLetter(Letter)
  • Zu Beginn eines jeden Tages prüft der Mod, ob Briefe den Zustellstatus erreicht haben, und fügt sie dem Briefkasten hinzu.
  • Diese Briefe werden zuerst geöffnet, wenn der Spieler den Briefkasten überprüft.
  • Wenn der Brief geöffnet wird, wird er aus dem Briefkasten entfernt.
  • Die Rückrufbedingung des Briefes wird ihnen genannt.
  • Am Ende des Tages werden die noch im Briefkasten befindlichen Briefe entfernt, sodass sie vom Spiel nicht gespeichert werden.
    
• Sie können sich diesen Mod als eine Art Aufbewahrungsort für Ihre Briefe vorstellen. Er funktioniert am besten, wenn Sie alle Ihre Briefe beim Laden des Spiels laden.
  

Beispiele:

Spoiler:

Zeigen

Laden eines einfachen Briefes, der dem Spieler angezeigt wird, wenn er ihn noch nicht gelesen hat, und der nach dem Öffnen durch den Spieler nicht erneut zugestellt wird:
MailRepository.SaveLetter(
neuer Buchstabe(
"Eindeutige Brief-ID"
,"Benutzerdefinierter Brieftext."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
)
);


Laden eines einfachen Briefes wie zuvor, aber mit 5 angehängten Smaragden:
MailRepository.SaveLetter(
neuer Buchstabe(
"Eindeutige Brief-ID"
,"Benutzerdefinierter Brieftext."
,neue Liste { neues StardewValley.Objekt(60,5) }
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
  )
);

Der Spieler erhält nicht denselben Gegenstand, sondern eine Kopie, die von der Methode getOne() zurückgegeben wird.

Ein einfacher Brief wird geladen, der ein Kochrezept vermittelt. Er wird zugestellt, wenn der Spieler das Rezept nicht kennt. Der Mod vermittelt die Rezepte automatisch beim Laden, ein Rückruf ist hier nicht erforderlich:
MailRepository.SaveLetter(
neuer Buchstabe(
"Eindeutige Brief-ID"
, „Benutzerdefinierter Brieftext.“
, "Eindeutiger Rezeptname"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
);

Der „RecipeUniqueName“ muss derselbe sein wie der in „Data//CookingRecipes“ oder „Data//CraftingRecipes“ gespeicherte.

Laden eines einfachen Briefes mit anderem Text und Hintergrund:
MailRepository.SaveLetter(
neuer Buchstabe(
"Eindeutige Brief-ID"
,"Benutzerdefinierter Brieftext."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
1
){TextColor=8}
);


Laden eines einfachen Briefes mit benutzerdefiniertem Hintergrund:
MailRepository.SaveLetter(
neuer Buchstabe(
"Eindeutige Brief-ID"
,"Benutzerdefinierter Brieftext."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
){
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,TextColor=4
  }
);
Wobei CustomLetterBG.png eine Bilddatei ist, die der gleichen Struktur wie „LooseSprites//letterBG“ folgt.

Laden eines einfachen Briefes mit Übersetzung für Text und Titel.
MailRepository.SaveLetter(
neuer Buchstabe(
"Eindeutige Brief-ID"
,"myletter.translation.key.text"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
){
Titel = "myletter.translation.key.title",
I18N = Helfer.Übersetzung
    }
);



Meine anderen Mods:

• Tierhaltungs-Mod
• Wasserrückhaltefeld-Mod
• Benutzerdefinierter Crystalarium-Mod
• Pflanzentransplantations-Mod
• Benutzerdefinierter Fassmod
  

• Benutzerdefinierter Kuss-Mod
  

• Randloser Holzboden-Mod
  

• Benutzerdefinierter Produzenten-Mod
• Mail-Dienste-Mod
• Arkane Tisch-Modifikation
• Edelstein-Laternenpfahl-Mod
• Erweiterter Fass-Mod