Minecraft-plugin DeluxeTags

🔌 About DeluxeTags

DeluxeTags is a Spigot Minecraft plugin that provides permission-based extra tags (prefixes) which players can unlock and switch between using an in-game GUI or commands. Tags are treated as an "extra prefix" and can be shown in chat, tab and other chat integrations through placeholders.

🎯 Purpose

DeluxeTags solves the problem of giving players optional, unlockable cosmetic tags separate from rank/group prefixes. It is useful for servers that want purchasable/unlockable or rewardable tags that players can enable or disable without changing their main group or rank.

⚙️ Features

• Permission-based tags: give access with deluxetags.tag.<identifier> (example shown in config as deluxetags.tag.example).
• Player GUI for browsing and selecting available tags.
• Commands to list, select and manage tags (player and admin commands documented by the project).
• PlaceholderAPI support and placeholders to insert active tag, identifier, description and count into chat formats.
• Configurable GUI items, names and pagination settings shown in the plugin configuration snippet.
• Options for loading a player's tag on join, chat formatting integration, and update checks.

🧩 Who It Is For

• Survival / SMP servers that want cosmetic, unlockable chat tags separate from rank prefixes.
• Servers that use permission plugins to grant cosmetic rewards (for example via LuckPerms).
• Admins who want a simple GUI-based tag selector for players.

🏗️ Example Use Cases

• Grant a VIP tag permission to a player as a purchasable cosmetic and allow them to toggle it via the tags GUI.
• An event reward grants a specific tag permission so winners can select the new tag from their available tags.
• Administrators create custom tags via commands and set which players can use them through permissions.

⌨️ Commands

Note: the project documentation confirms these commands; specific command permission nodes (other than the per-tag node pattern) are not listed in the primary source.

🔐 Permissions

The plugin uses permission nodes on a per-tag basis; other command-specific nodes are not explicitly documented in the main project files available.

⚙️ Installation

📥 Setup

• Download the plugin JAR from the project's Spigot resource or official build artifacts.
• Place the JAR into your server plugins/ folder.
• Start or restart the server and check the console to confirm the plugin loaded.

📦 Dependencies

• PlaceholderAPI — supported (plugin includes placeholders and a papi_chat option), listed in configuration and placeholder examples.

🧾 Configuration

• DeluxeTags uses a YAML configuration that defines tags, GUI settings and messages. The configuration includes examples for tag entries, GUI item settings, placeholders and chat format options. Common keys seen in the config: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 Technical Notes

• Project source is available in a public GitHub repository.
• The Spigot project lists tested Minecraft versions spanning from 1.8 through 1.21 and includes a specific 1.20.6 entry in the tested versions list.
• Development builds and CI artifacts are provided by the project's CI server.
• The repository does not show published releases on the source host; CI artifacts are available separately.

🤝 When This Plugin Is Useful

If you want players to have optional, permission-based cosmetic tags that they can enable via a GUI or commands without changing rank groups, DeluxeTags provides a straightforward, configurable solution with PlaceholderAPI integration for chat display.