PeliQ - 物品查詢工具框架

爲模組開發者添加物品查詢相關的實用工具

PeliQ

🌟 **開發者框架** - 爲星露谷物語模組開發者提供強大的物品查詢相關工具集

🎯 核心功能

🔗 嵌套物品查詢

• 運行一個物品查詢，然後將結果傳遞給另一個查詢進行進一步處理
• 內部物品查詢放在 `ModData` 字段中
• 目前只能嵌套一次，且內部查詢不能接受列表類型

**示例代碼：**

```json

{

"Id": "{{ModId}}_AllBait_Outer",

"ItemId": "ALL_ITEMS (O)",

"PerItemCondition": "ITEM_CONTEXT_TAG Target category_fish",

"ModData": {

"Id": "{{ModId}}_AllBait_Inner",

"ItemId": "FLAVORED_ITEM Bait mushymato.PeliQ_NestedId"

}

}

```

💾 存儲物品查詢

• 添加新的資產用於存儲可重複使用的物品查詢
• 使用 `mushymato.PeliQ/ItemQueries` 自定義資產
• 支持條件查詢和多種使用場景

**應用場景：**

• 物品查詢中使用：`mushymato.PeliQ_STORED_QUERY `
• 觸發器動作：`mushymato.PeliQ_AddItemByQuery [ItemQuerySearchMode]`
• 地圖動作：`mushymato.PeliQ_AddItemByQuery [ItemQuerySearchMode] [isDebris]`
• 郵件系統：`%peliQ [ItemQuerySearchMode] %%`

🔍 搜索模式選項

• **All** - 獲取所有結果
• **AllOfTypeItem** - 獲取所有類型物品（默認）
• **FirstOfTypeItem** - 獲取第一個類型物品
• **RandomOfTypeItem** - 隨機獲取類型物品

🛒 虛擬商店物品

• `mushymato.PeliQ_ACTION_SALABLE `
• 創建不實際購買物品的虛擬商店條目
• 主要用於激活 `ActionsOnPurchase` 而不給予實際物品

**自定義字段：**

• `mushymato.PeliQ/ExitOnPurchase` - 購買後立即退出菜單
• `mushymato.PeliQ/PurchaseSound` - 購買時播放的音效

🎮 新遊戲狀態查詢

**正則表達式匹配：**

• `mushymato.PeliQ_ITEM_ID_REGEX Target|Input +`
• 使用正則表達式匹配物品ID（不區分大小寫）

**邏輯操作符：**

• `mushymato.PeliQ_ANY_N` - 檢查多個GSQ結果
• `mushymato.PeliQ_AND` - 邏輯與操作
• `mushymato.PeliQ_OR` - 邏輯或操作
• `mushymato.PeliQ_XOR` - 邏輯異或操作

---

💡 **使用建議**：這個框架特別適合需要複雜物品查詢邏輯的模組開發者，可以大大簡化物品篩選和條件判斷的代碼實現。

🔗 **官方資源**：

• 源代碼
• 示例模組

🎯 **適用對象**：星露谷物語模組開發者，特別是需要處理複雜物品邏輯和查詢功能的模組製作。