简介
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>)。
安装
- 将 jar 文件放入你的
plugins 文件夹中
- (推荐) 安装 PacketEvents 以实现平滑的标签和伤害指示器
- 启动服务器一次以生成
plugins/MobTag/config.yml
- 根据需要编辑配置文件
- 运行
/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 = 红色)
-----------------------------------------------
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>
About
MobTag displays a clean, fully customizable health tag above mobs — and optionally above players — whenever someone gets close enough to see it.
Tags are drawn client-side, so nothing is written to your world, nothing survives a restart, and every tag is rendered per player. Two people standing side by side can see different tags, or none at all. The update loop works outward from each player instead of scanning your worlds, so the cost scales with how many mobs are actually near someone — not with how many mobs your server is holding.
What's new in 2.1.0
- MiniMessage support — gradients and modern tags in every format, alongside
&-codes and hex
/mobtag toggle — flip your own tags without opening the menu
- Smarter hiding — at full health, out of combat, on invisible mobs, on vanished players, on NPCs and pets
- Damage stacking — repeated hits on the same mob roll into one running total, with a per-player cap
- Much faster — the update loop, health bars,
LOOKING_AT raycasts and damage indicators were all rewritten
- Plus a long list of fixes — hex colours, projectile damage numbers, riding mobs, per-player toggles in ArmorStand mode and more
Features
Display
- Two rendering backends — client-side text displays via PacketEvents (smooth, zero server entities) or invisible armor stands as a universal fallback.
AUTO picks the best one available
- Fully configurable tag format with colours, symbols, custom name and health bar
- Gradient health bar that shifts colour as the mob drops
- Per-entity-type formats — make bosses, or any mob you like, look different
- Per-entity-type height offsets — fine-tune tall and tiny mobs individually
- Configurable tag scale and display range
- Damage animations — tags flash and bounce on hit
Damage indicators
- Floating damage numbers with motion, fade-out and critical-hit formatting
- Works with melee, bows, crossbows, tridents, snowballs and splash potions
- Repeated hits on the same mob merge into one running total instead of stacking clutter
- Per-player cap so AoE attacks and grinders cannot flood a client
- Numbers spawn on the mob's surface facing the attacker, not buried inside the model
Visibility & filtering
- Visibility modes:
ALL, DAMAGER (only whoever last hit it) or LOOKING_AT (only what you are aiming at)
- Line-of-sight requirement for
LOOKING_AT — walls now block targeting
- DAMAGER timeout — how long a mob remembers who hit it
- Hide at full health and hide once a mob leaves combat
- Skip invisible mobs and vanished players (Essentials, CMI, SuperVanish, PremiumVanish)
- Skip NPCs and pets via a configurable metadata key list
- Ignore passive mobs — detected by behaviour, so modded and newly added animals are covered automatically
- Boss handling with a configurable extra-boss list (Warden and Elder Guardian included)
- World blacklist
Players
- Player health tags with their own format, range and height offset
- In-game settings menu — every player toggles mob tags, player tags and damage indicators for themselves
- Command toggles for the same three, no menu needed
- Preferences persist across restarts, saved in batches off the main thread
Integrations
- PlaceholderAPI — works inside tag formats and provides its own placeholders
- MythicMobs — custom format and internal mob names
- PacketEvents — smooth lag-free tags and damage indicators
- Floodgate / Geyser — Bedrock players get their own height offsets, since Geyser anchors tags differently
- MiniMessage when your server ships Adventure, with automatic fallback to legacy colours when it does not
Quality of life
- Drop-in upgrades — new config keys are merged in automatically, your settings are kept
- Crash recovery — leftover tag armor stands from an unclean shutdown are swept on startup
/mobtag admin debug — live tag counts, loop timing and hook status
- Update checker with console and in-game notices
Screenshots
Requirements
|
|
| Server |
Spigot, Paper or a fork — 1.21+ |
| Java |
17 or newer |
| Optional |
PacketEvents, PlaceholderAPI, MythicMobs, Floodgate |
Without PacketEvents, MobTag falls back to armor stands. Damage indicators and tag animations require PacketEvents.
Commands
| Command |
Permission |
Description |
/mobtag |
mobtag.toggle |
Opens the personal settings menu |
/mobtag toggle mobs |
mobtag.toggle |
Toggles mob health tags for yourself |
/mobtag toggle players |
mobtag.toggle |
Toggles player health tags for yourself |
/mobtag toggle damage |
mobtag.toggle |
Toggles damage indicators for yourself |
/mobtag admin reload |
mobtag.admin |
Reloads config.yml |
/mobtag admin debug |
mobtag.admin |
Tag counts, loop timing and hook status |
Permissions
| Permission |
Default |
Description |
mobtag.use |
everyone |
Required to run /mobtag at all |
mobtag.toggle |
everyone |
Settings menu and personal toggles |
mobtag.admin |
op |
Reload, debug and update notices on join |
PlaceholderAPI
PlaceholderAPI placeholders work inside your tag formats and are resolved per viewer. MobTag also provides its own:
| Placeholder |
Returns |
%mobtag_nearby_mob_health% |
Health of the nearest tagged mob |
%mobtag_nearby_mob_maxhealth% |
Its max health |
%mobtag_nearby_mob_percent% |
Its health percentage |
%mobtag_nearby_mob_bar% |
Its rendered health bar |
%mobtag_nearby_mob_name% |
Its name |
%mobtag_tags_hidden% |
Whether this player hid mob tags |
%mobtag_indicators_hidden% |
Whether this player hid damage indicators |
Tag placeholders & colours
{name} · {type} · {current} · {max} · {bar} · {percent} · {mythic_name}
Legacy &a codes, &#RRGGBB hex, and MiniMessage tags such as <gradient:#ff0000:#00ff00> all work.
Installation
- Drop the jar into your
plugins folder
- (Recommended) Install PacketEvents for smooth tags and damage indicators
- Start the server once to generate
plugins/MobTag/config.yml
- Edit the config to your liking
- Run
/mobtag admin reload to apply changes
Upgrading from 2.0.0 is drop-in. New config keys are merged into your existing config.yml automatically and your current settings are preserved.
config.yml
# ╔══════════════════════════════════════╗
# ║ MobTag Config ║
# ║ by Abood_8001 ║
# ╚══════════════════════════════════════╝
# Internal. Do not edit — MobTag uses this to merge in new options on update
# without touching the settings you already changed.
config-version: 2
# -----------------------------------------------
# GENERAL SETTINGS
# -----------------------------------------------
# Log the full stack trace when something goes wrong internally.
# Leave this off unless you are chasing a bug.
debug: false
# Worlds where MobTag will NOT display tags
blacklisted-worlds:
- example_world1
- example_world2
# How often (in ticks) the tags are updated.
# 1 second = 20 ticks. Lower = smoother but more CPU. Recommended: 4
update-interval: 4
# The range (in blocks) a player must be within to see a tag.
display-range: 16.0
# -----------------------------------------------
# TEXT FORMATTING
# -----------------------------------------------
# When enabled, formats written with MiniMessage tags (e.g. <gradient:#ff0000:#00ff00>)
# are rendered with MiniMessage. Requires a server that ships Adventure — on servers
# that do not, MobTag falls back to legacy codes automatically and nothing breaks.
# Legacy '&' codes and '&#RRGGBB' hex always work regardless of this setting.
use-minimessage: true
# -----------------------------------------------
# BEDROCK DETECTION (for Geyser/Floodgate servers)
# -----------------------------------------------
bedrock:
# Use Floodgate API to detect Bedrock players (recommended if installed)
use-floodgate: true
# Fallback: detect Bedrock players by username prefix
prefix: "."
# -----------------------------------------------
# DISPLAY MODE
# -----------------------------------------------
# Options:
# AUTO - Automatically uses PacketEvents if installed, ArmorStand otherwise
# ARMORSTAND - Always use ArmorStands (works everywhere)
# PACKET - Always use PacketEvents (smooth movement, requires PacketEvents plugin)
display-mode: AUTO
# ArmorStand mode only.
armorstand:
# Attach the tag to the mob as a real passenger. Motion becomes perfectly smooth,
# but tag-height-offset no longer applies (the client positions the tag itself) and
# the mob can no longer be ridden. Leave false to keep the classic behaviour.
ride-mob: false
# -----------------------------------------------
# VISIBILITY
# -----------------------------------------------
# Who can see the tags?
# ALL - All players within range see the tag
# DAMAGER - Only the player who last damaged the mob sees the tag
# LOOKING_AT - Only the player currently looking at the mob sees the tag
visibility-mode: ALL
# How far the LOOKING_AT ray reaches, in blocks.
looking-at-range: 5.0
# Require an unobstructed view in LOOKING_AT mode, so you cannot target
# a mob through a wall.
looking-at-requires-line-of-sight: true
# DAMAGER mode: stop showing the tag this many seconds after the last hit.
# Set to 0 to remember the damager forever.
damager-timeout-seconds: 30
# Ignore peaceful mobs (cows, pigs, sheep, etc)?
# Detected by mob behaviour, so modded and newly added animals are covered automatically.
ignore-passive: false
# Ignore player entities? Must be false for player-tags below to do anything.
ignore-players: true
# Should tags be shown on boss mobs (Ender Dragon, Wither)?
show-on-bosses: true
# Extra entity types to treat as bosses for the setting above.
extra-boss-types:
- WARDEN
- ELDER_GUARDIAN
# Hide the tag while the mob is on full health.
hide-at-full-health: false
# Hide the tag this many seconds after the mob was last damaged.
# Set to 0 to always show tags regardless of combat.
hide-after-seconds-out-of-combat: 0
# Do not tag mobs or players under an invisibility effect.
hide-on-invisible: true
# Do not tag players hidden by a vanish plugin (Essentials, CMI, SuperVanish, PremiumVanish).
hide-on-vanished: true
# Skip any entity carrying one of these metadata keys.
# Covers NPC and pet plugins — add your own as needed.
ignore-metadata:
- NPC
- shopkeeper
- citizens-npc
# -----------------------------------------------
# TAG POSITION AND SIZE
# -----------------------------------------------
# Height offset of the tag above the mob's head (in blocks).
# Bedrock players (via Geyser) often need a different offset.
tag-height-offset:
java: 0.3
bedrock: 0.0
# Per entity type overrides. Useful because the client anchors a packet tag to the
# mob's rider position, which sits at a different height on each mob.
per-type: {}
# ENDER_DRAGON: 1.5
# BEE: 0.1
# Size multiplier for packet-based tags (PACKET mode only).
# 1.0 = default, 0.5 = half size, 2.0 = double size.
tag-scale: 1.0
# -----------------------------------------------
# PLAYER TAGS
# -----------------------------------------------
# Show health tags above players too?
# (ignore-players above must be false for this to work)
player-tags:
enabled: false
# Separate format for player tags
format: "&c❤ &f{current}&7/&f{max}"
# Separate height offset for player tags
height-offset:
java: 0.3
bedrock: 0.0
# Separate display range for player tags (blocks)
display-range: 16.0
# -----------------------------------------------
# TAG FORMAT
# -----------------------------------------------
# Available placeholders:
# {name} - Mob's custom name (or type if no custom name)
# {type} - Mob entity type (e.g. ZOMBIE)
# {current} - Current health
# {max} - Max health
# {bar} - Health bar (see health-bar section below)
# {percent} - Health percentage (e.g. 75.0)
#
# Color codes: Use & followed by a color code (e.g. &c = red, &a = green)
# Hex colors: Use &#RRGGBB format (e.g. &#ff0000 = red)
# MiniMessage: <red>, <gradient:#ff0000:#0000ff>, ... when use-minimessage is on
# -----------------------------------------------
tag-format: "&c❤ &f{current}&7/&f{max}"
# -----------------------------------------------
# HEALTH BAR
# -----------------------------------------------
health-bar:
# Total number of characters in the bar
length: 10
# Character used for filled portion
filled-char: "█"
# Character used for empty portion
empty-char: "░"
# Color of the filled portion
# Supports gradient based on health percentage:
# Use 'gradient' to enable dynamic color
# Or set a fixed color like '&a'
filled-color: gradient
# Colors for gradient (used when filled-color: gradient)
# high = above 60% health
# medium = between 30% and 60%
# low = below 30%
gradient-high: "&a"
gradient-medium: "&e"
gradient-low: "&c"
# Color of the empty portion
empty-color: "&8"
# -----------------------------------------------
# MYTHICMOBS INTEGRATION
# -----------------------------------------------
mythicmobs:
# Enable MythicMobs support?
enabled: false
# Show the MythicMob's internal name instead of entity type?
show-mythic-name: true
# Custom format for MythicMob tags (leave empty to use global tag-format)
# Supports same placeholders as tag-format plus:
# {mythic_name} - The MythicMob's internal name
custom-format: "&5⚔ &f{mythic_name} &8| &c❤ &f{current}&7/&f{max} {bar}"
# -----------------------------------------------
# PLACEHOLDERAPI INTEGRATION
# -----------------------------------------------
placeholderapi:
# Enable PlaceholderAPI support?
enabled: true
# -----------------------------------------------
# PER ENTITY FORMATS
# -----------------------------------------------
# Override the global tag-format for specific entity types.
# Use the entity type name in CAPS (e.g. ZOMBIE, CREEPER, ENDER_DRAGON)
# Leave empty to use the global tag-format for all mobs.
# Supports all the same placeholders as 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]"
# -----------------------------------------------
# DAMAGE ANIMATION
# -----------------------------------------------
# Animate the tag when the mob takes damage (PACKET mode only).
damage-animation:
enabled: false
flash: false
scale-bounce: false
duration: 8
# -----------------------------------------------
# DAMAGE INDICATOR
# -----------------------------------------------
# Show floating damage numbers when a mob takes damage (PACKET mode only).
damage-indicator:
enabled: true
format: "&c-{damage}"
crit-format: "&d-{damage} ✸"
show-on-players: true
duration: 20
height-offset: -0.5
# Motion direction: UP, DOWN, FORWARD, RANDOM, NONE
# FORWARD = moves toward the player who hit the mob
motion: UP
# How far it travels over its lifetime (in blocks)
motion-distance: 1.0
# Fade out towards the end of its lifetime?
fade-out: true
# Repeated hits on the same mob within this many ticks stack into one running
# total instead of spawning a new number each time. Set to 0 to disable merging.
merge-window-ticks: 10
# Hard cap on how many damage numbers a single player can see at once.
# Stops AoE attacks and grinders from flooding the client.
max-per-player: 24
# -----------------------------------------------
# UPDATE CHECKER
# -----------------------------------------------
update-checker: true
# -----------------------------------------------
# MESSAGES
# -----------------------------------------------
messages:
prefix: "&8[&bMobTag&8] "
reload-success: "&aConfiguration reloaded successfully!"
no-permission: "&cYou don't have permission to do that."
unknown-command: "&cUnknown sub-command. Usage: /mobtag admin reload"
players-only: "&cOnly players can use that."
toggle-on: "&a{feature} enabled."
toggle-off: "&c{feature} disabled."
Metrics
MobTag uses bStats to collect anonymous usage statistics. You can opt out at any time in plugins/bStats/config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧