Complete Deaths
Complete Deaths
This project has been superceded by CompleteDeaths2.
What is Complete Deaths?
Complete deaths is a Bukkit plugin designed to allow server-admins to completely customize death messages on your server.
It's intent is to provide a lightweight frame and basic implementation to allow you to write your own death messages, or simply use a pre-built list of them to replace the existing ones.
If it proves popular enough, I want to take your suggestions to add features that I feel would allow greater customisation and control. After all, it's your server!
Current Features (v1.5.1 - Bukkit 1.8.* builds):
- Use Display Names instead of usernames Think Essentials /nick
- Multiple messages per death type. No longer will it give the exact same message over and over
- User-customiseable messages, or use a pre-built set (based on my dry humor, ha) - Write your own messages
- Color-code support (Use the & symbol)
- Make messages specific to any player, killer, mob type, mob name, weapon name, or any combination!
- Basic API for other mods
- Minecraft 1.7.10 support
- Limit death messages to a radius
- Mute death messages, specific players, specific worlds, or specific categories
- Deafen players, or worlds - stopping them from receiving death messages
- Set death messages to act per-world only
- /deaths command contains most of the above features
Currently Planned Features:
How to Use
Throw CompleteDeaths in the plugins folder and run the server. It will automatically start handling your death messages, replacing them with ones from my pre-built list. You can add/remove/change any messages by editing the messages.yml file.
Example lines:
drowned: Messages: - "<player> drowned" gotfinishedoffbyentity: Messages: - "<player> got finished off by <enemy>" gotfinishedoffbyzombie: Messages: - "A Zombie devoured <player>'s brains" gotfinishedoffbyentityusingweapon: Messages: - "<player> got finished off by <enemy> using <weapon>" gotfinishedoffbyzombieusingexcalibur: Messages: - "Zombie Arthur stabbed <player> to death." wasslainbytslat: Messages: - "<player> was absolutely wrecked by some cool guy." wasslainbyplayer: Messages: - "<enemy> was destroyed by <player>."
The Messages are the exact default messages, except without spaces, and removing the player name. Make special messages for specific players or entities, or even specific enemies wielding a particular weapon. It's really up to you!
Config Variables
UseDisplayNames: Set this to true to make all death messages replace the players' names with their ingame display names
UseCaratForColor: Set this to true if you need to use an ampersand (&) in one of the messages, it will look for ^ symbols to identify colors instead
Debug: Set this to true to output a little more information with each death. This is handy for bug reports, or if you want to know which message you're missing
CollectMissingMessages: Set this to true so the plugin will remember each message that happens ingame which you haven't defined. Use with /deaths list to display them ingame
WhitelistMode: Set this to true, and any messages which your config file doesn't have won't show up ingame, useful for showing specific death message categories
RadiusValue: Set this to anything higher than 0, and any player that isn't within that many blocks of the dying player won't even know he died
WorldRestricted: Set this to true to make all death messages only show to other players in your world
Message Variables
Use these in your messages and the plugin will replace them in the output
<player> - the player that died
<enemy> - the enemy that did the killing
<weapon> - the name of the weapon that was used to kill
<health> - the amount of health the entity has remaining when killing the player
Commands
The plugin runs entirely off the /deaths command. Simply typing /deaths will give you information on the plugin, as well as the available sub-commands.
Current sub-commands are:
/deaths help - List information about other sub commands
/deaths reload - reload the death messages from the configuration
/deaths list - If CollectMissedMessages was set to true in the config, this will list out death message categories not matched since last restart.
/deaths enable - If the plugin was disabled previously, this re-enables it.
/deaths disable - Disables the features of this plugin
/deaths muteplayer - Mute a player's death messages
/deaths unmuteplayer - Unmute a player's death messages
/deaths muteworld - Mute a world's death messages
/deaths unmuteworld - Unmute a world's death messages
/deaths hideplayer - Prevent a player from receiving death messages
/deaths unhideplayer - Allow a player to receive death messages again
/deaths hideworld - Stop players in a world from receiving death messages
/deaths unhideworld - Allow players in a world to receive death messages again
API
boolean isDisabled() //Returns whether CompleteDeaths is changing death messages or not// boolean isMuted() //Returns whether the plugin is muting messages or not// void setDisplayNamesUsed(boolean) //Toggle whether CompleteDeaths uses display names or not until next restart// void setMute(boolean) //Toggle global muting of death messages// void setPlayerMute(String player, boolean) //Mute or Unmute a player's death messages// void setWorldMute(String world, boolean) //Mute or Unmute death messages in individual worlds void toggleCustomMessages(boolean) //Enable or Disable the plugin//
Feedback is very much appreciated!
Hi guys,
Sorry for the delays - I took a break from Bukkit dev for a while.
This project has now been replaced by CompleteDeaths2.
I completely re-wrote the plugin from the ground up, with a vastly improved matching algorithm and feature support. I plan to add all the additional features we have here, plus even more.
Go check it out over there!
Amazing plugin! Everyone on my server loves the custom death messages. People die on purpose just to see what it will say next! This is a great way to jazz up any server with little to no overhead. Really is a must-have plugin for any public server. *Works on 1.12*
Update to 1.9/1.10? pls
And actually working in 1.5.1 -.- hahaha sorry about that, my fault!
@SuperRonanCraft
Added that feature in v1.5, set "WorldRestricted" to true in the config
@SuperRonanCraft
Not yet, but ill add that soon
One questions, does this plugin allow to be able to not get death messages from worlds when a player is in ANOTHER world dies. EX: If a player dies in survival, all players in survival will receive the death message, but no one in Creative will receive it.
@mod_masta Version 1.4 Released.
Contains quite a few changes, including a new feature, and mutes persisting through restarts
@Scimiguy
Quick update to 1.3.1 to fix entity casting crashes
@mod_masta
That bug will be fixed in the next release.
I assume you're suggesting something where the death message runs as normal, but you can run a command for a given player and that player specifically would not receive the message like everyone else?
Could you possibly add a command for players to use that prevents them from seeing death messages?
Also I'm getting errors for a few death messages, such as falling anvils and burning. http://hastebin.com/qijowibeji.avrasm
@Scimiguy
MySQL? idk how it :l
@ItsBloo
I assume you mean a counter of how many times one player has killed another?
Doing so seems like it would have to contain a rather large matrix of players and their values, making it much less of a 'lightweight' plugin
And how exactly would you reset the counter to 0 ?
You can add the number of kills? like this:
"ItsBloo[0] was slain by Scimiguy[1] using a Diamond Sword"
Version 1.3 released, introduces the per-world message muting option in the config
@ItsBloo
Ah, I'll do the world whitelisting thing for you, look out for the next update
About the cross-world deaths, there's absolutely no reason why it wouldn't.
Easy way to think about it is: If the Vanilla death message does it, then so will this plugin
Only a suggestion
Add the worlds where you want to be active the death messages like this:
Out of curiosity. if I die in the end the message will appear in the overworld too? if so this what I was looking for
Nice plugin!
Version 1.2 Released, fixed numerous bugs:
Fixed PVP messages (replace "entity" with "player" in the message category) Fixed capitalisation of generic enemy mob names Fixed problem with Zombie Pigman messages Fixed inconsistent listing (Use <enemy> for all enemies, whether player or mob) Added more message categories to new pre-populated message lists
As always, if you have comments or suggestions or.. anything, let me know!
@Plumeex
Fixed in version 1.1, thanks for the report
Hello, this plugin looks nice but unfortunately it doesn't work on my server (Spigot 1.8.3).
It loads fine but this happens when a player dies:
Thanks for taking a look at this. :)