HyroTags

🏷️ HyroTags — Advanced Title Tags, Fusion & Visual Auras

HyroTags is a modern, feature-rich title tag and badge ecosystem engineered specifically for Paper / Purpur (1.20 - 1.21.x) Minecraft servers. Beyond simple chat prefixes, HyroTags turns title tags into an engaging collection system featuring an Altar of Fusion, passive set buffs, secure 2-way trading, gacha crates, and dynamic particle auras!

---

✨ Features

🔮 1. Altar of Fusion (/tags fusion)

• Place 3 duplicate tag vouchers of the same rarity into the altar.
• Synthesize them into a brand-new voucher of the next higher rarity!
• Features custom anvil click sounds, enchanting particle bursts, and server-wide milestone announcements.

⚡ 2. Tag Sets & Passive EXP Buffs (/tags sets)

• Reward players for completing collections!
• Collecting all tags in a theme grants permanent passive boosts:
  • Elemental Set: +15% Player EXP
  • Royal Set: +20% Player EXP
  • Mythic Order Set: +30% Player EXP

🌌 3. Dynamic Particle Auras

• Equipping tags attaches elegant visual auras to the player's avatar.
• Includes: Double Helix, Blazing Flame Ring, Fairy Dust Halo, Love Hearts, and Dragon Breath.

🤝 4. Secure 2-Way Trading (/tags trade <player>)

• Trade tag vouchers safely with other players in a dual-window GUI.
• Built-in anti-scam protection: Any changes to offered items will automatically un-ready both players and trigger a 3-second confirmation lock.

🎰 5. Mystery Box Crate (/tags crate)

• Interactive gacha system with horizontal rolling animation and ticking sounds.
• Fully configurable drop rates (Common up to Mythic) with duplicate refund protection.

📜 6. Physical Vouchers & Style Customization

• Convert any tag into an authentic physical item voucher with persistent PDC data (/tags convert).
• Switch display borders on the fly: Square [TAG], Angle <TAG>, Star ✦ TAG ✦, or Minimalist.
• Full integration with Chat, Overhead Nametags, and Tablist.

---

⌨️ Commands & Permissions

Command	Permission	Description
/tags	hyrotags.use	Opens the main Tags & Badges GUI
/tags fusion	hyrotags.use	Opens the Altar of Fusion
/tags crate	hyrotags.use	Opens the Mystery Box Gacha menu
/tags trade <player>	hyrotags.use	Requests a secure 2-way tag trade
/tags sets	hyrotags.use	Views tag collections and passive buffs
/tags set <id> [player]	hyrotags.admin	Sets an active tag for a player
/tags clear [player]	hyrotags.admin	Clears active tag for a player
/tags reload	hyrotags.admin	Reloads configurations and tag catalog

Aliases: /ht, /htags, /tag, /badges, /badge

---

⚙️ Requirements & Installation

Requirements:

• Server Software: PaperMC or Purpur (1.20 - 1.21.x)
• Java Version: Java 21 or newer
• Required Dependency: HyroCore
• Optional Dependencies:
  • PlaceholderAPI (For %hyrotags_tag% placeholders)
  • ItemsAdder (For pixel texture badges and custom glyphs)

Quick Installation:

1. Ensure HyroCore.jar is installed in your server's plugins/ directory.
2. Download HyroTags.jar and place it in the plugins/ folder.
3. Restart your server.
4. Configure database options (SQLite or MySQL) and customize tag rarities in config.yml.