Bukkit

What is it?

ItemFinder is a plugin which basically allows you to scan through all chests, furnaces, hoppers, and other stuff wich can hold items in your world and see if someone contains a specified item. This is really useful if, for example, you had a bad admin who, before getting banned, has hidden some precious stuff in some chests all around the world, and you don't know where.

How to use

1. when you first install the plugin, before starting to search for an item, you have to index all inventory holders in all worlds. To do so, you have to type the command /itemfinder index and then type Y. Indexing all those chest will take a while (depending on world size, it could also take several minutes);
2. once indexing is done, you can start searching for your items! Simply type /itemfinder search <item...>, replacing <item...> with the IDs or the names of the items you want to find. For example, if you want to find all inventory holders containing iron and diamond sworlds, you would have to type /itemfinder search iron_sword diamond_sword. Remember that if you want to search something again, you don't need to re-execute the /itemfinder index command!;
3. teleport to the locations found and evaluate what to do. If you have ProtocolLib installed, you can teleport to one of them by simply opening the chat and clicking on the desired location.

The plugin has an updater, which basically allows it to update itself when I publish a new version. You can disable it in the config, setting the key autoUpdate to false.

Commands

• /itemfinder index: indexes all inventory holders in all worlds;
• /itemfinder cancel-indexing: cancels inventory holder indexing;
• /itemfinder search: searches for an item in all indexed inventory holders.

Dependencies

To work, this plugin needs to have PowerNBT installed. Additionally, you can also install ProtocolLib if you want to have the additional teleporting utility discussed before.

Permissions

• itemfinder.*: allows the player to use all the ItemFinder commands;
• itemfinder.itemfinder.*: allows the player to use all the /itemfinder commands;
• itemfinder.itemfinder.index: allows the player to use the /itemfinder index command;
• itemfinder.itemfinder.cancelindexing: allows the player to use the /itemfinder cancel-indexing command;
• itemfinder.itemfinder.seach: allows the player to use the /itemfinder search command.

Todo

• disable the player to search for an item before inventory holders have been indexed;
• read region files directly to get all inventory holders;
• put the indexing code on a separate thread to reduce server lag;
• add support for data search;
• make the plugin also scan through all entities, especially minecarfts with furnaces or chests;
• make the plugin also scan through all player inventories;
• make the indexing work with multithreading;
• add the ability to index and search for enchantmets etc..

If you have any suggestions or have found a bug, please tell me!