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