Mod de cadre de messagerie

Objectif:
Simplifiez l'envoi de courrier au joueur, en lui donnant plus de contrôle sur le moment et ce qui doit être reçu.
Il offre également davantage d'options qui ne sont pas possibles en modifiant simplement les fichiers de données, comme changer la couleur du texte et l'arrière-plan de la lettre à volonté.

Installation:

• Installer la dernière version de SMAPI.
• Décompressez le MailFrameworkModdans /Stardew Valley/Mods.
  

Journal des modifications :

1.20.0

• Ajoute un nouvel élément personnalisé au jeu (DIGUS.MailFrameworkMod/MailData). Cela signifie que les lettres MFM peuvent désormais être chargées avec Content Patcher et bénéficier de toutes ses fonctionnalités, comme les jetons. Les mêmes propriétés sont prises en charge.
• Les lettres du pack de contenu sont également chargées dans le nouvel actif personnalisé et peuvent donc être modifiées avec Content Patcher.
• Les packs de contenu sont désormais chargés dans un cache au démarrage du jeu, au lieu d'être rechargés à chaque chargement de la sauvegarde. Vous pouvez forcer le rechargement des packs de contenu avec la commande console.
• Les propriétés Texte et Titre prennent désormais en charge la chaîne tokenisable.
• Les ressources de texture peuvent désormais être une ressource de jeu, et pas seulement une ressource dans le dossier mod.
• Nouvelle propriété GameStateQuery comme condition pour livrer une lettre.
  

1.19.0

• Nouvelle propriété permettant de conserver un courrier valide une fois que toutes les conditions ont été remplies pendant une journée mais que le courrier n'a pas été lu ce jour-là.
• Nouvelle fonctionnalité pour gérer les pièces jointes choisies par Randoly
• Nouvelle propriété permettant de définir le nombre d'éléments de la liste des pièces jointes à choisir pour la livraison.
• Nouvelle propriété permettant de définir un « RandomGroup » sur une pièce jointe, afin qu'elle soit sélectionnée dans ce groupe plutôt que dans la liste entière.
• Nouvelle propriété permettant de définir un « poids » pour une pièce jointe donnée, lorsqu'elle est sélectionnée au hasard.
• Nouvelle propriété permettant de définir le nombre d'éléments à sélectionner dans un groupe donné, au lieu d'utiliser la valeur par défaut.
• Nouvelle propriété permettant de dire si un élément d'un groupe donné peut être choisi plus d'une fois.
• Nouvel ensemble de propriétés pour définir une exigence MailReceived pour les pièces jointes et les réponses
• Nouvelle propriété permettant de définir un MailReceived à supprimer lorsqu'une lettre est lue ou lorsqu'une option de réponse est cochée.
• Nouvelle propriété permettant de définir un coût pour une option de réponse donnée.
• Nouveau type d'élément « Aucun ». Il est principalement utilisé lorsque vous souhaitez avoir une chance aléatoire de ne pas livrer un article, sans déclencher d'erreurs ou d'avertissements dans le journal.
  

1.18.0

• Nouvelle propriété Ids remplaçant Index et Name pour CollectionConditions. Elle permet d'agréger plusieurs éléments et d'additionner leurs valeurs pour les comparer au montant.
• Nouvelle propriété ReplyConfig pour ajouter un comportement de réponse. Vous pouvez afficher une option au joueur après la lecture d'un message ; un ou plusieurs messages « MailReceived » seront ajoutés en fonction de l'option choisie. Une logique de mod supplémentaire peut être implémentée en fonction de ce choix.
• Correction de la lettre avec la recette ne prenant pas en charge la propriété CustomTextColorName.
• Correction de l'exception de référence nulle lorsqu'un élément avec un nom nul était chargé dans le jeu.
  

1.17.1

• Les e-mails de pack de contenu avec propriété de recette ne doivent pas contenir de pièces jointes pour être redistribués si la recette n'est pas apprise. (La propriété de recette est ignorée s'il y a des pièces jointes)
• Corrigez les recettes de cuisine avec la même logique appliquée aux recettes d'artisanat auparavant.
  

1.17.0

• Nouvelle propriété pour définir la qualité de la pièce jointe
• Les courriers de pack de contenu avec recette doivent être redistribués si la recette n'est pas apprise.
• Corrigez les avertissements concernant Slingshot si vous utilisez l'ID d'élément qualifié.
• Correction des recettes pour les objets fabriqués livrées même si la recette a déjà été apprise.
• Pour des raisons d'héritage, si l'ID de recette n'est pas trouvé dans les recettes apprises, il recherchera une recette qui crée un élément avec le nom de l'ID de recette.
  

1.16.1

• Correction du nom traduit de la recette.
  

1.16.0

• Mise à jour du mod pour être compatible avec Stardew Valley 1.6
• Nouvelle commande pour recharger les packs de contenu
• MailDao a été rebaptisé MailRepository. (N'affecte que les modérateurs SMAPI qui l'utilisent)
• Nouveau type d'élément « QualifiedItemId » pour les pièces jointes, devrait fonctionner pour chaque type d'élément du jeu si vous utilisez la qualification appropriée.
• Nouvelle propriété avec conditions spéciales pour dates (mariage et naissance).
• Nouvelle propriété pour CustomTextColor, ancienne propriété obsolète.
• Nouvelle propriété HasMods
• Nouvelle propriété RequireAllMods
• Les identifiants d'événements sont désormais des chaînes. (Les nombres devraient toujours fonctionner)
• Suppression de la logique obsolète SV 1.6 incorporée à partir de MFM.
• Problème résolu depuis la version alpha où la lettre ne s'ouvrait pas dans la page de collecte de courrier.
  

Pour que les moddeurs utilisent le pack de contenu :

• Il y a un modèle dans le dossier mod avec des instructions commentées sur ce que fait chaque propriété.
• Toutes les fonctionnalités des lettres, à l'exception des conditions et du rappel, sont les mêmes que celles du codage avec le framework.
• Les conditions sont limitées à celles implémentées, et le rappel définit toujours l'identifiant de lettre comme reçu. Si vous avez besoin de conditions avancées, vous devez quand même les coder. Vous pouvez également me suggérer poliment d'ajouter une condition au pack de contenu ; si cela vous semble pertinent, je pourrais l'ajouter.
• Voici le modèle tel qu'ajouté dans le fichier mod :
  

Pour que Modder utilise l'API :

• CopieIMailFrameworkModApiinterface avec la méthode que vous souhaitez utiliser à partir de l'interface MFM.
• CopieLettre Isi l'une des méthodes en a besoin.
• Méthodes :
  
  • RegisterContentPack- UtiliserHelper.ContentPacks.CreateTemporaryPour charger un dossier depuis votre mod contenant le fichier mail.json et éventuellement le dossier i18n pour les traductions. Le manifeste n'est pas nécessaire, car vous pouvez utiliser ce paramètre de méthode.
  • Lettre d'inscription- Remplissez une ILetter avec les propriétés nécessaires. Une condition est également requise pour enregistrer une lettre. Un rappel est recommandé, afin d'ajouter au moins l'identifiant de la lettre reçue. Voir les exemples ci-dessous, à la page « »Pour que les moddeurs codent avec la dépendance MFM" session.
  • Obtenir une lettre- Vous obtiendrez l'objet ILetter pour l'ID de la lettre.
  • GetMailDataString- Vous obtiendrez la chaîne de données de courrier correspondant à l'identifiant de la lettre. Cette chaîne est composée du texte traduit et du titre traduit, séparés par un [#].
    

Pour que les moddeurs codent avec la dépendance MFM :

• Référencez MailFrameworkMod.dll sur votre projet SMAPI.
  
  • Vous enregistrez votre lettre en utilisant MailRepository.SaveLetter(Letter)
  • Au début de chaque journée, le mod vérifiera les lettres qui ont atteint leur état de livraison et les ajoutera à la boîte aux lettres.
  • Ces lettres seront ouvertes en premier lorsque le joueur vérifiera la boîte aux lettres.
  • Lorsque la lettre est ouverte, elle est retirée de la boîte aux lettres.
  • La condition de rappel de la lettre est alors appelée.
  • À la fin de la journée, les lettres encore présentes dans la boîte aux lettres seront supprimées, elles ne seront donc pas sauvegardées par le jeu.
    
• Vous pouvez considérer ce mod comme un dépôt pour vos lettres. Il est plus efficace si vous chargez toutes vos lettres au chargement du jeu.
  

Exemples :

Becquet:

Montrer

Chargement d'une lettre simple qui s'affichera pour le joueur si elle n'a pas été lue auparavant, et qui ne sera plus délivrée après avoir été ouverte par le joueur :
MailRepository.SaveLetter(
nouvelle lettre(
« LetterUniqueId »
« Lettre texte personnalisé ».
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
)
);


Chargement d'une lettre simple comme avant, mais avec 5 Émeraudes annexées :
MailRepository.SaveLetter(
nouvelle lettre(
« LetterUniqueId »
« Lettre texte personnalisé ».
,nouvelle liste<élément> { nouveau StardewValley.Object(60,5) }
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
  )
);

Le joueur ne recevra pas le même objet, mais une copie renvoyée par la méthode getOne().

Chargement d'une lettre simple qui apprend une recette de cuisine. Elle sera envoyée si le joueur ne la connaît pas. Le mod apprend automatiquement les recettes au chargement ; aucun rappel n'est nécessaire ici :
MailRepository.SaveLetter(
nouvelle lettre(
« LetterUniqueId »
« Texte personnalisé de la lettre. »
, "NomUniqueDeLaRecette"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
);

Le « RecipeUniqueName » doit être le même que celui stocké dans « Data//CookingRecipes » ou « Data//CraftingRecipes ».

Chargement d'une lettre simple avec un texte et un arrière-plan différents :
MailRepository.SaveLetter(
nouvelle lettre(
« LetterUniqueId »
« Lettre texte personnalisé ».
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
1
){TextColor=8}
);


Chargement d'une lettre simple avec un arrière-plan personnalisé :
MailRepository.SaveLetter(
nouvelle lettre(
« LetterUniqueId »
« Lettre texte personnalisé ».
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
){
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,TextColor=4
  }
);
Où CustomLetterBG.png est un fichier image qui suit la même structure que « LooseSprites//letterBG »

Chargement d'une lettre simple avec traduction du texte et du titre.
MailRepository.SaveLetter(
nouvelle lettre(
« LetterUniqueId »
,"myletter.translation.key.text"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
){
Titre = "myletter.translation.key.title",
I18N = aide.Traduction
    }
);



Mes autres mods :

• Mod d'élevage
• Modulation du champ de rétention d'eau
• Mod Crystalarium personnalisé
• Mod de transplantation de cultures
• Mod Cask personnalisé
  

• Mod de baiser personnalisé
  

• Mod de plancher en bois sans bordure
  

• Mod de producteur personnalisé
• Module de services de messagerie
• Mod de table arcanique
• Lampadaires Gem Mod
• Mod de fûts avancés