# Tiered Repair Kits

**Tiered Repair Kits** is a balance-focused mod for Hytale that overhauls Repair Kits for use with other mods that might have rare variants, quality tiers, rare drops, etc. Allowing you to maintain or even improve rare items that are hard to replace.

Instead of a one-size-fits-all approach, this mod introduces a progression of kits that range from makeshift copper kits to legendary Prisma-infused kits.

High-tier kits allow you to preserve or even extend the life of your equipment. By utilizing advanced materials, higher-quality kits feature a negative repair penalty, allowing you to reclaim or increase the maximum durability of your items as you maintain them.

_There are other repair kit mods that also allow you to enhance maxium durability but I believe that they are tuned way too high or the recipes are too cheap (OP). The durability increases in this mod are purposfully low which encourages using tools, and repairing them repeatedly at high material cost to make them stronger and stronger._

***

## 🛠️ Mod Features

*   **Tiered Progression:** 10 distinct tiers of repair kits integrated into the game's material tiers.
*   **Durability Management:** High-end kits (Silver and above) can increase the maximum durability of an item based on the amount of damage repaired.
*   **Balanced**  Low-tier kits are easy to craft in the field, while Legendary kits require rare materials.
*   **UI:** Uses the native `ItemRepair` interface.
*   **Safe:** Does not override any built-in items/recipes or files. All items use separate unique item IDs.

***

## 💎 Repair Kit Tiers & Recipes

Below is a breakdown of every kit available, ordered from basic field maintenance to legendary restoration.

| **Tier**  |**Change to Max Durability** |**Crafting Materials**                 |**Bench** |
| ---------------------- |------------------------ |--------------------------------------------------- |-------------- |
| **Copper (Fieldcrafting)** |**-5.0%**   |2x Fibre, 4x Copper Ore, 2x Stick                   |Fieldcraft     |
| **Copper** |**-5.0%**   |2x Fibre, 4x Copper Bar, 2x Stick                   |Workbench (T1) |
| **Iron**  |**0%**      |2x Linen Scrap, 8x Iron Bar, 2x Light Leather       |Workbench (T1) |
| **Gold**  |**+1.0%**   |4x Bolt of Wool, 16x Gold Bar, 4x Fire Essence      |Workbench (T2) |
| **Silver** |**+1.0%**   |4x Bolt of Wool, 16x Silver Bar, 4x Fire Essence    |Workbench (T2) |
| **Thorium** |**+2.5%**   |2x Sturdy Chitin, 16x Thorium Bar, 2x Venom Sac     |Workbench (T2) |
| **Cobalt** |**+5.0%**   |4x Shadoweave Scrap, 16x Cobalt Bar, 4x Ice Essence |Workbench (T2) |
| **Adamantite** |**+7.5%**   |4x Red Crystal, 16x Adamantite Bar, 4x Fire Essence |Workbench (T3) |
| **Mithril** |**+10.0%**  |4x Voidheart, 16x Mithril Bar, 4x Storm Leather     |Workbench (T3) |
| **Onyxium** |**+12.5%**  |1x Voidstone, 16x Onyxium Bar, 4x Storm Leather     |Workbench (T3) |
| **Prisma** |**+15.0%**  |1x Diamond, 16x Prisma Bar, 4x Storm Leather        |Workbench (T3) |

***

> <span style="color:#ba372a">**Design Note:** This mod is balanced for servers or playthroughs utilizing rare item variants, enchanted gear, or quality-based crafting (like Romna's) and therefore may not be appropriate for vanilla playthroughs. In these settings, preserving a high-stat item is often more valuable than crafting a new one. Consequently, high-tier recipes are intentionally expensive.<br><br>The intent is to give use to early game materials to maintain higer tier tools (i.e. using excess Gold/Iron/Thorium Ingots to craft Repair Kits to improve a Adamantite Pickaxe for example).</span>

***

## 📖 How it Works

The **RepairPenalty** is applied as a percentage to the amount of damage currently on a tool. When you perform a repair, the tool is fully restored, but the maximum durability of the tool is adjusted based on the kit used.

*   **Positive Penalty (e.g., 5%):** A portion of the damage repaired is subtracted from the tool's maximum durability. For example, a tool with 200 damage repaired by a 5% penalty kit would lose **up to** 10 maximum durability.
*   **Zero Penalty (0%):** The tool is fully repaired and its maximum durability remains unchanged.
*   **Negative Penalty (e.g., -10%):** The tool's maximum durability increases by a percentage of the damage repaired. A tool with 200 damage repaired by a -10% kit would gain **up to** 20 maximum durability.

_Note: The final adjustment is random within a range up to the maximum percentage defined by the kit._

### Crafting

All kits are crafted at a **Workbench** within the **Tinkering** category. The **Copper Tier** is unique, as it can be crafted directly in your **Fieldcrafting** menu using raw Copper Ore; ideal for emergency maintenance during early game expeditions.

***

## 📦 Installation

### Main Plugin

1.  Download the `QuickBASIC.TieredRepairKits.zip`.
2.  Place .zip file into your server's `Mods` folder.

 

### Recipe Overrides (Optional)

If you wish to customize crafting costs all of the recipes are defined separate from the item asset.

1.  With OP, in the creative menu open the Asset Editor. In the top right, click the … menu and create a pack.
2.  Call your pack something like `TieredRepairKitsOverrides`
3.  Navigate to QuickBASIC.TieredRepairKits in the editor.
4.  Find the recipe you'd like to override (Server/Items/Recipes/Tools/Repair\_Kits) and click Override
5.  Place your override in your newly created pack and change/edit the Input for the recipe to your hearts desire.

**Tip:** To disable a certain recipe, change its category to `Workbench_Hidden`. This keeps the item in the game (for loot/rewards from other mods maybe) but removes it from the crafting bench.