Skip to content

Damage Display

The damage display feature shows floating damage numbers above entities when they take damage, similar to RPG games.

Enabling

/mh feature enable damage_display

Or in config.json:

{
  "damageDisplay": {
    "enabled": true
  }
}

How It Works

When an entity takes damage, a temporary floating text hologram spawns above the entity showing the damage amount. It disappears after exactly durationTicks.

  • Triggers on LivingDamageEvent (the damage after armor and absorption), after other mods have changed it
  • One popup per hit, shown to the players within 48 blocks when it spawns, with a small random sideways offset so numbers do not stack
  • Critical hits use criticalFormat: a player's critical hit (a vanilla jump critical, or one another mod forces through Forge's CriticalHitEvent) marks the target, and the damage that player deals to it in the same tick uses the critical format
  • At most 256 damage and healing popups exist at once; further ones are skipped until older ones expire
  • 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

{
  "damageDisplay": {
    "enabled": false,
    "showForPlayers": true,
    "showForMobs": true,
    "showZeroDamage": false,
    "durationTicks": 40,
    "heightOffset": 2.0,
    "format": "&c-{damage}",
    "criticalFormat": "&4&l-{damage}"
  }
}
Field Default Description
enabled false Enable/disable the feature
showForPlayers true Show damage numbers when players are hit
showForMobs true Show damage numbers when mobs are hit
showZeroDamage false Show numbers for hits that deal 0 damage (for example fully absorbed by absorption hearts)
durationTicks 40 How long the number stays visible, in ticks (40 = 2 seconds)
heightOffset 2.0 Height above the entity's feet where the number spawns; for an entity taller than this the number spawns 0.3 above its head instead
format &c-{damage} Text format for normal damage
criticalFormat &4&l-{damage} Text format for critical hits

Format Placeholders

Placeholder Description
{damage} The damage amount with one decimal (10.0, 3.5)

Format Examples

"format": "&c-{damage}"           // Red: -10.0
"format": "&c❤ -{damage}"         // Red heart: ❤ -10.0
"criticalFormat": "&4&l✦ {damage}"  // Bold dark red: ✦ 10.0

Examples

Minimal Setup

Only show damage on mobs (useful for RPG servers):

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

Long Duration

Keep numbers visible for 5 seconds:

{
  "damageDisplay": {
    "enabled": true,
    "durationTicks": 100
  }
}

Show All Damage

Including blocked/absorbed hits:

{
  "damageDisplay": {
    "enabled": true,
    "showZeroDamage": true,
    "format": "&c-{damage}",
    "criticalFormat": "&4&l-{damage}"
  }
}