PerfTags
Chat tags with category GUI, in-game shop, personal tag creators, vouchers, animations and full PlaceholderAPI support.
Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – runs on Paper and Folia 1.21.x
• Tag GUI – browse, equip and buy tags with category sidebar and pagination
• Tag shop – sell tags for Vault, PlayerPoints or ExcellentEconomy
• Single-color tag creator – players redeem an item with /tags create (color) (name)
• Multicolor tag creator – full custom tags with & codes, hex, MiniMessage and gradients via /tags create (display)
• Tag vouchers – admin-given items that permanently unlock a tag on right-click
• Personal tags – owner-only tags created from creator items, with optional staff approval queue
• Animated tags – rotating MiniMessage frames for scoreboard and tab display
• Tag history & rollback – restore your previous equipped tag
• Newcomer mode – restrict new players to starter categories for a configurable period
• Default tag on join – auto-equip a tag when players first join
• AFK tag suffix – optional PlaceholderAPI-driven suffix while AFK
• Tab list formatting – show equipped tags in the tab list
• Discord webhooks – notify staff on shop purchases and tag creator redemptions
• Migration – import tags and player data from DeluxeTags, EternalTags, AlonsoTags and SupremeTags
• Cross-server sync – optional Redis cache invalidation across backends
• Oraxen & ItemsAdder icons – custom item icons for tags in the GUI
Placeholders
%perftags_tag% – active tag as legacy text with reset suffix
%perftags_tag_plain% – active tag as plain text without formatting
%perftags_tag_id% – active tag ID
%perftags_tag_mm% – active tag as MiniMessage including animation frames
Commands
/tags – Open the tag menu (perftags.use)
/tags clear – Remove your equipped tag (perftags.clear)
/tags set (tagId) – Equip a tag by ID (perftags.set)
/tags rollback – Restore your previous tag from history (perftags.rollback)
/tags create (color) (name) – Create a personal tag with a single-color creator item in main hand (perftags.createitem.use)
/tags create (display) – Create a personal tag with a multicolor creator item in main hand (perftags.createitem.use)
/perftags reload [tags] – Reload configs or tags.yml only (perftags.admin.reload)
/perftags help – Show admin command usage (perftags.admin)
/perftags create (id) (category) (display) – Create a server tag (perftags.admin.create)
/perftags delete (id) – Delete a tag (perftags.admin.delete)
/perftags set (player) (tagId|none) – Set or clear another player's tag (perftags.admin.setother)
/perftags list [category] – List tags in chat (perftags.admin.list)
/perftags edit (id) (field) (value) – Edit tag display, category, price, animation and more (perftags.admin.edit)
/perftags migrate (source) [flags] – Import from DeluxeTags, EternalTags, AlonsoTags or SupremeTags (perftags.admin.migrate)
/perftags givecreator (player) single|multi [amount] – Give a tag creator item (perftags.admin.givecreator)
/perftags voucher give (player) (tagId) [amount] – Give tag unlock vouchers (perftags.admin.voucher)
/perftags approve (tagId) – Approve a pending player-created tag (perftags.admin.approve)
/perftags reject (tagId) – Reject and delete a pending player-created tag (perftags.admin.reject)
/perftags pending – List tags awaiting approval (perftags.admin.pending)
Database
• SQLite (default)
• MySQL (configurable)
