Skip to content

Healing Display

The healing display feature shows floating green numbers above entities when they heal, complementing the Damage Display.

Enabling

/mh feature enable healing_display

Or in config.json:

{
  "healingDisplay": {
    "enabled": true
  }
}

How It Works

When an entity heals, a temporary floating text hologram spawns above them showing the heal amount. The hologram automatically disappears after a configurable duration.

  • Triggers on LivingHealEvent
  • Skips entities already at max health (prevents spam from natural regen)
  • Shows to all nearby players
  • Temporary holograms are not persisted

Configuration

{
  "healingDisplay": {
    "enabled": false,
    "showForPlayers": true,
    "showForMobs": false,
    "durationTicks": 40,
    "heightOffset": 2.0,
    "format": "&a+{healing}"
  }
}
Field Default Description
enabled false Enable/disable the feature
showForPlayers true Show heal numbers for players
showForMobs false Show heal numbers for mobs
durationTicks 40 How long the number stays visible (40 = 2 seconds)
heightOffset 2.0 Height above entity
format &a+{healing} Text format

Format Placeholders

Placeholder Description
{healing} The heal amount

Format Examples

"format": "&a+{healing}"          // Green: +5
"format": "&a❤ +{healing}"        // Green heart: ❤ +5
"format": "&2&l+{healing} HP"     // Bold dark green: +5 HP

Examples

Players Only (Default)

{
  "healingDisplay": {
    "enabled": true,
    "showForPlayers": true,
    "showForMobs": false
  }
}

All Entities

{
  "healingDisplay": {
    "enabled": true,
    "showForPlayers": true,
    "showForMobs": true
  }
}

Combining with Damage Display

Both features work independently and can be enabled together:

{
  "damageDisplay": {
    "enabled": true,
    "format": "&c-{damage}",
    "criticalFormat": "&4&l-{damage}"
  },
  "healingDisplay": {
    "enabled": true,
    "format": "&a+{healing}"
  }
}

This creates a full combat feedback system with red damage numbers and green heal numbers.