Smart Item Sorter

Teleport Targets

1. Creating Teleport Targets:

   • Place a horizontal item frame (must be facing upward).

   • Insert an item in the frame to indicate what should be teleported there.

   • Vertical item frames are ignored.

Example of a horizontal item frame facing upward.

1. Common Use Cases:

   • Above a hopper: Teleported items are picked up and distributed by the hopper.

Item frame above a hopper setup.

• Above a lava cauldron: Items are quickly destroyed.

Item frame above a lava cauldron setup.

• Above a cobweb: Items combine into stacks before further processing.

Item frame above a cobweb setup.

1. Matching Levels:

   • Exact Matches: Items exactly match the item in the item frame.

   • Item Tag Matches: Use a name tag with an item tag name in the item frame to teleport all items with that tag.

     • Commands:

       • /smartitemsort tags - Discover known tags.

       • /smartitemsort tag <name> - Identify items/blocks selected by a tag.

     • Custom tags can be created with datapacks.

   • Similar Matches: Items with the same base item but different NBT data are matched.

   • Bundle Matches: Place a shulker box containing multiple items in the item frame to teleport any of those items.

2. Fallbacks:

   • If no matches are found, items are sent to an item frame with a carrot on a stick (default item) or not transported at all.

3. Order of Preference for Matches:

   1. Exact match.

   2. Exact match to items in a shulker box.

   3. Item tag match.

   4. Item tag match in a shulker box.

   5. Similar match.

   6. Similar match in a shulker box.

   7. Default item (carrot on a stick).

4. Choosing a Teleport Target:

   • Only the best matching targets are considered.

   • If multiple targets match equally, one is chosen randomly.

5. Three Attempts to Teleport Items:

   • First Attempt: Looks for targets over blocks with inventories.

   • Second Attempt: Looks for targets over regular blocks.

   • Third Attempt: Looks for targets over lava cauldrons.

Teleport Pads

1. Creating Teleport Pads:

   • Stack specific blocks as defined in the plugin's configuration.

   • Custom Block Stacks for Teleport Pads:

     • Grass Teleport Pad: GRASS_BLOCK over IRON_BLOCK

     • Dirt Teleport Pad: DIRT over IRON_BLOCK

     • Magma Teleport Pad: MAGMA_BLOCK over IRON_BLOCK

     • Farmland Teleport Pad: FARMLAND over IRON_BLOCK

     • Soulsand Teleport Pad: SOUL_SAND over IRON_BLOCK

     • Sand Teleport Pad: SAND over IRON_BLOCK

     • Moss Teleport Pad: MOSS_BLOCK over IRON_BLOCK

Examples of different teleport pads.

1. Usage:

   • Items dropped above the specified block in the stack will be teleported to a matching target within the range set in the configuration.

Smart Item Sorters

1. Creating Smart Item Sorters:

   • Place an item frame on a dispenser and put an eye of ender in the item frame.

   • Automatically teleports an item stack from one of its inventory slots every second.

Example of a smart item sorter.

Troubleshooting and Integration

1. Where Did the Items Go?:

   • Use a stick in the main hand and another item in the off-hand.

   • Right-click with the stick on a smart item sorter or teleport pad to see the teleport target coordinates in the chat.

2. Interference:

   • If players build too close to each other, targets may interfere.

   • Integration with GriefDefender (Claims) plugin allows for better management.

   • Use sub-claims within your main claim to limit auto-sort systems. For example, create a sub-claim around a mob farm to auto-sort items into a mass chest collection at the farm, preventing them from being sent to your base's main chest room.

By following these instructions and using the diagrams, you can effectively manage item teleportation and sorting in your Minecraft server, enhancing the efficiency and organization of your resources.