祕密筆記框架

一個用於向遊戲添加自定義祕密筆記的框架模組

Secret Note Framework

✨ **一個爲模組作者打造的強大框架，輕鬆添加高度可定製的祕密筆記到遊戲中！**

---

🎯 主要功能

這個框架讓模組作者能夠輕鬆創建各種自定義祕密筆記，玩家可以在遊戲中發現和收集這些筆記。

**核心特性包括：**

• 🎮 **條件控制**：爲每個筆記設置複雜的資格條件，基於遊戲狀態查詢
• 📍 **位置定製**：指定筆記可以出現的具體位置或位置上下文
• 🎨 **自定義物品**：使用不同的自定義物品代表不同的筆記集合
• 🖼️ **資產定製**：指定自己的筆記內容和格式資源，包括圖片筆記
• 📝 **圖文結合**：創建包含圖片和少量文字的筆記
• ⚡ **觸發動作**：設置任意數量的觸發動作，在筆記首次閱讀時執行

---

🛠️ 使用指南

**如果你是玩家**：

• 你可能是因爲其他模組的需求而來到這裏
• 只需下載、解壓，然後享受遊戲！

**如果你是模組作者**：

• 請查閱作者指南獲取文檔和示例
• 如需幫助，可以在星露谷物語Discord服務器上找到我（ichortower）
• 報告bug請使用Bugs標籤或GitHub倉庫

---

📋 系統要求

• 🎮 Stardew Valley 1.6.9+
• 🔧 SMAPI 4.1+
• 📝 強烈推薦作者使用Content Patcher（雖然不是必需，但你可能已經有了）

---

💡 爲什麼需要這個框架？

祕密筆記是星露谷物語1.6中少數仍然需要整數ID的遊戲數據類型之一。這帶來了幾個問題：

• **ID衝突**：任何兩個想要添加祕密筆記的模組都面臨協調問題
• **類型限制**：ID決定了筆記類型（ID≥1000是日誌碎片，在島嶼位置上下文中生成）
• **標籤限制**：ID還決定了筆記在收藏菜單中的標籤
• **資源共享**：所有祕密筆記必須共享相同的圖片紋理
• **界面限制**：收藏菜單中的祕密筆記標籤只知道有38個筆記，並且只設置了一頁

這個框架解決了所有這些限制，讓模組作者能夠自由地創建豐富的祕密筆記內容！

---

🌍 多語言支持

模組內置支持以下語言：

• 🇫🇷 **法語**（由Caranud提供）
• 🇯🇵 **日語**（由ichortower提供）
• 🇰🇷 **韓語**（由JA3B2提供）

特別感謝這些貢獻者的辛勤工作！

---

🎉 **開始你的祕密筆記創作之旅吧！**