[MECH] DropChest v0.8.3 - Chests that absorb dropped items [1.1-R3]

DropChest - Chests that absorb dropped items
Version 0.8.2

Important! When migrating from 0.6 to any above version, you have to move the DropChest.txt from server/plugins/DropChest.txt to server/plugins/DropChest/DropChest.txt
This is because I have to follow the Bukkit plugin saves guidelines.

This plugin automatically adds dropped items to near chests. That is very useful for automatic farming and monster traps that gather loot.
Features

• automatically suck dropped items that are near a chest to that chest
• customizable warning if the chest is nearly full
• list your DropChests and watch how much percent is still free
• Permissions
• Filter
• Storage Minecart support
• Dispenser and Furnace support
• Item information
• Chest protection
• Automatic Owner tracking
• Double-Chest support

Download

DropChest.jar
GitHub Project (Source Download)
Download development version

Donate, if you want to support me

Video



Usage
Commands

To add a chest to the "watchlist", type

Code:

/dropchest add [radius]

After that, rightclick the chest that you want to add. Radius is the radius in which the Chest should suck items. Default value is 2.

To remove a chest from the "watchlist", just type

Code:

/dropchest remove chestid

where chestid is the number of the chest that you get when you call /dropchest list

You can list the chests that are on the watchlist via

Code:

/dropchest list

You can adjust the radius of a chest via

Code:

/dropchest setradius chestid radius

You can check which id and radius the Chest in front of you has:

Code:

/dropchest which

after that, rightclick on the Chest to get information about it.
If you are sitting in front of the console, or don't want to rightclick, you can use

Code:

/dropchest info chest

It will generate the same output as /dc which.

You can teleport to a chest via

Code:

/dropchest tp chestid

where chestid is the ID of the dropchest

You can set the name of a DropChest via

Code:

/dropchest setname {chestid} {newname}

The name is displayed in chest is full warnings, and in the DropChest list!

If you migrate from 0.6 to 0.7, you can set the owner of a dropchest by typing:

Code:

/dropchest setowner {chest} {newowner}

You can protect a chest by typing

Code:

/dropchest protect {chest} {on|off}

You can always use /dc instead of /dropchest if you are lazy.

Another very helpful command is /dcitem:

Code:

/dcitem [NAME|id]

This can be used to obtain the name of an item by it's id or get an id of the item-name.
This doesn't work with all names, though.

Use the new command /chestinfo {name|id} to get info about what's inside the chest.
Omit the argument and rightclick on any chest to get info about that.
Example:

Code:

>/dcitem 4
4 is COBBLESTONE
>/dcitem cobblestone
COBBLESTONE is 4

You can configure DropChest by pasting the contents of the following block to plugins/DropChest/dropchest.cfg

Code:

#Should the dropchest drop items when it gets a redstone signal?
droponredstone=true
#How long should the dropchest not suck items after it has dropped them
waitafterdrop=10
#Should users be able to protect chests like in LWC?
usercanprotectchest=true
#Which is the default radius if you omit the radius argument in /dropchest add?
defaultradius=2
#Which should be the maximum radius for players that have not dropchest.setBig and aren't ops?
fallbackradius=15
#At which fill-status should the chest warn you?
warnfillstatus=90
#Which message should appear as warning?
#You can use this variables (example):
# $owner : the owner of the chest (narrowtux)
# $name  : the name of the chest (my superduper mobtower chest/#42)
# $fill  : The fill status, in percent (81)
warnmessage=$owner, your chest $name is nearly full($fill%).

Filter / Storage Minecarts

Filters have changed in version 0.6. There are now 3 seperate filters that are for sucking items, pulling items from passing minecarts and pushing them to passing minecarts.
You can now set the filters by either using commands or using the interactive mode. Let me show you the interactive mode first:
to begin, type

Code:

/dropchest filter {suck|push|pull}

Note: choose one of suck, push or pull, please (for example /dropchest filter suck)
Then you will enter the interactive mode. In this mode you can edit the selected filter by hitting the chest with the desired item in your hand.
To edit another filter, type the above command again.
To finish your filter, type

Code:

/dropchest filter finish

Commands mode:

Code:

/dropchest filter {suck|push|pull} {chestid} {itemid|itemtype|clear}

Call the filter-command like above, as second argument, use the chest-ID, and as third argument, either type the item-ID, the name of the item (as they appear here: org.bukkit.Material) or type clear to clear this filter.
Please note! The suck filter acts different from the Pull/Push-Filter when it's empty. When the suck-filter is empty, the chest will suck every item. When a Pull/Push filter is empty, it won't take or give any items to a passing minecart.

You can use these nodes:

• dropchest - To get the right to use DropChest
• dropchest.create - To call /dropchest add
• dropchest.remove - To call /dropchest remove chestid
• dropchest.radius.set - To set the radius of a Chest to something else than 2
• dropchest.radius.setBig - To have unlimited radius
• dropchest.which - To have access to the /dropchest which command
• dropchest.teleport - To be able to teleport via /dropchest tp chestid
• dropchest.filter - To set or reset filters
• dropchest.filter.set - To set filters in interactive mode
• dropchest.filter.reset - To reset filters in interactive mode (click with nothing in hand)
• dropchest.list - To have access to /dc list and /dc info
• dropchest.destroy - To be able to break a dropchest without removing it before.
• dropchest.protect - To be able to protect a chest
• dropchest.moderator - To be able to modify a dropchests properties even if you're not the owner. Also, ops and the console can do that.

You can use these variables:

• dropchestmaxradius - To adjust the maximum radius for a group or a user

How to use variables:

Code:

users:
  narrowtux:
    info:
      dropchestmaxradius: 1000

This is just an example and this also works with groups!

Changelog
Version 0.8.2

• Fixed the loading issue.

Version 0.8.1

• Supports SuperPermissions (when no Permissions plugin was found)
• Fixed show stopping bugs.
• Use YAML as persistence storage. You can find the new file at plugins/DropChest/dropchests.yml

Version 0.8

• Performance improvements
• Fixed a bug that caused dropchest to eat stacks in storage minecarts (thanks @Tenebria )
• Implemented per-chest delay (thanks @Gibbers )
• Made /dc list per player. Use /dc list {pagenum} all to see all showcases (works without all in the console)

Version 0.7.9

• Fixed bug where items were lost when a chest/minecart was full on pushing/pulling
• Little code cleanup

Version 0.7.8

• Fixed a bug where, for example, if you had several ItemStacks of 1 block each, only 1 ItemStack would be pulled to the chest or pushed to the MineCart, the others would be deleted.
• Minecarts can now be over/under DropChests to be handled

Thanks M-Type!
Version 0.7.7

• Double Chest support

Version 0.7.6

• Fixed some issues when using a Permissions implementation that is not complete (in this case EssentialsGroupManager as reported by @Kartus )

Version 0.7.5

• you can add all items to a filter by using the keyword "all" instead of the material-type
• you can obtain info about a dropchest without having to rightclick (/dc info {chest}). However, the output is the same as when you would have called /dc which

Version 0.7.4

• warnfillstatus=-1 now disables the "chest is full"-warning

Version 0.7.3

• Fixed a bug that came with a new Bukkit release

Version 0.7.2

• /dc which now says something again, thanks to @Liger_XT5.

Version 0.7.1

• Removed debug messages

Version 0.7

• Configuration added
• DropChests can drop their contents when a redstone input is present
• Now, only the owner of a dropchest can adjust it's properties
• The owner of a dropchest can protect the chest. So other players can't open it.
• Customizable warning message and fill threshold.
• Warnings will now be displayed to the owner of a chest, if he is online.
• And made compatible to Minecraft 1.5_01. Older versions of craftbukkit won't work!

Version 0.6.9

• /dc which even more fancy
• Removed debug message reported by @Reterg
• Implemented the /item command which tells you what item this id is or vice-versa.

Version 0.6.8

• /dc which now looks fancy and shows the filtered items, too.

Version 0.6.7

• Added dropchest-id to the /dc which output.

Version 0.6.6

• Fixed NullPointerException on startup

Version 0.6.5

• Fixed /dc which
• Refactored some code
• You can now also use names of dropchests in the commands.

Version 0.6.4

• Fixed chunk unload that results in crash

Version 0.6.3

• Updated to bukkit-version 602
• Tried to fix Thread-Exceptions. Breaking DropChests still not fixed, maybe happens later this day

Version 0.6.2

• Permissions not required anymore.
• Thread-Safe. No more ConcurrentModificationCheck Exceptions!

Version 0.6.1

• Fixed loading issues. You have to move your old DropChest.txt to the folder DropChest/ in your plugin directory!

Version 0.6

• Seperate filters for sucking, pushing to minecarts, pulling from minecarts
• Multiple users can add dropchests at the same time now!
• Added a name to the DropChests
• Fixed Minecraft 1.3-Bug (method net.minecraft.server.Entity.q() was not available any more)

I'm working on extended furnace handling, that fuels automatically go to the fuel slot and so on. This is still buggy so I didn't released it, it comes in the next version.


Version 0.5.1

• Multiworld works now
• Paginated /dc list
• Persistent DropChest IDs

Version 0.5

• Added support for Storage Minecarts
• Added support for Dispensers and Furnaces

Version 0.4.2

• Fixed bug that Tearlow described.

Version 0.4.1

• Fixed loading bug when migration from versions 0.3 or below

Version 0.4

• Added filters.

Version 0.3.1

• Multiple world support
• Since the Craftbukkit version from feb, 13 at 12:00 CET, Chests that are destroyed by Players are rebuilt
• Worked around NullPointerException when Permissions is not loaded properly
• Files now hosted on github that non-members also can download DropChest

Version 0.3

• Permissions support.
• Configure the maximum radius for each single user or group (via Permissions)
• Fixes bug with unhandled Exception in the EntityWatcher-Timer.
• /dropchest can be called via /dc for short
• /dropchest without arguments just lists the commands that the user can execute, as well as his maximum radius.
• Oh, and I corrected the Pythagoras formula for radius calculation. Shame on me...

Version 0.2.3


This is quite a huge bugfix update. Permissions come next

• Broken DropChests are now automatically removed from the list
• changed package name from com.bukkit.narrowtux.DropChest to com.narrowtux.DropChest to prevent not loading issues coming up next monday
• Added command "which", that allows you to see which id a chest has and if it is already a dropchest.
• Linked against the most recent versions of Bukkit and Craftbukkit. The Bukkit guys have fixed a lot of bugs that affected this plugin. In my tests, there were no more nullPointerExceptions or similar errors. Also, DropChest now also works on very fresh placed Chests
• And a currently constant maximum radius of 20 blocks

Version 0.2.2

• DropChest are now removed when you call /dropchest remove chestid
• DropChest now have a minimum radius of 2
• Fixed some saving issues

Version 0.2.1

• Fixed a problem where the radius has not been saved

Version 0.2

• Added a radius

Version 0.1

• First Release of DropChest