文本描述
ModernTags 2.0
一款用于在玩家头颅上方显示自定义标签的现代插件
✨ 特性
| 🎨 完全自定义 | 配置标签外观:颜色、阴影、透明度、对齐方式、大小等 |
| 🎬 动画标签 | 支持多帧动画,并可配置动画速度 |
| 🖥️ 双渲染器 | 1.19.4+ 客户端使用 Text Display 实体,旧版本使用 Scoreboard Teams — 根据查看者自动选择 |
| 🔀 条件系统 | owner-conditions 和 viewer-conditions 允许您通过任意逻辑选择正确的标签组 |
| 🏆 优先级系统 | 标签组和条目按优先级排序;优先级最高的匹配项胜出 |
| 👁️ 查看者感知占位符 | {owner:key} 和 {viewer:key} 允许根据查看者的不同显示不同的内容 |
| 📌 PlaceholderAPI | 任何 PAPI 占位符均可开箱即用 |
| 👑 Vault 集成 | 自动从权限系统中插入前缀和后缀 |
| 🫥 潜行变暗 | 在 1.19.4+ 客户端上,蹲下的玩家标签会变暗,以匹配原版行为 |
| 🔗 TAB 兼容性 | ModernTags 内部管理 Scoreboard Teams — 无需禁用 TAB 的名称标签显示 |
⚡ 技术优势
该插件基于 PacketEvents 构建 —— 所有渲染均通过数据包完成,而非 Bukkit API。
通过 GikyMessage 构建组件减少了内存分配并加快了占位符替换速度。
完全支持 Folia 以及所有 Paper 分支(Paper、Purpur 等)。
🔧 配置示例
# config.yml
tags:
- priority: 0
entries:
- priority: 0
modern: tags/default.yml:<root>
legacy: tags/default-legacy.yml:<root>
- priority: 1
owner-conditions: "hasPermission('moderntags.tag.vip')"
entries:
- priority: 0
modern: tags/vip.yml:modern
legacy: tags/vip.yml:legacy
# tags/default.yml (现代模式 — Text Display, 1.19.4+)
frame-update-rate: -1
placeholders-update-rate: 10
frames:
- text: |-
{owner:prefix}&r{owner:name}{owner:suffix}
&c❤&f{owner:health}
shadowed: true
y-offset: 0.15
background-color: "#00000000"
# tags/default-legacy.yml (传统模式 — Scoreboard Teams, 低于 1.19.4)
frame-update-rate: -1
placeholders-update-rate: 10
preserve-player-name-color: true
frames:
- prefix: "{owner:prefix}"
name-color: "white"
suffix: "{owner:suffix}"
💬 命令与权限
命令
/moderntags reload— 重新加载插件配置 权限moderntags.see.own— 可见自己的标签moderntags.reload— 访问重载命令的权限
📦 依赖项
必需:
- PacketEvents 2.0+ 可选:
- PlaceholderAPI
- Vault
Text description
ModernTags 2.0
A modern plugin for displaying custom tags above player heads
✨ Features
| 🎨 Full Customization | Configure tag appearance: color, shadows, transparency, alignment, size and more |
| 🎬 Animated Tags | Support for multiple frames with configurable animation speed |
| 🖥️ Dual Renderer | Text Display entities for 1.19.4+ clients, Scoreboard Teams for older ones — picked automatically per viewer |
| 🔀 Condition System | owner-conditions and viewer-conditions let you select the right tag group with arbitrary logic |
| 🏆 Priority System | Tag groups and entries are sorted by priority; the highest-priority match wins |
| 👁️ Viewer-Aware Placeholders | {owner:key} and {viewer:key} let you show different content depending on who is looking |
| 📌 PlaceholderAPI | Any PAPI placeholder works out of the box |
| 👑 Vault Integration | Automatic insertion of prefixes and suffixes from permission systems |
| 🫥 Sneak Dimming | Tags fade for crouching players on 1.19.4+ clients, matching vanilla behavior |
| 🔗 TAB Compatibility | ModernTags manages Scoreboard Teams internally — no need to disable TAB's nametag display |
⚡ Technical Advantages
The plugin is built on PacketEvents — all rendering is done through packets, not Bukkit APIs.
Component building via GikyMessage reduces allocations and speeds up placeholder replacement.
Fully supports Folia and all Paper forks (Paper, Purpur, etc.).
🔧 Configuration Example
# config.yml
tags:
- priority: 0
entries:
- priority: 0
modern: tags/default.yml:<root>
legacy: tags/default-legacy.yml:<root>
- priority: 1
owner-conditions: "hasPermission('moderntags.tag.vip')"
entries:
- priority: 0
modern: tags/vip.yml:modern
legacy: tags/vip.yml:legacy
# tags/default.yml (modern — Text Display, 1.19.4+)
frame-update-rate: -1
placeholders-update-rate: 10
frames:
- text: |-
{owner:prefix}&r{owner:name}{owner:suffix}
&c❤&f{owner:health}
shadowed: true
y-offset: 0.15
background-color: "#00000000"
# tags/default-legacy.yml (legacy — Scoreboard Teams, below 1.19.4)
frame-update-rate: -1
placeholders-update-rate: 10
preserve-player-name-color: true
frames:
- prefix: "{owner:prefix}"
name-color: "white"
suffix: "{owner:suffix}"
💬 Commands & Permissions
Commands
/moderntags reload— reload plugin configuration Permissionsmoderntags.see.own— visibility of own tagmoderntags.reload— access to reload command
📦 Dependencies
Required:
- PacketEvents 2.0+ Optional:
- PlaceholderAPI
- Vault
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ModernTags
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
玩家头顶的名称标签:支持多行、多彩、动画效果,且对服务器性能占用极低。
ModernTags 会在每个玩家头顶显示一个标签,展示其头衔、名称、生命值或任何你想展示的内容。你只需在一个简单的配置文件中设置即可,无论玩家使用哪个 Minecraft 版本加入,都能看到这些标签。
对服务器性能友好
| 插件 | 50 名玩家时的内存负载 |
|---|---|
| ModernTags | 2.1 MB/s |
| UnlimitedNameTags | 63.6 MB/s |
使用 spark 分析器在相同测试条件下运行 5 分钟测得。更低的内存负载意味着繁忙服务器上更少的卡顿峰值。
- 不会向你的世界添加任何内容。 标签仅存在于玩家的屏幕上,因此不会为服务器增加需要跟踪的实体。
- 不会拖慢主服务器循环。 标签更新在后台运行,不会占用游戏运行的时间。
- 平滑的标签移动。 标签跟随玩家移动,无需频繁更新。
- 专为满员服务器设计。 旨在大量玩家在线时保持轻量级运行。
玩家所见
1.19.4 及更高版本的玩家 获得现代风格标签:
- 多行文本,支持任意颜色和渐变
- 可自定义大小、位置和对齐方式
- 支持背景、透明度和穿墙可见性
- 标签随玩家平滑移动
较低版本的玩家 获得经典风格标签:
- 前缀和后缀支持颜色与占位符
- 任意名称颜色
- 兼容发光插件
- 名称下方显示生命值或其他数值
你可以做什么
- 为不同玩家显示不同的标签。 通过权限、组、占位符值或查看者的游戏版本来选择标签。例如,捐赠者一种标签,管理员另一种标签。
- 为不同查看者显示不同的标签。 盟友和敌人可以看到同一玩家头顶的不同标签。
- 动画标签。 添加几个帧即可实现动画效果,如闪烁的渐变。
- 显示实时信息。 生命值、延迟(ping)、等级、公会或任何 PlaceholderAPI 占位符。
- 使用你的头衔系统。 前缀和后缀直接来自 LuckPerms 或 Vault。
- 保留其他插件。 TAB 和发光插件可与 ModernTags 共存,无需关闭任何功能,并保留发光颜色。
- 行为像普通名称标签一样。 当玩家潜行时标签会淡出,隐身或死亡时隐藏。观察者仍能看到隐身玩家的标签。
- 允许玩家看到自己的标签。 赋予
moderntags.see.own权限,例如用于第三人称视角。
个性化定制
标签使用与其他大多数插件相同的 & 颜色代码。
| 配置中写入 | 实际效果 |
|---|---|
&6Gold &eyellow &cred |
标准 Minecraft 颜色 |
7ffffAny hex color |
1600 万种颜色中的任意一种 |
[Gradient](gradient:#ff5555-#ffff55) |
任意两种颜色之间的渐变 |
$#7a2fd1Colored shadow |
任意阴影颜色 |
&c❤ &f{owner:health} |
玩家数据,如生命值 |
一个包含头衔、名称和生命值的两行标签如下所示:
&6★ {owner:prefix}&r&e{owner:name}{owner:suffix} &r&6★
&c❤&f{owner:health}
所有设置均位于纯文本配置文件中,注释提供英文和俄文说明。文档中包含现成的示例。
要求
- Paper 或其分支,版本 1.20 或更高(Spigot 也可用)
- Java 21
- PacketEvents 2.11 或更高版本,这是 ModernTags 所需的免费插件
- 可选:PlaceholderAPI、Vault、LuckPerms
安装
- 将 ModernTags 和 PacketEvents 的 jar 文件放入
plugins文件夹。 - 重启服务器。
- 编辑
plugins/ModernTags/config.yml以及tags文件夹中的文件。 - 运行
/moderntags reload以应用更改而无需重启。
命令与权限
| 命令 | 功能 |
|---|---|
/moderntags reload |
重新加载配置而无需重启 |
/moderntags update |
检查新版本并下载 |
| 权限 | 默认分配给 | 赋予的功能 |
|---|---|---|
moderntags.admin |
操作员 (Operators) | 使用插件命令 |
moderntags.see.own |
无 | 玩家可以看到自己的标签 |
更新与隐私
ModernTags 会在服务器启动时检查新版本。如果启用了自动下载,它还会下载更新并在下次重启时安装。该插件使用 bStats 收集匿名使用统计数据。如需关闭,请在 plugins/bStats/config.yml 中将 enabled 设置为 false。
链接
更新内容
- 内置更新管理。 ModernTags 可在启动时检查更新,并可选择自动下载。使用
/moderntags update可手动检查和下载更新,即使已禁用启动检查或自动下载功能。下载的文件将放置于服务器的更新文件夹中,并在服务器重启时安装。 - 旁观者模式下的隐形玩家标签。 处于旁观者模式(GM3)的观察者现在可以通过现代渲染器看到隐形玩家的标签,如同原版名称一样。这使得现代渲染器与 Minecraft 原版及旧版渲染器保持一致。普通观察者仍然无法看到隐形玩家的标签。
- 标准 bStats 指标。 添加了基本的使用统计数据。如需退出统计,请在共享配置文件
plugins/bStats/config.yml中设置enabled: false;ModernTags 没有单独的选项。
新增配置项
updates:
check: true
auto-download: false
启动检查默认启用。设置 auto-download: true 可在启动检查期间下载更新;但仍需重启服务器才能完成安装。无论是否启用自动下载,手动 update 命令均有效,但在启用自动下载时该命令会从 Tab 补全列表中隐藏。
权限变更: moderntags.admin 取代了 moderntags.reload,同时授予配置重载和更新下载的权限。默认情况下,操作员拥有此权限。如果你曾手动授予过旧权限,请将其替换为新权限。
错误修复
- 重载或死亡时无默认名称闪烁。 修复了在移除或重建现代标签时,原版玩家名称短暂闪现的问题。
- 旁观者可以看到其他旁观者的标签。 修复了旁观者标签对旁观者观察者不可见的问题;普通观察者仍无法看到这些标签。
- 旧版格式在隐身状态下得以保留。 修复了在玩家隐身期间进行重载后,前缀和后缀丢失的问题,包括隐身状态结束后仍未恢复的情况。
- 隐藏的旧版标签在更新期间保持隐藏。 共享文本和格式的更新不再向原本被隐藏的观察者暴露标签。
依赖项
- 为支持更新管理,已将 MyLib 更新至
7d2ccd9fd9。 - 添加了 bStats
3.2.1。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧