> For the complete documentation index, see [llms.txt](https://ney.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ney.gitbook.io/docs/lootroll/configuration.md).

# Configuration

Loot configurations are stored in YAML files in the `plugins/LootRoll/drops/` folder. You can create multiple files to organize your configurations.

### Basic Structure

```yaml
mob_id:
  min-drops: 1
  max-drops: 3
  loot:
    - vanilla{item=diamond} 1-3 .5
    - vanilla{item=iron_sword} 1 .3
```

### Mob Configuration

#### Required Fields

* `loot` - List of loot items that can drop

#### Optional Fields

* `min-drops` - Minimum number of items to drop (default: 0)
* `max-drops` - Maximum number of items to drop (default: min-drops)
* `override-vanilla-drops` - Replace vanilla drops completely (default: false)
* `process-vanilla-drops` - Process vanilla drops through roll system (default: false)

### Loot Item Format

The new format for loot items is:

```yaml
type{parameters} amount-range chance
```

#### Format Breakdown

* **type** - Item type (`vanilla`, `mmoitems`, `mythicmobs`, `exp`, `money`)
* **parameters** - Item-specific parameters (see below)
* **amount-range** - Amount range (e.g., `1-5`, `2to5`, or `3`)
* **chance** - Drop chance as decimal (e.g., `.7` = 70%)

#### Vanilla Items

```yaml
- vanilla{item=diamond} 1-3 .5
- vanilla{item=iron_sword} 1 .3
```

* `item` - Material name (case-insensitive, e.g., `diamond`, `DIAMOND`, `Diamond`)

#### MMOItems

```yaml
- mmoitems{type=SWORD;item=EXCALIBUR} 1 .8
- mmoitems{type=WEAPON;item=LegendarySword;unidentified=true} 1 .5
```

* `type` - MMOItems type (e.g., `SWORD`, `WEAPON`, `ARMOR`)
* `item` - Item ID
* `unidentified` - Whether item should be unidentified (default: false)

#### MythicMobs Items

```yaml
- mythicmobs{item=LegendarySword} 1 .7
- mm{item=EpicBow} 1 .5
```

* `item` - MythicMobs item ID
* You can use `mythicmobs` or `mm` as the type

#### Nexo Items

```yaml
- nexo{item=NexoItem} 1 .7
```

* `item` - Nexo item ID

#### CraftEngine Items

```yaml
- craftengine{item=namespace:item_id} 1 .7
```

* `item` - CraftEngine item ID

#### Experience

```yaml
- exp{split=true} 100-150 .1
```

* `split` - Automatically split experience among party members (default: false)
* Amount range is the experience points to give

#### MMOCore Experience

```yaml
- mmoexp{split=true} 100-150 .1
```

* `split` - Automatically split experience among party members (default: false)
* Amount range is the experience points to give

#### Money

```yaml
- money{split=true} 50-100 .5
```

* `split` - Automatically split money among party members (default: false)
* Amount range is the money amount to give
* Requires Vault and an economy plugin

### Vanilla Mob Configuration

#### Override Vanilla Drops

```yaml
zombie:
  override-vanilla-drops: true
  min-drops: 1
  max-drops: 2
  loot:
    - vanilla{item=rotten_flesh} 2-5 .9
```

When `override-vanilla-drops: true`, vanilla drops are completely replaced with configured loot.

#### Process Vanilla Drops

```yaml
zombie:
  process-vanilla-drops: true
  min-drops: 1
  max-drops: 2
  loot:
    - vanilla{item=diamond} 1 .5
```

When `process-vanilla-drops: true`, vanilla drops are processed through the roll system along with configured loot.

### Item Stacking

Items with the same type and properties automatically stack together. For example:

```yaml
- vanilla{item=rotten_flesh} 2-5 .7
```

If this drops 3 rotten flesh, they will stack into one item stack: `[3x Rotten Flesh]`

### Examples

#### Simple Zombie Loot

```yaml
zombie:
  min-drops: 1
  max-drops: 2
  loot:
    - vanilla{item=rotten_flesh} 2-5 .9
    - vanilla{item=iron_sword} 1 .1
```

#### MythicMobs Boss

```yaml
DragonBoss:
  min-drops: 2
  max-drops: 4
  loot:
    - mythicmobs{item=DragonSword} 1 .8
    - mmoitems{type=ARMOR;item=DragonChestplate} 1 .6
    - money{split=true} 1000-2000 .5
    - exp{split=true} 500-1000 .3
```

#### Vanilla Mob with Override

```yaml
skeleton:
  override-vanilla-drops: true
  min-drops: 1
  max-drops: 3
  loot:
    - vanilla{item=bone} 1-3 .8
    - vanilla{item=bow} 1 .2
    - vanilla{item=arrow} 5-10 .5
```

### Tips

1. **Organize by Category**: Create separate files for different mob types (e.g., `vanilla.yml`, `mythicmobs.yml`)
2. **Use Ranges**: Use amount ranges to add variety (e.g., `2-5` instead of `3`)
3. **Balance Chances**: Lower chances for rare items, higher for common ones
4. **Test Configurations**: Use `/lootroll reload` and test in-game before deploying
5. **Check Logs**: If items don't drop, check console for parsing errors