Minecraft plugin SupremeTags

🔌 About SupremeTags

SupremeTags is a Minecraft plugin that gives servers a permission-based tag system so players can choose and display custom tags in chat, the tab list and scoreboards. The plugin emphasizes configurable tag presentation (variants, rarities and effects), a GUI editor for players/admins and integration points for common server extensions.

🎯 Purpose

SupremeTags solves the problem of limited or static player titles by providing a flexible, permission-driven tagging system that can be sold, earned, or assigned. It is useful for servers that want cosmetic player tags with economy integration, placeholder support, and runtime configuration via an in-game GUI.

⚙️ Features

• Permission-based tags and category system.
• In-game GUI editor for browsing, selecting and managing tags.
• Personal tags, animated tags and tag variants.
• Buyable tags, tag vouchers, favourites and sorting/filtering.
• Tag rarities and visual "effects" for tags.
• Custom placeholders and built-in placeholders (e.g. %tag%, %description%, %rarity%, %effects%).
• PlaceholderAPI support and a dedicated %supremetags_*% placeholder set.
• Vault integration and support for multiple economy plugins.
• Optional integration with ProtocolLib and PacketEvents for advanced display features.
• HeadDatabase and ItemsAdder support for item/head-based tag icons.
• Developer API for extending or reading tag data.

🧩 Who It Is For

• Small to large public servers that want a configurable cosmetic tag system.
• Survival / SMP servers that monetize or reward cosmetic tags.
• Servers using PlaceholderAPI, economy plugins and Vault integrations.

🏗️ Example Use Cases

• An admin creates buyable tags and sells them via the server economy.
• Players select animated or RGB tags from an in-game GUI and display them in chat and tab.
• A plugin or script checks %supremetags_has_access_% to grant behaviour based on tag ownership.

🔐 Permissions

Each tag and category also defines its own permission nodes in the plugin's configuration.

⚙️ Installation

📥 Setup

• Download the official plugin JAR and place it in your server plugins/ directory.
• Ensure required dependencies are present, then start or restart the server.
• Check the server console for plugin startup messages to confirm the plugin loaded.

📦 Dependencies

• NBTAPI — required.
• Vault — integration for economy features (listed as dependency).
• PlaceholderAPI — for placeholder support.
• ProtocolLib — optional (not required) for advanced packet/display features.
• PacketEvents — optional (not required) alternative for packet handling.

🧠 Technical Notes

• Provides built-in placeholders and explicit PlaceholderAPI placeholders such as %supremetags_tag%, %supremetags_identifier%, %supremetags_description%, and checks like %supremetags_has_access_<identifier>%.
• The plugin lists official support/testing across many Minecraft versions (including legacy and modern series); server admins should use the build that matches their server runtime.
• The plugin exposes an API for developers and integrates with common cosmetic/item plugins for richer tag icons.

🤝 When This Plugin Is Useful

If you need a configurable, permission-driven tagging system with GUI management, economy and placeholder integration for players to display custom titles or cosmetics across chat, tab and scoreboards, SupremeTags provides the confirmed building blocks to implement that on a Spigot-based server.