ItemFinder

# ItemFinder ItemFinder is a plugin created to ease the search for items within all near containers. ## Features - Search for specific items stored in containers within a configured radius. - Highly configurable. - Folia support. - WorldGuard and GriefPrevention integration. ## Commands and Permissions | **Command** | **Description** | **Permission** | |-----------------------------|---------------------------------------------------------|---------------------| | `/itemfinder` | Base command of the plugin. | `itemfinder.base` | | `/itemfinder search <Item>` | Searches the specified item within all near containers. | `itemfinder.search` | | `/itemfinder reload` | Reloads the configurations of the plugin. | `itemfinder.reload` | | `/itemfinder help` | Displays a list of the commands of the plugin. | `itemfinder.help` | ## Configurations | **Configuration** | **Description** | **Example** | |-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------| | item-blacklist | List of items that can't be searched through the `/itemfinder search` command. | item-blacklist: <br/>- GOLDEN_APPLE | | world-blacklist | List of worlds the `/itemfinder search` command can't be used in. | world-blacklist: <br/>- world_the_end | | region-blacklist | List of WorldGuard regions the `/itemfinder search` command can't be used in. | region-blacklist: <br/>- region1 <br/>- region2 | | search-radius | Radius (in blocks) around the player where items will be searched. | search-radius: 10 | | searched-chunks-per-tick | Amount of chunks that will be searched for items per tick. The higher the amount the fastest the search and the highest the impact on the server. | searched-chunks-per-tick: 15 | | item-found-effects-iterations | Amount of times the item found particles will be shown on containers with the searched item. | item-found-effects-iterations: 5 | | search-cooldown | Time (in seconds) between each item search. | search-cooldown: 5 | Messages, sounds and particles from the plugin are also configurable. For instructions for how to configure this, check the (https://modrinth.com/plugin/penpenlib)) guide. ## Dependencies - (https://modrinth.com/plugin/penpenlib). ## Soft Dependencies - (https://dev.bukkit.org/projects/worldguard): Used to check for blacklisted search regions. - (https://www.spigotmc.org/resources/griefprevention.1884/): Used to check for container access while searching for items. ## Installation 1. Download the latest version of (https://modrinth.com/plugin/penpenlib)) and ItemFinder JAR files. 2. Drop the JAR files into the `plugins` folder of your Spigot/Paper server. 3. Restart the server. ## Compatibility ItemFinder is compatible with Minecraft versions 1.19.4 and later. Compatibility with older versions is not currently planned, as Folia's oldest supported version is 1.19.4.