MobTag

插件

· 作者 Abood_8001

在生物上方显示生命值标签 | 完全可配置 | 支持 PAPI 和 MythicMobs

0 本站下载 0 关注 更新于 2 个月前

最新 2.1.0 · 26.2 · Paper / Purpur

一键开服(送7天)

简介

MobTag 会在实体(包括可选的玩家)靠近到可见范围时,在其上方显示一个简洁且完全可自定义的生命值标签。

标签是在客户端绘制的,因此不会写入你的世界数据,重启后也不会保留,且每个标签都是针对每位玩家单独渲染的。并排站立的两个人可能看到不同的标签,或者都看不到任何标签。更新循环从每位玩家向外辐射工作,而不是扫描整个世界的实体,因此性能开销取决于实际接近某人的实体数量——而非服务器中持有的实体总数。

2.1.0 新增内容

  • MiniMessage 支持 — 支持渐变和现代标签格式,同时兼容 & 代码和十六进制颜色
  • /mobtag toggle — 无需打开菜单即可切换你自己的标签显示
  • 更智能的隐藏逻辑 — 在满血、脱离战斗、隐形实体、消失状态玩家、NPC 和宠物身上自动隐藏
  • 伤害叠加 — 对同一实体的连续攻击会合并为一个持续累加的伤害值,并设有每位玩家的独立上限
  • 大幅提升性能 — 重新编写了更新循环、生命值条、LOOKING_AT 射线检测以及伤害指示器
  • 此外还修复了大量问题,包括:十六进制颜色、投射物伤害数字、骑乘实体、ArmorStand 模式下的玩家独立开关等

功能特性

显示效果

  • 两种渲染后端 — 通过 PacketEvents 实现纯客户端文本显示(流畅且无服务端实体),或作为通用回退方案使用不可见的盔甲架。AUTO 模式会自动选择可用的最佳方案
  • 完全可配置的标签格式 — 包含颜色、符号、自定义名称和生命值条
  • 渐变生命值条 — 随着实体生命值降低而改变颜色
  • 按实体类型定制格式 — 可以让 Boss 或你喜欢的任何实体拥有独特的外观
  • 按实体类型调整高度偏移 — 可单独微调高大或微小的实体位置
  • 可配置的标签缩放比例和显示范围
  • 伤害动画 — 受到攻击时标签会闪烁和弹跳

伤害指示器

  • 带有运动轨迹、淡出效果和暴击格式的浮动伤害数字
  • 支持近战、弓、弩、三叉戟、雪球和喷溅药水造成的伤害
  • 对同一实体的多次命中会合并为一个累计总值,避免杂乱堆积
  • 每位玩家独立上限 — 防止 AOE 攻击或刷怪机导致客户端信息过载
  • 伤害数字生成于实体表面并朝向攻击者,不会嵌入模型内部

可见性与过滤

  • 可见性模式: ALL(所有)、DAMAGER(仅最后攻击者)或 LOOKING_AT(仅当前瞄准目标)
  • LOOKING_AT 模式的视线要求 — 墙壁现在可以阻挡瞄准
  • DAMAGER 超时设置 — 设定实体记住攻击者的时长
  • 满血时隐藏 和 实体脱离战斗后隐藏
  • 跳过隐形实体和消失状态玩家(支持 Essentials, CMI, SuperVanish, PremiumVanish)
  • 跳过 NPC 和宠物 — 通过可配置的中继键列表实现
  • 忽略被动型实体 — 基于行为检测,自动覆盖模组添加的新动物
  • Boss 处理 — 支持可配置的高级 Boss 列表(已包含 Warden 和 Elder Guardian)
  • 世界黑名单

玩家相关

  • 玩家生命值标签 — 拥有独立的格式、范围和高度偏移
  • 游戏内设置菜单 — 每位玩家可以分别为自己切换实体标签、玩家标签和伤害指示器
  • 命令开关 — 无需菜单即可直接切换上述三项功能
  • 偏好设置会在重启间持久保存,并在后台线程批量存储

集成支持

  • PlaceholderAPI — 可在标签格式内部使用 并且 提供其专属占位符
  • MythicMobs — 支持自定义格式和内部实体名称
  • PacketEvents — 提供流畅无卡顿的标签和伤害指示器
  • Floodgate / Geyser — Bedrock 玩家拥有独立的高度偏移,因为 Geyser 锚定标签的方式不同
  • MiniMessage — 当服务器搭载 Adventure API 时使用;若无则自动回退到传统颜色代码

用户体验优化

  • 无缝升级 — 新的配置项会自动合并,你的原有设置会被保留
  • 崩溃恢复 — 非正常关闭遗留下来的标签盔甲架会在启动时被清理
  • /mobtag admin debug — 实时查看标签计数、循环耗时和钩子状态
  • 更新检查器 — 提供控制台通知和游戏内提示

截图

依赖要求

服务端 Spigot、Paper 或其分支 —— 1.21+
Java 版本 17 或更高
可选依赖 PacketEvents, PlaceholderAPI, MythicMobs, Floodgate

若未安装 PacketEvents,MobTag 将回退至使用盔甲架。伤害指示器和标签动画功能需要 PacketEvents。

命令

命令 权限节点 描述
/mobtag mobtag.toggle 打开个人设置菜单
/mobtag toggle mobs mobtag.toggle 切换你自己的实体生命值标签
/mobtag toggle players mobtag.toggle 切换你自己的玩家生命值标签
/mobtag toggle damage mobtag.toggle 切换你自己的伤害指示器
/mobtag admin reload mobtag.admin 重载 config.yml
/mobtag admin debug mobtag.admin 查看标签计数、循环耗时和钩子状态

权限节点

权限节点 默认分配 描述
mobtag.use 所有人 运行 /mobtag 所必需
mobtag.toggle 所有人 设置菜单和个人开关功能
mobtag.admin op 重载、调试及加入时的更新通知

PlaceholderAPI

PlaceholderAPI 占位符可以在你的标签格式内部使用,并按观察者解析。MobTag 同时也提供了自己的占位符:

占位符 返回值
%mobtag_nearby_mob_health% 最近的可标记实体的当前生命值
%mobtag_nearby_mob_maxhealth% 其最大生命值
%mobtag_nearby_mob_percent% 其生命值百分比
%mobtag_nearby_mob_bar% 其渲染的生命值条
%mobtag_nearby_mob_name% 其名称
%mobtag_tags_hidden% 该玩家是否隐藏了实体标签
%mobtag_indicators_hidden% 该玩家是否隐藏了伤害指示器

标签占位符与颜色

{name} · {type} · {current} · {max} · {bar} · {percent} · {mythic_name}

支持 Legacy &a 代码、&#RRGGBB 十六进制颜色以及 MiniMessage 标签(例如 <gradient:#ff0000:#00ff00>)。

安装

  1. 将 jar 文件放入你的 plugins 文件夹中
  2. (推荐) 安装 PacketEvents 以实现平滑的标签和伤害指示器
  3. 启动服务器一次以生成 plugins/MobTag/config.yml
  4. 根据需要编辑配置文件
  5. 运行 /mobtag admin reload 应用更改

从 2.0.0 升级可直接替换。 新的配置键会自动合并到你现有的 config.yml 中,并且会保留你当前的设置。

config.yml
# ╔══════════════════════════════════════╗
# ║           MobTag Config              ║
# ║        by Abood_8001                 ║
# ╚══════════════════════════════════════╝

# 内部使用。请勿修改 —— MobTag 使用此字段在更新时合并新选项,
# 而不会触碰你已经修改过的设置。
config-version: 2

# -----------------------------------------------
# 常规设置
# -----------------------------------------------

# 当内部出现问题时记录完整的堆栈跟踪。
# 除非你在排查 bug,否则请保持关闭。
debug: false

# MobTag 不会显示标签的世界列表
blacklisted-worlds:
  - example_world1
  - example_world2

# 标签更新的频率(以刻为单位)。
# 1 秒 = 20 刻。数值越低越流畅但更耗 CPU。推荐值:4
update-interval: 4

# 玩家必须处于多少方块范围内才能看到标签。
display-range: 16.0

# -----------------------------------------------
# 文本格式化
# -----------------------------------------------
# 启用后,使用 MiniMessage 标签编写的格式(例如 <gradient:#ff0000:#00ff00>)
# 将通过 MiniMessage 渲染。需要搭载 Adventure 库的服务器——在不搭载的服务器上,
# MobTag 会自动回退到 Legacy 代码,且不会导致任何问题。
# 无论此设置如何,Legacy '&' 代码和 '&#RRGGBB' 十六进制颜色始终有效。
use-minimessage: true

# -----------------------------------------------
# Bedrock 检测(适用于 Geyser/Floodgate 服务器)
# -----------------------------------------------
bedrock:
  # 使用 Floodgate API 检测 Bedrock 玩家(如果已安装则推荐)
  use-floodgate: true
  # 备选方案:通过用户名前缀检测 Bedrock 玩家
  prefix: "."

# -----------------------------------------------
# 显示模式
# -----------------------------------------------
# 选项:
#   AUTO        - 如果安装了 PacketEvents 则自动使用它,否则使用 ArmorStand
#   ARMORSTAND  - 始终使用 ArmorStands(处处可用)
#   PACKET      - 始终使用 PacketEvents(移动平滑,需要 PacketEvents 插件)
display-mode: AUTO

# 仅在 ArmorStand 模式下生效。
armorstand:
  # 将标签附加为实体的真实乘客。运动变得完美平滑,
  # 但 tag-height-offset 不再适用(客户端自行定位标签),
  # 且实体无法再被骑乘。设为 false 以保持经典行为。
  ride-mob: false

# -----------------------------------------------
# 可见性
# -----------------------------------------------
# 谁可以看到标签?
#   ALL        - 范围内的所有玩家都能看到标签
#   DAMAGER    - 只有最后攻击该实体的玩家能看到标签
#   LOOKING_AT - 只有当前正看着该实体的玩家能看到标签
visibility-mode: ALL

# LOOKING_AT 模式下射线探测的范围,以方块为单位。
looking-at-range: 5.0

# 在 LOOKING_AT 模式下要求视线无遮挡,防止你透过墙壁瞄准实体。
looking-at-requires-line-of-sight: true

# DAMAGER 模式:距离最后一次受击多少秒后停止显示标签。
# 设为 0 表示永久记住攻击者。
damager-timeout-seconds: 30

# 是否忽略被动型实体(牛、猪、羊等)?
# 通过实体行为进行检测,因此自动涵盖模组添加的新动物。
ignore-passive: false

# 是否忽略玩家实体?下方的 player-tags 功能必须将此设为 false 才能生效。
ignore-players: true

# 是否在 Boss 级实体(末影龙、凋灵)上显示标签?
show-on-bosses: true

# 额外视为 Boss 的实体类型,用于上述设置。
extra-boss-types:
  - WARDEN
  - ELDER_GUARDIAN

# 当实体满血时隐藏标签。
hide-at-full-health: false

# 在实体最后一次受击多少秒后隐藏标签。
# 设为 0 表示无论战斗状态如何都始终显示标签。
hide-after-seconds-out-of-combat: 0

# 不要对处于隐身效果下的实体或玩家打标签。
hide-on-invisible: true

# 不要对通过 vanish 插件隐藏的玩家打标签(Essentials, CMI, SuperVanish, PremiumVanish)。
hide-on-vanished: true

# 跳过携带以下元数据键的任何实体。
# 覆盖 NPC 和宠物插件——根据需要自行添加。
ignore-metadata:
  - NPC
  - shopkeeper
  - citizens-npc

# -----------------------------------------------
# 标签位置和大小
# -----------------------------------------------
# 标签相对于实体头顶的高度偏移量(以方块为单位)。
# Bedrock 玩家(通过 Geyser)通常需要不同的偏移量。
tag-height-offset:
  java: 0.3
  bedrock: 0.0
  # 按实体类型的覆盖设置。很有用,因为客户端将数据包标签锚定在
  # 实体的骑乘者位置,而该位置在不同实体上的高度不同。
  per-type: {}
  #  ENDER_DRAGON: 1.5
  #  BEE: 0.1

# 基于数据包的标签的大小倍数(仅限 PACKET 模式)。
# 1.0 = 默认,0.5 = 一半大小,2.0 = 双倍大小。
tag-scale: 1.0

# -----------------------------------------------
# 玩家标签
# -----------------------------------------------
# 是否也在玩家头顶显示生命值标签?
# (上方的 ignore-players 必须设为 false 才能生效)
player-tags:
  enabled: false
  # 玩家标签的单独格式
  format: "&c❤ &f{current}&7/&f{max}"
  # 玩家标签的单独高度偏移
  height-offset:
    java: 0.3
    bedrock: 0.0
  # 玩家标签的单独显示范围(方块)
  display-range: 16.0

-----------------------------------------------

标签格式

-----------------------------------------------

可用的占位符:

{name} - 生物自定义名称(若无自定义名称则为类型)

{type} - 生物实体类型(例如 ZOMBIE)

{current} - 当前生命值

{max} - 最大生命值

{bar} - 生命条(详见下方的 health-bar 部分)

{percent} - 生命值百分比(例如 75.0)

颜色代码:使用 & 后跟颜色代码(例如 &c = 红色,&a = 绿色)

十六进制颜色:使用 &#RRGGBB 格式(例如 &#ff0000 = 红色)

MiniMessage:当 use-minimessage 开启时使用 <red>, gradient:#ff0000:#0000ff 等

-----------------------------------------------

tag-format: "&c❤ &f{current}&7/&f{max}"

-----------------------------------------------

生命条

-----------------------------------------------

health-bar:

生命条中的字符总数

length: 10

用于填充部分的字符

filled-char: "█"

用于空白部分的字符

empty-char: "░"

填充部分的颜色

支持基于生命值百分比的渐变:

使用 'gradient' 启用动态颜色

或设置固定颜色如 '&a'

filled-color: gradient

渐变的颜色(仅在 filled-color: gradient 时生效)

high = 生命值高于 60%

medium = 生命值在 30% 到 60% 之间

low = 生命值低于 30%

gradient-high: "&a" gradient-medium: "&e" gradient-low: "&c"

空白部分的颜色

empty-color: "&8"

-----------------------------------------------

MythicMobs 集成

-----------------------------------------------

mythicmobs:

是否启用 MythicMobs 支持?

enabled: false

是否显示 MythicMob 的内部名称而不是实体类型?

show-mythic-name: true

MythicMob 标签的自定义格式(留空则使用全局 tag-format)

支持与 tag-format 相同的占位符,此外还包括:

{mythic_name} - MythicMob 的内部名称

custom-format: "&5⚔ &f{mythic_name} &8| &c❤ &f{current}&7/&f{max} {bar}"

-----------------------------------------------

PlaceholderAPI 集成

-----------------------------------------------

placeholderapi:

是否启用 PlaceholderAPI 支持?

enabled: true

-----------------------------------------------

按实体分类的格式

-----------------------------------------------

为特定实体类型覆盖全局 tag-format。

使用大写的实体类型名称(例如 ZOMBIE, CREEPER, ENDER_DRAGON)

留空则对所有生物使用全局 tag-format。

支持与 tag-format 相同的所有占位符。

entity-formats: ENDER_DRAGON: "&5❤ &f{current}&7/&f{max} &7| {bar} &5[Dragon]" WITHER: "&8❤ &f{current}&7/&f{max} &7| {bar} &8[Wither]"

-----------------------------------------------

伤害动画

-----------------------------------------------

当生物受到伤害时动画化标签(仅 PACKET 模式)。

damage-animation: enabled: false flash: false scale-bounce: false duration: 8

-----------------------------------------------

伤害指示器

-----------------------------------------------

当生物受到伤害时显示浮动的伤害数字(仅 PACKET 模式)。

damage-indicator: enabled: true format: "&c-{damage}" crit-format: "&d-{damage} ✸" show-on-players: true duration: 20 height-offset: -0.5

运动方向:UP, DOWN, FORWARD, RANDOM, NONE

FORWARD = 向攻击该生物的玩家移动

motion: UP

在其生命周期内移动的距离(以方块为单位)

motion-distance: 1.0

是否在生命周期结束时淡出?

fade-out: true

在此时间间隔内对同一生物的重复命中将合并为一个累计总额

而不是每次生成一个新的数字。设置为 0 以禁用合并。

merge-window-ticks: 10

单个玩家同时可见的伤害数字上限。

防止范围攻击和刷怪机导致客户端过载。

max-per-player: 24

-----------------------------------------------

更新检查器

-----------------------------------------------

update-checker: true

-----------------------------------------------

消息

-----------------------------------------------

messages: prefix: "&8[&bMobTag&8] " reload-success: "&a配置已成功重载!" no-permission: "&c你没有权限执行此操作。" unknown-command: "&c未知子命令。用法:/mobtag admin reload" players-only: "&c只有玩家可以使用此命令。" toggle-on: "&a{feature} 已启用。" toggle-off: "&c{feature} 已禁用。"


</details>

## 指标统计

MobTag 使用 [bStats](https://bstats.org/) 收集匿名使用统计数据。你可以在 `plugins/bStats/config.yml` 中随时选择退出。

<div align="center">

**如果你喜欢这个插件,请留下评论!**

源代码:[github.com/Abood8001/MobTag](https://github.com/Abood8001/MobTag)

</div>

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源