# Add Socket

***

The Gem Add Socket feature lets you add sockets to desired items, with customization options based on the available features.

<figure><img src="https://1245303946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMKTTfYtO1c14jr3rkcH%2Fuploads%2FI7SQgLRwPSz9vK8mrhGr%2F21222.png?alt=media&#x26;token=9d4d7d33-e52c-405e-a9df-bf1e07d055c7" alt=""><figcaption><p>Add Socket Gui</p></figcaption></figure>

### Features

### **1**. **Material Item**&#x20;

You can use **Material Items** to add sockets to your items. You can also enable `material-chance` to introduce a success/failure chance for adding sockets. You're able to add more than one item to the list.

```yaml
materials:
  enabled: true
  material-chance: true
  addsocket:
    - type: MATERIAL # Item type (MATERIAL, MMOITEM)
      id: STEEL_INGOT # Item ID
      amount: 1
      chance: 50
    - type: MATERIAL # Item type (MATERIAL, MMOITEM)
      id: RARE_DIAMOND # Item ID
      amount: 1
      chance: 50
```

***

### **2**. **Add Socket Case**

**2.1 Default Add Socket**&#x20;

This method adds sockets to items up to a maximum defined by `max-sockets` for all items.

```yaml
default-add-socket:
    socket-color: "Uncolored" #Default value is ANY, but if using a colored GEM STONE, that color will be the primary one.
    max-sockets: 50
    

#default
socket-color: "Uncolored"

#random
socket-color:
      - "Uncolored"
      - "Red"
      - "Blue"
      - "Green"
```

**2.2 Tiers Add Socket**&#x20;

This method checks the **Tier** of the item you're adding sockets to. If it matches any condition in the `tier-list`, items with that Tier will reference their `max-sockets` setting. You can add more than one Tier to the list.

```yaml
tiers-add-socket:
    enabled: false
    socket-color: "Uncolored"
    no-tier-max-sockets: 50
    tier-list:
      - tier: COMMON
        max-sockets: 3
      - tier: RARE
        max-sockets: 5
```

***

### **3**. **Cost Add Socket**&#x20;

This feature allows you to use **Vault (Money)** for each socket addition.

```yaml
cost-add-socket:
    enabled: false #Cost
    amount: 5000
```

***

### **4**. **Remove Durability When Fail**&#x20;

If you fail to add a socket, your item's **durability will be completely removed**.

```yaml
remove-durability-when-fail: 
    enabled: true
```

***

### 5. Destroy Item When Fail

If an item upgrade fails, the item will be replaced with a predefined material.

```yaml
destroy-item-when-fail:
  enabled: false
  item-return:
    type: MATERIAL # Item type (MATERIAL, MMOITEM)
    id: STEEL_INGOT # Item ID
    amount: 1
```

***

### **6. Applies To**

You can specify more than one **MMOItem type** that this configuration applies to.

```yaml
applies-to:
  - SWORD
  - PICKAXE
```