Description
Gallery
Changelog
Versions
SUPREME TAGS v3.0
The Ultimate Modern Custom Title & Tag System for Minecraft Servers
Give your players full expression over their chat, tab list, and scoreboards with custom, animated, and interactive tags.
SupremeTags delivers premium features out of the box, 100% free with no limitations.
WHY CHOOSE SUPREMETAGS?
Most tag plugins rely on static text, tedious file editing, and basic permissions. See how SupremeTags stacks up against standard alternatives:
| Feature / Capability | SupremeTags | Other Tag Plugins |
|---|---|---|
| Interactive Online Web Editor | ✅ | ❌ |
| In-Game GUI Tag & Config Editor | ✅ | ❌ |
| Personal / Player-Created Custom Tags | ✅ | ❌ |
| Banned Words Filtering for Personal Tags | ✅ | ❌ |
| Tag Variants & Multi-Style Unlocks | ✅ | Maybe |
| Tag Name-Wrappers (Player Formatting) | ✅ | ❌ |
| Tag-Specific Custom Placeholders | ✅ | ❌ |
| Animated Tags | ✅ | ❌ |
| Tag Visual Effects, Particles & Trails | ✅ | ❌ |
| Tag Favorites & Fast-Equip System | ✅ | ❌ |
| Tag Sorting (Alphabetical, Rarity, Ownership) | ✅ | Rarely |
| Physical Redeemable Tag Vouchers | ✅ | Rarely |
| Buyable Tags with Multi-Economy Support | ✅ | Limited |
| Custom Item Support (ItemsAdder, Nexo, Oraxen, HDB, CraftEngine) | ✅ | Limited |
| Custom Tag Rarities & Categories | ✅ | Rarely |
| Per-Group Tag Ownership Limits | ✅ | ❌ |
| CustomTag Admin Overrides (No Direct Permissions Needed) | ✅ | ❌ |
| Dialog UI & Bedrock / Geyser Compatibility | ✅ | ❌ |
| Subdirectory / Multi-File Organization | ✅ | ❌ |
| Built-in Developer API & Event Hooks | ✅ | Limited |
| Native Folia & Paper Threading Optimization | ✅ | Mixed |
| Pricing & Licensing | ✅ 100% Free (No Paywall) | Often Paid / Locked |
UNMATCHED INTEGRATIONS & COMPATIBILITY
Custom Item Plugins Supported for GUI Icons
- HeadDatabase —
hdb-<id> - ItemsAdder —
itemsadder-<id> - Nexo —
nexo-<id> - Oraxen —
oraxen-<id> - CraftEngine —
craftengine-<id> - SimpleItemGenerator —
sid-<id>
Supported Dependencies
- Vault — Required for economy functions
- PlaceholderAPI — Required for placeholders
- ProtocolLib & PacketEvents — Supported for advanced packet handling
- Chat Plugins — Supports
{tag}and the PlaceholderAPI expansion
PLACEHOLDERS & PERMISSIONS
Click to view Built-in & PlaceholderAPI Placeholders
Chat / Built-In Placeholders
| Placeholder | Description |
|---|---|
%tag% |
Displays selected tag |
%description% |
Tag description |
%rarity% |
Tag rarity label |
%effects% |
Active tag effects |
%category% |
Tag category name |
%cost% |
Purchase price of tag |
%tags_amount% |
Total tags in category |
%page% |
Current active menu page |
PlaceholderAPI
All PlaceholderAPI placeholders use the %supremetags_...% format.
| Placeholder | Description |
|---|---|
%supremetags_tag% |
Active formatted tag |
%supremetags_identifier% |
Identifier string |
%supremetags_description% |
Description string |
%supremetags_permission% |
Tag permission string |
%supremetags_category% |
Category identifier |
%supremetags_cost% |
Purchase cost |
%supremetags_rarity% |
Associated rarity |
%supremetags_effects% |
Associated effects |
%supremetags_tags_amount% |
Total unlocked tags count |
%supremetags_hastag_selected% |
Returns true / false |
%supremetags_hastag_tags% |
Returns true / false if player has any tags |
%supremetags_has_access_<identifier>% |
Returns true / false for a specific tag |
Note: For chat plugins such as EssentialsX, use
{tag}.
Click to view Permissions
supremetags.player
supremetags.admin
supremetags.withdraw
supremetags.search
supremetags.mytags
supremetags.mytags.limit.<group>
supremetags.voucher.[identifier]| Permission | Description |
|---|---|
supremetags.player |
Access to player commands (/tags) |
supremetags.admin |
Full administrative access |
supremetags.withdraw |
Convert tags to vouchers |
supremetags.search |
Search through available tags in the GUI |
supremetags.mytags |
Access to the personal tag view |
supremetags.mytags.limit.<group> |
Set custom tag ownership limits per group |
supremetags.voucher.[identifier] |
Permission to redeem specific tag vouchers |
Each tag and category also supports individual custom permissions defined in their respective YAML files.
💬 NEED SUPPORT OR HAVE A FEATURE REQUEST?
Join our community on Discord for fast support, update announcements, and suggestions!
All Versions
+ Add Version
[3.0.4] SupremeTags 3.0.4
by ScapeHelp on Oct 15, 2026
Download
Many fixes & Web Editor improvements v2
- Full log found here: [[github....log]](https://github.com/ScapeCodes/SupremeTags/releases/tag/3.0.4)**
[3.0.3] SupremeTags 3.0.3
by ScapeHelp on Oct 15, 2026
Download
Many fixes & Web Editor improvements.
- Full log found here: [github....log](https://github.com/ScapeCodes/SupremeTags/releases/tag/3.0.3)**
[3.0.2] SupremeTags 3.0.2
by ScapeHelp on Oct 15, 2026
Download
_Many fixes & introducing a brand new tag feature!_
- Full log found here: [github....log](https://github.com/ScapeCodes/SupremeTags/releases/tag/3.0.2)**
[3.0.1] SupremeTags 3.0.1
by ScapeHelp on Oct 15, 2026
Download
- Fixed**
- Confirm Menu not properly loading all items from configuration.
[3.0.0] SupremeTags 3.0.0
by ScapeHelp on Oct 15, 2026
Download
# Welcome to v3! A new beginnings for SupremeTags.
- Full log found here: [github....log](https://github.com/ScapeCodes/SupremeTags/releases/tag/3.0.0)**
[2.2.9] SupremeTags 2.2.9
by ScapeHelp on Oct 15, 2026
Download
- Added** ability to save tags to the database instead of YAML files. The
settings.db-only-tagsoption inconfig.ymlwill use thedata.ymlstorage type.
- Added** ability to edit tag vouchers inside the Tag Editor.
- Improved** menu click safety to prevent errors from empty slots or clicks outside plugin inventories.
- Improved** fallback handling for invalid or missing materials in menu and voucher configurations.
- Improved** safety for missing optional configuration sections.
- Fixed** Folia scheduler compatibility for features introduced in 2.2.7 and 2.2.8.
- Fixed** invalid CraftEngine item IDs causing menu item creation errors.
- Fixed** PlaceholderAPI and packet placeholder errors when players are offline or cannot be resolved.
- Fixed** data cache settings not properly syncing between servers.
- Fixed** file syncing not working properly.
- Fixed** merge issues.
[2.2.8] SupremeTags 2.2.8
by ScapeHelp on Oct 15, 2026
Download
- Added** Velocity File syncing, add
settings.proxy-file-syncing: true
- Added** auto-apply, this enables auto displayname & tab for tag display.
- Added** new commands & command changes:
- /tags move <tag> <new folder/file location>
- /tags seteveryone <new tag>
- /tags reseteveryone
- confirmation to delete/reseteveryone/seteveryone/move.
- Improved** Tag Editor to edit new settings/options and QOL toggles/confirmations/click-to-cycle/undo history action.
- Fixed** All/Any hard-coded messages that were missed, please regenerate messages.yml or see github resources to compare.
[2.2.7] SupremeTags 2.2.7
by ScapeHelp on Oct 15, 2026
Download
- Updated/Fixed** EssentialsX Hook.
[2.2.6] SupremeTags 2.2.6
by ScapeHelp on Oct 15, 2026
Download
## Update 26.2
This update massively reduces the JAR file size from **6 MB to approximately 3 MB**.
> [!IMPORTANT]
> If you see unexpected bold messages, this is caused by changes to how colors are handled in this update. Add
> [!WARNING]
> This update includes new content in
``
> [!NOTE]
> This update contains new **beta features**. Please report any issues you encounter.
This update massively reduces the JAR file size from **6 MB to approximately 3 MB**.
> [!IMPORTANT]
> If you see unexpected bold messages, this is caused by changes to how colors are handled in this update. Add
&r inside your prefix to reset the bold formatting.> [!WARNING]
> This update includes new content in
config.yml, guis.yml, and messages.yml. **Please update or regenerate these files.**- Added** a complete Personal Tags overhaul, including tag credits, requirements, a Personal Tags menu hub, and a browsing menu for personal tags.
- Added** confirmation menus for voucher redemption, tag selection, and tag purchases. This includes three new settings in
config.yml.
- Added** page placeholders for menu titles:
%page%%max_pages%
- Added** Personal Tag creation requirements for minimum server age and playtime, with an administrator and operator bypass.
- Added** an output type option for placeholders. Reset
config.yml, or add the following option to each placeholder configuration:
``
yaml
output: 'legacy' # Available options: 'minimessage', 'legacy'
`
This resolves issues with MiniMessage formatting.
- Added** tag statistics tracking, including:
- Total selections
- Unique users
- Active users
- First and last selection times
- Per-player usage
- Added**
, new statistics placeholders, and GUI sorting options for popularity and recently used tags.
- Added** the
XItemFlag` model to XSeries for backwards compatibility with item flags.- Updated** the confirmation menu to display additional information explaining why an action is being confirmed or denied.
- Fixed** EssentialsX hook errors.
> [!NOTE]
> This update contains new **beta features**. Please report any issues you encounter.
[2.2.5] SupremeTags 2.2.5
by ScapeHelp on Oct 15, 2026
Download
- Introducing** Requirements! A built-in unlocking feature for extended progression. **(BETA)**
- Added** null checkers for tag values to prevent future null errors, all features should be optional now.
- Changes** to DIALOG UI:
> Fixed short length issue in tag style dialog box.
- Fixed** null error for rarity value in EditorMenu.
- Fixed** error when PlaceholderAPI is not installed.
- Fixed** some minor errors tracked by faststats.
[2.2.4] SupremeTags 2.2.4
by ScapeHelp on Oct 15, 2026
Download
- _2.2.5 will be the Progression & Unlock update for Tags! Stay turned..._**
- Added** FastStats Support, Gives me more feedback & plugin information than BStats.
- Fixed** some minor issues.
[2.2.3] SupremeTags 2.2.3
by ScapeHelp on Oct 15, 2026
Download
- Improved** Overall framework handling & animated-tag rebuilding **[Reduced CPU Usage]**
- Added** CraftEngine Support! Use
craftengine-<id>inside of the material values.
[2.2.2] SupremeTags 2.2.2
by ScapeHelp on Oct 15, 2026
Download
- Added** empty tags anvil item to tag menus.
- Fixed** items returning as NAME_TAG when the
display-itemis set.
- Fixed** tags duplicating.
- Fixed** custom placeholder lookups to use the tag’s real source config.
- Fixed** normal tag editing appending new tag text instead of replacing it.
- Fixed** path matching for tag config files in ConfigManager so nested
- Fixed** PlaceholderAPI
identifierresponse to return the actual variant identifier when a variant is active.
[2.2.1] SupremeTags 2.2.1
by ScapeHelp on Oct 15, 2026
Download
- Added** Silent argument to both set and reset commands, just put "-s" at the end of the commands.
[2.2.0] SupremeTags 2.2.0
by ScapeHelp on Oct 15, 2026
Download
- _Here's the update a lot of people have been waiting for! Massive changes/features/fixes to the plugin._**
- Added** Multi-file and subdirectory support for tags (Thanks to @AndresCS20)
- Added** Player Tag Showcase Menu (View all certain player's owned tags)
- Added** Group based tag requirement [permission based untouched]
- Added** DIALOG as a search type, use
search: 'DIALOG'inconfig.yml/settings.search
- Added** Brand new config editor! fresh new configuration menu editor and is more simpler and efficient.
- Fixed** Several database issues.
- Fixed** MYSQL bug where cache data was not getting saved (SYNCING ISSUE)
- Fixed** Search
ANVILtype not working.
- Fixed** Various performance issues across the plugin (Paper/Spigot & folia)
- Fixed** Favourites item not working in variants menu.
- Fixed** Many other minor issues.
[2.1.20] SupremeTags 2.1.20
by ScapeHelp on Oct 15, 2026
Download
- Hot-Fixed** colliding cache keys preventing data to save for CustomTags & display incorrectly.
- Updated** some dependencies.
[2.1.19] SupremeTags 2.1.19
by ScapeHelp on Oct 15, 2026
Download
- Recoded/Reworked** of placeholder handling & tag handling, should fix displaying issues.
- Fixed** customtag displaying issues inside of GUI.
[2.1.18] SupremeTags 2.1.18
by ScapeHelp on Oct 15, 2026
Download
- Fixed** placeholders not showing correct returns.
[2.1.17] SupremeTags 2.1.17
by ScapeHelp on Oct 15, 2026
Download
- This update contains config changes/additions, please check them at:**
- Updated** to support 26.1.1/26.1.2 (Thanks to @Snewmy)
- Updated** all dependencies to latest.
- Changed** COINSENGINE to EXCELLENTECONOMY.
- Added** slots option for categories (Thanks to @Snewmy)
- Added** more support for lower versions on new editor menus.
- Added** favourites system.
- Added** built-in dialog UI for personal-tag creation (enable/disable)
- Added** category editor section, you can now edit categories in-game.
- Updated** all outdated editor menus to be consistant overall layout/design.
- Added** CustomTag admin feature! this feature allows admins to assign custom tag to a player without the need of creating a tag itself.
Added Offline fallback support with SkinRestorer.
- Fixed** personal tags not be re-assigned on join.
- Fixed** personal tags giving null error.
- Fixed** invalid usernames throwing null error, will give a simple error message and a default playerhead.
- Fixed** voucher item not using its
voucher-itemcustom-model-data value.
- Fixed** config generating issues.
- Fixed** command null error on incomplete arguments (now will output the usage message)
- Fixed** null set player argument in "/tags set" command.
- Fixed** Variant displayname/lore not applying placeholders.
- Fixed** edit command arguments not auto suggesting other data.
[2.1.16] SupremeTags 2.1.16
by ScapeHelp on Oct 15, 2026
Download
- Fixed** Variant next & back buttons not working as intended.
[2.1.15] SupremeTags 2.1.15
by ScapeHelp on Oct 15, 2026
Download
- Added** custom-model-data edit per variant.
- Fixed** new variants configuration from 2.1.14 not working properly.
[2.1.14] SupremeTags 2.1.14
by ScapeHelp on Oct 15, 2026
Download
- Updated** PlaceholderAPI to 2.11.7.
- Updated** XSeries being more included for more lower version support.
- Improved** Debug command (Config checkers / errors checkers / tag validators)
- Added** Animated tags now work in tag menus.
- Added** %filter% / %sort% replacements to be editable.
- Added** locked/unlocked item edits per variant.
- Added** new economy type "CUSTOM"
- Added** %filter% / %sort% replacements to be editable.
- Fixed** anvil type not working for search.
- Fixed** big menu performance issue, resulting in high cpu usage. (Massive Improvement)
- Fixed** inventoryview on lower versions.
- Fixed** /tag opening personal-tags menu rather than main tag menus.
- Fixed** "no-permission-menu-action" option not working when true.
- Fixed** variants not loading properly.
- Fixed** auto-merge not being respected.
- Fixed** missing purchase logic to actions menu.
- Fixed** "supremetags" & "stags" being stuck as a command/sub-command.
- Fixed** essentialsxchat hook adding %% to start/end of format.
- Fixed** folia warnings spamming console, corrected class names.
- Fixed** minimessage not working.
[2.1.13] SupremeTags 2.1.13
by ScapeHelp on Oct 15, 2026
Download
- This build contain new configuration values!**
- This build massively reduces the jar file size, allowing the plugin to rely on the server to load certain dependencies.
- Implemented XSeries to combat backwards compatibility on Materials & Sounds.
- Updated** to 1.21.10
- Added** confirmation Menus for editor delete.
- Added** development structure to the plugin (OP dev alert join message & dev build in jar file)
- Added** sound settings in config.yml for many actions. (Drag and drop config update)
- Added** %current% placeholder to editor messages. (returns the current value before a new one is set)
- Added** Rarity to be editable in editor menus.
- Added** tag-removed in messages.yml.
- Added** "cancel" function in editor event chat.
- Added** Tag Actions Menu toggle in config menu.
- Added** head-UUID & skull-TEXTURE_URL as material types.
- Optimized** unlocked tags count schedular.
- Fixed** basehead-BASE64 from not working.
- Fixed** Tag Effects not re-applying on respawn due to dying.
- Fixed** Tag Effects not re-applying when consuming milk.
- Fixed** NullPointerException to built-in %tag% placeholder in messages.
- Fixed** main thread staling/crash issue.
- Fixed** error found in debug command.
- Fixed** %tag% placeholder error in messages.
- Fixed** issues in config menu.
- Fixed** ingame editor issues.
- Fixed** some lores in editor menu displaying wrong.
- Fixed** players tag is getting reset on rejoin.
- Fixed** sounds on lower versions.
- Fixed** automatic material pulling without needing to change configs for lower versions. (some may still need configuration, use: material:id for lower versions)
- Fixed** config menus for lower versions.
- Fixed** replacement error on success message & others.
- Fixed** customModelData check error on custom items.
- Fixed** miniMessage from not working.
