Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
VonTum committed Jul 16, 2017
2 parents e6b0a84 + 9120bef commit 9570cc7
Showing 1 changed file with 17 additions and 4 deletions.
21 changes: 17 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,32 @@
# ItemFinder
ItemFinder is a plugin that allows players to quickly and easily find and tally their items in nearby containers. It requires little to no setting up once installed.

The plugin will currently look for the specified item in the following places:
- Chests, hoppers, droppers, dispencers, or any other block with an inventory
- Entities with inventories, such as chest minecarts, donkeys
- Items on the floor in item form
- The player's inventory
- The player's enderchest

## Commands
`/find <Material>[:data] [range]`
`/find [Material[:data]] [range]`
Searches the nearby containers and the player's inventory and enderchest and display in chat what it found. It will also mark every chest/container that contains the requested item.

### Examples
`/find` on it's own will look for the item the player is holding, with exact NBT, this is currently the only way to look for specific item lores or enchants.
`/find wood` looks for wood in nearby containers within the default radius (20 by default)
`/find wood:1` looks for spruce wood, again within the default radius
`/find diamond 50` looks for diamonds within a range of 50 blocks

## Permissions
Name | Description | Default
--- | --- | ---
`ItemFinder.*` | Allows access to all features | OP
`ItemFinder.find` | Allows access to /find | Everyone
`ItemFinder.find.longRange` | Overrides maximum search radius | OP
`ItemFinder.find.ignorePerms` | Overrides permission check with other plugins | OP
`ItemFinder.find.*` | Allows access to all admin features | OP
`ItemFinder.longRange` | Overrides maximum search radius | OP
`ItemFinder.ignorePerms` | Overrides permission check with other plugins | OP
`ItemFinder.in.*` | Allows searching in all available containers | Everyone
`ItemFinder.in.container` | Searching Blocks and Entities that can contain Items | Everyone
`ItemFinder.in.floor` | Looking for Items on the floor | Everyone
`ItemFinder.in.inventory` | Searching the player's inventory | Everyone
`ItemFinder.in.enderchest` | Searching the player's enderchest | Everyone

0 comments on commit 9570cc7

Please sign in to comment.