> For the complete documentation index, see [llms.txt](https://quality-plus.gitbook.io/untitled/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quality-plus.gitbook.io/untitled/theminions/minion-layout.md).

# Minion Layout

This is an easy tutorial of how does work the area of each minion.

## **Block Break Layout:**

{% code title="/plugins/TheMinions/minions/diamond\_minion.yml" lineNumbers="true" %}

```yaml
minion-layout:
  type: TWO_X_TWO
  toReplaceBlock: DIAMOND_ORE
  materialThatCauseException:
  - DIRT
  allMaterialsCauseExceptionExcept:
  - COBBLESTONE
  - STONE
  - DIAMOND_ORE
```

{% endcode %}

* **type:** this is the area around where minion will look for, it can be **TWO\_X\_TWO** or **THREE\_X\_THREE**
* **toReplaceBlock:** this is the block that minion will place in the selected position
* **materialThatCauseException:** if minion has one of these materials around it will cause an exception
* **allMaterialsCauseExceptionExcept:** if minion has a material that doesn't be here it will cause an exception

## **Crop Break Layout:**

{% code title="/plugins/TheMinions/minions/wheat\_minion.yml" overflow="wrap" lineNumbers="true" %}

```yaml
minion-layout:
  type: TWO_X_TWO
  toReplaceBlock: FARMLAND
  toReplaceCrop: WHEAT
  materialThatCauseException:
  - STONE
  allMaterialsCauseExceptionExcept:
  - DIRT
  - FARMLAND
```

{% endcode %}

* **toReplaceCrop:** this is the crop that minion will plant in the selected position

## Mob Killer Layout:

**Vanilla Mobs Example:**

{% code title="/plugins/TheMinions/minions/cow\_minion.yml" overflow="wrap" %}

```yaml
minion-layout:
  type: TWO_X_TWO
  materialThatCauseException: []
  allMaterialsCauseExceptionExcept:
  - GRASS_BLOCK
  - DIRT
  minionMob:
    displayName: null
    entityType: COW
    isFromMythicMobs: false
    id: null
```

{% endcode %}

**Mythic Mobs Example:**

{% code title="/plugins/TheMinions/custom\_minions/epic\_cow\_minion.yml" overflow="wrap" lineNumbers="true" %}

```yaml
minion-layout:
  type: TWO_X_TWO
  materialThatCauseException: []
  allMaterialsCauseExceptionExcept:
  - GRASS_BLOCK
  - DIRT
  minionMob:
    displayName: null
    entityType: COW
    isFromMythicMobs: true
    id: epic_cow
```

{% endcode %}

* **minionMob.displayName:** if the entity to look for should have a specific name (only for vanilla mobs)
* **minionMob.entityType:** the type of entity to look for
* **minionMob.isFromMythicMobs:** if the entity to look for is from MythicMobs
* **minionMob.id:** the id of the entity from MythicMobs