Smart Item Sorter
Teleport Targets
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.
Common Use Cases:
Above a hopper: Teleported items are picked up and distributed by the hopper.
Above a lava cauldron: Items are quickly destroyed.
Above a cobweb: Items combine into stacks before further processing.
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.
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.
Order of Preference for Matches:
Exact match.
Exact match to items in a shulker box.
Item tag match.
Item tag match in a shulker box.
Similar match.
Similar match in a shulker box.
Default item (carrot on a stick).
Choosing a Teleport Target:
Only the best matching targets are considered.
If multiple targets match equally, one is chosen randomly.
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
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
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
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.
Troubleshooting and Integration
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.
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.
Last updated