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
  Permissions
• moderntags.see.own — visibility of own tag
• moderntags.reload — access to reload command

📦 Dependencies

Required:

• PacketEvents 2.0+
  Optional:
• PlaceholderAPI
• Vault