Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for PunJarrr

Display mob's health change (damage/heal) as a hologram.

Report DamageIndicator_?

Damage Indicator

paper purpur modrinth spigot hangar github

A lightweight Minecraft plugin that displays floating damage and heal indicators above entities when they take damage or recover health.

✨ Features

  • Shows damage dealt as floating text above the entity's head
  • Shows healing received with a distinct color
  • Fully customizable text format using MiniMessage
  • Configurable number format — integer or precise decimal
  • Configurable display duration, scale, and billboard mode
  • Blacklist specific entity types from showing indicators
  • Lightweight and performance-friendly

⚙️ Configuration

  • All settings are configurable in config.yml.
  • All messages are fully customizable in translation files using MiniMessage format.
############################
#     Damage Indicator     #
############################

# Plugin settings
settings:
  # The language file to use from the /lang folder (e.g. en_US).
  language: en_US

  # Customize the damage and heal text displayed above mobs when they are damaged or healed.
  text-format:
    # Placeholders:
    # {damage} - The amount of damage dealt to the mob.
    # {heal} - The amount of healing received by the mob.
    # {current} - The mob's current health after the damage or heal is applied.
    # {max} - The mob's maximum health.

    # The text to display when a mob is damaged. Use {damage} to show the damage amount.
    damage: "<red>-{damage}❤<aqua>[{current}❤]"
    # The text to display when a mob is healed. Use {heal} to show the heal amount.
    heal: "<green>+{heal}❤<aqua>[{current}❤]"

  # The duration (in ticks) that the text will be displayed (1 second = 20 ticks).
  display-duration: 10

  # The format used for numbers in the displayed text.
  # Options: int (e.g. 5), double (e.g. 5.25)
  number-format: int

  # Settings for the text display entity.
  text-display:
    # The scale of the text display (1.0 = default size).
    scale: 1.0
    # The billboard mode of the text display.
    # Options: CENTER (always faces the player), VERTICAL (rotates only on the Y-axis)
    billboard: CENTER

  # The location where the text will be displayed above the mob's head.
  text-location:
    # The vertical offset (in blocks) from the mob's head where the text will be displayed.
    vertical-offset: 0.5
    # The radius (in blocks) around the mob's head where the text will be displayed.
    radius: 0.5

  # The list of entities that are blacklisted from showing damage or heal indicators.
  blacklisted-entities:
    - PLAYER

# Leave this option alone unless you know what you're doing.
# Changing this value may cause unexpected issues!
config-version: 1.0.0

📚 Commands & Permissions

Command Permission Description
/damageindicator reload damageindicator.reload Reload the configuration.

Aliases: /di reload

Information

CategoryMiscellaneous
Published onMay 14, 2026
LicenseMIT
Downloads0
Stars0
Watchers0

Pinned Versions

Members