生日快樂

有沒有想過為什麼你在星露谷沒有生日？不用再擔心了！

這個模組可以讓你選擇生日日期。生日那天，你會收到父母的來信，村民也會送你禮物並祝你生日快樂。

已更新至 SDV 1.6+！
需要 SMAPI 4.0 或更高版本。

安裝

• 安裝最新版本的 SMAPI.
• 下載此 mod 的生日快樂檔案並將其解壓縮到星露谷/模組.
• 下載生日快樂翻譯內容包。英文內容包可以在單獨的模組下載頁面找到。這裡。這是為了確保 Vortex 可以正確處理下載內容包，因為它在與 mod 捆綁時不起作用。
• 安裝 3.0.0+ 版本星塵核心也一樣。
• 使用 SMAPI 運行遊戲。
  

用法
早上醒來時，系統會彈出選擇生日的選單。生日當天，像往常一樣與NPC對話，他們會祝你生日快樂並送你禮物。禮物會根據你和他們的好感度而改變。查看信箱，看看有沒有父母的來信。

常問問題
1.救命！路易斯沒有來問我生日，我的配偶也沒有問我最喜歡的禮物！
- 您是否至少安裝了一個 HappyBirthday 內容套件？我支持並創建的主要內容包可以在以下網址找到：https://www.nexusmods.com/stardewvalley/mods/11148.
-你在安卓/iOS 上玩嗎？目前不支持，因為我需要進行更大規模的重寫才能支援這些平台。
-在 HappyBirthday 模組資料夾下，是否有一個包含玩家生日的資料資料夾？如果有，刪除它能解決問題嗎？
-您能在控制台中執行 SMAPI 命令（不含引號）來重置詢問生日的提示嗎？ “Omegasis.Happy_Birthday.reset_birthday”
2. 這個模組可以在行動裝置上運作嗎？ （安卓/IOS）
目前還沒有，但我考慮過升級它來實現這一點。最大的限制在於找時間並建立開發環境。
3. 您能支援這個模組使其與（XYZ）模組相容嗎？
-市面上有許多模組會對 NPC、地圖等進行修改，這使得相容所有模組變得非常困難。雖然我很想讓這個模組相容所有模組，但很遺憾我沒有時間。可能會有一些大型模組提供不同程度的相容性支援（例如《星露穀物語》擴充版），但具體情況將視具體情況而定。
4. 我可以為這個模組製作一個內容包並自己上傳嗎？
-當然可以，請一定要這樣做！


3.0.0 版新功能

重大變化

• 如果玩家生日當天村民沒有送出禮物/生日祝福，他們會寄來一封信，上面寫著遲來的祝福和禮物。不用再四處追殺村民了！
• 遊戲開始時不再詢問玩家生日。取而代之的是，劉易斯會在農舍外舉辦活動，屆時詢問你生日。
• 玩家在遊戲開始時不再被詢問他們最喜歡的禮物。取而代之的是，當玩家結婚時，配偶會與他們一起參加活動，並詢問他們最喜歡的禮物，這更符合配偶作為玩家最喜歡的禮物的初衷。
  新增了新的生日活動。
• 社區生日派對：當你與所有村民的心數達到 5 顆以上時，去酒吧會有一個驚喜。 :)
• 配偶專屬生日活動：所有配偶都會有一個特別的生日活動，他們會祝你生日快樂，並送你最喜歡的禮物！除了原始對話外，還包含額外對話。
• Joja 也承認其會員的生日，但只有當他們仍在城裡時才可以。
• 生日事件現在保存到 .json 檔案中，以便在發生某些類型的隨機衝突時可以進行修改（例如，npc 卡在修改過的地圖上）
  細微變化
• 無論社區中心是否完工，祝尼魔都會在社區中心為玩家舉辦生日派對。千萬別成為祝尼魔的會員！
• 現在可以在模組的設定檔中調整爸爸媽媽的生日禮物。
• 爸爸在第一年給的錢較少，在第二年及以後給的錢為 5000 美元。
• 添加了對 Leo 的生日祝福。
  生活品質
• 在禮品選擇器選單中新增了搜尋框。
• 在禮品選擇器選單中新增了工具提示懸停框。
  改裝
• 重寫了禮物和生日祝福系統，使其使用內容包格式來表達「生日快樂」。這意味著透過內容包添加自訂NPC會更加容易，因為只需添加他們的禮物和對話條目。更多詳情請見下文
  錯誤修復：
• 農場工人重啟遊戲時不再需要重新選擇生日。 （我知道這是一個很大的bug報告）
• 阻止用戶在節日期間選擇生日。此功能原本存在，但在更新模組時不知何故失效了。如果有人要求，我們願意移除此功能，因為現在玩家可以在第二天收到郵件中的生日祝福了。 :)
  

進階：內容包
隨著「生日快樂」重寫至 V3.0，我想為用戶提供一種方式，讓他們能夠自行添加內容，而無需聯繫我。因此，解決方案是編寫一些可以實現以下功能的內容包。

1.增加自訂NPC對話支援。
1.1. 自訂對話是透過建立/編輯 /Content/Strings/BirthdayWishes.json 來實現的。如果您要為自訂 NPC 建立新的內容包，請刪除所有條目，只需添加您自己的 NPC 名稱以及您希望他們說的生日祝福。例如，如果您有一個名為 Joshua 的自訂 NPC，您只需在 BirthdayWishes.json 檔案中新增類似這樣的內容即可。
“Joshua”：“嘿@，很高興在你生日那天見到你！希望你今天過得愉快！”
1.1.1 配偶也可以透過編輯 SpouseBirthdayWishes 來實現（如果您的模組添加了自訂結婚候選人）。請注意，一些特殊關鍵字，例如 {TimeOfDay} 或 {AffectionateSpouseWord}，會分別翻譯成相應的時間文本，例如“早安”和“南瓜、甜心等等”，以便進行修改。

1.2. 要在郵件中新增/編輯遲到的生日祝福，您需要修改 /Content/Strings/Mail.json 文件，在其中執行相同的操作，但要為遲到的（也就是第二天的）生日祝福添加一條訊息。例如，它可能看起來像這樣。
“Joshua”：“祝你生日快樂，@！^ 希望今年我們可以有更多時間一起出去玩。^^ - Joshua {0}”
1.2.1：字串末尾的 {0} 是批判的因為生日禮物就是這樣加到郵件中的。忘記這一點意味著玩家不會由於我添加了郵件動態禮物支援的特性，所以我收到了一份遲來的生日禮物。
1.2.2：星露穀物語的郵件文本結構與對話文本不同。我建議你閱讀維基百科來了解兩者之間的區別，因為我很久沒看維基百科了，我自己也花了很長時間才弄清楚。

1.3. 自訂禮物支援。透過在 /Content/Data/Gifts 下方新增一個包含對應 NPC 名稱的文件，您可以指定該 NPC 會贈送給玩家的禮物。我建議您查看 /Content/Data/Gifts/RegisteredGifts.json 文件，其中包含所有原版《星露穀物語》的禮物 ID。

2. 新增一種為事件新增額外對話字串的方法。雖然不太有趣，但現在允許模組製作者修改文字。

我個人建議使用隨附的英文內容包，複製一份，然後修改後製作自己的內容包。修改時請務必更改 Manifest.json 檔案！


進階：新增翻譯

現在，模組可以添加自訂翻譯，內容包系統也充當了翻譯內容系統。在為原版內容新增翻譯時，只需進行少量調整即可。

1./Content/Strings/ 下的所有檔案都需要根據新翻譯進行修改。這些文件包括生日祝福、郵件、活動對話等。
2. 需要修改 /TranslationInfo.json 檔案中的「LanguageCode」字段，使其反映遊戲正在使用的翻譯程式碼。例如，新增西班牙文翻譯需要將新內容包中的語言程式碼變更為“LanguageCode”：“es-ES”。

這樣用戶就能更輕鬆地添加自訂翻譯或對話變體，無需再向我發送訊息。只需建立內容包，然後將其拖放到 StardewValley/Mods 資料夾中即可！ Happy Birthday 會自動載入！


關於內容包：

請隨意在您自己的用戶資料下發佈內容包。我不會再將翻譯內容包放在此模組的下載部分，相反，我很高興看到其他人的貢獻也能獲得應有的認可。如果您製作了內容包，請務必註冊 Nexus 的模組捐贈積分系統！

關於Mod支持：
我知道大家普遍希望能加入《星露穀物語》擴充版等熱門模組的支援。為了實現這一點，我已經添加了很多框架，但我仍然需要調查具體需要做什麼，還要為這些新的NPC編寫事件/對話等等。我自己還沒玩過這個模組，所以近期無法保證什麼，但我還是想做這件事。

目前，如果您對「生日快樂」的擴展模組製作感興趣，我們提供了一些額外支持，例如添加模組贈送的自訂生日物品、添加自訂活動以及擴展活動功能。如需了解具體功能，請參閱
https://github.com/janavarro95/Stardew_Valley_Mods/blob/DevelopmentModRewrites/GeneralMods/HappyBirthday/Framework/API/HappyBirthdayAPI.cs
和
https://github.com/janavarro95/Stardew_Valley_Mods/tree/DevelopmentModRewrites/GeneralMods/HappyBirthday/Framework/Events
了解更多。

關於 Bug：
如果本模組有任何 Bug，請在此模組頁面的 Bug 版塊中發帖，以便我記錄並解決。這有助於我了解哪些地方仍需修復。雖然我已經盡可能地測試了新版本，但我知道可能還是有一些地方是我在熬夜工作時遺漏的，所以請耐心等待並告知我。

結束語：
距離我發布《生日快樂》已經過去五年多了，這原本是出於業餘愛好，為了更好地融入電子遊戲設計領域而進行的嘗試。雖然我知道自己並非一直都很活躍，但與社群互動、看到大家的回饋以及看到其他人對我作品的喜愛，真的非常開心。我從未想過要變得如此受歡迎，但如果能幫助大家以正面的方式體驗《星露穀物語》，我會感到欣慰。感謝你們一路走來的支持，並一如既往地祝福你們一切順利。 :)

歐米伽西斯。

特別感謝以下人士！

nexus 用戶：賽雷利尋找生日祝福的原始英文對話。
所有 nexus 用戶都為該 mod 創建了自己的翻譯！
PathosChild 多年來對我進行修改的支援！
Spacechase0 使用了 SpaceCore，它（一度！）幫助模組運作！ （SDV 1.5）

難題9999用於透過 stardew-access 添加螢幕閱讀器存取。
看https://github.com/janavarro95/Stardew_Valley_Mods/pull/95和https://github.com/khanshoaib3/stardew-access

（LEGACY V 2.0）包含的翻譯：
中文：感謝 Nexus 用戶艾林揚!
英文：我自己（Omegasis）為 nexus 使用者完成的生日活動和生日祝福：賽雷利
義大利菜單字串：LeecanIt
德文：Nexus 用戶納丁0147
俄文：Nexus 用戶帕納納埃瓦斯

參見

• 官方討論帖
• 原始碼+發行說明
• 我的其他模組
• 我的嘰嘰喳喳我有時會在那裡發布我正在做的事情。
• 我的遊戲，館長，我正在努力。它仍在開發中，所以也請耐心等待。