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.
@Bone008 Please tell me I did something wrong.
Here is the debug output from death in my minigames world. [INFO] [DeathControl] @IrParadox: "Death" is checking conditions ...\par 1:05:51 PM [INFO] [DeathControl] "cause" matched\par 1:05:51 PM [INFO] [DeathControl] @IrParadox: Preprocessing 4 actions ...\par 1:05:51 PM [INFO] [DeathControl] Handled death:\par 1:05:51 PM [INFO] [DeathControl] | Player: IrParadox\par 1:05:51 PM [INFO] [DeathControl] | Death cause: lava\par 1:05:51 PM [INFO] [DeathControl] | Executed handlings: Death\par 1:05:52 PM [INFO] [DeathControl] | Disconnect timeout: 15\par 1:05:53 PM [INFO] [DeathControl] @IrParadox: Starting execution of 4 actions ...\par 1:05:53 PM [INFO] [DeathControl] @IrParadox: keep-items -> FAILED\par 1:05:53 PM [INFO] [DeathControl] @IrParadox: charge -> STANDARD\par 1:05:54 PM [INFO] [DeathControl] @IrParadox: message -> STANDARD\par 1:05:54 PM [INFO] [DeathControl] @IrParadox: message -> STANDARD\par 1:05:54 PM [INFO] [DeathControl] @IrParadox: All actions executed!}
And my config file:
disable-permissions: true logging-level: debug
multi-world: allow-cross-world: true disabled-worlds: - Flat - MiniGames
handlings:
- message %plugin-prefix%Hey &e%victim-name% &f%death-cause-formatted% - message %plugin-prefix%Total cost to save inventory = &c%money-paid%
@IrParadox
Last time I checked the
disabled-worlds
feature worked properly. You seem to be taking the correct approach as well. Please post your entire config.yml (using code-tags or simply over pastebin.com).Also, make sure to set logging-level in the config to "debug" and check the output of the server console when soneone dies in the minigame world. If you can't make any sense out of it, please post it as well.
Ok, I am having a small issue here. Maybe I am missing something somewhere.... I don't know. But anyways. I need for DeathControl to not work at all on a specific world. What I have is a minigames world on my server and when someone dies in a minigame, deathcontrol still does its job. Here is my settings for multiworld:
multi-world: allow-cross-world: true disabled-worlds: - MiniGames
I have also tried it with the allow-cross-world set to false even though I need this to work for end and nether in the survival world. My minigames plugin handles inventories and such for the minigames, so I do not need deathcontrol to do that. This also has an affect on kits that are used in minigames if someone dies. The money gets deducted and they keep the kit and any other items in their inventory. Which is useless since I also use multi inv to keep them from taking anything to the survival world. But it is still costing my players when they die. If this comment comes from me missing something due to lack of sleep, I deeply apologize.
Thank you.
@drexel_levante
Unfortunately, that is not possible. It would be a nice feature, though, and not too difficult to add to the current Advanced Lists feature. I will add a ticket for it, but since right now I kind of stalled the development of new features, I can't promise anything.
Hi there i was wondering if its possible just to habe item damage apply to the armor being worn and the currently selected weapon/tool in the hotbar.
@Iwitrag
The other plugin might be Essentials or something else fiddling with a "keep experience" feature. If you are using CraftBukkit for 1.7.9, make sure to update to v2.1.0, which includes a fix for those types of issues (please let me know if it works).
As for the "charge" money issue: Damn, I actually missed a semantic bug. When writing "
charge 100
", the 100 is interpreted as a percentage, because for some reason I decided to write a sophisticated algorithm to auto-detect percentages and made it a little too trigger-happy ;)You have already found a work-around though, so at least it's not completely broken.
To anyone having issues with death costs between 0 and 100 units, those are made into percentages automagically, sorry ...
Hello,
I have a problem - when I die it will remove all my money (but I have set charge 100) and exp are not substracted even with keep exp 90% .. using version 2.0.0
EDIT: money problem solved when used - charge 100% min=100 max=100 but experience problem remains
EDIT2: well that experience problem seems to be caused by another plugin, because when I removed deathcontrol exp are not dissapeared after death.
Since a beta build for 1.7.9 has been released, I have uploaded the new version 2.1.0, which is awaiting approval.
A hook for PVP Arena has also been added (@SanCarlo).
@Bone008
Thank you!!!
Can you create a hook for the plugin "pvparena"?
Even though this plugin is barely affected by the change to the Unique ID system, I updated it so it doesn't rely on player names any more. A problem could only potentially occur when a player does the following steps:
Since player lookup by their unique id is a very slow operation in 1.7.5 and does not work at all without an internet connection, I will wait for 1.7.6/1.7.7 before I release the plugin update. Please refer to the official announcement thread for more information.
Also in this patch is the fix to the
deathcontrol.free
permission node and the "experience dupe" bug with the Essentials plugin.Other notes:
damage-items
action, you have to put it before thekeep-items
action. Otherwise it will report aFAILED
status because it couldn't find any items (they were already transferred back into the player's inventory before they had any chance of being damaged, so to speak).Also, sorry for my very long absence. I have quit active Bukkit development because I am committed to various other large projects. I will keep DeathControl updated when changes like this one occur, but development of new features is completely stalled for the time being.
If you need my immediate attention, feel free to write a private message.
Cheers, Bone
Please fix the bug and update to 1.7.6 uuids.
I do have the rare inventory loss as well, but it's like one out of every 300 deaths.
To the point, I have an issue right now with item damage not working.. I know it used to work because I just altered my setup but for some reason now it fails.
and in the config:
1.7.2 Random lost irems!!!
Do not put it on your server if you do not want problems with loss of inventories This plugin has bothered me a lot. seeking alternative
Please, can you make this plugin compatible with Player Heads ? Heads are not droping after I added your plugin!
so i looked through the config link and couldnt find how to make it so when you die all your items except for a certain item are deleted?
How add player heads to list.txt
397 and 397:3 not work. only drop default skull from inventory
Used as blacklist
$list head
397:3
Need this to PlayerHeads plugin
I'm having a weird issue with Deaths since I upgraded to 1.7.2, though I'm not necessarily sure it's this plugin, I keep having people get multiple deaths in a row from a single source:
I'm going to change it to debug and see if it gives any more information, otherwise I'm at a loss for what to do. I'm kind of wondering if anyone else is having this issue as well, if not I'll have to dig through my plugins for a cause.
It also doesn't happen every time, it's random, so I'm at a loss.
Does this work on 1.7.2?
@Bone008
All the actions work except 'damage-items' even tried it without the filter, the items just dont get damaged