DamageIndicator
是否曾好奇过那把剑究竟造成了多少伤害?DamageIndicator 会在生物头顶显示飘出的伤害数值,以及其剩余的生命值。
✨ 功能特性
- 生物头顶显示 伤害,例如
-5❤ [15❤]
- 治疗 以另一种颜色显示,例如
+4❤ [19❤]
- 支持自定义带颜色、渐变和格式的 文本(MiniMessage),并包含占位符
{damage}、{heal}、{current}、{max}
- 可调节: 文本停留时间、大小、出现位置,支持整数或小数
- 黑名单: 不显示数值的生物列表(默认排除玩家)
- 尊重保护机制: 当 WorldGuard 或其他插件取消伤害时,不显示数字
- 兼容 Paper, Purpur, Spigot 和 Folia,Minecraft 1.19.4 – 26.3,一个 jar 包适用于所有平台
- 轻量级: 每次攻击仅生成一个短命的文本实体,不会随世界保存
📸 展示
-
伤害

-
治疗

📦 支持的版本
| 服务端 |
Minecraft |
| Paper |
1.19.4 – 26.3 |
| Purpur |
1.19.4 – 26.3 |
| Spigot |
1.19.4 – 26.3 |
| Folia |
1.19.4 – 26.3 |
📄 安装方法
- 下载 jar 文件(上述所有服务端和版本均使用同一个文件)
- 将其放入服务端的
plugins 文件夹中
- 重启服务器
仅需服务端安装,玩家无需安装任何内容。
⚙️ 配置
- 在
config.yml 中修改文本样式、停留时间、大小、位置以及黑名单。
- 文本格式使用 MiniMessage。占位符:
{damage}、{heal}、{current}、{max}。
- 命令消息位于
translations/<language>.properties 文件中。
- 修改后运行
/di reload。从旧版本更新?你的 config.yml 会自动更新,且保留原有设置。
📝 config.yml
############################
# Damage Indicator #
############################
# 修改任何设置后,请运行 /di reload。
# 插件设置
settings:
# 用于命令消息的语言文件,来自 translations 文件夹(例如 en_US)。
language: en_US
# 自定义生物受到伤害或治疗时在头顶显示的文本。
# 使用 MiniMessage: https://docs.papermc.io/adventure/minimessage/format/
text-format:
# 占位符:
# {damage} - 对生物造成的伤害量。
# {heal} - 生物获得的治疗量。
# {current} - 应用伤害或治疗后生物的当前生命值。
# {max} - 生物的最大生命值。
# 生物受到伤害时显示的文本。
damage: "<red>-{damage}❤ <aqua>[{current}❤]"
# 生物被治疗时显示的文本。
heal: "<green>+{heal}❤ <aqua>[{current}❤]"
# 文本显示持续的时间(单位:刻,1秒 = 20刻)。
display-duration: 10
# 显示文本中数字的格式。
# 选项:int(整数,向下取整,例如 5),double(小数,例如 5.25)
number-format: int
# 文本显示实体的设置。
text-display:
# 文本显示的比例(1.0 = 默认大小)。
scale: 1.0
# 文本面向玩家的方式。
# 选项:CENTER(始终面向玩家),VERTICAL(仅侧转),
# HORIZONTAL(仅上下倾斜),FIXED(从不转动)
billboard: CENTER
# 文本在生物头顶显示的位置。
text-location:
# 文本相对于生物头顶的垂直偏移量(单位:方块)。
vertical-offset: 0.5
# 文本围绕生物头顶显示的半径(单位:方块),
# 以防止快速攻击产生的数字重叠。
radius: 0.5
# 永不显示伤害或治疗指示器的实体类型(例如 PLAYER, VILLAGER, WOLF)。
# 名称参考:https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
# 盔甲架永远不会显示指示器。
blacklisted-entities:
- PLAYER
# 此文件的版本。DamageIndicator 使用它来自动更新旧配置文件
# (你的设置会被保留,旧文件会保存到备份文件夹中)。请勿修改此项。
config-version: 1.1.0
📚 命令与权限
| 命令 |
权限 |
描述 |
/di reload |
damageindicator.reload |
重新加载配置和消息(默认仅限操作员)。 |
❓ 常见问题
我从旧版本升级过来,我的设置会丢失吗?
不会。旧配置文件会自动更新,你的设置会被保留,并且备份会保存在 plugins/DamageIndicator/backup/ 中。
它能在 Spigot 和 Folia 上运行吗?
可以,从 1.1.0 版本开始支持。Paper 和 Purpur 也同样适用。
当玩家受到伤害时,我能看到数字吗?
可以。从 blacklisted-entities(黑名单实体)中移除 PLAYER,然后运行 /di reload。
如果服务器崩溃,会不会留下悬浮文字?
不会。从 1.1.0 版本开始,这些文字永远不会随世界一起保存,因此不会卡住。
在受保护区域内它会显示数字吗?
从 1.1.0 版本开始,不会。当 WorldGuard 或其他插件取消伤害或治疗时,将不显示任何内容。
💬 反馈
发现错误或有任何想法?请在 GitHub 上提交 Issue。
DamageIndicator
Ever wondered exactly how hard that sword hit? DamageIndicator shows the damage floating above the mob, with the health it has left.
✨ Features
- Damage above the mob's head, like
-5❤ [15❤]
- Healing in another colour, like
+4❤ [19❤]
- Your own text with colours, gradients and formatting (MiniMessage), and the placeholders
{damage}, {heal}, {current}, {max}
- Adjustable: how long the text stays, its size, where it appears, whole numbers or decimals
- Blacklist for mobs that shouldn't show numbers (players by default)
- Respects protection: no numbers when WorldGuard or another plugin cancels the damage
- Paper, Purpur, Spigot and Folia, Minecraft 1.19.4 – 26.3, one jar for all of them
- Lightweight: one short-lived text entity per hit, never saved with the world
📸 Showcase
-
Damage

-
Heal

📦 Supported Versions
| Server |
Minecraft |
| Paper |
1.19.4 – 26.3 |
| Purpur |
1.19.4 – 26.3 |
| Spigot |
1.19.4 – 26.3 |
| Folia |
1.19.4 – 26.3 |
📄 Installation
- Download the jar (the same file works on every server and version above)
- Put it in your server's
plugins folder
- Restart the server
Only the server needs it. Players don't install anything.
⚙️ Configuration
- Change the text, how long it stays, its size and position, and the blacklist in
config.yml.
- The text uses MiniMessage. Placeholders:
{damage}, {heal}, {current}, {max}.
- Command messages are in
translations/<language>.properties.
- Run
/di reload after changing anything. Updating from an older version? Your config.yml is updated automatically, with your settings kept.
📝 config.yml
############################
# Damage Indicator #
############################
# After changing anything, run /di reload.
# Plugin settings
settings:
# The language file to use for command messages, from the translations folder (e.g. en_US).
language: en_US
# Customize the damage and heal text displayed above mobs when they are damaged or healed.
# Uses MiniMessage: https://docs.papermc.io/adventure/minimessage/format/
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.
damage: "<red>-{damage}❤ <aqua>[{current}❤]"
# The text to display when a mob is healed.
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 (whole numbers, rounded down, e.g. 5), double (decimals, 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
# How the text turns to face the player.
# Options: CENTER (always faces the player), VERTICAL (turns sideways only),
# HORIZONTAL (tilts up and down only), FIXED (never turns)
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,
# so numbers from quick hits don't stack on top of each other.
radius: 0.5
# Entity types that never show damage or heal indicators (e.g. PLAYER, VILLAGER, WOLF).
# Names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
# Armor stands never show indicators.
blacklisted-entities:
- PLAYER
# The version of this file. DamageIndicator uses it to update older config files automatically
# (your settings are kept, and the old file is saved in the backup folder). Don't change it.
config-version: 1.1.0
📚 Commands & Permissions
| Command |
Permission |
Description |
/di reload |
damageindicator.reload |
Reload the config and messages (operators by default). |
❓ FAQ
I'm updating from an older version. Do I lose my settings?
No. Old config files are updated automatically, your settings are kept, and a backup is saved in plugins/DamageIndicator/backup/.
Does it work on Spigot and Folia?
Yes, from 1.1.0. Paper and Purpur work too.
Can I see numbers when players get hurt?
Yes. Remove PLAYER from blacklisted-entities and run /di reload.
Will it leave floating text behind if the server crashes?
No. From 1.1.0, the text is never saved with the world, so it can't get stuck.
Does it show numbers in protected areas?
From 1.1.0, no. When WorldGuard or another plugin cancels the damage or healing, nothing is shown.
💬 Feedback
Found a bug or have an idea? Open an issue on GitHub.
评论 0
登录后参与评分
还没有评论,来抢沙发吧