DeathControl
Overview
This plugin is a powerful tool to control what happens when players die. Its primary feature is to allow players to keep their inventory, but by now it offers plenty of more possibilities about what to do. You can set conditions that have to be met and actions that will be executed.
Flexibility is one of the main objectives of the plugin. Whether you want a simple way to keep inventories, you want enchanted pickaxes named "Pink Elephant" to be destroyed upon death or you just want to change PVP deaths - this plugin makes it all possible.
Main Features
- provides a powerful way to set up handlings for player deaths
- create different behaviors depending on how and where the player died
- able to save a player's inventory, experience and/or food level upon death
- destroy or damage items upon death
- allows item filters to affect only certain items
- economy support: charge them money for it!
- waiting for the player to perform a command can give them the choice of what to do
- disconnecting players are treated with a timeout
- supports every major economy-plugin through Vault or Register
- uses regular permissions system or the OP system
- flexible messaging system that allows localization and customization
- hooks into the API of MobArena and BattleArena to fix deaths in an arena
Donate
If you want to support the development of the plugin, feel free to drop a donation! It really helps to keep this plugin alive. Thank you :)
Pages
- Configuration
- Commands
- Permissions
- Changelog
- FAQ (Frequently Asked Questions)
- Source code
Setup
- If you want to use economy plugins, you need to have Register or Vault installed as a plugin.
Just download the jar from the linked page and put it in yourplugins/
folder, if you haven't yet. - Drop the plugin's jar in the
plugins/
-directory of your server (just like every plugin, eh?). - Start/Reload the server once to generate the configuration files at
plugins/DeathControl/
. - Read the instructions on the Configuration page for config information!
- Make your adjustments to
config.yml
andlists.txt
as you wish - Reload the config files either through reloading the server or, easier, with the command "
/death reload
" - Enjoy the plugin!
Dependencies
The plugin is functional without any other plugins.
To be able to use the "charge" action (and thus make players pay money), you need one of those plugin libraries so this plugin can make use of your installed economy plugin:
One of them needs to be installed as a plugin on your server.
Reporting an issue
If you think you found an error with the plugin:
- Read the FAQ. It might be a common incompatibility.
- Go to the Issues forum and check if the issue was already posted/answered by another user.
- If not, create a new topic in that same forum and describe your issue precisely. Always post your craftbukkit version, plugin version and if relevant your config file(s).
Please do not report issues in the comments! Only use the forums!
To-Do
This section is now represented by the Tickets tab.
@Brock_Blocking Maybe it will eventually come. Not entirely sure when I will add it. Not too complicated to implement, though, so I might take a look at it for the next feature ...
@breuemic000 You mean the really old Permissions plugin before SuperPerms? That's been dead for ages now! Every permissions plugin which uses SuperPerms (the native Bukkit Permissions API) is compatible with this, and TheYeti's one doesn't (it was created before the API was introduced).
Is this compatible with Permissions 3 Yeti? I set it up properly but everyone still drops all their items.
Thanks for the update. Small request, could you add a text file so we can alter the death message info. They can feel a bit spammy in areas where you die over and over.
@Bone008
Thank you =)
@Sacredox As far as I could tell from the source code of xpShop, it doesn't give the experience properly. I can't say that for sure since I don't know the experience API very good, but their way of changing experience apparently doesn't work well with mine of getting it (
getTotalLevel()
). It's likely a bukkit/vanilla issue, but xpShop should be usinggiveExp()
as far as I know. Sorry, nothing I can do here.@richboos Working on it :)
@pandapipino It works for me with the vanilla
/kill
command. What plugin are you using that provides/suicide
? If you've configured DeathControl correctly (check with "/death info cause SUICIDE
"), then it is that plugin that implemented the suicide-command crappily - in terms of not setting the correct damage cause.All the death cause has been added on the config but when tried doing "/suicide" it still drops all my items, can you please take a look on this? Thanks
Looking forward to Vault :)
@Bone008
Thank you for this great plugin! It is really loved on my server!
However, I just tested a plugin called xpShop and once they buy xp from the shop and die they will go back to the level they were at before they bought xp. They shouldn't lose any xp since the setting is set that way in the config. And they don't lose it all. But the xp from the shop is not saved. I don't know if that is something you can fix or not but if so that would be awesome!
Thank you =)
Update to 1.5 is out! R5 will be promoted very soon, this fixes compatibility with it and adds new features:
@toxuin I usually only push to github when I release updates (like now). If you want to help with features, please contact me before you begin, then I can make sure the github repo is up to date and what you want to add wasn't already done by me or doesn't fit my intentions. But thanks for the offer :)
Can you please keep your github updated? Could do some contribution but don't want to work on old versions. Thank you!
when is the released? XD
This looks perfect for what I need... I can't wait till you have Vault Support so I will keep a close eye on this one.
@surrounded001 Try setting "logging-level" to 2 in the config, then post the server log when somebody dies, as well as your config.yml so I can see which death causes you configured.
@freaky85 Already on the To-Do-list. With the upcoming recode of one part of the plugin, I added this more or less automatically. So yes, it will be in the next update.
@FiddyCraft Also planned (2nd entry on the To-Do list right now), but requires lots of work. Won't be in the next update, though.
can you make it so I can set up different results for groups
so Like new players loose 90% regular players lose 50% and donors lose 25%
can u maybe implement the keep items when player reconnects? because if ppl die and dc, they always lose their items :(
For some reason users that die, have their time to type /death back instantly run out. And if I set it to auto, then it just doesn't give them their items. I have given them their permission, and I have had this working previously. Whats weird is, it works fine for me. Great plugin btw
@nurwin22
You can have the plugin only enabled in certain worlds through only giving the permission "deathcontrol.use" to your users in these worlds. There is currently no option to configure separate settings for different worlds, though. That will be implemented eventually.
@dj1142
Thanks, I've apparently overlooked some messages to respect the logging-level. The first one (about no economy plugin) is only supposed to be displayed when you configured a cost bigger than 0. The plugin also fails to do so at the moment, as I just noticed. Sorry about that.
Will be handled in the next update.
Hello,
i have got a problem: My config:
and my server.log:
Why this in my server.log? I have disabeled the logging-level and I have a iConomy system (but I do not use this with DeathControl).
multiworld support?
thanks for the epic plugin! xD
@Bone008
thanks I think you got it. Just note that you wont always keep stacks of 1 items. If you have 25% keep ratio:
you have 5 items 25% chance to keep two (if you are not lucky you keep only 1)
4 items you have 100% chance to keep one.
3 items you will have 75% chance to keep one. (if you have no luck you keep 0)
2 items 50% chance to keep one
1 item 25% chance to keep one