---
description: Use the item filter requirement in a KubeJS recipe.
---

# Item filter

U**se one of these methods to add an** [item-filter](../../../recipes/requirements/item-filter "mention") **requirement to the recipe.**

```javascript
.requireItemFilter(ingredient)
.requireItemFilter(ingredient, slot)
```

* The `ingredient` param must be an Ingredient.\
  KubeJS support various ingredient types : "item\_id", "#tag\_id", "@mod\_id" or even regex.
* The `slot` param must be a valid slot id.

### Example

The following recipe will run only if the filter slot "filter1" is set to a vanilla diamond :&#x20;

```javascript
ServerEvents.recipes(event => {

  event.recipes.custommachinery.custom_machine("custommachinery:power_crusher", 100)
  .requireItemFilter("minecraft:diamond", "filter1")
})
```
