# How To Use<\/p>\n
### 1. Install the Plugin ### 2. Setting Up Filters #### Allow Only Specific Items #### Exclude Specific Items #### Allow Items by Prefix or Part of the Name #### Exclude Items by Part of the Name ### 3. Example Names ### 4. In-Game Usage ### 5. How the Hopper Handles Blocked Items ## Notes A Minecraft Paper plugin that allows you to control what items a hopper can pick up or move, based on renaming the hopper with an anvil.<\/p>\n","protected":false},"featured_media":108603,"template":"","meta":{"_minecraft_slug":"namefilterhopper","_minecraft_project_id":"vyPDFfg1","_minecraft_author":"kcbleeker","_minecraft_license":"Apache-2.0","_minecraft_downloads":34,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"namefilterhopper.zip","_minecraft_size_bytes":5006,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:52:21.643058Z","_minecraft_date_created":"2026-01-05T22:49:21.218322Z","_minecraft_date_modified":"2026-01-01T08:56:24.616278Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/namefilterhopper","_minecraft_icon_attachment_id":108603,"_minecraft_imported_at":"2026-06-06T06:45:29+00:00","_minecraft_import_hash":"de66d809e2b51647ee343a795ac7eb84","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,91,92],"mod_loader":[132],"minecraft_version":[40,41,79,80,81,82],"class_list":["post-108602","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-storage","mod_category-utility","mod_loader-paper","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Place the `namefilterhopper-
\n– Start or reload your Paper server.<\/p>\n
\nThe hopper’s name determines what items it will allow or block. You can use the following formats:<\/p>\n
\n– Name the hopper with the item name(s) you want to allow, separated by `|` (pipe character).
\n– Example: `diamond|iron_ingot` \u2014 Only allows diamonds and iron ingots.<\/p>\n
\n– Use `x:` before an item name to exclude it.
\n– Example: `x:stone|x:dirt` \u2014 Excludes stone and dirt, allows everything else.<\/p>\n
\n– Use `s:` to allow items that start with a string.
\n– Use `c:` to allow items that have a string as part of their name.
\n– Example: `s:iron|c:ingot` \u2014 Allows items starting with “iron” or with “ingot” as part of their name.<\/p>\n
\n– Use `n:` to exclude items that have a string as part of their name.
\n– Example: `n:log` \u2014 Excludes any item with “log” as part of its name.<\/p>\n
\n– `diamond` \u2014 Only allows diamonds.
\n– `x:stone` \u2014 Excludes stone.
\n– `c:stone|x:smooth_stone` \u2014 Allows anything with “stone” in the name, excludes smooth stone.
\n– `s:iron` \u2014 Allows items starting with “iron” (e.g., iron_ingot, iron_block).
\n– `c:ingot` \u2014 Allows any item with “ingot” as part of its name.<\/p>\n
\n– Name a hopper item using an anvil, then place it in the world.
\n– Once placed, the hopper will automatically filter items according to its name.
\n– No commands are required. Just name the hopper before placing it and it will work!<\/p>\n
\nIf your hopper tries to move an item that isn’t allowed by its name filter, it will look through the rest of its inventory and try to move a different item that is allowed. This way, your hopper doesn’t get stuck and can still move other items that match its filter.<\/p>\n
\n– Item names must match the Minecraft item type names (e.g., `diamond`, `iron_ingot`, `stone`).
\n– You can combine multiple filters using the `|` character.
\n– The plugin works with all hoppers in the world as soon as they are named.<\/p>\n","protected":false},"excerpt":{"rendered":"