DeathBukkit
DeathBukkit
General
DeathBukkit allows players items' to be preserved after death, so that they can be recovered. Specifically, when a player dies with death chests/signs enabled (see the "Use" section below), a chest will be created at the death point, containing the items which were in the inventory of the player prior to being dead (this is highly configurable). A sign will also be created (again, configurable), indicating who the owner of the chest is, as well as the time and date when they died. Right-clicking on this sign will automatically recover the chest's contents, and destroy the chest.
While several other "death chest" plugins do already exist, they are all either out-of-date or abandoned. This plugin is intends to supersede those plugins.
A server owner could easily change the configuration file and customize timings such that:
A chest will be inaccessible by only the dead player for X minutes. A chest will break after Y minutes.
News
DeathBukkit Release v1.0.1
DeathBukkit v1.0.1 is a huge update. It adds multiple commands, different chest types, many bugfixes and better permissions system. It was the product of a lot of effort and consists of more than 1,409 new lines of code.
DeathBukkit Release v0.3.0
DeathBukkit v0.3.0 re-adds the ability to make chests exist of an infinite amount of time (no expiry). It also stops chests from "auto-expiring" when the sign is clicked and the player's inventory is filled.
DeathBukkit Release v0.2.1
DeathBukkit v0.2.1 fixes a potential TileEntity CCE.
Use
Configuration
Just drop the plugin in your plugins directory and next time the server is run it will automatically generate it's config file for you. The 2 options in the plugin config file are self explanatory (seconds until unlock and seconds to expiration) and the defaults are:
- unlockAfter: 0
- expireAfter: 0
A value of zero indicates that the chest should unlock/expire immediately and a value less than zero indicates that the chest should never unlock/expire. Any other value is a time in seconds.
Types
DeathBukkit uses a type-based system for extra configurability. Chest types can be configured per player and define what happens when a player dies. You set a player's chest type by giving them the permission "deathbukkit.type.<name of type>" (e.g. to the set "grave" type a player should be given the "deathbukkit.type.grave" permission). If no chest type is set for a particular player, that player will not have a chest created for them.
Currently, three different death chest types exist, and they are listed below. The order of this list matters. If a player has more than one chest type set, DeathBukkit will ignore all but the type that appears first on this list.
Name | Description | Image |
---|---|---|
grave | Creates a sign at the place of death containing information about the player's death including time of day. By right-clicking the sign, items can be retrieved. | View |
doublechest | Creates two chests containig the entire contents of the player's inventory. It is located at their place of death and also includes a sign, similar to "grave". | View |
singlechest | Creates a single chests containig as much of the player's inventory that can fit. Extra items are dropped on the ground. It is located at their place of death and also includes a sign, similar to "grave". | View |
Commands
Please Note: Commands may also be prefixed with the alias /deathbukkit instead of /db.
Name | Description |
---|---|
/db | Displays your number of chests. |
/db loc | Alias for "/db loc 1". |
/db loc <num> | Displays chest <num>'s location. |
/db tp | Alias for "/db tp 1". |
/db tp <num> | Teleports you to chest <num>. |
/db reload | Reloads the config file. |
Permissions
Please Note: Wildcard *s are valid in permission nodes (e.g. "deathbukkit.commands.*" grants access to all permissions beginning with "deathbukkit.commands.").
Name | Description |
---|---|
deathbukkit.command.status | Permits "/deathbukkit" |
deathbukkit.command.loc.first | Permits "/deathbukkit loc" |
deathbukkit.command.loc.any | Permits "/deathbukkit loc <num>" |
deathbukkit.command.tp.first | Permits "/deathbukkit tp" |
deathbukkit.command.tp.any | Permits "/deathbukkit tp <num>" |
deathbukkit.command.reload | Permits "/deathbukkit reload" |
deathbukkit.type.grave | "Grave"-style DeathBukkit chests should be created for this player |
deathbukkit.type.doublechest | "Double chest"-style DeathBukkit chests should be created for this player |
deathbukkit.type.singlechest | "Single chest"-style DeathBukkit chests should be created for this player |
Media
By: VariationVault
By: luigi_vampa
Download
The latest plugin build can be downloaded here.
Latest Changes
- Fixed config parsing
- Fixed config loading
- Added death sign
- Fixed armor loading
- Fixed serious chest inventory reading bug
- Fixed potential TileEntity CCE
- Re-added the ability to make chests exist of an infinite amount of time (no expiry)
- Stops chests from "auto-expiring" on click
- Added /db, /db loc and /db tp commands
- Added chest type permissions
- Added "grave" chest type
- Added "single" chest type
- Improved code modularization
- Fixed config parsing bug (can't set unlockAfter to infinite when expireAfter is finite
- Overall better code and code cleanup
Planned Features
- More customizable options - Feel free to suggest anything!
How Can I Help?
This plugin is developed solely by me in my free time so:
- If you are a developer would like to contribute to this project, or any of my other projects, please PM me or email me at [email protected].
- If you are a not developer but would still like to contribute somehow, please consider donating. Donations are highly valued and much appreciated.
About
Developer: Keeley Hoek (escortkeel)
@googlebuscus
I've run into a problem. What should happen when a player has multiple death chests?
If I set expireAfter to a value less than 0 so the chest never expires like this page says, the console instead tells me that I can't and it defaults back to 0.
unlockAfter works fine though.
@LiLChris06
Sure! That makes perfect sense. I didn't think about players being able to steal. :)
@escortkeel
Yea keeping the items in the chest till your not full again would be ideal.
Example...
1. Died with full inventory + worn gear
2. Get back to the chest and click sign
3. All items go into your inventory, except armor (4 pieces) which stays in the chest
4. Player then can click the sign again to get those last 4 pieces.
(if you only have 1 space and click the sign 1 item goes to your inventory)
That's basically how it works with Deathtp, if items fell to the ground then others will just steal it.
@googlebuscus
Sure! (It will be permission protected so that it may be disabled on servers which don't want it.)
@LiLChris06
Hi LilChris06! :)
If I'm not mistaken, that is intended behavior. If you attempt to auto-recover the contents of chest, and you can't hold all of the items which the chest contains, those items are dropped on the ground any the chest is deleted. If you have and better ideas for a more intuitive behavior, feel free to comment!
Regards,
Keeley
How about a command that a player can use to get the coordinates of their chest? Possible? If so, i'd be happy to see it as a feature!
@Hopium
Your issue appears to originate from a problem with Spout and how it deals with TileEntities. If I get time I'll have a look and see if there is anything I can do about that from the plugin-side, but it is unlikely.
@LiLChris06
On it! :D
Noticed that when you click the sign any gear you are wearing seems to just drop on the ground if your inventory/chest was full.
Anyway to change that? :)
@escortkeel
i just removed deathbukkit and went back to tombstone no errors on death, so i don't know what the deal is. but i only get those errors when running your plugin. so i just removed it sorry.
@Hopium
Hey Hopium,
Those two exceptions were a result of Multiverse-Inventories attempting to deserialize a corrupt object from it's config file, and there is no obvious reason (that I see) why DeathBukkit would cause that to happen. Try deleting all of your Multiverse-Inventories config data and dieing again. If it still happens, it is obviously this plugins fault.
Kind Regards,
Keeley :)
that build conflicts with mv inventories now its seems. log
@Hopium
Does this version fix this issue?
been getting this error on death. it both drops the items and the deathbukkit resulting in a dupe of the inventory. any other info needed as i don't think this is related to any other plugins that i can see
Thanks , love the new additions
@escortkeel
Awesome! :D
And still under 20kb, love it already.
Take your time, trust me most of us coming here prefer a stable/lite release over other plugins.
Only thing missing for myself would be the double chest permission node when ever you get the chance.
@xclucky
@Melekaiah
@luigi_vampa
@LiLChris06
@jimm0thy
@Chemical_Datas
@Folas1337
@arihin
@Mortalsinn
Hi everyone! :)
I've made tons of changes to the initial release! v0.2.0 brings with it a huge number of bugfixes, death signs (which you can right click to recover chest contents), better armor loading, plus a number of other (minor) things.
You can grab it here!
Thanks for using DeathBukkit :D ,
Keeley
P.S. I just remembered that there have been requests for a "/db tp" (or similar) command. I'll do this now.
P.P.S. Sorry about the delay for this update. I ran into several CraftBukkit bugs along the way, as well as a _super_ obscure bug in my own code which took days to track down. It's done now though!
I've found a bug with the Bukkit API which is inhibiting some progress. You can view the ticket here.
@luigi_vampa
I've fixed this in the next build. It's coming, I promise!