DamageIndicator

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.

# 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

📚 Commands & Permissions

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

Aliases: /di reload