Items Filter

Set up easy and automatic sorting systems.

No longer need for laggy and bulky redstone contraptions. The Items Filter provides a better alternative to automatically sort your storage room!

🪄Introduction

What is Items Filter?

Items Filters allow you to you to filter several types of items from a container placed above it to another container placed below it. You can choose what items the filter let pass by presetting them in an adjacent reference container. Items Filters can also directly drop their sorted items if you there is a fluid block below them (air, water or lava).

If you used to use V.2, you may have noticed that the data pack changed its name. This is due to the fact it doesn't strictly rely on hoppers anymore: you can directly pass an item from a chest or a shulker box to another one if you want to.

How to craft and use an Item Filter?

Items Filters can be crafted using:

• 6x Cobbled Deeplsate
• 1x Hopper
• 1x Observer
• 1x Dropper The recipe is the following:

When you place an items filter, the side facing your player will show a tiny grey button. This is the one you can right-click to toggle mode, that we will explain later.

The opposite face shows a tiny observer icon. This is where you need to place a compatible containers (all containers having a direct Items entry like chests, hoppers, barrels, shulker boxes, dropper, dispenser, etc.). This one need to contain all reference items, meaning the one you want to let pass through the relative filter. Other items that don't match those ones will remain in the container above, or continue their path to your system if it is an hopper connected to another.

In order to make it work, Items Filters then needs to have :

• A compatible container placed above them.
• A compatible container placed on their tiny observer icon, and containing items to filter.
• A compatible container placed below them to receive the filtered items, or a fluid block (air/lava/water) to directly drop them.

I recommend you to see the tutorial video for better explanations and examples.

🔖 Modes

Item Filters have two modes: the Lax mode that is the one by default, and the Strict mode. Modes are toggleable by right-clicking the little grey button on one of its face.

Lax mode

The Lax mode is represented by the grey color of the button. When an Items Filter is set on Lax mode, it will only take items' id into account to filter them, and ignore all their potential NBT. Meaning for example, in Lax mode, if you set an enchanted Diamond Sword in the reference container, all Diamond Swords, no matter their enchantments, their damage or any other tag will pass the filter, because they still share the same id (minecraft:diamond_sword).

Strict mode

The Strict mode is represented by the yellow color of the button. When an Items Filter is set on Strict mode, it will consider the id but also all (non-ignored) tags (before MC 1.20.5) or components (after MC 1.20.5) of items. In this case, to take back the example above, only Diamond Swords which share the exact same data (enchantments, damage, etc.) will pass the filter. It is useful if you want to items like Enchanted Books, custom Player Heads, or custom items from other data packs.

The Strict mode also has the ability of ignoring some tags or components if needed. See the Settings section below for explanations.

⚙️Settings

/function pk_it_fi:settings/mode/strict/ignored_components/add {id:"<id>"}
/function pk_it_fi:settings/mode/strict/ignored_components/remove {id:""<id>"}
/function pk_it_fi:settings/mode/strict/ignored_components/list

/function pk_it_fi:settings/mode/strict/ignored_components/add {id:"minecraft:repair_cost"}

/function pk_it_fi:settings/mode/strict/ignored_components/add_default_sample

/function pk_it_fi:settings/mode/strict/ignored_tags/add {property:"<property>"}
/function pk_it_fi:settings/mode/strict/ignored_tags/remove {property:""<property>"}
/function pk_it_fi:settings/mode/strict/ignored_tags/list

/function pk_it_fi:settings/mode/strict/ignored_tags/add {property:"repairCost"}

/function pk_it_fi:settings/mode/strict/ignored_tags/add_default_sample

function pk_it_fi:settings/mode/lax/ignore_container_color/true
function pk_it_fi:settings/mode/lax/ignore_container_color/false
function pk_it_fi:settings/mode/lax/ignore_container_color/get

/function pk_it_fi:settings/transfer_cooldown/get
/function pk_it_fi:settings/transfer_cooldown/set {value:<value>}

/function pk_it_fi:settings/transfer_cooldown/set {value:1}

/function pk_it_fi:settings/reference/allow_double_chest/true
/function pk_it_fi:settings/reference/allow_double_chest/false
/function pk_it_fi:settings/reference/allow_double_chest/get

🧰 Other Commands

Give yourself an items filter

If you are an operator of your server or if cheats are enabled in your single-player world, you can give yourself an items filter using these following command:

(after V.3.1.0):

/function pk_it_fi:cmd/give/items_filter

(before V.3.1.0):

/function pk_it_fi:items/items_filter/give

Troubleshooting

Recreate all items filters from the database

If ever items filters have been broken accidentally (using a kill @e command for example) you can run the following command to recreate all items filters from the database

/function pk_it_fi:cmd/debug/recreate_all_items_filters

The process will automatically remove all remaining entities and blocks of broken items filters before placing fresh ones. All data (id, owner, filterring mode...) will be preserved. It may take some time for it to complete, so be sure to get the message telling the process ended successfully before interacting with or placing an items filter.

🔧 Update from V.2

You can transform all existring Hopper Sorters (from V.2) to Items Filters. In order to do so, don't uninstall V.2 upstream with the uninstalling process, as you should keep its database. Just remove the V.2 data pack from the datapacks folder of your world, update your world to the newer version of Minecraft if desired and install Items Filters V.3 at the same time. Then use the following command to start the automatic updating process:

(after V.3.1.1):

/function pk_it_fi:cmd/database/update_from_v2

(before V.3.1.1):

/function pk_it_fi:base/update/from_v2/start

And wait for the updating process to end.

Note that this process won't unfortunately keep the filterring mode (lax or strict) of hopper sorters, as it wasn't previously stored in the database. However, they will keep all other data (their id, owner and location).

🧹 Uninstall

Items filters comes with an automatic uninstallation process. Running it will:

• Remove all items filters that have been placed in your world, in every dimensions
• Remove all scores and storage specific to the Items Filter data pack
• If there is no more KawaMood data packs installed, also remove all common scores and storages

The uninstalling process may take some seconds to complete. Be sure to wait for the message telling you that you can safely remove the data pack from your world's folder before doing it.

The command to start the uninstalling process is the following one:

/function pk_it_fi:base/uninstall/start

❓ F.A.Q

🪠 Report an issue

If you encountered an issue with this data pack, preferably join the Discord server, and open a post in the dedicated #data-pack-issues channel to describe your problem. Please, don't forget to provide all necessary informations including:

• The Minecraft version you're using.
• The version of the concerned data pack you're using.
• If you're using any modified version like Forge, Paper or Spigot.
• If you do, the plugins or mods you're using that may alter the functioning of data packs.
• The list of other data packs you're using, if you have others.
• A clear description of your issue, and a way to reproduce it.
• If necessary, a video or a screenshot of the issue in game.

Before doing that, please read the F.A.Q. section just above. The issue you're facing may be a common one, and a way to fix it may already have been provided in it.

📌 Other links

Thank you for using Items Filter! It makes me happy to know people are enjoying it. If you want to support its development and the development of other data packs, you can support me on my other social networks:

• Youtube
• Planet Minecraft
• Or if you're in a generous mood, I accept donation on paypal or buy me a kawa (slang term for "coffee")!