Mob Health

This simple but invaluable plugin lets you know the damage you just caused to a mob (including other players), and how much health it has left.

Now with ActionBars!

ActionBar If you have 1.8 bukkit/spigot then you can now enable actionbars by adding useActionBar: true to your config (or set to false to disable).


Mob Health has a range of useful options including:

  • Control over how messages are shown
  • When messages are shown
  • When messages are *not* shown (a useful feature!)
  • Exactly what is displayed - including your own custom messages...

Current Release Version: 9.1.0

Updater Information
Note that unless you edit MobHealth configuration it will automatically update as new versions are approved by the Bukkit team.

You can edit config.yml in the /plugins/MobHealth/ folder you can find the following settings.

updateCheck true
Show notification of available updates.
doUpdate true
Update MobHealth automatically when new download is available.

Change doUpdate to false to stop any file download, and updateCheck to false to stop notices about new versions in your startup log.

Curse Mod Spotlight

Got API?

MobHealth now has 100% more API included!

You can trigger damage notifications, if your plugin adds skills or spells for example. And far more usefully - you can query MobHealth to get the current health and max health of any Mob, regardless of which plugin is responsible for tracking it.

Think of it as Vault for mob health levels ;) You code for one plugin - I sort out the mess behind the scenes.

See the API page for more info.

NEW healthbars!!

As frequently requested, MobHealth can now display health bars above Mobs, and a health counter for players.

PLEASE NOTE: If enabled - these bars show above ALL players / mobs, regardless of any toggle or permissions settings.

Enable this feature with the following flags in config:

showPlayerHeadHealth: true

Enables health counter display below player names.

usePercentForPlayer: true

Changes health counter from HP to a percentage of health left (recommended).

showMobHeadHealth: true

Enable health bars for all mobs.

useBarForMobs: true

If true, use a health bar in format of [||||||||||] if false, show in format of "10/20"

Compatible Plugins


You shouted for it - here it is, Epic Boss support.
Thanks to ThaH3lper for adding in an entire API for MobHealth.


If Spout-plugin is installed and the client uses SpoutCraft (and disableSpout is on its default false setting) then notification will be shown with the achievement notification (as seen above).


Exclusive to Imagicraft's Zombie Apocalypse RP (Zarp) server, ZombieMod creates several variaties of Zombie to terrorise players trying to survive in this post-apocalyptic server.


MobHealth now supports the Client Mod simple notice. Lets you show the messages elsewhere so your chat is spam free.
Thanks to FeildMaster for the pull request :)


Heroes health and levelled up HP's are reported correctly as are mobs whose health levels have been adjusted in the config. Use of a Heroes skill will trigger a notification when it damages.


Mobs adjustments to health are now tracked and reported in MobHealth.
Thanks to coldandtired for adding in MaxHealth and an API for me :)

Mob Arena

Bosses in a currently running Mob Arena report correct health and max-health. As do waves with a modified reduced health.
Thanks to garbagemule for adding MaxHealth to mob area for me.


MobHealth detects wandering bosses and correctly reports their health and name.
Thanks to bm01 and Erackron for integration help.

Monster Apocalypse (6.0b+)

If Monster Apocalypse is set to handle mob's health then these values are used for MobHealth.
Thanks to blainicus for answering my queries.


See MobHealth in action here...

Thanks to WoopaGaming for the video.


/MobHealth reload

Reloads current configuration.

/MobHealth toggle [player]

Toggle notifications. [player] is ignored via chat and mandatory via the console.


See the configuration page for full details.


See the permissions page for full details.

Source Code

Stats Collection

Like many bukkit plugins, Mobhealth utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to

  • A unique identifier
  • The server's version of Java
  • Whether the server is in offline or online mode
  • The plugin's version
  • The server's version
  • The OS version/name and architecture
  • The core count for the CPU
  • The number of players online
  • The Metrics version
  • The number of damage notices displayed (but not their content)

Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.


9.0.0: New ActionBar notifications.

8.3.0: Adds Rabbit, Endermite and Guardian mobs

8.2.2: Added fallback code for potential missing new methods.

8.2.1: Rollback gettextresource to get resources

8.2.0: Filter rogue &f colour code prefix's. Add scoreboard event (so it can be cancelled to preserve scoreboards).

8.0.1: Cleanup - removed unused class, update metrics to V7

8.0.0: Reworked Heroes integration. 1.7.2 compatibility fixes.

Read full change log here.


Github no longer allows a "downloads" section, so I no longer mirror files there. If you'd like to test beta/dev versions follow me on twitter and ask there! But understand such files would not yet be approved by BukkitDev staff.

Known Bugs/Conflicts

  • Plugins that alter mobs health levels usually return false health levels.
    The plugins listed above are supported.


Donations of any amount are, of course appreciated :)

Contributions go towards maintaining my development server to encourage continued development, MobHealth is solo coded by me, and supporting so many other plugin takes a fair bit of time. So if you think that time is worth something then Hit the dontae button in the top right of this page :)

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Kixot14 Kixot14 Aug 10, 2016 at 11:26 UTC - 0 likes

    @SableDnah: Go

    Please, add a little change to your plugin!

    1. Add decimal values for damage. Damage calculation very unaccuracy in this plugin! Take the example in HealthBar and CombatIndicator.

    2. Imposible to change player nickname (with %N placeholder). Always displayed in red color in action bar! [UPD]: Cause only when player in OP (maybe Essentials prefix or something else...)

    3. Add HP-placeholder to [playerLabel] and [playerLabelPercent] message string, for be able to add prefix and suffix to side of player health point. Now only suffix possible!

    4. Visible range for [playerLabel] and [playerLabelPercent].

    5. Divide %N placeholder separatedly for mobs and players. And add chatMessage for mobs and separated for players. Very need!

    6. When low HP, %H placeholder turn in red color. Can you remove that ??

    7. Add hide time, and visible not only when u looking for mob (As in the HealthBar).

    Need more customizations!!!

    Last edited Aug 12, 2016 by Kixot14
  • Avatar of SableDnah SableDnah Jul 31, 2016 at 09:43 UTC - 0 likes

    @ZwPBerserk: Go

    Mobhealth uses a scoreboard for player health, If you have featherboard you wont need that so disable it in mobhealth config and it'll disable the scoreboard.

    "All this technology and it still takes forever to get anywhere" [ Donate ] [ Twitter ]

    Mob HealthLegendQuest
    Mob Health: Simple damage reporting.LegendQuest: Complete RPG plugin.
  • Avatar of ZwPBerserk ZwPBerserk Jul 30, 2016 at 19:33 UTC - 0 likes


    This plugin is breaking my scoreboard plugin (featherboard).

    It removes the scoreboard on worldchange, or when i do: /heal or other things.

    When i remove mobhealth the issue is fixed.

  • Avatar of 789101112 789101112 Jul 19, 2016 at 15:54 UTC - 0 likes

    Thanks for this!!! I just replaced HealhBar with MobHealth, which seems way better!

  • Avatar of SableDnah SableDnah Jun 17, 2016 at 18:26 UTC - 0 likes

    @Keopha: Go

    Just done some rejigging of the packaging, can you try this one and see if it works

  • Avatar of SableDnah SableDnah Jun 17, 2016 at 18:03 UTC - 0 likes

    @Keopha: Go

    Could you open a ticket: And post full startup log if possible please. Also check folder permissions it looks like it cant create the startup files.

  • Avatar of Keopha Keopha Jun 17, 2016 at 17:51 UTC - 0 likes

    @SableDnah: Go

    Okay, i've got this :

    ([19:47:56] [Server thread/INFO]: [MobHealth] Enabling MobHealth v10.0.0 [19:47:56] [Server thread/ERROR]: Error occurred while enabling MobHealth v10.0.0 (Is it up to date?) java.lang.NullPointerException at [?:?] at [?:?] at [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at org.bukkit.plugin.SimplePluginManager.enablePlugin( [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at org.bukkit.craftbukkit.v1_10_R1.CraftServer.loadPlugin( [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at org.bukkit.craftbukkit.v1_10_R1.CraftServer.enablePlugins( [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at net.minecraft.server.v1_10_R1.MinecraftServer.t( [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at net.minecraft.server.v1_10_R1.MinecraftServer.l( [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at net.minecraft.server.v1_10_R1.MinecraftServer.a( [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at net.minecraft.server.v1_10_R1.DedicatedServer.init( [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at [craftbukkit-1.10.jar:git-Bukkit-10c10b3] at [?:1.8.0_72])

  • Avatar of SableDnah SableDnah Jun 17, 2016 at 16:09 UTC - 0 likes

    @Keopha: Go

    Ok that's worrying cause there should be a config.yml and a lang,yml file already there!

    Your gonna need to check your startup logs for any/all messages about MobHealth - somethings not running right.

  • Avatar of Keopha Keopha Jun 17, 2016 at 15:52 UTC - 0 likes

    @SableDnah: Go

    Hi, thanks for answering Mhh no there isn't "toggleStates.bin error" :/ I didn't even have the folder, I created it and also a file players.yml but it's still not working :(

  • Avatar of SableDnah SableDnah Jun 17, 2016 at 09:35 UTC - 0 likes

    @Keopha: Go

    Look at your console start up: Do you see "toggleStates.bin error" ? (its echoed to console not logs so may not show in logs).

    MH defaults to enabled for all, so not sure why - maybe permissions.

    Your error is a problem with saving your MH taggle status. first time its used it creates a players.yml file in the /plugins/MobHealth/ folder? Do you have this file? If not - create an empty one maybe you don't have permissions to create it.


Date created
Jan 10, 2012
Last update
Jun 18, 2016
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Reverse relationships
Recent files



Optional dependency