礦井寶藏框架

一個允許內容包修改礦井寶藏的框架

Mine Treasure Framework

🎯 框架介紹

MineTreasureFramework（MTF）是一個SMAPI框架，專門用於**修改本地礦井中的獎勵物品**（位於第10、20、40層等寶箱中的物品）。

⚠️ **注意**：第120層礦井、骷髏洞穴寶箱層和火山寶箱無法通過此框架編輯。

✨ 核心特性

• 從您創建的列表中隨機選擇一個獎勵，與原版獎勵機制相同
• 支持三種不同類型的內容包
• 靈活的配置選項

🎁 內容包類型

1. **微調原版寶藏包** (`alter_vanilla_treasures`)

對原版礦井寶藏進行細微調整。例如：如果您創建了一個添加多種靴子模型的模組，並希望這些靴子能在玩家啓用"重混礦井獎勵"選項時出現在礦井寶箱中。

2. **完整替換套裝包** (`full_replacement_set`)

替換礦井寶藏層中的所有寶箱物品。例如：創建一個將所有礦井獎勵替換爲隨機種子的模組。此類內容包優先級高於微調包，同一遊戲中只能添加一個。

3. **調整替換套裝包** (`alter_replacement_set`)

對"完整替換套裝包"產生與"微調原版寶藏包"相同的效果。例如：您喜歡給予礦井寶箱隨機種子的模組，並希望創建一個補丁來添加豐饒之角種子和一些平衡調整。

📋 配置示例

完整套裝包示例

```json

{

"PackType": "full_replacement_set",

"Floors": [

{

"Floor": 10,

"TreasureList":[

{"QualifiedItemId": "(W)11"},

{"QualifiedItemId": "(W)20", "Condition": "remixed"}

]

}

]

}

```

調整包示例

```json

{

"PackType": "alter_vanilla_treasures",

"Floors": [

{

"Floor": 10,

"TreasureList":[

{"QualifiedItemId": "(B)506", "Remove": "yes"},

{"QualifiedItemId": "SkillBook_0"}

]

}

]

}

```

⚙️ 高級功能

樓層類型更改

啓用`EnableFloorTypeChange`配置後，MTF允許內容包更改樓層類型，使普通採礦層可以變成寶箱房間，寶箱房間可以變成普通採礦層。

字段說明

**包級別字段：**

• `PackType`：定義內容包類型
• `Floors`：樓層列表

**樓層級別字段：**

• `ClearAllTreasures`：移除所有現有寶藏
• `KeepVanillaVersion`：保留原版版本
• `OnNoTreasureFound`：處理空寶箱房間
• `MapId`：指定使用的地圖ID

**寶藏字段：**

• `QualifiedItemId`：物品的限定ID
• `Amount`：物品堆疊數量
• `Condition`：出現條件
• `Remove`：移除現有物品

🔧 兼容性

• 基於星露谷物語1.6.8原版創建
• 已在1.6.13版本測試通過
• 與Cornucopia模組兼容性已驗證
• 使用Harmony修補遊戲方法

💡 **提示**：此模組本身不產生任何效果，需要配合內容包使用。您可以嘗試作者的內容包來體驗完整功能。