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. It disappears after exactly durationTicks.

  • Triggers on LivingHealEvent, after other mods have changed it; cancelled heals show nothing
  • Shows the health actually restored: never more than the entity was missing, so a heal at full health shows nothing
  • A player's natural regeneration (from food and saturation, and on Peaceful) shows nothing, so players do not get a stream of small numbers; potions, golden apples and other heals do show
  • Shown to the players within 48 blocks when it spawns, with a small random sideways offset
  • Shares the limit of 256 active popups with the damage display
  • Popups are not saved (a restart or /mh reload clears them)

To keep the feature on, set enabled in config.json; /mh feature enable only lasts until the next reload or restart.

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, in ticks (40 = 2 seconds)
heightOffset 2.0 Height above the entity's feet; for an entity taller than this the number spawns 0.3 above its head instead
format &a+{healing} Text format

Format Placeholders

Placeholder Description
{healing} The health restored, with one decimal (5.0, 0.5)

Format Examples

"format": "&a+{healing}"          // Green: +5.0
"format": "&a❤ +{healing}"        // Green heart: ❤ +5.0
"format": "&2&l+{healing} HP"     // Bold dark green: +5.0 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.