Bukkit

Item Hoover

Suck up items in to your inventory!

The Item Hoover plugin lets you suck up dropped items in to your inventory. You can refine the hoover by specifying a custom range, excluding some items, or only sucking up a specific item you choose.

Commands

Item Hoover includes 3 simple yet powerful commands, which let you refine the items you choose to suck up. They are as follows:

/hoover [range | x y z]
The /hoover command sucks up everything within the specified radius. If no radius is specified, the default of 5 blocks is used. You can even tell Item Hoover to use a different range along each axis.

/hooveronly <item> [range | x y z]
The /hooveronly command only sucks up the specified item, and nothing else. Like the regular /hoover command, you can optionally specify a custom range.

/hooverexcept <item> [range | x y z]
The /hooverexcept command sucks up all items on the floor except from the item specified in the command. You can also optionally use a range on this command too.

Permissions

The Item Hoover permissions can be used to enable or disable specific parts of the Item Hoover plugin. The permissions are as follows.

• hoover.use - Allows the player to use the /hoover command, but not with a custom range.
• hoover.userange - Applies to all commands. Allows the player to use a custom range with the hoover.
• hoover.filterinclude - Allows the player to use the /hooveronly command. To use a range, the hoover.userange permission is needed.
• hoover.filterexclude - Allows the player to use the /hooverexcept command. To use a range, the hoover.userange permission is needed.

Installing

To install the Item Hoover plugin, follow these instructions.

• Download Item Hoover from the DevBukkit website.
• Upload to your server, placing the Jar file in the Plugins directory.
• Either restart your server, or reload it using /reload. We recommend restarting.

Notes

The default range of the Item Hoover is 5. This is a radius, and is applied in all directions around the player. If no custom range is specified on the Item Hoover commands, then this will be used.

The maximum range of the Item Hoover is 150 blocks in any direction.

For the /hooveronly and /hoverexcept commands, you must use the item name, not ID. For example, use wool for Wool, not 35.