> For the complete documentation index, see [llms.txt](https://docs.sarry20.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sarry20.com/products/minions/upgrades.md).

# Upgrades

You can create custom upgrades for your minions to make your server more personalized and attractive.

| 🆙Level Upgrade Options    | Expected Value                                                                                                                                                                   |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Chest/Leggings/Boots Color | WHITE, BLACK, RED, GREEN, GRAY, CYAN, PINK, PURPLE, BROWN, YELLOW, BLUE                                                                                                          |
| Tool                       | [Material](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)                                                                                                    |
| Head                       | [Head Value](https://minecraft-heads.com/custom-heads)                                                                                                                           |
| ActionTime                 | Number                                                                                                                                                                           |
| SlotsNumber                | Number                                                                                                                                                                           |
| Upgrade.Money.Available    | Boolean (Requires [Vault](https://www.spigotmc.org/resources/vault.34315/))                                                                                                      |
| Upgrade.Money.Amount       | Number (Requires [Vault](https://www.spigotmc.org/resources/vault.34315/))                                                                                                       |
| Upgrade.Items.Available    | Boolean                                                                                                                                                                          |
| Upgrade.Items.ItemList     | String List, you can use EcoItems **ecoitems#id\_material#amount**, or other minions **minion#minion\_type#minion\_material#level** or simply vanilla items, **material#amount** |

{% hint style="info" %}
In the configuration section **Upgrade** It is the cost needed to reach **that same level**, that is, you are configuring what is needed for **that level.**
{% endhint %}

{% hint style="info" %}
If you will use a minion to upgrade another minion keep in mind that the player will need two of the same level, one in hand and the other that is placed.
{% endhint %}

How to add custom upgrade:

```yaml
Level_3:
    ChestColor: WHITE
    LeggingsColor: WHITE
    BootsColor: WHITE
    Tool: WOODEN_PICKAXE
    Head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNTczMDkyY2FlYTg5ZGQxMmQzNjgzNzVmMWEwOTc3OTZlM2JjODhmODA5YWNjZjMyMDcwNmJkYzA0OGNkNGM1ZSJ9fX0=
    ActionTime: 3
    SlotsNumber: 15
    Upgrade:
      Money:
        Available: false
        Amount: 0
      Items:
        Available: true
        CraftingId: '#'
        ItemList:
        - COBBLESTONE:32
        - IRON_ORE:32
        - minion#MINER#IRON_ORE#1
```