---
title: Filter
id: morered:filter
type: block
---

Filters are item-handling blocks which can accept insertions of one type of item, rejecting all other items.


<table>
	<thead><tr><th>Contents</th></tr></thead>
	<tbody><tr><td>
		1. [Recipes](#recipes)
		2. [Usage](#usage)
		3. [Data](#data)
		4. [History](#history)
	</td></tr></tbody>
</table>

## Recipes

<table>
	<thead>
		<tr>
			<th>Recipe Type</th>
			<th>Ingredients</th>
			<th>Output</th>
			<th>Example</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Shaped Crafting</td>
			<td style={{width: '30%'}}>
				* 1x [<ModAsset width={32} height={32} location='morered:item/shunt'/> Shunt](@morered:shunt)
				* 1x [<ModAsset width={32} height={32} location='item_frame'/> Item Frame](https://minecraft.wiki/Item_Frame)
			</td>
			<td>
				* 1x Filter
			</td>
			<td>
				![Shaped Crafting Recipe for Filters](https://commoble.s3.us-east-1.amazonaws.com/images/morered/recipes/filter_recipe.png)
			</td>
		</tr>
	</tbody>
</table>

## Usage

While the filter holds no item, it acts as a [Shunt](@morered:shunt).

Right-clicking the filter will open a menu with a single item slot.
While that slot holds an item, it will be displayed inside the filter,
and only items of that type can be inserted into the filter.

![](https://commoble.s3.us-east-1.amazonaws.com/images/tubesreloaded/filter_2.png)

Using the [Pliers](@morered:pliers) or another mod's wrenchlike item on a filter will rotate it.

## Data

| Blockstate Properties | Values | Description
| --- | - | -
| `facing` | `{"down", "up", "north", "south", "west", "east"}` | Output direction

Blockentity data has the following format:

```json
{
	"inventory": {
		"stacks": <list of itemstacks>
	}
}
```
| BlockEntity Data | Format | Description
| --- | - | -
| `stacks` | List of Itemstack objects | Each object has values "id", "count", and "data". Only the first slot is used.

## History
| Version | Changelog
| --- | -
| 21.10.0 | Inventory is now serialized under inventory -> stacks
| 1.21.3-7.0.0.0 | Added to More Red