HoloMobHealth

## About It's frustrating when you can't see how much health your opponent has left. Well, now you can! With HoloMobHealth, you can customize how you would like to display mob health above its head! ## Videos **Want video demonstrations? Here are some videos made by some awesome people!** Video by [**ServerMiner**](https://www.youtube.com/channel/UCmK95YYh_5uRqSfopXhUNLQ) in English: Video by **[SirBukkit](https://www.youtube.com/watch?v=NYJRB34RW64&feature=youtu.be)** in German: ## Features **First of all, it won't affect your death messages or mob names!** **The health display is only CLIENT-SIDE!** ***So that death message filled with hearts won't happen!*** ## 1. Display health above all mob's head - Well obviously, this is the point of the plugin, here is a few pictures!  ## 2. Customize your own mob health display design - The plugin provides multiple different placeholders for you to customize your display, for example you can choose round health to nearest integer, or 2 decimal places, or display the mob's name!  ## 3. Support hearts display ❤ - If you like to use hearts instead of text, you can! Just put the corresponding placeholder {ScaledSymbols} in the config!  ## 4. Damage Indicators! *[1.11 or above]* - Show health gain and loses with tiny numbers around the mob! - You can hide damage indicators in certain regions through flags if you use [WorldGuard](https://www.enginehub.org/worldguard/) *[v7]*.  ## 5. Completely client-side! No mobs are changed - The health display is only visual, meaning that the mob's actual name isn't changed on the server. - If you want to not let the health display override named mobs, or want health display to display alongside the mob's name, you can do that all in the config! ## 6. Custom placeholder scripts - Yes! You can create _your own placeholders_ through the use of _JavaScript_ - More info on that below ## 7. Languages and Mob types - All of course! You will be able to change all the text that is sent to players to your liking to suit your server. - Entity type names will be translated to the language of each user's client language! - Villager professions and Tropical Fish types are also identified by the plugin! ## 8. Blacklist any mobs - Blacklist any mob type from being affected by the health display - Blacklist any mob with a certain name - Blacklist any mob with a name that contains a certain text ## 9. Dynamic health display - You can toggle the plugin to only display mob health when it is attacked or taking damage in the config! ## 10. Supports RGB and Font *[1.16 or above]* You can use RGB code in any part of the config that support colors! ``` &x&F&F&F&F&F&F ``` or ``` [color=#ffffff] ``` If you have a custom resource pack that has different fonts, you can even use them like color codes! ``` [font=myawesomefont] ``` ## 11. Compatibility with other plugins - You can disable health display for mobs from [**MyPet**](https://www.spigotmc.org/resources/mypet.12725/), [**Citizens**](https://www.spigotmc.org/resources/13811/), [**MythicMobs**](https://www.mythicmobs.net/index.php) (Partly) and [**Shopkeeper**](https://dev.bukkit.org/projects/shopkeepers) in the config! - [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) placeholders can be used as well! - If you have other plugins you want to be supported, tell me in the discussions! ## Supported Plugins - [MythicMobs](https://www.mythicmobs.net/index.php) *(Only Partly)* - [Citizens](https://www.spigotmc.org/resources/citizens.13811/) *(Except Player Mob Types)* - [Shopkeepers](https://www.spigotmc.org/resources/shopkeepers.80756/) - [MyPet](https://wiki.mypet-plugin.de/) - [ModelEngine](https://www.spigotmc.org/resources/conxeptworks-model-engine%E2%80%94ultimate-custom-entity-model-manager-1-16-5-1-19-3.79477/) *(Partially, Experimental)* - [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) - [WorldGuard](https://www.enginehub.org/worldguard/) *(Requires at least v7)* ## Dependencies - [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/) or [PacketEvents](https://modrinth.com/plugin/packetevents)+[Module](https://modrinth.com/plugin/holomobhealth-packetevents) *(Please install the latest version that is compatible with your server version)* ## Installation 1. Put HoloMobHealth.jar into the plugins folder along with the required dependencies 2. Start the server 3. *Edit the config (if you need to)* 4. *Restart the server (if you changed something in the config in step 3)* ## Development Builds  **[Jenkins](https://ci.loohpjames.com/job/HoloMobHealth/)** ## Placeholder Scripts In HoloMobHealth, you can define **_your own custom placeholders_** through the use of _**JavaScripts**_, here is an example: **[Take me to the example](https://github.com/LOOHP/HoloMobHealth/blob/master/src/main/resources/placeholder_scripts/VerticalStripedSymbols.js)** **Showcase Server** Want to give the plugin a try? ``` IP: mc.loohpjames.com ```  ## Commands /holomobhealth reload - Reloads the plugin (or /hmh reload) /holomobhealth update - Check for updates (or /hmh update) /holomobhealth toggle - Toggle mob health display for yourself (or /hmh toggle) ## Permissions ```yaml permissions: holomobhealth.reload: description: Allows you to reload the plugin default: op holomobhealth.use: description: Allows you to see the health display default: true holomobhealth.toggle: description: Allows you to toggle health display for yourself default: true holomobhealth.toggle.others: description: Allows you to toggle health display for others default: op holomobhealth.update: description: Allows you to recieve update notifications default: op ``` ## Default Config **[Latest Config with Descriptions](https://github.com/LOOHP/HoloMobHealth/blob/master/common/src/main/resources/config.yml)** ## Limitations - AlwaysShow doesn't work in 1.8 due to a Minecraft bug - Multi-Line IS NOT SUPPORTED on 1.8 - 1.9.4 - Mobs disguised as the player mob type will not have its health shown as player names and mob names are handled differently ## Data usage Usage statistics at https://bstats.org/plugin/bukkit/InteractiveChat will be visible to the public with your server included in the statistics. No private information of your server is sent. Update checking is also done via https://api.loohpjames.com to notify you whenever a new version is released. No private information of your server is sent.