メール フレームワーク モド

客観的：
プレイヤーへのメール送信を簡素化し、いつ何を受信するかをより細かく制御できるようにします。
また、文字のテキストの色や背景を自由に変更するなど、データ ファイルの編集だけでは不可能なオプションも追加されています。

インストール:

• SMAPIの最新バージョンをインストールする.
• MailFrameworkModを解凍する/Stardew Valley/Mods へ。
  

変更ログ:

1.20.0

• ゲームに新しいカスタムアセットを追加します。(DIGUS.MailFrameworkMod/MailData) これにより、MFMレターをContent Patcherで読み込み、トークンなどのすべての機能を利用できるようになります。同じプロパティをサポートします。
• コンテンツ パックの文字も新しいカスタム アセットに読み込まれるため、Content Patcher を使用して編集できます。
• コンテンツパックは、セーブデータの読み込みごとに再読み込みされるのではなく、ゲーム開始時にキャッシュに読み込まれるようになりました。コンソールコマンドを使用して、コンテンツパックの再読み込みを強制的に実行できます。
• テキストおよびタイトル プロパティは、トークン化可能な文字列をサポートするようになりました。
• テクスチャ アセットは、mod フォルダー内のアセットだけでなく、ゲーム アセットにもできるようになりました。
• 手紙を配達する条件として新しい GameStateQuery プロパティを追加します。
  

1.19.0

• 1 日間すべての条件が満たされたが、その日にメールが読まれなかった場合にメールを有効なままにする新しいプロパティ。
• ランダムに選択された添付ファイルを処理する新機能
• 添付ファイルリストから配信に選択する項目の数を設定するための新しいプロパティ。
• 「RandomGroup」を添付ファイルに設定する新しいプロパティ。これにより、リスト全体ではなく、そのグループから選択されます。
• ランダムに選択されるときに、特定のアタッチメントの「重み」を設定するための新しいプロパティ。
• デフォルト値を使用する代わりに、特定のグループから選択するアイテムの数を設定するための新しいプロパティ。
• 特定のグループからのアイテムを複数回選択できるかどうかを指定する新しいプロパティ。
• 添付ファイルと返信の MailReceived 要件を設定するための新しいプロパティ セット
• メールが読まれたとき、または返信オプションがチェックされたときに MailReceived を削除するように設定するための新しいプロパティ。
• 特定の返信オプションのコストを設定する新しいプロパティ。
• 新しいアイテムタイプ「None」。これは基本的に、ログにエラーや警告を出力せずに、アイテムを配送しないランダムな可能性が必要な場合に使用します。
  

1.18.0

• CollectionConditionsのIndexとNameに代わる新しいIdsプロパティが追加されました。複数のアイテム数を集計し、それぞれの値を合計して合計金額と比較できます。
• ReplyConfigプロパティを追加することで、返信の動作を追加できます。メールを読んだ後にプレイヤーにオプションを表示し、選択されたオプションに基づいて1つ以上のMailReceivedテキストを追加できます。選択したオプションに基づいて、追加のModロジックを実装できます。
• CustomTextColorName プロパティをサポートしていないレシピの文字を修正しました。
• ゲーム内で null 名のアイテムがロードされるときに発生する null 参照例外を修正しました。
  

1.17.1

• レシピプロパティを持つコンテンツパックメールは、レシピが学習されていない場合は再配信するために添付ファイルがあってはいけません。(添付ファイルがある場合、レシピプロパティは無視されます)
• 以前のクラフトレシピに適用されたのと同じロジックで料理レシピを修正します。
  

1.17.0

• 添付ファイルの品質を設定するための新しいプロパティ
• レシピが学習されていない場合は、レシピを含むコンテンツ パック メールを再配信する必要があります。
• 修飾されたアイテム ID を使用する場合の Slingshot に関する警告を修正しました。
• レシピがすでに学習されている場合でも、クラフト可能なレシピが配信される問題を修正しました。
• レガシーな理由により、学習したレシピにレシピ ID が見つからない場合は、レシピ ID の名前を持つアイテムを作成するレシピが検索されます。
  

1.16.1

• レシピの翻訳名を修正しました。
  

1.16.0

• Stardew Valley 1.6と互換性のあるアップデートMOD
• コンテンツパックを再読み込みする新しいコマンド
• MailDao の名前を MailRepository に変更しました。(これを使用している SMAPI モッドにのみ影響します)
• 添付ファイルの新しいアイテム タイプ「QualifiedItemId」は、適切な資格を使用すれば、ゲーム内のすべてのタイプのアイテムで機能するはずです。
• 特別な日付条件のための新しいプロパティ。(結婚式と出産)
• CustomTextColor の新しいプロパティ。古いプロパティは非推奨です。
• 新しい HasMods プロパティ
• 新しいRequireAllModsプロパティ
• イベント ID は文字列になりました。(数値も引き続き機能します)
• MFM から組み込まれた古いロジック SV 1.6 を削除しました。
• メール収集ページで手紙が開かないというアルファ版からの問題を修正しました。
  

モッダーがコンテンツ パックを使用するには:

• mod フォルダー内には、各プロパティの機能に関するコメント付きの説明が記載されたテンプレートがあります。
• 条件とコールバック以外のすべての文字機能は、フレームワークを使用したコーディングと同じです。
• 条件は実装されたものに限定され、コールバックは常にレターIDを受信済みに設定します。高度な条件が必要な場合は、やはりコーディングする必要があります。あるいは、コンテンツパックに条件を追加するようご丁寧にご提案いただければ、それが理にかなったものであれば、追加するかもしれません。
• 以下は mod ファイルに追加されたテンプレートです。
  

Modder が API を使用するには:

• コピーIMailFrameworkModApiMFM インターフェースから使用したいメソッドとのインターフェース。
• コピーILetterいずれかの方法で必要な場合。
• 方法:
  
  • コンテンツパックの登録- 使用Helper.ContentPacks.CreateTemporarymail.json と、翻訳用の i18n フォルダ（必要な場合）を含むフォルダを mod から読み込みます。メソッドパラメータを使用できるため、マニフェストは不要です。
  • レジスタレター- ILetterに必要なプロパティを設定します。レターを登録するには条件も必要です。少なくとも受信したレターIDを追加するために、コールバックの使用をお勧めします。以下の例を参照してください。MFM依存のコードを書くModder向け「セッション」。
  • ゲットレター- 文字 ID の ILetter オブジェクトを取得します。
  • メールデータ文字列の取得- レターIDのメールデータ文字列を取得します。メールデータ文字列は基本的に、翻訳されたテキストと[#]区切りの翻訳されたタイトルで構成されます。
    

Modder が MFM 依存関係を使用してコードを作成する場合:

• SMAPI プロジェクトで MailFrameworkMod.dll を参照します。
  
  • MailRepository.SaveLetter(Letter) を使用してレターを登録します。
  • 毎日の初めに、この mod は配達条件に達した手紙をチェックし、それらをメールボックスに追加します。
  • この手紙は、プレイヤーがメールボックスを確認するときに最初に開かれます。
  • 手紙が開かれると、メールボックスから削除されます。
  • レターのコールバック条件は、それらが呼び出されることです。
  • 一日の終わりにメールボックスに残っている手紙は削除されるため、ゲームによって保存されません。
    
• このMODはあなたの手紙の保管庫のようなものと考えてください。ゲームのロード時にすべての手紙を読み込むと、最も効果的に機能します。
  

例:

ネタバレ:

見せる

以前に読まれていない場合にプレイヤーに表示されるシンプルな手紙を読み込みます。プレイヤーが開いた後は再度配信されません。
MailRepository.SaveLetter(
新しい手紙(
「レターユニークID」
,"文字のカスタムテキスト。"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
)
）;


以前と同じように単純な手紙をロードしますが、5 つのエメラルドが添付されています。
MailRepository.SaveLetter(
新しい手紙(
「レターユニークID」
,"文字のカスタムテキスト。"
,新しいリスト<アイテム> { 新しいStardewValley.Object(60,5) }
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
  )
）;

プレイヤーは同じアイテムを受け取るのではなく、getOne() メソッドから返されたコピーを受け取ります。

料理のレシピを教えてくれるシンプルな手紙をロードします。プレイヤーがレシピを知らない場合は手紙が届きます。このMODはプレイヤーのロード時に自動的にレシピを教えるので、ここでコールバックする必要はありません。
MailRepository.SaveLetter(
新しい手紙(
「レターユニークID」
、「文字のカスタムテキスト」
, "レシピ固有名"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
）;

「RecipeUniqueName」は、「Data//CookingRecipes」または「Data//CraftingRecipes」に保存されているものと同じである必要があります。

異なるテキストと背景を持つシンプルなレターを読み込みます。
MailRepository.SaveLetter(
新しい手紙(
「レターユニークID」
,"文字のカスタムテキスト。"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
1
){テキストカラー=8}
）;


カスタム背景を持つシンプルなレターを読み込みます:
MailRepository.SaveLetter(
新しい手紙(
「レターユニークID」
,"文字のカスタムテキスト。"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
）{
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,テキストカラー=4
  }
）;
CustomLetterBG.pngは「LooseSprites//letterBG」と同じ構造に従う画像ファイルです。

テキストとタイトルの翻訳を含むシンプルなレターを読み込んでいます。
MailRepository.SaveLetter(
新しい手紙(
「レターユニークID」
,"myletter.translation.key.text"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
）{
タイトル = "myletter.translation.key.title",
I18N = ヘルパー.翻訳
    }
）;



私の他のMOD:

• 動物飼育Mod
• 保水フィールドMod
• カスタムクリスタリウムMOD
• 作物移植MOD
• カスタムカスクモッド
  

• カスタムキスMOD
  

• ボーダーレスウッドフロアモッド
  

• カスタムプロデューサーMod
• メールサービスMod
• アーケインテーブルMod
• 宝石ランプポストMod
• 高度な樽MOD