This plugin allows you to keep a record of all player deaths in Discord! See your player deaths sent in real time, displaying your player's name, death message and head. Not only that, but your message's accent colour and motto can be changed with commands!

Perfect for an SMP server, competitive game server or just about anything!

IMPORTANT NOTE: This plugin now requires ProtocolLib. You can download it here.

How to Use

1. Start by downloading the plugin and adding it to your plugins folder.
2. Download ProtocolLib and add it to your plugins folder.
3. Go to your Discord server and create a webhook (see here for a guide, first 50 seconds only)
4. Once you have a webhook URL, type /ddmset <url>, replacing the url with your webhook's URL
5. You're done! It's that simple. Now all death messages will be sent directly to your Discord channel.

Customisation
The accent colour and motto text (bold text above the death message) can be altered at any time by players to customise the messages so they can die in style! There are currently two command to do so:

1. /ddmcolor for changing the accent colour
2. /ddmmotto for changing the motto message

By default the accent colour is red, and the motto is randomly selected from a list in the plugin's config file.

If you have a 'hat' layer on your skin, it either will or won't be displayed in Discord depending on whether your hat layer is enabled or disabled in your Skin Customization settings.

For a full guide of the configuration file, click here.

Word Blocking
There is an option in the plugin configuration file to filter out words from motto messages. This system is currently very basic but any motto messages with these words in them will be matched, regardless of capitalization. This will allow you to ban certain words which you do not want appearing in your Discord channel. Words must be added between the square brackets, surrounded by double quotes (" "), and separated by a comma (,)

e.g.
Cache Prevention
Occasionally Discord will cache the skin images which are used for the death messages. This is normally fine, however sometimes if a user changes their skin it will not immediately update as Discord will not redownload their skin until their cached version has expired.

By default, the plugin will now prevent Discord from caching player skins. This will keep the skins up to date, however there is a slight change that it may increase the loading time of skins in Discord.

If this is an issue for you, you can disable cache prevention in the plugin's config file. This can be done by setting the "preventCaching" property from true to false.

Commands/Permissions

• /ddmset <url>
  Permission: ddm.set
  Sets the webhook URL to send Discord messages to.
  
  
• /ddmclear
  Permission: ddm.clear
  Clears the webhook URL and disables death messages being sent to Discord.
  
  
• /ddmcolor <hex code | clear>
  Permission: ddm.color
  Alias: /ddmcolour
  Changes your own accent color. You can either provide a hex color code (e.g. #ff22ee), or type 'clear' to reset it to default.
  
  
• /ddmmotto <message | clear> [clear target]
  Permission: ddm.motto
  Changes your own motto message. You can either write any text to set it as your motto, or type 'clear' to reset it to default. Your motto message must be no longer than 25 characters.
  
  If you are an admin with the ddm.motto.others permission, you can specify a player name after 'clear' to clear their motto message.

• /ddmversion
  Permission: ddm.version
  Shows version information about the currently installed copy of the plugin. If the user has the ddm.updates permission, it will also check for new versions and show the result.
  
• /ddmreload
  Permission: ddm.reload
  Reloads the plugin's configuration file. Allows you to make changes to the config (such as the motto messages and blocked words) without restarting the server to having to use /reload.
  
  
• ddm.updates
  Default: OP only
  Any player with this permission will receive a notification about new versions of the plugin when joining the server. It also causes the /ddmversion command to check for new updates when run.

Planned Features

• Integration with MyMinecraft (automatic webhook setup)
• More customisation options for admins (e.g. setting defaults)

Known Issues

• When using /reload confirm to reload the server, the hat layer will be disabled for all online players, regardless of it it's turned off or not, and must be synced by either relogging into the server or going into your Skin Customization options. For this reason, you should rely on /ddmreload if you need to make config changes on the fly.

Thank you!
Hopefully this plugin can serve to improve your server-based Discord bot and add some flair to your deaths in game. Thank you so much for checking out the plugin, and if you like it feel free to show your support with a star on Github!

Thanks so much, enjoy