ModernTags 2.0 — Dual Renderer & Condition System

⚠️ Breaking change: the configuration format has been completely reworked and is incompatible with previous versions. Please delete your existing config and reconfigure the plugin using the updated documentation.

---

What's changed

Dual renderer — support for all client versions

Added a Scoreboard Teams renderer for clients below 1.19.4. The plugin automatically selects the appropriate renderer per viewer: Text Display for 1.19.4+ clients, Scoreboard Teams for older ones.

TAB compatibility

ModernTags now manages Scoreboard Teams internally, eliminating the need to disable TAB's nametag handling.

Tags in separate files

Tags are now defined in dedicated files referenced from config.yml, each optionally containing both modern and legacy sections.

Condition system

Replaced the moderntags.tag.<name> permission model with owner-conditions and viewer-conditions — arbitrary expressions evaluated per owner and per viewer respectively.

Viewer-aware placeholders

Placeholder syntax updated from <placeholder:key> to {owner:key} / {viewer:key}, enabling per-viewer tag content.

Sneak dimming

Tags now dim when the owner is sneaking on 1.19.4+ clients, consistent with vanilla behavior.

Permission changes

Removed moderntags.tag.<name> and moderntags.see.other. Tag selection is now fully driven by the condition system.

v1.0.1 – Initial Release

🎉 Version 1.0.1

This release adds legacy server compatibility and support for Folia, improving multithreaded server performance while keeping all features of ModernTags intact.

✨ Changes & Improvements

• Legacy Compatibility – Replaced isTrackedBy with getTrackedPlayers().contains(player) for servers older than 1.21.5
• Folia Support – All asynchronous tasks now run through AsyncScheduler instead of Bukkit’s async methods, enabling Folia compatibility

ModernTags v1.0.0 - Initial Release

🎉 Initial Release

The first stable release of ModernTags - a modern plugin for displaying custom tags above player heads using Text Display entities.

✨ Features

• Customizable Tags - Full control over tag appearance including colors, shadows, transparency, alignment, and size
• Animated Tags - Support for multiple frames with configurable transition rates
• Priority System - Automatic tag selection based on player permissions with priority ranking
• PlaceholderAPI Integration - Support for any PAPI placeholders
• Vault Integration - Automatic prefix and suffix insertion from permission plugins
• Asynchronous Processing - Fully asynchronous operation in Netty threads via PacketEvents
• High Performance - In-memory caching for fast access during repeated operations

📋 Requirements

• Minecraft 1.19.4+
• Paper, Purpur or Paper forks
• PacketEvents 2.0+

📦 Optional Dependencies

• PlaceholderAPI - for using placeholders from other plugins
• Vault - for working with prefixes and suffixes

📝 Commands & Permissions

Commands:

• /moderntags - Reload plugin configuration

Permissions:

• moderntags.tag.<name> - Permission to use specific tag (auto-generated)
• moderntags.see.own - See own tag
• moderntags.see.other - See other players' tags
• moderntags.reload - Access to reload command