Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
ItemFinder

ItemFinder

Quality of life plugin to search for items within near containers

86
5

Compatibility

Minecraft: Java Edition

1.20.x
1.19.x

Platforms

Bukkit
Folia
Paper
Spigot

Supported environments

Server-side

75% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

Report issues View source
Donate on Ko-fi

Creators

Eeshe
Eeshe Member

Details

Licensed MIT
Published 5 months ago
Updated 5 months ago

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:
- GOLDEN_APPLE
world-blacklist List of worlds the /itemfinder search command can't be used in. world-blacklist:
- world_the_end
region-blacklist List of WorldGuard regions the /itemfinder search command can't be used in. region-blacklist:
- region1
- 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 PenPenLib) guide.

Dependencies

Soft Dependencies

  • WorldGuard: Used to check for blacklisted search regions.
  • GriefPrevention: Used to check for container access while searching for items.

Installation

  1. Download the latest version of 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.