Mod khung thư

Khách quan:
Đơn giản hóa việc gửi thư cho người chơi, giúp kiểm soát tốt hơn thời điểm và nội dung thư sẽ nhận được.
Ngoài ra còn cung cấp thêm nhiều tùy chọn không chỉ có thể chỉnh sửa các tệp dữ liệu, như thay đổi màu chữ và nền của chữ theo ý muốn.

Cài đặt:

• Cài đặt phiên bản mới nhất của SMAPI.
• Giải nén MailFrameworkModvào /Stardew Valley/Mods.
  

Nhật ký thay đổi:

1.20.0

• Thêm một tài sản tùy chỉnh mới vào trò chơi. (DIGUS.MailFrameworkMod/MailData) Điều này có nghĩa là các chữ cái MFM giờ đây có thể được tải bằng Content Patcher và sử dụng tất cả các tính năng của nó như mã thông báo. Nó hỗ trợ các thuộc tính tương tự.
• Các chữ cái trong Content Pack cũng được tải vào tài sản tùy chỉnh mới và do đó có thể được chỉnh sửa bằng Content Patcher.
• Các Gói Nội dung hiện được tải vào bộ nhớ đệm khi bắt đầu trò chơi, thay vì phải tải lại mỗi lần tải bản lưu. Bạn có thể buộc tải lại các gói nội dung bằng lệnh console.
• Thuộc tính Văn bản và Tiêu đề hiện hỗ trợ chuỗi Tokenizable.
• Tài sản kết cấu giờ đây có thể là tài sản của trò chơi, không chỉ là tài sản trong thư mục mod.
• Thuộc tính GameStateQuery mới như một điều kiện để gửi một lá thư.
  

1.19.0

• Thuộc tính mới để giữ cho thư có hiệu lực sau khi tất cả các điều kiện đã được đáp ứng trong một ngày nhưng thư không được đọc vào ngày hôm đó.
• Tính năng mới để xử lý Tệp đính kèm được chọn ngẫu nhiên
• Thuộc tính mới để thiết lập số lượng mục từ danh sách đính kèm sẽ được chọn để giao hàng.
• Thuộc tính mới để đặt "RandomGroup" thành Tệp đính kèm, do đó sẽ chọn từ nhóm đó thay vì từ toàn bộ danh sách.
• Thuộc tính mới để đặt "Trọng lượng" cho một tệp đính kèm nhất định khi được chọn ngẫu nhiên.
• Thuộc tính mới để thiết lập số lượng mục cần chọn từ một nhóm nhất định, thay vì sử dụng giá trị mặc định.
• Thuộc tính mới cho biết liệu một mục từ một nhóm nhất định có thể được chọn nhiều lần hay không.
• Bộ thuộc tính mới để thiết lập yêu cầu MailReceived cho tệp đính kèm và trả lời
• Thuộc tính mới để thiết lập MailReceived sẽ bị xóa khi đọc thư hoặc khi tùy chọn trả lời bị bỏ qua.
• Thuộc tính mới để thiết lập chi phí cho tùy chọn trả lời nhất định.
• ItemType mới "None". Về cơ bản, nó được sử dụng khi bạn muốn có cơ hội ngẫu nhiên không giao một mặt hàng nào đó mà không gây ra lỗi/cảnh báo trong nhật ký.
  

1.18.0

• Thuộc tính Ids mới thay thế Index và Name cho CollectionConditions. Thuộc tính này có thể tổng hợp số lượng nhiều mục, cộng giá trị của chúng để so sánh với số lượng.
• Thuộc tính ReplyConfig mới để thêm hành vi trả lời. Bạn có thể hiển thị một số tùy chọn cho người chơi sau khi đọc thư và nó sẽ thêm một hoặc nhiều văn bản MailReceived dựa trên tùy chọn đã chọn. Logic mod bổ sung có thể được triển khai dựa trên lựa chọn đó.
• Sửa lỗi chữ cái có công thức không hỗ trợ thuộc tính CustomTextColorName.
• Sửa lỗi ngoại lệ tham chiếu null khi một mục có tên null đang tải trong trò chơi.
  

1.17.1

• Các email gói nội dung có thuộc tính công thức không cần phải có tệp đính kèm để có thể gửi lại nếu công thức không được học. (thuộc tính công thức sẽ bị bỏ qua nếu có tệp đính kèm)
• Sửa các công thức nấu ăn theo cùng logic áp dụng cho các công thức chế tạo trước đó.
  

1.17.0

• Thuộc tính mới để thiết lập chất lượng của tệp đính kèm
• Nội dung thư có công thức nấu ăn sẽ được gửi lại nếu công thức không được học.
• Sửa cảnh báo về Slingshot nếu sử dụng ID vật phẩm đủ điều kiện.
• Sửa lỗi công thức chế tạo vật phẩm vẫn được cung cấp ngay cả khi công thức đã được học.
• Vì lý do kế thừa, nếu ID công thức không được tìm thấy trong các công thức đã học, nó sẽ tìm kiếm công thức tạo ra vật phẩm có tên ID công thức.
  

1.16.1

• Sửa tên công thức đã dịch.
  

1.16.0

• Cập nhật bản mod để tương thích với Stardew Valley 1.6
• Lệnh mới để tải lại gói nội dung
• Đã đổi tên MailDao thành MailRepository. (Chỉ ảnh hưởng đến các mod SMAPI sử dụng tên này)
• Loại vật phẩm mới 'QualifiedItemId' dành cho tệp đính kèm, có thể áp dụng cho mọi loại vật phẩm trong trò chơi nếu bạn sử dụng tiêu chuẩn phù hợp.
• Bất động sản mới cho các điều kiện ngày đặc biệt. (Đám cưới và Sinh con)
• Thuộc tính mới cho CustomTextColor, thuộc tính cũ đã lỗi thời.
• Thuộc tính HasMods mới
• Thuộc tính RequireAllMods mới
• ID sự kiện hiện là chuỗi. (số vẫn có thể dùng được)
• Đã xóa logic SV 1.6 lỗi thời được tích hợp từ MFM.
• Đã khắc phục sự cố từ bản alpha khiến thư không mở được trong trang thu thập thư.
  

Để Modder sử dụng gói nội dung:

• Có một mẫu bên trong thư mục mod với hướng dẫn được chú thích về chức năng của từng thuộc tính.
• Tất cả các tính năng của chữ cái nhưng điều kiện và lệnh gọi lại đều giống như khi mã hóa bằng khuôn khổ.
• Điều kiện chỉ giới hạn ở những điều kiện đã được triển khai, và lệnh gọi lại luôn đặt id của chữ cái là đã nhận. Nếu bạn cần các điều kiện nâng cao, bạn vẫn nên viết mã cho chúng. Hoặc bạn có thể lịch sự đề xuất tôi thêm một điều kiện vào gói nội dung, nếu điều đó hợp lý, tôi có thể thêm vào.
• Sau đây là mẫu được thêm vào trong tệp mod:
  

Để Modder sử dụng API:

• Sao chépIMailFrameworkModApigiao diện với phương pháp bạn muốn sử dụng từ giao diện MFM.
• Sao chépThưnếu một trong các phương pháp cần đến nó.
• Phương pháp:
  
  • RegisterContentPack- Sử dụngHelper.ContentPacks.CreateTemporaryđể tải một thư mục từ mod của bạn chứa mail.json và thư mục i18n có thể dùng để dịch. Không cần Manifest vì bạn có thể sử dụng tham số phương thức đó.
  • Thư đăng ký- Điền các thuộc tính cần thiết vào ILetter. Một điều kiện cũng cần thiết để đăng ký một chữ cái. Nên sử dụng lệnh gọi lại để thêm ít nhất ID chữ cái đã nhận. Xem ví dụ bên dưới, trên "Để Modder mã hóa với sự phụ thuộc của MFM" phiên họp.
  • Nhận thư- Bạn sẽ nhận được đối tượng ILetter cho ID của chữ cái.
  • Lấy chuỗi dữ liệu Mail- Bạn sẽ nhận được chuỗi dữ liệu thư cho ID thư. Chuỗi dữ liệu thư về cơ bản là văn bản đã dịch cộng với tiêu đề đã dịch với dấu phân cách [#].
    

Để Modder mã hóa với sự phụ thuộc của MFM:

• Tham chiếu MailFrameworkMod.dll trên dự án SMAPI của bạn.
  
  • Bạn đăng ký Thư của mình bằng MailRepository.SaveLetter(Letter)
  • Vào đầu mỗi ngày, người quản lý sẽ kiểm tra các Thư đã đạt điều kiện để gửi và thêm chúng vào hộp thư.
  • Những lá thư này sẽ được mở đầu tiên khi người chơi kiểm tra hộp thư.
  • Khi bức thư được mở, nó sẽ được lấy ra khỏi hộp thư.
  • Điều kiện gọi lại của chữ cái đó là chúng được gọi.
  • Vào cuối ngày, bức thư vẫn còn trong hộp thư sẽ bị xóa, do đó trò chơi sẽ không lưu chúng lại.
    
• Bạn có thể coi bản mod này như một kho lưu trữ thư của mình. Nó hoạt động tốt nhất nếu bạn tải toàn bộ thư khi trò chơi đang tải.
  

Ví dụ:

Tiết lộ:

Trình diễn

Tải một bức thư đơn giản sẽ hiển thị cho người chơi nếu chưa đọc trước đó và sẽ không được gửi lại sau khi người chơi mở bức thư đó:
MailRepository.SaveLetter(
Thư mới(
"LetterUniqueId"
"Văn bản tùy chỉnh của chữ cái."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
)
);


Tải một lá thư đơn giản như trước, nhưng kèm theo 5 Emerald:
MailRepository.SaveLetter(
Thư mới(
"LetterUniqueId"
"Văn bản tùy chỉnh của chữ cái."
,Danh sách mới { StardewValley.Object(60,5) mới }
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
  )
);

Người chơi sẽ không nhận được cùng một vật phẩm mà là một bản sao được trả về từ phương thức getOne().

Tải một lá thư đơn giản để dạy công thức nấu ăn, thư sẽ được gửi đến nếu người chơi không biết công thức. Bản mod sẽ tự động dạy công thức khi người chơi tải, không cần phải gọi lại ở đây:
MailRepository.SaveLetter(
Thư mới(
"LetterUniqueId"
, "Văn bản tùy chỉnh chữ cái."
, "RecipeUniqueName"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
);

"RecipeUniqueName" phải giống với tên được lưu trữ trong "Data//CookingRecipes" hoặc "Data//CraftingRecipes".

Tải một bức thư đơn giản với văn bản và nền khác nhau:
MailRepository.SaveLetter(
Thư mới(
"LetterUniqueId"
"Văn bản tùy chỉnh của chữ cái."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
1
){Màu văn bản=8}
);


Tải một bức thư đơn giản với nền tùy chỉnh:
MailRepository.SaveLetter(
Thư mới(
"LetterUniqueId"
"Văn bản tùy chỉnh của chữ cái."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
){
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,Màu văn bản=4
  }
);
Trong đó CustomLetterBG.png là một tệp hình ảnh có cùng cấu trúc với "LooseSprites//letterBG"

Tải một bức thư đơn giản có bản dịch cho văn bản và tiêu đề.
MailRepository.SaveLetter(
Thư mới(
"LetterUniqueId"
,"myletter.translation.key.text"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
){
Tiêu đề = "myletter.translation.key.title",
I18N = trợ giúp.Bản dịch
    }
);



Các bản mod khác của tôi:

• Mod Chăn nuôi
• Mod giữ nước ngoài trời
• Mod Crystalarium tùy chỉnh
• Mod cấy ghép cây trồng
• Mod thùng tùy chỉnh
  

• Mod Hôn Tùy Chỉnh
  

• Bản mod sàn gỗ không viền
  

• Mod Nhà sản xuất tùy chỉnh
• Mod Dịch vụ Thư
• Bản mod Arcane Table
• Mod Cột đèn Gem
• Mod Casks nâng cao