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
```yaml
# config.yml
tags:
- priority: 0
entries:
- priority: 0
modern: tags/default.yml:
legacy: tags/default-legacy.yml:
- priority: 1
owner-conditions: "hasPermission('moderntags.tag.vip')"
entries:
- priority: 0
modern: tags/vip.yml:modern
legacy: tags/vip.yml:legacy
```
```yaml
# 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"
```
```yaml
# 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
**Permissions**
- `moderntags.see.own` — visibility of own tag
- `moderntags.reload` — access to reload command
---
## ? Dependencies
**Required:**
- [PacketEvents](https://modrinth.com/plugin/packetevents) 2.0+
**Optional:**
- [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
- [Vault](https://www.spigotmc.org/resources/vault.34315/)
暂无评论，抢个沙发吧~