{"id":31853528,"url":"https://github.com/programie/itemsorter","last_synced_at":"2025-10-12T13:29:45.127Z","repository":{"id":169490086,"uuid":"638470238","full_name":"Programie/ItemSorter","owner":"Programie","description":"  A Minecraft Bukkit plugin which transfers and sorts items from inventories like chests into other inventories","archived":false,"fork":false,"pushed_at":"2025-06-19T09:29:32.000Z","size":4754,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-25T09:36:07.388Z","etag":null,"topics":["bukkit","bukkit-plugin","minecraft","spigot","spigot-plugin"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Programie.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-05-09T12:41:39.000Z","updated_at":"2025-06-19T09:29:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"f836ea11-dfd3-4465-9e02-7648791cf15b","html_url":"https://github.com/Programie/ItemSorter","commit_stats":null,"previous_names":["programie/itemsorter"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Programie/ItemSorter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Programie%2FItemSorter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Programie%2FItemSorter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Programie%2FItemSorter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Programie%2FItemSorter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Programie","download_url":"https://codeload.github.com/Programie/ItemSorter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Programie%2FItemSorter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279011444,"owners_count":26084947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-12T02:00:06.719Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","bukkit-plugin","minecraft","spigot","spigot-plugin"],"created_at":"2025-10-12T13:29:42.670Z","updated_at":"2025-10-12T13:29:45.119Z","avatar_url":"https://github.com/Programie.png","language":"Java","readme":"# ItemSorter\n\nA Minecraft Bukkit plugin which transfers and sorts items from inventories like chests into other inventories.\n\n![](logo.png)\n\n[![actions status](https://github.com/Programie/ItemSorter/actions/workflows/build.yml/badge.svg)](https://github.com/Programie/ItemSorter/actions/workflows/build.yml)\n[![download from GitHub](https://img.shields.io/badge/download-Releases-blue?logo=github)](https://github.com/Programie/ItemSorter/releases/latest)\n[![download from Modrinth](https://img.shields.io/badge/download-Modrinth-blue?logo=modrinth)](https://modrinth.com/plugin/itemsorter)\n[![download from CurseForge](https://img.shields.io/badge/download-CurseForge-blue?logo=curseforge)](https://www.curseforge.com/minecraft/bukkit-plugins/itemsorter)\n\n## What is it?\n\nItemSorter allows players to automatically sort items from a chest (or any other inventory block like hoppers) into any number of target chests (or any other inventory blocks like barrels).\n\nWhen transferring the items from the source chest into the target chests, the plugin takes a look of already existing items in the target chests and moves items into the chest already containing the specific item type.\n\n## Configuration\n\nThe following options can be configured in the config.yml of the plugin (created on the first load):\n\n* `allow-cross-world-connections` - Allow to connect signs between worlds (i.e. transfer items from the Nether to the Overworld) (`true` or `false`, default: `false`)\n* `max-distance` - The maximum distance between source and target chests (`0` = unlimited, default: `100`)\n* `max-names-per-player` - The maximum number of different names per player (`0` = unlimited, default: `0`)\n* `max-signs-per-name` - The maximum number of signs per name (`0` = unlimited, default: `0`)\n* `allow-multi-chests` - Allow multiple chests connected to a single target sign (default: `true`)\n* `max-multi-chests-blocks` - The maximum number of chest blocks used for the multi chest feature (`0` = unlimited, default: `0`)\n* `transfer-single-item-per-interval` - Controls whether only a single item (true) or the whole stack (false) is transferred per interval (default: `true`)\n* `transfer-interval` - Interval (in ticks) at which items are checked and transferred (default: `10`)\n\n## Permissions\n\n* `itemsorter.create` - Allow to create and destroy your own ItemSorter signs' (Default: everyone)\n* `itemsorter.destroyAny` - Allow to destroy any ItemSorter signs (not just your own) (Default: op)\n* `itemsorter.command` - Allow to execute the `/itemsorter` command (Default: op)\n* `itemsorter.*` - Allow access to all features (Default: op)\n\n## How to use it?\n\nSimply place a sign at the side of any inventory block (chest, barrel, hopper, etc.) you would like to use as the source chest containing the following content:\n\n* First line: `[ItemSource]`\n* Second line: Any unique name used by the other connected chests\n\nThis will define the chest as an item source (i.e. the chest you will throw in your items for the plugin to sort them for you).\n\nAfter that, place a sign at the side of any inventory block (chest, barrel, hopper, etc.) you would like to use as the target chest containing the following content:\n\n* First line: `[ItemTarget]`\n* Second line: Any unique name used by the other connected chests\n\nThis will define the chest as an item target (i.e. the chest your items will be moved to).\n\nNext, place any item you would like to sort into the target chest. For example, if you want to move cobblestone into the chest, simply place at least one cobblestone item into the chest.\n\nAfter that, you are ready to go. Now you may move any item from your player inventory into the source chest and the plugin will try to find the correct target chest for each item.\n\nAny remaining items which can't be sorted into a target chest will remain in the source chest.\n\nI've also created a [short video](https://www.youtube.com/watch?v=1KBjjMT5_-0) demonstrating the plugin.\n\n### Target order\n\nAt some point, you might have multiple chests for a single item type like cobblestone or dirt. In that case, you may also want to define which chest should be filled up first before trying the next one.\n\nTo archive that type of target chest order, simply define the order using `o:\u003cany number\u003e` on the fourth line of the sign attached to the target chest:\n\n![](screenshots/target-order.png)\n\nExample:\n\n* First line: `[ItemTarget]`\n* Second line: Any unique name used by the other connected chests\n* Third line: Keep empty (will be replaced with your player name)\n* Fourth line: `o:10`\n\nA lower number means the chest is used before another with a higher number. By default, any target chest without the order option will have the order number `0`.\n\nIf you define multiple chests with the same order number, the order of those chests might be random.\n\n### Multiple chests with a single target sign\n\nSometimes, you might get at the point where placing lots of signs is really time-consuming and could also decrease the client rendering performance (i.e. if there are hundreds of signs in your storage room).\n\nThink about the follow setup:\n\n![](screenshots/multichests-1.png)\n\nIn that case, you can use another feature build into this plugin. Simply place a single target sign at any chest and add `mc` (short for \"Multi Chests\") to the fourth line of it. Any directly connected chests are now connected equally with this target sign.\n\nExample:\n\n* First line: `[ItemTarget]`\n* Second line: Any unique name used by the other connected chests\n* Third line: Keep empty (will be replaced with your player name)\n* Fourth line: `mc`\n\nYou may also specify other options like the target order by separating each option with a comma.\n\nExample:\n\n* First line: `[ItemTarget]`\n* Second line: Any unique name used by the other connected chests\n* Third line: Keep empty (will be replaced with your player name)\n* Fourth line: `o:10,mc`\n\nPlacing that sign on a chest allows you to connect as many chests as you want (limited by the `max-multi-chests-blocks` config option). You only have to make sure, they are touching each other on any block side.\n\nThe previous setup would look like that:\n\n![](screenshots/multichests-2.png)\n\nAll of those eight chests are connected using the same name `some name`, just like placing a target sign on each of them.\n\n### Show info about sign\n\nClicking on a ItemSorter sign (left or right click) shows some information about the sign as well as it's connection to the other signs/chests.\n\n## Commands\n\nThe plugin has a single command `/itemsorter` with multiple subcommands (actions).\n\nAvailable actions:\n\n* `remove-signs \u003cplayer name\u003e \u003csign name\u003e`: Remove all signs with the specified name of the specified player\n\n## Build\n\nYou can build the project in the following 2 steps:\n\n* Check out the repository\n* Build the jar file using Maven: *mvn clean package*\n\n**Note:** This project requires Maven and at least JDK 11!\n\n## My other plugins\n\nYou can find them on [my website](https://selfcoders.com/projects/minecraft-plugins).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogramie%2Fitemsorter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprogramie%2Fitemsorter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogramie%2Fitemsorter/lists"}