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.
There are 2 bugs that are worrying me. The first one is that under certain circumstances DeathControl bugs the exp of a player and give him a huge amount of exp points (It's not all the time, but when the plugin seems to have broken, because it threw severes in the console), The other bug is that when a player dies twice in a row, deathcontrol gives him his inventory twice which means that he duplicated his items (For example: sendind twice /kill command). If I find the logs, iI'll send a ticket. Thanks
@Bone008
Can you support Mob Arena and Battle Arena? If died in the mob or battle arena, just dearth control doen't work with.
Is there a permission to keep everything on death? That would work as I could set that permission for that world specifically
General note: I broke my wrist, so I'm kind of limited about what I can do for some time, sorry ;)
@krisdestruction This isn't a concern of this plugin, buy of your permissions plugin (or bukkit's permission system). I only check if the permission is active for the player, managing whether it is or not is part of your permission plugin.
@user_41429 I don't use factions, what part of a faction would affect how items are dropped on death? I'll take a look at it when I'm able to do anything again ;)
@diannetea Currently, you can only set the rules for the whole plugin, and limit that to specific worlds, unfortunately.
But you could set it to keep everything, only put "dungeonmaze" into the
limited-worlds
list, and enable cross-world functionality. That of course only works if you don't need to keep items anywhere else on the server (like other rules in the normal world). That's a major feature that I have not yet found motivation to implement as it requires rewriting most of the plugin if done properly.Is there a way I could change the rules per world? I have a dungeonmaze world set up and when people die I plan on having them sent back to the main world, but I want them to keep everything regardless of how they died (partially because there are going to be special rewards they can't get other places)
Found item dupe bug .. set faction home on 24 blocks high, falling from 24 blocks high over and over quickly and you will keep you inventory when you spawn and items will be on ground basicly duping it ive testing it over and over and it works please fix asap!! specialy cause I just told every one how to do it :)
I believe I found a bug. I tried negating deathcontrol.nolimits to an Admin group with *.*
I don't think it negates it properly.
@Recolance You mean you wrote the code for it? o.O
@diannetea Yeah, that's a minor inconsistency. Since the last version, you can however change that message to something more appropiate :)
Reminding me that I still haven't written the documentation page on that feature ...
But just take a look at
plugins/DeathControl/messages.yml
.It seems that if a player gets to keep EXP the notification is misleading and states the items-kept on death
Essentially recoded this plugin's main use entirely to utilize sql and functions even when the player hits the title screen button, or if the server shuts down upon death. Has single deathcause permissions and a node for will never drop on death under and circumstances. I suggest adding these things.
@krisdestruction
Everything's fine for me.
Anyone receiving glitched restored XP where it maxes the XP level (12k something levels)?
@Qwahchees Thank you, it's always great to hear that!
@CrossfireLR99 Yes, that is possible. For the death causes you want (or all of them), leave "keep-inventory" at
false
and only set "keep-experience" totrue
. To make the functionality available through a command, also set "method" to "command
".More information at the Configuration page.
Example:
It's a nice plugin, but I want only that players can do a command that they only get back there XP that they had before they died; is that possible, if yes, how? What is the permission and command? Please answer this! Thanks
Perfect plugin, thanks a lot!
Yes, I'm pretty sure it should, if you are fine with the side-effect that players never loose their inventory at all, as opposed to just when being killed by a spell, or whatever your intention was.
@Bone008
Ah, I see thank you for the informed post. I will let the plugin author know about this maybe he can do something about it.
"So, if the player jumped off a cliff a second ago, and then was killed by that spell, the death cause will be FALL."
Does this mean if I put every single death cause in my config file it should work?
@Killer2demon
I've checked the source code of the plugin, the reason for that is the same as with many plugins that manually damage players: They don't set the last damage cause of the entity when damaging it, thus DeathControl is unable to notice it.
The death cause that is detected then is based on what kind of damage the player took before that. So, if the player jumped off a cliff a second ago, and then was killed by that spell, the death cause will be FALL. There's no way I can influence that.
If you really want this fixed, you can ask the author of MagicSpells to set the last damage cause whenever his plugin does damage the player. (technote: player.setLastDamageCause(event))
@Recolance
Sorry, no big new features that require a major redesign of the plugin at the moment.
Killing a player with the spell Pain associated with the plugin MagicSpells does not let the player hold onto thier items. It says Time is up items have been dropped instantly after they die. I have both the UNKNOWN and the MAGIC sources in my file.
This only seems to happen when it's used in association with a passive spell.
Flatfile, and permission node to keep players from dropping under any circumstances / death cause / timeout / cost / etc.
That is all.