Mine treasure frame

A framework that allows content packs to modify mine treasures

Mine Treasure Framework

🎯 Framework introduction

MineTreasureFramework (MTF) is a SMAPI framework specifically used to modify reward items in local mines (items located in treasure chests on floors 10, 20, 40, etc.).

⚠️ **Note**: The 120th Mine Shaft, Skull Cave Treasure Chest Level, and Volcano Treasure Chest cannot be edited through this frame.

✨ Core Features

• Randomly select a reward from the list you created, same as the original reward mechanism
• Supports three different types of content packs
• Flexible configuration options

🎁 Content pack type

1. **Fine-tuned original treasure package** (`alter_vanilla_treasures`)

Minor adjustments to the original mine treasure. For example: If you create a mod that adds various boot models, and want those boots to appear in mine chests when the player enables the "Remix Mine Rewards" option.

2. **Full Replacement Set** (`full_replacement_set`)

Replaces all treasure chest items in the mine's treasure layer. For example: Create a mod that replaces all mine rewards with random seeds. Such content packs have higher priority than tweak packs, and only one can be added to the same game.

3. **Adjust replacement set package** (`alter_replacement_set`)

The "Complete Replacement Set" has the same effect as the "Tweaked Original Treasure Pack". For example: You like mods that give random seeds to Mine Chests, and want to create a patch that adds Horns of Plenty seeds and some balance adjustments.

📋 Configuration example

Complete package example

```json

{

"PackType": "full_replacement_set",

"Floors": [

{

"Floor": 10,

"TreasureList":[

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

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

]

}

]

}

```

Tuning package example

```json

{

"PackType": "alter_vanilla_treasures",

"Floors": [

{

"Floor": 10,

"TreasureList":[

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

{"QualifiedItemId": "SkillBook_0"}

]

}

]

}

```

⚙️ Advanced features

Floor type change

With the `EnableFloorTypeChange` configuration enabled, MTF allows content packs to change floor types so that normal mining floors can become treasure chest rooms, and treasure chest rooms can become normal mining floors.

Field description

**Package level fields:**

• `PackType`: Define content package type
• `Floors`: floor list

**Floor Level Field:**

• `ClearAllTreasures`: Remove all existing treasures
• `KeepVanillaVersion`: Keep the original version
• `OnNoTreasureFound`: Handle empty treasure chest rooms
• `MapId`: Specify the map ID to use

**Treasure Field:**

• `QualifiedItemId`: The qualified ID of the item
• `Amount`: the number of items stacked
• `Condition`: condition occurs
• `Remove`: Remove existing items

🔧 Compatibility

• Created based on the original version of Stardew Valley 1.6.8
• Passed the test in version 1.6.13
• Verified compatibility with Cornucopia mod
• Use Harmony to patch gameplay methods

💡 **Tips**: This module itself does not produce any effects and needs to be used in conjunction with the content pack. You can try the author's content pack to experience full functionality.