Overview

The Magic Sorting System is a free Data Pack available for Minecraft v1.13, v1.14, v1.15 and v1.16 (Java edition). It provides an easy way to craft an automatic, extensible item sorting system, which does not require redstone, nor console commands, nor command blocks. Items are teleported to matching item frames, where they can be routed via hoppers into chests or furnaces (so it still requires considerable resources and building). The whole system can be entirely built in survival mode, and supports both single and multiplayer (local or server install).

The sorting system works by providing a special magic drop off area, where you can dump any number of unsorted items (for e.g. when you come back from a mining trip), and they will be automatically sorted into 39 different categories, each with its own item frame. Note that you do not need all 39 categories to start out -- you can progressively build your storage system over time, and have it look however you want. You can also provide a "misc" (catch-all) category, which catches all items which don't have their own group built.

Items are teleported directly to their matching item frames for the category. The idea is that you can place a hopper directly under each item frame, which then routes the items into a connected chest (or multiple chests), or furnaces for auto-smelting. Item routing and storing is left up to the player, which can be simple or quite complex.

Why

It is already possible to build a complete item sorting and storage system using built-in vanilla Minecraft features. I've seen some incredible systems, and my hat is off to those amazing builders. However in practice, actually doing it is very difficult and tedious in my experience. It requires a large amount of hoppers and complex redstone contraptions for filtering. For example, to filter and store every item in the game, it would take at least 2 hoppers per unique item, or 1,550 hoppers total (3,875 iron ingots). Doing this in survival mode would take a very long time, and use up an enormous amount of space just for the machinery.

The magic sorting system is designed to make all this much easier to build. It requires only 1 hopper per category (39 categories total for sorting all items in the game), and handles all the item filtering and routing "magically" (i.e. by automatic item teleportation). It is server-friendly (lag-free), and it keeps survival gameplay balanced by requiring some expensive resources to start out.

Players can still build out custom storage systems using hoppers, chests, furnaces and more. They can be as simple or complex as they want. The magic sorting system only teleports items to special item frames. The rest is up to the player.

Features at a Glance

• Build and setup everything in pure survival mode
• Design your storage system to look however you like
• Progressively add new categories over time
• Sorts 878 unique items into 39 categories
• Unsorted items automatically go into a "misc" group
• Can have multiple sorting systems in same world (128+ blocks apart)
• Items are sorted to nearest matching item frames
• Very server-friendly (lag-free design)
• No redstone, no command blocks, and no console commands required
• Costs 1 gold block and 1 lapis block for controller
• Each sort group costs at least 1 item frame, 1 hopper and 1 chest
• Can extend sort groups into infinite chests with chained hoppers
• Can dump entire stacks quickly using Ctrl-Q keybind (Windows only)
• Items are sorted the moment they land on the pickup area
• Many categories have fallback groups (i.e. sandstone falls back to sand, etc.)
• Automatically distributes items across multiple item frames in same group
• Support for automatic smelting, and automatic food cooking
• Create your own custom sort groups by modifying config file

Table of Contents

• Installation
  • Single Player
  • Multiplayer
• Usage
  • Building
  • Creating the Controller
  • Creating an Item Receiver
    • Multiple Chests
    • Multiple Item Frames
    • Automatic Smelting or Cooking
    • Automatic Coal Fuel
    • Fallback Groups
    • Misc Catch-All Group
  • Controller for Farms
  • Advanced
    • Double Speed Auto-Drop Chest
  • Groups
    • Dirt
      • Gravel
    • Sand
      • Sandstone
    • Wood
      • Woodwork
    • Books
    • Stone
      • Stonework
    • Coal
    • Tools
      • Storage
      • Armor
      • Rails
    • Plants
      • Sugar_cane
      • Bamboo
      • Flowers
    • Food
      • Vegetables
        • Potato
      • Seeds
      • Raw
    • Mobs
    • Precious
      • Copper
    • Magic
    • Wool
    • Concrete
    • Terracotta
    • Glass
    • Ice
    • Ocean
      • Coral
      • Prismarine
    • Ink
    • Nether
    • Ores
    • Redstone
    • End
    • Music
• FAQ
• Development
  • Maximum Teleport Distance
  • Teleport Effects
  • Compiling
• References
• License

Installation

To install the data pack, download the latest ZIP file from the releases page, unzip the file, and copy the magic-sorting-system-#.#.# folder into your datapacks folder for your Minecraft world. Here are specific instructions for single and multiplayer:

Single Player

• Open Minecraft.
• Select your world, click on "Edit", then "Open world folder".
• Open the folder named datapacks, and put the data pack folder file into it.
• Play the world.

Multiplayer

• FTP to your server.
• Open your server folder, then open the folder named world.
• Upload the data pack folder into a folder named datapacks.
• Restart the server.

Usage

In a nutshell, the magic sorting system is an item teleporter. It will teleport unsorted items dropped onto a special pickup area, to their respective item frames nearby, and from there they simply fall into hoppers and into your storage chests. So you need a special magic drop-off block, and one or more item groups containing item frames, hoppers and chests. The item frames require special items displayed which identify the groups. See Groups below to learn which groups require which framed items.

Building

To build the magic sorting system, assuming survival mode, you will have to play your way to gold level first. You will need some gold, lapis, wood, and plenty of iron to build a storage system. At the bare minimum to get things started, you will need the following raw materials:

Item	Name	Amount	Purpose
	Gold Ingot	9	To build the lower base controller block.
	Lapis Lazuli	9	To build the upper base controller block.
	Iron Ingot	5	To build the first hopper.
	Wood Log	4	To build the first chests and item frame.
	Leather	1	To build the first item frame.

As you add more groups to your sorting system, you will need additional chests, item frames (plus one special target item to put in the item frame), and a hopper. For larger groups, multiple chests and chained hoppers are recommended (instructions below).

Creating the Controller

The first thing you will need is a storage "controller" to deposit your unsorted items onto. This is created by placing down a gold block, with a lapis block on top of it.

Typically the two blocks are submerged underground, so you could start with a 2-block-deep hole like this:

Place the gold block on the bottom:

And then place the lapis block on top of that:

Fill in the rest of the hole:

And you're done:

If you have more lapis and gold blocks, a 3x3 grid is recommended, so it's easier to drop items onto:

Now the controller is ready to go! All you have to do now is drop your items to be sorted onto any lapis block, and they will be teleported to their respective item frames. For Windows PC users, you can drop entire stacks at a time from your inventory using the Ctrl-Q keybind. For Mac users, you can press Q to drop single items, or click and drag each stack out of your inventory to drop it.

For a more advanced auto-controller, see the Advanced section below. It requires a tiny bit of redstone, but it allows you to design a dropoff chest that automatically sorts all items placed into it.

Creating an Item Receiver

Note: You need to rotate the item in the item frame 3 times. Otherwise this item frame will be ignored. This feature will prevent conflicts with the other item frames in your world, that should not interact with the sorting system. I will update the screenshots and the guide here soon.

An "item receiver" is just an item frame that contains a special item which represents one of the 39 groups. Then, all items to be sorted within that group will teleport to the item frame. What happens then? Well, it's actually entirely up to you! But the most common thing is to simply place a hopper underneath the item frame, and route that to a nearby chest. Example:

In this example, the item frame contains a block of cobblestone, which is the item representing the Stone group, so all stone items will be routed here. They'll teleport to the item frame, drop into hopper and be delivered to the chest.

Tip: Make sure you shift-click on the chest when placing the hopper, so it directs the output accordingly. By default hoppers drop straight down.

Multiple Chests

Note: You need to rotate the item in the item frame 3 times. Otherwise this item frame will be ignored. This feature will prevent conflicts with the other item frames in your world, that should not interact with the sorting system. I will update the screenshots and the guide here soon.

To handle item overflow, the best way is to simply build downward by adding more chests and hoppers directly beneath. The hopper system in Minecraft seems to handle distribution by filling the topmost and bottommost chests evenly, working inwards as things fill up. Example:

There are, of course, a million different ways to solve this problem -- this is only one simple example. But the idea with the magic sorting system is that it leaves things up to you! It only teleports items to appropriate frames, but you can decide how to handle routing and storage.

Multiple Item Frames

Note: You need to rotate the item in the item frame 3 times. Otherwise this item frame will be ignored. This feature will prevent conflicts with the other item frames in your world, that should not interact with the sorting system. I will update the screenshots and the guide here soon.

For high traffic groups such as Stone, where a player might drop off a large number of item stacks at once, it is recommended that you use multiple item frames. This is because a single hopper can only handle up to 5 stacks of items at one time. If you drop off more all at once, your hopper might overflow and dump some items onto the floor before it can route them. To handle this situation better, consider the following setup:

Here we have two item frames with identical items inside them, pointing to hoppers that route to the same chest. This works because the magic sorting system will pick random item frame targets for teleporting each item, if they both display the correct group target item, effectively balancing the drop-off load between the matching frames. So in this case the group could handle up to 10 stacks of items dropped off at once before it overflows.

There are other ways to handle item drop-off overflow, including building walls all around your item frames, so the items get "trapped" after teleporting, and just sit and wait until the hopper can service them. However, this means your item frame would have to be hidden in a wall, or in the ceiling, and thus you lose the dual-purpose nature of having the item frame be both a visual label, and a teleportation target.

Also see the Advanced section for another way to solve item overflow, which is to build an automatic drop chest.

Automatic Smelting or Cooking

Note: You need to rotate the item in the item frame 3 times. Otherwise this item frame will be ignored. This feature will prevent conflicts with the other item frames in your world, that should not interact with the sorting system. I will update the screenshots and the guide here soon.

You can route your items into things other than chests -- you can also setup an easy auto-smelting system, for ores and/or raw food. Simply add an additional hopper under the item chest, and route it to a furnace on its top side:

As you can see in the above example, you can also route the output of the furnace to another chest out the bottom, to hold your completed ingots or cooked food.

Automatic Coal Fuel

Note: You need to rotate the item in the item frame 3 times. Otherwise this item frame will be ignored. This feature will prevent conflicts with the other item frames in your world, that should not interact with the sorting system. I will update the screenshots and the guide here soon.

Furnaces need fuel as well. So taking this a step further, you can route the Coal item group into the sides of the furnace, to automatically supply it with fuel. Here is a more complete example, with double item frames for handling many items at once:

Here we have Ores routed into a double-chest at the top, which is then routed into two furnaces, which are auto supplied with fuel from the Coal group into the sides. Finally, the furnaces deposit smelted ingots into a double chest at the bottom, which is also setup as the Precious group (with the gold ingots displayed in the bottom item frames).

So let's say you come home from a mining trip and have some raw ores, some coal, and some ingots you found in a treasure chest. Simply drop off all the items at once, and the ores will get smelted, the coal fuel will power the furnaces, and all the ingots (including the ones you brought with you, and the smelted ones from the ore), will all end up in the Precious chest.

Remember that the magic sorting system will randomly pick item frames if multiple are available for a group. So you can also have a Coal group with additional item frames routed to plain chests, and it'll balance between storing the coal in your chests, and fueling your auto-smelting system.

Fallback Groups

Note: You need to rotate the item in the itemframe 3 times. Otherwise the itemframe will be ignored. This feature will prevent conflicts with the other item frames in your world, that should not interact with the sorting system. I will update the screenshots and the guide here soon.

Several of the item groups have sub-groups, which are optional and fall back to the main group if a more specific item frame isn't found. For example, consider the following simple item receiver for the Ocean group:

By default, this item frame with the kelp leaf on display would receive all items that come from the ocean. However, the sorting system defines two sub-groups under ocean, Prismarine and Coral. These optional sub-groups can further sort the ocean's many items into 3 categories, if you want:

So in this case, all prismarine related items would teleport to the item frame with the prismarine block, all coral items would teleport to the item frame with the bubble coral block, and all the other non-prismarine non-coral ocean items would teleport to the item frame with the Kelp leaf. The magic sorting system automatically detects which item frames are on display, and sorts accordingly.

See the Groups section below for a list of all 39 groups and to see how the sub-group hierarchy works.

Misc Catch-All Group

Note: You need to rotate the item in the item frame 3 times. Otherwise this item frame will be ignored. This feature will prevent conflicts with the other item frames in your world, that should not interact with the sorting system. I will update the screenshots and the guide here soon.

All item groups ultimately fall back to a special Misc group, which is the universal "catch-all". That is, if no suitable item frame can be found for an item, it will teleport to the miscellaneous group, which uses the carrot on a stick display item:

This is a great way to start out your storage system, so you don't have to build everything at once. Just build the main groups you need (dirt, sand, stone, ores, tools, etc.), and everything else will route to the misc group, until you have the time and resources to build all the specific groups.

Note that if the misc group item frame itself cannot be found, items will teleport back to the player.

Controller for Farms

You can have as many controllers as you want in a Minecraft world. All you need is another lapis block on top of a gold block. One neat trick is to use one of these for a water-harvested plant farms or a nearby dungeon. Any loose items detected on top of the lapis block will be sorted and teleported just like the drop-off chest. For example, consider a simple mob dungeon like this:

That's a lapis block in the bottom right corner there, just outside of the water range, with a gold block under it. If you were to setup a mob kill system here, either by trapping the mobs and killing them for XP, or devising a long fall for them, their item drops would fall onto the lapis and be instantly teleported into the sorting system.

This same kind of thing can work for an automated food farm as well, assuming you have a water-flush-harvest system in place. If all the ripe food gets flushed into a canal and routed to a single block, have it be a lapis block, with gold underneath, and you have an automated harvest sorting system!

Advanced

One of the features of the Magic Sorting System is that no redstone is required. That is true, however with a simple redstone clock you can build a drop-off chest that automatically sorts all items placed inside it. It is much easier to dump your entire inventory into a chest versus tossing it out onto the floor. Also, this has another nice side effect in that it "throttles" item sorting so your hoppers do not overload. Here is how to build it:

This requires a one chest, one hopper, one dropper facing downward, one comparator, one repeater and 5 redstone dust. The redstone circuit is copied verbatim from this video tutorial, so please watch that to see how to orient the blocks. In particular, the comparator must be facing away from the dropper. Here is a view from above:

The key here is to face the dropper downward, leave one block of empty space below it, and then place your lapis block on top of a gold block underneath all that. Here is a cross section view:

Then, simply place items or entire stacks into the chest and they'll automatically start sorting themselves. This redstone clock only ticks if there are items in the chest, so it makes no noise unless items are dropped into it.

Tip: If the dropper ticking noise bothers you, consider using a resource pack. Check out Vanilla Tweaks, click to expand the "Peace and Quiet" group and then download the "Quieter Dispensers and Droppers" pack.

Tip: If you use a trapped chest instead of a normal one, the system will not start sorting items until you close the chest lid. This is a nice safeguard in case you shift-click on the wrong item in your inventory.

Double Speed Auto-Drop Chest

If the auto-drop chest is too slow for your taste, you can build a much faster one with some more materials. For this you will need two chests, two hoppers, two droppers facing downward, two comparators, two repeaters and 10 redstone dust. The double-speed redstone circuit is copied verbatim from this video tutorial, so please watch that to see how to orient the blocks. Here is how it should look:

Note that each comparator faces away from the droppers, but the redstone is mirrored on each side. The video does a much better job of explaining this, but here is a view from above:

Just like the single drop chest, you should face both droppers downward, leave one block of empty space below them, and then place your lapis blocks on top of gold blocks underneath all that. Here is a cross section view:

Feel free to bury the entire thing (leave some air for the redstone to breathe), and just have the drop chest sticking up above ground.

Groups

Here is a list of all 39 groups in the magic sorting system, how some fallback to others, and all the items they contain.

Dirt

Group ID	Items	Fallback Group	Item Frame	Image
dirt	8	misc	minecraft:dirt

Click to Show the Items

Item ID	Image
minecraft:coarse_dirt
minecraft:dirt
minecraft:farmland
minecraft:grass_block
minecraft:grass_path
minecraft:mycelium
minecraft:podzol
minecraft:rooted_dirt

Gravel

Group ID	Items	Fallback Group	Item Frame	Image
gravel	1	dirt	minecraft:gravel

Click to Show the Items

Item ID	Image
minecraft:gravel

Sand

Group ID	Items	Fallback Group	Item Frame	Image
sand	1	misc	minecraft:sand

Click to Show the Items

Item ID	Image
minecraft:sand

Sandstone

Group ID	Items	Fallback Group	Item Frame	Image
sandstone	21	sand	minecraft:sandstone

Click to Show the Items

Item ID	Image
minecraft:chiseled_red_sandstone
minecraft:chiseled_sandstone
minecraft:cut_red_sandstone
minecraft:cut_sandstone
minecraft:red_sand
minecraft:red_sandstone
minecraft:red_sandstone_slab
minecraft:red_sandstone_stairs
minecraft:sandstone
minecraft:sandstone_slab
minecraft:sandstone_stairs
minecraft:smooth_red_sandstone
minecraft:smooth_sandstone
minecraft:cut_red_sandstone_slab
minecraft:cut_sandstone_slab
minecraft:red_sandstone_wall
minecraft:sandstone_wall
minecraft:smooth_red_sandstone_slab
minecraft:smooth_red_sandstone_stairs
minecraft:smooth_sandstone_slab
minecraft:smooth_sandstone_stairs

Wood

Group ID	Items	Fallback Group	Item Frame	Image
wood	41	misc	minecraft:oak_log

Click to Show the Items

Item ID	Image
minecraft:acacia_log
minecraft:acacia_planks
minecraft:acacia_wood
minecraft:birch_log
minecraft:birch_planks
minecraft:birch_wood
minecraft:dark_oak_log
minecraft:dark_oak_planks
minecraft:dark_oak_wood
minecraft:jungle_log
minecraft:jungle_planks
minecraft:jungle_wood
minecraft:oak_log
minecraft:oak_planks
minecraft:oak_wood
minecraft:spruce_log
minecraft:spruce_planks
minecraft:spruce_wood
minecraft:stick
minecraft:stripped_acacia_log
minecraft:stripped_acacia_wood
minecraft:stripped_birch_log
minecraft:stripped_birch_wood
minecraft:stripped_dark_oak_log
minecraft:stripped_dark_oak_wood
minecraft:stripped_jungle_log
minecraft:stripped_jungle_wood
minecraft:stripped_oak_log
minecraft:stripped_oak_wood
minecraft:stripped_spruce_log
minecraft:stripped_spruce_wood
minecraft:crimson_hyphae
minecraft:crimson_stem
minecraft:crimson_planks
minecraft:warped_hyphae
minecraft:warped_stem
minecraft:warped_planks
minecraft:stripped_crimson_hyphae
minecraft:stripped_crimson_stem
minecraft:stripped_warped_hyphae
minecraft:stripped_warped_stem

Woodwork

Group ID	Items	Fallback Group	Item Frame	Image
woodwork	116	wood	minecraft:oak_stairs

Click to Show the Items

Item ID	Image
minecraft:acacia_boat
minecraft:acacia_button
minecraft:acacia_door
minecraft:acacia_fence
minecraft:acacia_fence_gate
minecraft:acacia_pressure_plate
minecraft:acacia_slab
minecraft:acacia_stairs
minecraft:acacia_trapdoor
minecraft:birch_boat
minecraft:birch_button
minecraft:birch_door
minecraft:birch_fence
minecraft:birch_fence_gate
minecraft:birch_pressure_plate
minecraft:birch_slab
minecraft:birch_stairs
minecraft:birch_trapdoor
minecraft:black_bed
minecraft:blue_bed
minecraft:bowl
minecraft:brown_bed
minecraft:crafting_table
minecraft:cyan_bed
minecraft:dark_oak_boat
minecraft:dark_oak_button
minecraft:dark_oak_door
minecraft:dark_oak_fence
minecraft:dark_oak_fence_gate
minecraft:dark_oak_pressure_plate
minecraft:dark_oak_slab
minecraft:dark_oak_stairs
minecraft:dark_oak_trapdoor
minecraft:gray_bed
minecraft:green_bed
minecraft:item_frame
minecraft:jungle_boat
minecraft:jungle_button
minecraft:jungle_door
minecraft:jungle_fence
minecraft:jungle_fence_gate
minecraft:jungle_pressure_plate
minecraft:jungle_slab
minecraft:jungle_stairs
minecraft:jungle_trapdoor
minecraft:ladder
minecraft:light_blue_bed
minecraft:light_gray_bed
minecraft:lime_bed
minecraft:magenta_bed
minecraft:oak_boat
minecraft:oak_button
minecraft:oak_door
minecraft:oak_fence
minecraft:oak_fence_gate
minecraft:oak_pressure_plate
minecraft:oak_slab
minecraft:oak_stairs
minecraft:oak_trapdoor
minecraft:orange_bed
minecraft:painting
minecraft:petrified_oak_slab
minecraft:pink_bed
minecraft:purple_bed
minecraft:red_bed
minecraft:sign
minecraft:spruce_boat
minecraft:spruce_button
minecraft:spruce_door
minecraft:spruce_fence
minecraft:spruce_fence_gate
minecraft:spruce_pressure_plate
minecraft:spruce_slab
minecraft:spruce_stairs
minecraft:spruce_trapdoor
minecraft:white_bed
minecraft:yellow_bed
minecraft:acacia_sign‌
minecraft:acacia_wall_sign‌
minecraft:birch_sign
minecraft:birch_wall_sign
minecraft:dark_oak_sign
minecraft:dark_oak_wall_sign
minecraft:jungle_sign
minecraft:jungle_wall_sign
minecraft:oak_sign
minecraft:oak_wall_sign
minecraft:spruce_sign
minecraft:spruce_wall_sign
minecraft:scaffolding
minecraft:cartography_table
minecraft:composter
minecraft:lectern
minecraft:bookshelf
minecraft:filled_map
minecraft:map
minecraft:paper
minecraft:crimson_button
minecraft:crimson_door
minecraft:crimson_fence
minecraft:crimson_fence_gate
minecraft:crimson_pressure_plate
minecraft:crimson_sign
minecraft:crimson_slab
minecraft:crimson_stairs
minecraft:crimson_trapdoor
minecraft:warped_button
minecraft:warped_door
minecraft:warped_fence
minecraft:warped_fence_gate
minecraft:warped_pressure_plate
minecraft:warped_sign
minecraft:warped_slab
minecraft:warped_stairs
minecraft:warped_trapdoor
minecraft:glow_item_frame

Books

Group ID	Items	Fallback Group	Item Frame	Image
books	4	misc	minecraft:book

Click to Show the Items

Item ID	Image
minecraft:book
minecraft:enchanted_book
minecraft:writable_book
minecraft:written_book

Stone

Group ID	Items	Fallback Group	Item Frame	Image
stone	15	misc	minecraft:cobblestone

Click to Show the Items

Item ID	Image
minecraft:andesite
minecraft:clay
minecraft:clay_ball
minecraft:cobblestone
minecraft:diorite
minecraft:granite
minecraft:mossy_cobblestone
minecraft:stone
minecraft:blackstone
minecraft:deepslate
minecraft:cobbled_deepslate
minecraft:calcite
minecraft:tuff
minecraft:dripstone_block
minecraft:pointed_dripstone

Stonework

Group ID	Items	Fallback Group	Item Frame	Image
stonework	82	stone	minecraft:cobblestone_stairs

Click to Show the Items

Item ID	Image
minecraft:brick
minecraft:brick_slab
minecraft:brick_stairs
minecraft:brick_wall
minecraft:bricks
minecraft:chiseled_stone_bricks
minecraft:cobblestone_slab
minecraft:cobblestone_wall
minecraft:cracked_stone_bricks
minecraft:flower_pot
minecraft:mossy_cobblestone_wall
minecraft:mossy_stone_bricks
minecraft:polished_andesite
minecraft:polished_diorite
minecraft:polished_granite
minecraft:smooth_stone
minecraft:stone_brick_slab
minecraft:stone_brick_stairs
minecraft:stone_bricks
minecraft:stone_button
minecraft:stone_pressure_plate
minecraft:stone_slab
minecraft:cobblestone_stairs
minecraft:andesite_slab
minecraft:andesite_stairs
minecraft:andesite_wall
minecraft:bell
minecraft:diorite_slab
minecraft:diorite_stairs
minecraft:diorite_wall
minecraft:granite_slab
minecraft:granite_stairs
minecraft:granite_wall
minecraft:mossy_cobblestone_slab
minecraft:mossy_cobblestone_stairs
minecraft:mossy_stone_brick_slab
minecraft:mossy_stone_brick_stairs
minecraft:mossy_stone_brick_wall
minecraft:polished_andesite_slab
minecraft:polished_andesite_stairs
minecraft:polished_diorite_slab
minecraft:polished_diorite_stairs
minecraft:polished_granite_slab
minecraft:polished_granite_stairs
minecraft:smooth_stone_slab
minecraft:stone_brick_wall
minecraft:stone_stairs
minecraft:blackstone_slab
minecraft:blackstone_stairs
minecraft:blackstone_wall
minecraft:chiseled_polished_blackstone
minecraft:cracked_polished_blackstone_bricks
minecraft:gilded_blackstone
minecraft:polished_blackstone
minecraft:polished_blackstone_brick_slab
minecraft:polished_blackstone_brick_stairs
minecraft:polished_blackstone_brick_wall
minecraft:polished_blackstone_bricks
minecraft:polished_blackstone_button
minecraft:polished_blackstone_pressure_plate
minecraft:polished_blackstone_slab
minecraft:polished_blackstone_stairs
minecraft:polished_blackstone_wall
minecraft:chiseled_deepslate
minecraft:cobbled_deepslate_slab
minecraft:cobbled_deepslate_stairs
minecraft:cobbled_deepslate_wall
minecraft:cracked_deepslate_bricks
minecraft:cracked_deepslate_tiles
minecraft:deepslate_brick_slab
minecraft:deepslate_brick_stairs
minecraft:deepslate_brick_wall
minecraft:deepslate_bricks
minecraft:deepslate_tile_slab
minecraft:deepslate_tile_stairs
minecraft:deepslate_tile_wall
minecraft:deepslate_tiles
minecraft:infested_deepslate
minecraft:polished_deepslate
minecraft:polished_deepslate_slab
minecraft:polished_deepslate_stairs
minecraft:polished_deepslate_wall

Coal

Group ID	Items	Fallback Group	Item Frame	Image
coal	3	misc	minecraft:coal

Click to Show the Items

Item ID	Image
minecraft:charcoal
minecraft:coal
minecraft:coal_block

Tools

Group ID	Items	Fallback Group	Item Frame	Image
tools	75	misc	minecraft:wooden_pickaxe

Click to Show the Items

Item ID	Image
minecraft:anvil
minecraft:arrow
minecraft:bow
minecraft:bucket
minecraft:chipped_anvil
minecraft:clock
minecraft:cod_bucket
minecraft:compass
minecraft:damaged_anvil
minecraft:diamond_axe
minecraft:diamond_hoe
minecraft:diamond_pickaxe
minecraft:diamond_shovel
minecraft:diamond_sword
minecraft:fire_charge
minecraft:firework_rocket
minecraft:firework_star
minecraft:fishing_rod
minecraft:flint
minecraft:flint_and_steel
minecraft:furnace
minecraft:golden_axe
minecraft:golden_hoe
minecraft:golden_pickaxe
minecraft:golden_shovel
minecraft:golden_sword
minecraft:iron_axe
minecraft:iron_bars
minecraft:iron_door
minecraft:iron_hoe
minecraft:iron_pickaxe
minecraft:iron_shovel
minecraft:iron_sword
minecraft:iron_trapdoor
minecraft:lava_bucket
minecraft:lead
minecraft:milk_bucket
minecraft:name_tag
minecraft:shears
minecraft:spectral_arrow
minecraft:stone_axe
minecraft:stone_hoe
minecraft:stone_pickaxe
minecraft:stone_shovel
minecraft:stone_sword
minecraft:tipped_arrow
minecraft:tnt
minecraft:torch
minecraft:water_bucket
minecraft:wooden_axe
minecraft:wooden_hoe
minecraft:wooden_pickaxe
minecraft:wooden_shovel
minecraft:wooden_sword
minecraft:crossbow
minecraft:blast_furnace
minecraft:campfire
minecraft:lantern
minecraft:fletching_table
minecraft:grindstone
minecraft:loom
minecraft:smithing_table
minecraft:smoker
minecraft:stonecutter
minecraft:netherite_axe
minecraft:netherite_hoe
minecraft:netherite_pickaxe
minecraft:netherite_shovel
minecraft:netherite_sword
minecraft:lodestone
minecraft:target
minecraft:chain
minecraft:bundle
minecraft:spyglass
minecraft:lightning_rod

Storage

Group ID	Items	Fallback Group	Item Frame	Image
storage	21	tools	minecraft:chest

Click to Show the Items

Item ID	Image
minecraft:chest
minecraft:trapped_chest
minecraft:ender_chest
minecraft:black_shulker_box
minecraft:blue_shulker_box
minecraft:brown_shulker_box
minecraft:cyan_shulker_box
minecraft:gray_shulker_box
minecraft:green_shulker_box
minecraft:light_blue_shulker_box
minecraft:lime_shulker_box
minecraft:magenta_shulker_box
minecraft:orange_shulker_box
minecraft:pink_shulker_box
minecraft:purple_shulker_box
minecraft:red_shulker_box
minecraft:shulker_box
minecraft:light_gray_shulker_box
minecraft:white_shulker_box
minecraft:yellow_shulker_box
minecraft:barrel

Armor

Group ID	Items	Fallback Group	Item Frame	Image
armor	27	tools	minecraft:leather_chestplate

Click to Show the Items

Item ID	Image
minecraft:armor_stand
minecraft:chainmail_boots
minecraft:chainmail_chestplate
minecraft:chainmail_helmet
minecraft:chainmail_leggings
minecraft:diamond_boots
minecraft:diamond_chestplate
minecraft:diamond_helmet
minecraft:diamond_leggings
minecraft:golden_boots
minecraft:golden_chestplate
minecraft:golden_helmet
minecraft:golden_leggings
minecraft:iron_boots
minecraft:iron_chestplate
minecraft:iron_helmet
minecraft:iron_leggings
minecraft:leather_boots
minecraft:leather_chestplate
minecraft:leather_helmet
minecraft:leather_leggings
minecraft:shield
minecraft:turtle_helmet
minecraft:netherite_boots
minecraft:netherite_chestplate
minecraft:netherite_helmet
minecraft:netherite_leggings

Rails

Group ID	Items	Fallback Group	Item Frame	Image
rails	15	tools	minecraft:rail

Click to Show the Items

Item ID	Image
minecraft:activator_rail
minecraft:chest_minecart
minecraft:command_block_minecart
minecraft:detector_rail
minecraft:furnace_minecart
minecraft:hopper_minecart
minecraft:minecart
minecraft:powered_rail
minecraft:rail
minecraft:tnt_minecart
minecraft:saddle
minecraft:iron_horse_armor
minecraft:diamond_horse_armor
minecraft:golden_horse_armor
minecraft:leather_horse_armor

Plants

Group ID	Items	Fallback Group	Item Frame	Image
plants	50	misc	minecraft:oak_sapling

Click to Show the Items

Item ID	Image
minecraft:acacia_leaves
minecraft:acacia_sapling
minecraft:birch_leaves
minecraft:birch_sapling
minecraft:brown_mushroom
minecraft:brown_mushroom_block
minecraft:cactus
minecraft:carved_pumpkin
minecraft:cocoa_beans
minecraft:dark_oak_leaves
minecraft:dark_oak_sapling
minecraft:dead_bush
minecraft:fern
minecraft:grass
minecraft:jack_o_lantern
minecraft:jungle_leaves
minecraft:jungle_sapling
minecraft:large_fern
minecraft:lily_pad
minecraft:mushroom_stem
minecraft:oak_leaves
minecraft:oak_sapling
minecraft:poisonous_potato
minecraft:red_mushroom
minecraft:red_mushroom_block
minecraft:spruce_leaves
minecraft:spruce_sapling
minecraft:tall_grass
minecraft:vine
minecraft:bamboo_sapling
minecraft:potted_bamboo
minecraft:potted_cornflower
minecraft:potted_lily_of_the_valley
minecraft:potted_wither_rose
minecraft:sweet_berry_bush
minecraft:wither_rose
minecraft:turtle_egg
minecraft:azalea
minecraft:azalea_leaves
minecraft:big_dripleaf
minecraft:flowering_azalea
minecraft:flowering_azalea_leaves
minecraft:small_dripleaf
minecraft:moss_block
minecraft:moss_carpet
minecraft:glow_lichen
minecraft:cave_vines
minecraft:cave_vines_plant
minecraft:spore_blossom
minecraft:hanging_roots

Sugar_cane

Group ID	Items	Fallback Group	Item Frame	Image
sugar_cane	1	plants	minecraft:sugar_cane

Click to Show the Items

Item ID	Image
minecraft:sugar_cane

Bamboo

Group ID	Items	Fallback Group	Item Frame	Image
bamboo	1	plants	minecraft:bamboo

Click to Show the Items

Item ID	Image
minecraft:bamboo

Flowers

Group ID	Items	Fallback Group	Item Frame	Image
flowers	16	plants	minecraft:poppy

Click to Show the Items

Item ID	Image
minecraft:allium
minecraft:azure_bluet
minecraft:blue_orchid
minecraft:dandelion
minecraft:lilac
minecraft:orange_tulip
minecraft:oxeye_daisy
minecraft:peony
minecraft:cornflower
minecraft:lily_of_the_valley
minecraft:pink_tulip
minecraft:poppy
minecraft:red_tulip
minecraft:rose_bush
minecraft:sunflower
minecraft:white_tulip

Food

Group ID	Items	Fallback Group	Item Frame	Image
food	20	misc	minecraft:cooked_beef

Click to Show the Items

Item ID	Image
minecraft:apple
minecraft:baked_potato
minecraft:beetroot_soup
minecraft:bread
minecraft:cake
minecraft:cooked_beef
minecraft:cooked_chicken
minecraft:cooked_cod
minecraft:cooked_mutton
minecraft:cooked_porkchop
minecraft:cooked_rabbit
minecraft:cooked_salmon
minecraft:cookie
minecraft:melon_slice
minecraft:mushroom_stew
minecraft:pumpkin_pie
minecraft:rabbit_stew
minecraft:sugar
minecraft:suspicious_stew
minecraft:glow_berries

Vegetables

Group ID	Items	Fallback Group	Item Frame	Image
vegetables	7	food	minecraft:carrot

Click to Show the Items

Item ID	Image
minecraft:carrot
minecraft:wheat
minecraft:hay_block
minecraft:beetroot
minecraft:melon
minecraft:pumpkin
minecraft:sweet_berries

Potato

Group ID	Items	Fallback Group	Item Frame	Image
potato	1	vegetables	minecraft:potato

Click to Show the Items

Item ID	Image
minecraft:potato

Seeds

Group ID	Items	Fallback Group	Item Frame	Image
seeds	4	food	minecraft:wheat_seeds

Click to Show the Items

Item ID	Image
minecraft:wheat_seeds
minecraft:beetroot_seeds
minecraft:melon_seeds
minecraft:pumpkin_seeds

Raw

Group ID	Items	Fallback Group	Item Frame	Image
raw	8	food	minecraft:beef

Click to Show the Items

Item ID	Image
minecraft:beef
minecraft:chicken
minecraft:cod
minecraft:mutton
minecraft:porkchop
minecraft:rabbit
minecraft:salmon
minecraft:egg

Mobs

Group ID	Items	Fallback Group	Item Frame	Image
mobs	96	misc	minecraft:bone

Click to Show the Items

Item ID	Image
minecraft:bat_spawn_egg
minecraft:blaze_spawn_egg
minecraft:gunpowder
minecraft:bone
minecraft:bone_block
minecraft:bone_meal
minecraft:cave_spider_spawn_egg
minecraft:chicken_spawn_egg
minecraft:cobweb
minecraft:cod_spawn_egg
minecraft:cow_spawn_egg
minecraft:creeper_head
minecraft:creeper_spawn_egg
minecraft:dolphin_spawn_egg
minecraft:donkey_spawn_egg
minecraft:drowned_spawn_egg
minecraft:elder_guardian_spawn_egg
minecraft:enderman_spawn_egg
minecraft:endermite_spawn_egg
minecraft:evoker_spawn_egg
minecraft:feather
minecraft:fermented_spider_eye
minecraft:ghast_spawn_egg
minecraft:ghast_tear
minecraft:guardian_spawn_egg
minecraft:horse_spawn_egg
minecraft:husk_spawn_egg
minecraft:infested_chiseled_stone_bricks
minecraft:infested_cobblestone
minecraft:infested_cracked_stone_bricks
minecraft:infested_mossy_stone_bricks
minecraft:infested_stone
minecraft:infested_stone_bricks
minecraft:leather
minecraft:llama_spawn_egg
minecraft:magma_cube_spawn_egg
minecraft:spawner
minecraft:mooshroom_spawn_egg
minecraft:mule_spawn_egg
minecraft:ocelot_spawn_egg
minecraft:parrot_spawn_egg
minecraft:phantom_membrane
minecraft:phantom_spawn_egg
minecraft:pig_spawn_egg
minecraft:player_head
minecraft:polar_bear_spawn_egg
minecraft:pufferfish_spawn_egg
minecraft:rabbit_foot
minecraft:rabbit_hide
minecraft:rabbit_spawn_egg
minecraft:rotten_flesh
minecraft:salmon_spawn_egg
minecraft:sheep_spawn_egg
minecraft:shulker_spawn_egg
minecraft:silverfish_spawn_egg
minecraft:skeleton_horse_spawn_egg
minecraft:skeleton_skull
minecraft:skeleton_spawn_egg
minecraft:slime_ball
minecraft:slime_block
minecraft:slime_spawn_egg
minecraft:spider_eye
minecraft:spider_spawn_egg
minecraft:squid_spawn_egg
minecraft:stray_spawn_egg
minecraft:string
minecraft:tropical_fish_spawn_egg
minecraft:turtle_spawn_egg
minecraft:vex_spawn_egg
minecraft:villager_spawn_egg
minecraft:vindicator_spawn_egg
minecraft:witch_spawn_egg
minecraft:wither_skeleton_skull
minecraft:wither_skeleton_spawn_egg
minecraft:wolf_spawn_egg
minecraft:zombie_head
minecraft:zombie_horse_spawn_egg
minecraft:zombie_pigman_spawn_egg
minecraft:zombie_spawn_egg
minecraft:zombie_villager_spawn_egg
minecraft:cat_spawn_egg
minecraft:fox_spawn_egg
minecraft:panda_spawn_egg
minecraft:pillager_spawn_egg
minecraft:ravager_spawn_egg
minecraft:trader_llama_spawn_egg
minecraft:wandering_trader_spawn_egg
minecraft:hoglin_spawn_egg
minecraft:piglin_brute_spawn_egg
minecraft:piglin_spawn_egg
minecraft:strider_spawn_egg
minecraft:zoglin_spawn_egg
minecraft:zombified_piglin_spawn_egg
minecraft:axolotl_spawn_egg
minecraft:glow_squid_spawn_egg
minecraft:goat_spawn_egg

Precious

Group ID	Items	Fallback Group	Item Frame	Image
precious	49	misc	minecraft:gold_ingot

Click to Show the Items

Item ID	Image
minecraft:beacon
minecraft:conduit
minecraft:diamond
minecraft:diamond_block
minecraft:diamond_ore
minecraft:elytra
minecraft:emerald
minecraft:emerald_block
minecraft:gold_block
minecraft:gold_ingot
minecraft:gold_nugget
minecraft:heart_of_the_sea
minecraft:iron_ingot
minecraft:iron_nugget
minecraft:iron_block
minecraft:lapis_block
minecraft:lapis_lazuli
minecraft:nether_star
minecraft:obsidian
minecraft:totem_of_undying
minecraft:trident
minecraft:coal_ore
minecraft:emerald_ore
minecraft:lapis_ore
minecraft:nether_quartz_ore
minecraft:redstone_ore
minecraft:netherite_block
minecraft:netherite_ingot
minecraft:netherite_scrap
minecraft:ancient_debris
minecraft:copper_ore
minecraft:deepslate_coal_ore
minecraft:deepslate_copper_ore
minecraft:deepslate_diamond_ore
minecraft:deepslate_emerald_ore
minecraft:deepslate_gold_ore
minecraft:deepslate_iron_ore
minecraft:deepslate_lapis_ore
minecraft:deepslate_redstone_ore
minecraft:raw_copper_block
minecraft:raw_gold_block
minecraft:raw_iron_block
minecraft:large_amethyst_bud
minecraft:medium_amethyst_bud
minecraft:small_amethyst_bud
minecraft:amethyst_cluster
minecraft:amethyst_shard
minecraft:amethyst_block
minecraft:budding_amethyst

Copper

Group ID	Items	Fallback Group	Item Frame	Image
copper	33	precious	minecraft:copper_ingot

Click to Show the Items

Item ID	Image
minecraft:copper_block
minecraft:copper_ingot
minecraft:cut_copper
minecraft:cut_copper_slab
minecraft:cut_copper_stairs
minecraft:exposed_copper
minecraft:exposed_cut_copper
minecraft:exposed_cut_copper_slab
minecraft:exposed_cut_copper_stairs
minecraft:oxidized_copper
minecraft:oxidized_cut_copper
minecraft:oxidized_cut_copper_slab
minecraft:oxidized_cut_copper_stairs
minecraft:waxed_copper_block
minecraft:waxed_cut_copper
minecraft:waxed_cut_copper_slab
minecraft:waxed_cut_copper_stairs
minecraft:waxed_exposed_copper
minecraft:waxed_exposed_cut_copper
minecraft:waxed_exposed_cut_copper_slab
minecraft:waxed_exposed_cut_copper_stairs
minecraft:waxed_oxidized_copper
minecraft:waxed_oxidized_cut_copper
minecraft:waxed_oxidized_cut_copper_slab
minecraft:waxed_oxidized_cut_copper_stairs
minecraft:waxed_weathered_copper
minecraft:waxed_weathered_cut_copper
minecraft:waxed_weathered_cut_copper_slab
minecraft:waxed_weathered_cut_copper_stairs
minecraft:weathered_copper
minecraft:weathered_cut_copper
minecraft:weathered_cut_copper_slab
minecraft:weathered_cut_copper_stairs

Magic

Group ID	Items	Fallback Group	Item Frame	Image
magic	34	misc	minecraft:glass_bottle

Click to Show the Items

Item ID	Image
minecraft:bedrock
minecraft:blaze_powder
minecraft:blaze_rod
minecraft:brewing_stand
minecraft:cauldron
minecraft:dragon_breath
minecraft:enchanted_golden_apple
minecraft:enchanting_table
minecraft:ender_eye
minecraft:experience_bottle
minecraft:glass_bottle
minecraft:glistering_melon_slice
minecraft:golden_apple
minecraft:golden_carrot
minecraft:lingering_potion
minecraft:potion
minecraft:splash_potion
minecraft:black_candle
minecraft:blue_candle
minecraft:brown_candle
minecraft:candle
minecraft:cyan_candle
minecraft:gray_candle
minecraft:green_candle
minecraft:light_blue_candle
minecraft:light_gray_candle
minecraft:lime_candle
minecraft:magenta_candle
minecraft:orange_candle
minecraft:pink_candle
minecraft:purple_candle
minecraft:red_candle
minecraft:white_candle
minecraft:yellow_candle

Wool

Group ID	Items	Fallback Group	Item Frame	Image
wool	49	misc	minecraft:white_wool

Click to Show the Items

Item ID	Image
minecraft:black_banner
minecraft:black_carpet
minecraft:black_wool
minecraft:blue_banner
minecraft:blue_carpet
minecraft:blue_wool
minecraft:brown_banner
minecraft:brown_carpet
minecraft:brown_wool
minecraft:cyan_banner
minecraft:cyan_carpet
minecraft:cyan_wool
minecraft:gray_banner
minecraft:gray_carpet
minecraft:gray_wool
minecraft:green_banner
minecraft:green_carpet
minecraft:green_wool
minecraft:light_blue_banner
minecraft:light_blue_carpet
minecraft:light_blue_wool
minecraft:light_gray_banner
minecraft:light_gray_carpet
minecraft:light_gray_wool
minecraft:lime_banner
minecraft:lime_carpet
minecraft:lime_wool
minecraft:magenta_banner
minecraft:magenta_carpet
minecraft:magenta_wool
minecraft:orange_banner
minecraft:orange_carpet
minecraft:orange_wool
minecraft:pink_banner
minecraft:pink_carpet
minecraft:pink_wool
minecraft:purple_banner
minecraft:purple_carpet
minecraft:purple_wool
minecraft:red_banner
minecraft:red_carpet
minecraft:red_wool
minecraft:white_banner
minecraft:white_carpet
minecraft:white_wool
minecraft:yellow_banner
minecraft:yellow_carpet
minecraft:yellow_wool
minecraft:piglin_banner_pattern

Concrete

Group ID	Items	Fallback Group	Item Frame	Image
concrete	32	misc	minecraft:gray_concrete_powder

Click to Show the Items

Item ID	Image
minecraft:black_concrete
minecraft:black_concrete_powder
minecraft:blue_concrete
minecraft:blue_concrete_powder
minecraft:brown_concrete
minecraft:brown_concrete_powder
minecraft:cyan_concrete
minecraft:cyan_concrete_powder
minecraft:gray_concrete
minecraft:gray_concrete_powder
minecraft:green_concrete
minecraft:green_concrete_powder
minecraft:light_blue_concrete
minecraft:light_blue_concrete_powder
minecraft:light_gray_concrete
minecraft:light_gray_concrete_powder
minecraft:lime_concrete
minecraft:lime_concrete_powder
minecraft:magenta_concrete
minecraft:magenta_concrete_powder
minecraft:orange_concrete
minecraft:orange_concrete_powder
minecraft:pink_concrete
minecraft:pink_concrete_powder
minecraft:purple_concrete
minecraft:purple_concrete_powder
minecraft:red_concrete
minecraft:red_concrete_powder
minecraft:white_concrete
minecraft:white_concrete_powder
minecraft:yellow_concrete
minecraft:yellow_concrete_powder

Terracotta

Group ID	Items	Fallback Group	Item Frame	Image
terracotta	33	misc	minecraft:terracotta

Click to Show the Items

Item ID	Image
minecraft:black_glazed_terracotta
minecraft:black_terracotta
minecraft:blue_glazed_terracotta
minecraft:blue_terracotta
minecraft:brown_glazed_terracotta
minecraft:brown_terracotta
minecraft:cyan_glazed_terracotta
minecraft:cyan_terracotta
minecraft:gray_glazed_terracotta
minecraft:gray_terracotta
minecraft:green_glazed_terracotta
minecraft:green_terracotta
minecraft:light_blue_glazed_terracotta
minecraft:light_blue_terracotta
minecraft:light_gray_terracotta
minecraft:lime_glazed_terracotta
minecraft:lime_terracotta
minecraft:magenta_glazed_terracotta
minecraft:magenta_terracotta
minecraft:orange_glazed_terracotta
minecraft:orange_terracotta
minecraft:pink_glazed_terracotta
minecraft:pink_terracotta
minecraft:purple_glazed_terracotta
minecraft:purple_terracotta
minecraft:red_glazed_terracotta
minecraft:red_terracotta
minecraft:light_gray_glazed_terracotta
minecraft:terracotta
minecraft:white_glazed_terracotta
minecraft:white_terracotta
minecraft:yellow_glazed_terracotta
minecraft:yellow_terracotta

Glass

Group ID	Items	Fallback Group	Item Frame	Image
glass	35	misc	minecraft:glass

Click to Show the Items

Item ID	Image
minecraft:black_stained_glass
minecraft:black_stained_glass_pane
minecraft:blue_stained_glass
minecraft:blue_stained_glass_pane
minecraft:brown_stained_glass
minecraft:brown_stained_glass_pane
minecraft:cyan_stained_glass
minecraft:cyan_stained_glass_pane
minecraft:glass
minecraft:glass_pane
minecraft:gray_stained_glass
minecraft:gray_stained_glass_pane
minecraft:green_stained_glass
minecraft:green_stained_glass_pane
minecraft:light_blue_stained_glass
minecraft:light_blue_stained_glass_pane
minecraft:light_gray_stained_glass
minecraft:light_gray_stained_glass_pane
minecraft:lime_stained_glass
minecraft:lime_stained_glass_pane
minecraft:magenta_stained_glass
minecraft:magenta_stained_glass_pane
minecraft:orange_stained_glass
minecraft:orange_stained_glass_pane
minecraft:pink_stained_glass
minecraft:pink_stained_glass_pane
minecraft:purple_stained_glass
minecraft:purple_stained_glass_pane
minecraft:red_stained_glass
minecraft:red_stained_glass_pane
minecraft:white_stained_glass
minecraft:white_stained_glass_pane
minecraft:yellow_stained_glass
minecraft:yellow_stained_glass_pane
minecraft:tinted_glass

Ice

Group ID	Items	Fallback Group	Item Frame	Image
ice	8	misc	minecraft:ice

Click to Show the Items

Item ID	Image
minecraft:blue_ice
minecraft:ice
minecraft:packed_ice
minecraft:snow
minecraft:snow_block
minecraft:snowball
minecraft:powder_snow
minecraft:powder_snow_bucket

Ocean

Group ID	Items	Fallback Group	Item Frame	Image
ocean	16	misc	minecraft:kelp

Click to Show the Items

Item ID	Image
minecraft:dried_kelp
minecraft:dried_kelp_block
minecraft:kelp
minecraft:nautilus_shell
minecraft:pufferfish
minecraft:sea_pickle
minecraft:seagrass
minecraft:sponge
minecraft:tropical_fish
minecraft:wet_sponge
minecraft:scute
minecraft:pufferfish_bucket
minecraft:salmon_bucket
minecraft:tropical_fish_bucket
minecraft:clownfish_bucket
minecraft:axolotl_bucket

Coral

Group ID	Items	Fallback Group	Item Frame	Image
coral	20	ocean	minecraft:bubble_coral_block

Click to Show the Items

Item ID	Image
minecraft:brain_coral
minecraft:brain_coral_block
minecraft:brain_coral_fan
minecraft:bubble_coral
minecraft:bubble_coral_block
minecraft:bubble_coral_fan
minecraft:dead_brain_coral_block
minecraft:dead_bubble_coral_block
minecraft:dead_fire_coral_block
minecraft:dead_horn_coral_block
minecraft:dead_tube_coral_block
minecraft:fire_coral
minecraft:fire_coral_block
minecraft:fire_coral_fan
minecraft:horn_coral
minecraft:horn_coral_block
minecraft:horn_coral_fan
minecraft:tube_coral
minecraft:tube_coral_block
minecraft:tube_coral_fan

Prismarine

Group ID	Items	Fallback Group	Item Frame	Image
prismarine	13	ocean	minecraft:prismarine

Click to Show the Items

Item ID	Image
minecraft:dark_prismarine
minecraft:dark_prismarine_slab
minecraft:dark_prismarine_stairs
minecraft:prismarine
minecraft:prismarine_brick_slab
minecraft:prismarine_brick_stairs
minecraft:prismarine_bricks
minecraft:prismarine_crystals
minecraft:prismarine_shard
minecraft:prismarine_slab
minecraft:prismarine_stairs
minecraft:prismarine_wall
minecraft:sea_lantern

Ink

Group ID	Items	Fallback Group	Item Frame	Image
ink	21	misc	minecraft:ink_sac

Click to Show the Items

Item ID	Image
minecraft:cactus_green
minecraft:cyan_dye
minecraft:dandelion_yellow
minecraft:gray_dye
minecraft:ink_sac
minecraft:light_blue_dye
minecraft:light_gray_dye
minecraft:lime_dye
minecraft:magenta_dye
minecraft:orange_dye
minecraft:pink_dye
minecraft:purple_dye
minecraft:rose_red
minecraft:black_dye
minecraft:blue_dye
minecraft:brown_dye
minecraft:green_dye
minecraft:yellow_dye
minecraft:red_dye
minecraft:white_dye
minecraft:glow_ink_sac

Nether

Group ID	Items	Fallback Group	Item Frame	Image
nether	51	misc	minecraft:netherrack

Click to Show the Items

Item ID	Image
minecraft:chiseled_quartz_block
minecraft:glowstone
minecraft:glowstone_dust
minecraft:magma_block
minecraft:magma_cream
minecraft:nether_brick
minecraft:nether_brick_fence
minecraft:nether_brick_slab
minecraft:nether_brick_stairs
minecraft:nether_brick_wall
minecraft:nether_bricks
minecraft:red_nether_brick_slab
minecraft:red_nether_brick_stairs
minecraft:red_nether_brick_wall
minecraft:nether_wart
minecraft:nether_wart_block
minecraft:netherrack
minecraft:quartz
minecraft:quartz_block
minecraft:quartz_pillar
minecraft:quartz_slab
minecraft:quartz_stairs
minecraft:red_nether_bricks
minecraft:smooth_quartz
minecraft:soul_sand
minecraft:smooth_quartz_slab
minecraft:smooth_quartz_stairs
minecraft:basalt
minecraft:polished_basalt
minecraft:quartz_bricks
minecraft:soul_campfire
minecraft:soul_lantern
minecraft:soul_soil
minecraft:soul_torch
minecraft:chiseled_nether_bricks
minecraft:cracked_nether_bricks
minecraft:crimson_fungus
minecraft:crimson_nylium
minecraft:crimson_roots
minecraft:warped_fungus
minecraft:warped_nylium
minecraft:warped_roots
minecraft:warped_fungus_on_a_stick
minecraft:warped_wart_block
minecraft:twisting_vines
minecraft:weeping_vines
minecraft:crying_obsidian
minecraft:nether_sprouts
minecraft:respawn_anchor
minecraft:shroomlight
minecraft:smooth_basalt

Ores

Group ID	Items	Fallback Group	Item Frame	Image
ores	4	misc	minecraft:raw_iron

Click to Show the Items

Item ID	Image
minecraft:raw_copper
minecraft:raw_gold
minecraft:raw_iron
minecraft:nether_gold_ore

Redstone

Group ID	Items	Fallback Group	Item Frame	Image
redstone	20	misc	minecraft:redstone

Click to Show the Items

Item ID	Image
minecraft:chain_command_block
minecraft:command_block
minecraft:comparator
minecraft:daylight_detector
minecraft:dispenser
minecraft:dropper
minecraft:heavy_weighted_pressure_plate
minecraft:hopper
minecraft:lever
minecraft:light_weighted_pressure_plate
minecraft:observer
minecraft:piston
minecraft:redstone
minecraft:redstone_block
minecraft:redstone_lamp
minecraft:redstone_torch
minecraft:repeater
minecraft:repeating_command_block
minecraft:sticky_piston
minecraft:tripwire_hook

End

Group ID	Items	Fallback Group	Item Frame	Image
end	20	misc	minecraft:end_stone

Click to Show the Items

Item ID	Image
minecraft:end_crystal
minecraft:end_portal_frame
minecraft:end_rod
minecraft:end_stone
minecraft:end_stone_bricks
minecraft:purpur_block
minecraft:purpur_pillar
minecraft:purpur_slab
minecraft:purpur_stairs
minecraft:end_stone_brick_slab
minecraft:end_stone_brick_stairs
minecraft:end_stone_brick_wall
minecraft:chorus_fruit
minecraft:popped_chorus_fruit
minecraft:chorus_plant
minecraft:chorus_flower
minecraft:dragon_egg
minecraft:dragon_head
minecraft:ender_pearl
minecraft:shulker_shell

Music

Group ID	Items	Fallback Group	Item Frame	Image
music	15	misc	minecraft:note_block

Click to Show the Items

Item ID	Image
minecraft:music_disc_11
minecraft:music_disc_13
minecraft:music_disc_blocks
minecraft:music_disc_cat
minecraft:music_disc_chirp
minecraft:music_disc_far
minecraft:music_disc_mall
minecraft:music_disc_mellohi
minecraft:music_disc_stal
minecraft:music_disc_strad
minecraft:music_disc_wait
minecraft:music_disc_ward
minecraft:music_disc_pigstep
minecraft:note_block
minecraft:jukebox

FAQ

Q. Why do some of my items teleport to my friend's storage system?

A. If you have multiple magic sorting systems in the same world or on the same server, make sure they are at least 8 chunks (128 blocks) away from each other. This is the maximum teleport distance of items in the magic sorting system. You can use the F3 debug screen to measure distance between locations using your player X/Y/Z coordinates.

Q. Why do some of my items keep teleporting back to ME?

A. This happens when a suitable item frame cannot be found for the items, which can happen for a number of reasons. First, make sure you have an item frame displaying the correct item that matches the target group. This may not be the exact item in your inventory, but rather a specific item that represents the whole group. See Groups for a list of these special items -- the item frames must contain those exact items! Second, the item frame must be within 8 chunks (128 blocks) of the controller (drop-off chest), and the chunks all have to be loaded. Finally, you may not have a misc category setup. That is, you need an item frame with a carrot on a stick, which is a universal catch-all for all unsorted items. Add this to catch all the items that you don't have specific groups for.

Q. Why isn't diamond ore sorted into the ores group?

A. This was actually a deliberate decision when we made the data pack. We assumed that most of the time, the player would not want diamond ore to be auto-smelted (which is probably where the ores group gets routed -- i.e. into a smelter). It is more likely that the player would want to break the diamond ore themselves, using a fortune pick. That being said, if you want diamond ore sorted into your ores group, you can edit the config.json file and rebuild the data pack to your liking! See Development for details.

Q. Why not simply teleport items to the nearest matching item frame? Then you wouldn't even need a maximum teleport distance!

A. That is true, however we actually don't want items teleported to the nearest matching item frame per se. Consider that a single sort group may have double or more item frames, to load balance the deposited items between multiple hoppers and/or chests. See Multiple Item Frames for an example. In this case, to handle large numbers of deposited items at once, we need to randomize between the target item frames, but still maintain compatibility with multiple sorting systems in the same world. That is where the maximum distance (8 chunks) comes into play.

Q. I dropped off a stack of coal but it didn't split between my two item frames!

A. Sometimes Minecraft treats a stack of items as a "single item with 64 quantity" and thus it gets teleported as one item, to a single item frame. To fix this, you can "spread out" your stack of items in the drop-off chest, simply by holding down the left mouse button and dragging across the chest dialog, like this:

This spread arrangement has a much better chance of load balancing between multiple item frame targets, because the game treats the items as multiple smaller stacks when the chest is broken.

Development

The Magic Sorting System is designed to be extensible. You can change group sorting rules, add your own custom groups, and even add new items (possibly for supporting mod packs or when new Minecraft versions are released). This is accomplished by editing a special JSON configuration file.

If you unzip the data pack, and look inside the source folder, you will find a config.json file. Open this in your favorite text editor and you will find groups array, containing all the sorting groups. Example snippet:

"groups": {
	{
		"group_name": "dirt",
		"item_frame": "minecraft:dirt",
		"fallback": "misc",
		"items": [
			"minecraft:coarse_dirt",
			"minecraft:dirt",
			"minecraft:farmland",
			"minecraft:grass_block",
			"minecraft:grass_path",
			"minecraft:mycelium",
			"minecraft:podzol"
		]
	},
	{
		"group_name": "gravel",
		"item_frame": "minecraft:gravel",
		"fallback": "dirt",
		"items": [
			"minecraft:gravel"
		]
	},
	{
		"group_name": "misc",
		"item_frame": "minecraft:carrot_on_a_stick",
		"items": [
			"minecraft:carrot_on_a_stick"
		]
	}
}

Each group entry has the following properties:

Property	Type	Description
group_name	String	The name of the sort group, which should be lower-case alphanumeric. This is an arbitrary name, and does not correspond with any Minecraft Item ID.
item_frame	String	The exact Minecraft Item ID of the item in the Item Frame that the sort group uses as a teleport target.
fallback	String	The name of the group items should fall back to, if this group's item frame cannot be found. Omit this to fallback to teleporting to the player.
items	Array	A list of all the Minecraft Item IDs of items to be sorted into this group.

The idea is that all the item IDs listed in the items array will be sorted into this group, if and only if an item frame containing the item specified in item_frame can be found within 128 blocks. If not, then the item is sorted into the fallback group instead.

In the example JSON snippet above, you can see three separate groups described. The cascading works as follows. The gravel group would sort gravel into an item frame containing a minecraft:gravel block. However, if that item frame couldn't be found, the group falls back to the dirt group. The dirt group itself contains 7 items, which would all be sorted to an item frame containing a minecraft:dirt block. However, if that item frame couldn't be found, those items would fall back to the misc group. The misc group by default catches all unsorted items, and routes to an item frame containing a minecraft:carrot_on_a_stick.

Maximum Teleport Distance

By default, the maximum item teleportation is 128 blocks. This feature allows multiple sorting systems to coexist in the same world, without items teleporting to the wrong item frames. However, if you want to change this, it is set in the config.json file outside of the groups array:

"max_teleport_distance": 128,

Change this to any number of blocks you want, but please note that the chunks containing the item frames have to be loaded for the teleport to work. For long distance teleportation it is recommended you build your storage system inside the spawn chunks, so it stays loaded.

Teleport Effects

Don't like the particle effect or sound effect when items are sorted? You can customize or disable those by editing the effects array:

"effects": [
	"playsound minecraft:entity.illusioner.mirror_move block @a[distance=..5] ~ ~ ~ 1.0 1.0",
	"particle minecraft:entity_effect ~ ~ ~ 1 1 1 1 100"
]

By default we show some colorful particles and play one of the sound effects from the illusioner mob, but you can change this. For example, if you don't want any effects at all, just empty the effects array like this:

"effects": []

Or, you can choose your own particles and/or sounds from the game, and replace the commands with your custom versions.

Compiling

When you are done making your changes to the file, save and validate the syntax (JSON can be picky). Then you will have to "compile" the config file into actual data pack function code. This is done by running a special generate.js script that also lives in the source folder. You will need Node.js installed on your machine to run this script. Once installed, open a command prompt, change into the source directory and type this:

node generate.js

This will regenerate all the data pack function code (i.e. all the .mcfunction files) using your own config.json file as the source. When the script is complete, the new data pack should be all ready to be installed to your local folder or server.

Note that data packs can be installed as a ZIP file, or as a folder.

References

• Minecraft Data Packs
• Minecraft Item IDs
• Node.js
• JSON Validator
• Many thanks to Joseph Huckaby. This project is based on his original work.

License

The MIT License (MIT)

Copyright (c) 2021 Demian Welker

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG.