DeathMessages Plugin Wiki

Mar 3, 2021
DeathMessages Plugin Wiki
  • Welcome to the DeathMessages plugin wiki!

    We will talk about the configuration and capabilities of the plugin in this post :)

    Plugin Anatomy
    Commands:
    • /dm blacklist <username> - blacklists the user from death messages. They will still see other players' death messages, but not send them.
    • /dm toggle - toggles death messages on or off. NEW: Settings are saved via user data files.
    • /dm reload - reload the plugins configs.
    • /dm version - display the installed version of the plugin.

    Permissions:

    • deathmessages.command.deathmessages - View access of the command page of /deathmessages
    • deathmessages.command.deathmessages.blacklist - Access to run /dm blacklist
    • deathmessages.command.deathmessages.toggle - Access to run /dm toggle
    • deathmessages.command.deathmessages.reload - Access to run /dm reload
    • deathmessages.command.deathmessages.version - Access to run /dm version

    Hooks:
    The plugin hooks in with a handful of plugins for elite customization.
    - PlaceHolderAPI
    You can use any placeholder from PlaceHolderAPI in any death message in the plugin.
    I have made some placeholders that you can use elsewhere in your server:
    Available placeholders:
    - %deathmessages_messages_enabled%
    - %deathmessages_is_blacklisted%
    - WorldGuard
    If enabled in your settings.yml in Hooks.WorldGuard.Enabled, you can flag your regions with my custom flags. All of the flags that I created are set to 'ALLOW' by default.
    Here are my custom flags:
    - broadcast-deathmessage-player
    - broadcast-deathmessage-mobs
    - broadcast-deathmessage-natural
    - broadcast-deathmessage-tameable​
    Settings any of these flags to 'DENY' in a region will disable the death message from being sent to the server.​
    - DiscordBotAPI
    If enabled in your settings.yml in Hooks.Discord.Enabled, you can send death messages to discord channels. Simply install the dependant and configure for your servers needs. Then restart the server.
    DiscordBotAPI is not designed to be reloaded with a plugin manager.
    - DiscordSRV
    Same as DiscordBotAPI
    DiscordSRV is not designed to be reloaded with a plugin manager.
    Key Plugin-Features:
    • Hex Color Support (Use in any message in the plugin. Use as you would with regular color codes (#223dc)
    • Multiple configs for easy navigation. Some of the configs are loaded with helpful comments to assist in configuration.
    • Gangs (if there x amount of x mob within the player's radius, it will classify as a gang kill (Configurable)
    • All messages are TextComponents. Meaning you can build messages to have hover text and click actions.
    • Complete customization for mob damage types
    • A configurable time where mob damages are expired. When expired, the deaths will default to Natural-Death
    • A random list of all death types. Meaning you can have 100 messages for players dying from lava.
    • Customization of Weapon Kills.
    • Default-To configuration of weapons
    • World Grouping for death messages
    • World death messages disabling
    • Per-World death messages
    • Tameable Mob Kills (Player x has killed Player y's dog)
    • A whole bunch of plugin placeholders
    Configuration

    EntityDeathMessages.yml - Death messages of mobs
    In this config, you can configure the death messages of certain mobs. Useful for ender dragon killing
    Note: Only tameable mobs are supported for now.
    Code (YAML):
    Tamable:
     - "%killer% killed %owner%'s %tamable%::&aCustom name: %tamable_displayname%"
     
    Gangs.yml - Configure what defines a gang kill of a mob type killing a player
    In this config, you can configure what defines a gang kill of a certain mob
    I'm not going to show the whole config because it is rather large
    Code (YAML):
    Gang:
     #Here you can enable/disable the gang kill feature as a whole
      Enabled
    : true
      Mobs
    :
        elderguardian
    :
          Radius
    : 5
          Amount
    : 4
    In the above setting, if there are 4 or more elder guardians in a 5 block radius of a player, and they manage to kill the player, then this will be defined as a gang-related kill.

    Messages.yml
    Self-Explanatory, you can edit the messages of the base plugin.

    PlayerDeathMessages.yml
    Here is the root configuration of the plugin, here is where you can configure death messages of certain circumstances.
    I'm not going to show the whole config because it is rather large
    Code (YAML):
    Natural-Cause:
      Suicide
    :
       - "%player% killed themselves"
        - "%player% went to the heavens"
    Mobs
    :
      creeper
    :
        Solo
    :
         #This shows the complete customization of death messages, as other plugins can spawn custom mobs.
          Projectile-Arrow
    :
           - "%player% was shot by a %killer% somehow using %weapon%"
          Explosion
    :
           - "%player% got boom boomed by a %killer%"
          Melee
    :
           - "%player% was slain by a %killer%"
        Gang
    :
          Explosion
    :
           - "%player% was playing around in a gang of %killer%'s"
     
    Note: You may add any death-type to any mob. As shown in Mobs.player
    Code (YAML):
     player:
        Solo
    :
          Contact
    :
           - "%player% was pushed into a cactus by %killer%"
          Projectile-Unknown
    :
           - "%player% was shot by %killer%"
          Projectile-Arrow
    :
           - "%player% was shot by %killer% somehow using %weapon%"
          Projectile-Fireball
    :
           - "%player% was fireballed by %killer%"
          Projectile-Snowball
    :
           - "%player% was hit in the head with a snowball thrown by %killer%"
          Weapon
    :
           - "%player% was slain by %killer% somehow using %weapon%"
          Melee
    :
           - "%player_display% was slain by %killer_display%"
          Suffocation
    :
           - "%player% suffocated in a wall while fighting %killer_display%"
          Fall
    :
           - "%player% was pushed off a high place by %killer%"
          Lava
    :
           - "%player% was pushed into lava by %killer%"
          Explosion
    :
           - "%killer% blew up %player%"
          TNT
    :
           - "%killer% blew up %player% with tnt"
          Firework
    :
           - "%player% stood too close to %killer%'s fireworks"
          End-Crystal
    :
           - "%killer% killed %player% by blowing up an end-crystal!"
          Void
    :
           - "%player% was pushed into the void by %killer%"
          Wither
    :
           - "%player% withered away from %killer%'s magic"
          Thorns
    :
           - "%player% tried playing with %killer%'s armor with thorns"
        Gang
    :
          Projectile-Arrow
    :
           - "%player% was ganged up on by some %killer%! One shot them with %weapon%"
          Weapon
    :
           - "%player% was ganed up on by some %killer%'s! One wacked them with %weapon%"
          Melee
    :
           - "%player% was slain by a bunch of %killer%'s"

    I will work on this plugin wiki page more later
  • Loading...
  • Loading...