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.
Sorry for being impatient, have you read my message :)? If you don't know how to fix it at the moment, just tell me - at the moment i check every hour or so for an answer :)
I'm sorry I didn't give enough information ... I think I'm close to figuring it out, however. I've defined potions wrong in the "list" I written "373:8201" as a potion, which the config says is wrong, how do you find the potion ID's? WARN lists.txt[29]: data value '8201' must be a number!
@Bajads
You need to provide more information than "it doesn't do it". At the very least, describe what actually happens. To see what happens behind the scenes, set the "logging-level" in the config file to "debug" and then look at the server logs to find out what happens.
If you cannot make anything from the logs, post them here, otherwise I cannot help you.
The handlings configuration looks correct, but please use
Tags in the future or post your comment as "Plain Text" so the formatting does not get messed up.<<code>>
demo: priority-order: 1 timeout-on-disconnect: 15 conditions: - cause pvp actions: - destroy-items !consumables Shouldn't it destroy everything, but the things listed under "consumables"? - When killing a player via PvP?? It doesn't, do you know where the problem lies?
@Bajads Yes, you can just remove "conditions" entirely.
A minimal handling could be:
If I want everything but emeralds to get destroyed upon death (no matter how you die), can I just remove conditions? Or should I do cause "all" or "death" ... Thanks!
@erdrickk I am not sure what you mean. The double death issue simply causes two deaths in a row, I don't know where priority comes in.
@Bajads You have to declare an item list in
lists.txt
and use its name for thedestroy-items
action (inverted using the!
character).In lists.txt:
in config.yml:
I want every item to get destroyed upon death - but not "emeralds" demo: conditions: cause pvp priority-order: 1 actions: - destroy-items -388 At the time it doesn't work (everything gets dropped), what have I dont wrong?
is there a way you can make your plugin the highest priority so it catches everything first?
@erdrickk
That message is shown when for some reason, you twice in a row (you can also tell because the death message "You have died." is shown twice in your screenshot).
That is usually caused by another plugin that kills the player after they are already dead, because its code does not account for that situation.
why does this happen once in a while???
http://prntscr.com/6do9lo
@Dsiddia
You have 2 options:
keep-inventory 60%
" option (see Configuration page).@drew5494
When dealing with color codes, I would recommend using the ">" operator instead of "=", which translates to "name contains xyz" for strings. Maybe it would work with
§
as the color code character, but I am not sure.Since there seems to be a color code in the middle, you could write something like that:
@Bone008
Hi great plugin! So I want to do something similar to @Si7VdeR with filtering custom named dropped items but when I put the custom name of the item in the lists.txt, it doesn't work. The name uses colour codes. What am I doing wrong?
$list music
{ id = 84, name = &d&lMusic &7(Right-CLick)}
How do I have one group receive a certain percentage of their inventory kept on death?
@NewtPvP
This plugin works fine on 1.8, it doesn't need an update methinks.
when Will this plugin update to 1.8?
@HenriTeja
Unfortunately, this is currently not possible. There is only a less-than-perfect workaround I can think of.
If you could somehow ensure that a player has exactly one item of a kind (could also be a specially named item), you could try to keep exclusively that item based on a percentage, and if that succeeded keep the rest afterwards.
This exploits the "succeeds if ..." behavior of keep-items by making it a
required
action. keep-items succeeds only if at least one item was kept.You would also need to create the item list
special_list_name
and make it contain that special item. If having that item is a trade-off you can live with, this would be a possibility. I cannot offer a better solution at this point, sorry.The percentage in the config, represents the dropped items percentage.
How can I change this into the chance of dropping all items of a player?
Thankyou, Cheers Henri Teja
@AlteOgre
Sorry for the late reply, I must have overlooked the notification. You assumed correctly, unfortunately the plugin is using display names to fill %victim-name% (source).
Apparently, I mainly had writing the name into a chat message in mind when implementing that feature. I did not think about implementing both variants (real name and display name) unfortunately.
The "character knockout" sounds like a cool idea :) If the issue is still relevant, feel free to send me a PM and I can send you a quick patch adding the necessary variable.
@Si7VdeR
I haven't followed the development of Spigot, but this plugin only uses standard Bukkit API functions, so if regular Bukkit plugins work, this one should as well. Give it a try!
Yes, keeping only your custom item is possible by using an advanced list and applying it to the "keep-items" action.
In lists.txt, you would for example declare the following list:
Then you go to config.yml and add a handling without any conditions and with the action:
VoilĂ !
Hi, I am looking for some kind of plugin like this for my 1.8 server (Spigot protocol hack 1.7.10) but I have a question. First, does this work for my version mentioned above. Second, I want to make a legendary sword with a custom name, lore etc.. is it possible to filter that item so the player always keeps it on death ?