SupremeTags 2.1.12
Give your players custom titles with style. Fully customizable, GUI-based, and placeholder-ready.
2.1.12
Sep 20, 2025
2.1.12
Additions & Changes:
- global-locked-tag (allows you to mass edit locked tag item for every tag)
- Removed locked-tag from specific tags. (replacement: global-locked-tag)
- Removed settag argument (use /tag edit <identifier> tag ...)
- Optimized tag handling & removed old messy code.
Fixes:
- Effects potions issue for lower versions.
- Imported runtime issues for lower versions.
- Incompatible InventoryView issue for lower versions.
- No tag access message not respecting `gui-messages` toggle.
Add under guis.yml > tag-menu:
global-locked-tag:
displayname: '&7Tag: %tag%'
display-item: BARRIER
custom-model-data: 0
2.1.8
Jul 22, 2025
2.1.8
This New version comes with many new content files and additions see the GitHub files: HERE
Updated to 1.21.8 Support.
This build uses a snapshot build of nbtapi(2.15.2-SNAPSHOT) to support 1.21.8, download here: https://ci.codemc.io/job/Tr7zw/job/Item-NBT-API/
Additions:
- Rarity displayname option, this is now used for %rarity%
- More effective placeholder outputs & improved none-output formats etc.
- rarities.yml, allows for more effective & controlled system. (Auto tag rarity is coming soon)
- PacketEvents API Support for {tag}, {TAG}, {supremetags_tag} placeholders.
- More folia compatibility.
- New Placeholders: `%supremetags_scorebardtag & %supremetags_tabtag%
- MiniMessage Support option in config.yml. (Disabled by default)
- Categories filter-labels option.
- Tag Actions Menu, this menu adds more user friendly interface for what do with the tag
- ItemsAdder FontImage's support to all menu titles.
- Variant descriptions. description
- Placeholder: %supremetags_rarity% (%rarity% - built in)
- Personal-Tags item "no-tags-item".
Fixes:
- withdraw success message being executed when its not successfully.
- null error happening inside of variants menu reset button.
- %supremetags_chattag% including none-output.
- %tag% & %identifier% not using using none-output in the active item lore.
- Variant unselect re-click not working.
- ProtocolLib classes from loading if its not installed.
- Tag deletion not properly working in personal tags.
- New rarities not being registered, now comes with a loaded counter log(in console) when using /tag reload
- messages.yml not being properly reloaded and synced with new messages changes.]
- Both %description% & %effects% replacing the entire line its being set on in lores.
- Layout items being displayed in menus they shouldn't be.
- Conflict issue with both locked-view && only-show-player-access-tags
- only-show-player-access-tags from not properly working when its set to false.
- Priority access to not being put first making tags look messy.
- Some areas still trying to using old none-output: option (removed)
- Variant lores not using its specified lores.
- HIDE_DYE flag for versions <1.12.2
- issue chat receivers displaying their own tag in {tag}, {TAG}, {supremetags_tag} placeholders for protocollib.
AND MANY MORE THAT ISN'T LISTED IN HERE
Changes:
- Permission supremetags.menu > supremetags.player
Improvements:
- Menu click handling.
- ItemProvider to make it easier to add more support in future. Cleaned up Code
- Packet lib handling.
Removed:
- none-output option in replacement of specific placeholder values in config.
2.1.7
May 17, 2025
2.1.7
2.1.7+ Now requires protocollib!
Updated Nexo to 1.5
Updated ItemNBTAPI to 2.15.0
Added new placeholder: %supremetags_player_track_unlocked% - returns the amount of tags the player has unlocked.
Added New search type. Anvil GUI Input! Edit in config.yml `search-type: 'SIGN' # either 'SIGN' or 'ANVIL'`
Improved Search finding result.
Added function that makes back button hidden if you're on page 1.
Added Hide tooltip Display option to all items & custom-items hide-tooltip: true # 1.21.5+ only (Only will work in 1.21.5+ paper versions)
Added %category% to tag lores.
Added CoinsEngine is now supported as a economy type. Usage: COINSENGINE-<currencyname> without the <>.
Added "no effects found" to be editable in messages.yml: no-effects: '&7No Effects Found!' Added editable effect replacement in messages.yml: effects-replace-style: '&8&l> &f%effect%'
Added bought back Oraxen Support for those who still use it: oraxen-id
Added %effects_list% placeholder to format effects into its ..,...,... list. Optimization Loading tags is now done async and not on main thread. Fixed create command usage & argument handling.
Fixed/Removed Debug spam from chat parsing.
Fixed Tag order not properly prioritizing "order" option first. (make sure you correct any in tags config)
Fixed Search tags not following the same format/layout.
Removed Tag lores, now only uses global lore in guis.yml. (use-global-lores is no longer used in config.yml.)
Fixed/Redone {tag}, {TAG}, {supremetags_tag} not working for essentialsxchat (Requires LATEST ProtocolLib)
Changed/Added Variant tags now uses its parent tags locked-tag area to display different materials/data when locked.
Fixed Variant tags now assigning its glow effect for config > active-tag-glow Fixed Variant tags not displaying in Placeholders(PAPI)
Fixed %supremetags_player_track_unlocked% placeholder.
Fixed Variant tag lores not updating.
Fixed Variant menu issues.
Fixed Some missing placeholders in categories.
Fixed/Added %tag% to be display none-outputs.
Fixed Personal tags setup process not completing properly.
Fixed %tag% & %identifier% not using variant or personal active tags.
Fixed items not working in personal tags.
Fixed %identifier% for items in personal tags.
Fixed reset button giving null tag in personal tags.
2.1.6
Apr 29, 2025
2.1.6
Now Supports 1.21.5.
Now Supports java 21 -- So make sure you have updated your java before upgrading to this version.
Installer Change Plugins now builds with gradle rather than maven to fix dependencies.
Now comes with more folia support!
Added Tag Effects!
Added New placeholder in PAPI: %supremetags_chattag% - doesn't include the none output.
Added Font Image placeholders(ItemsAdder) to the rest of the plugin.
Added Edit argument command: With auto suggestion for old data.
Added [next-page] / [previous-page] for click-command actions.
Added no-selected-tag for messages.yml (this applies to menu reset button when the player doesn't have a tag active.)
Added "Search Result Below:" to be editable in messages.yml. Add to messages.yml > sign-line-top: '&eSearch Result Below:'
Fixed Create tag command.
Removed settag argument command (now use edit)
Fixed reset for both menus & reset command null issue.
Fixed custom item click-commands from not working.
Fixed lore not clearing when lore removed, use `lore: []` to clear the lore of items.
Fixed items not working when placeholders are included in displayname.
Fixed VaultAPI passing all worlds therefore making the permissions duplicate for luckperms, now only makes the permission "global" for all worlds.
Fixed null issue on nbtapi items.
Fixed Error trying to remove effects when players doesn't have a tag.
Fixed Variant items not allowing custom variables set. (Nexo)
Fixed Editors/Variants not allowing placeholderapi in titles.
Fixed Some menus breaking due to not support custom items.
Fixed/Added Slots for guis > items items.
Fixed Some issue checks towards lores status.
Fixed Withdraw & some other comes checking for wrong permissions.
Fixed Missing dependencies occurring.
Changed Now using VaultUnlocked rather than Vault. (Vault uses an old Bukkit version which breaks building the plugin but VaultUnlocked is backwards compatible with Vault so don't worry!)
Fixed Locked-View / Global-Cost / Category-Cost / Tag-Cost compatible issues.
Fixed Nexo Support.
Fixed Voucher item not displaying voucher-item variables from tags.yml.
Fixed Vault Request on tracking unlocked tag counts, now updates in an async cache every 60 seconds.
Fixed Commands in console not working.
Fixed tags names not showing in some 3rd argument commands.
Fixed search function not working.
Fixed Commands giving errors.
Optimized animation tag schedulers.
Optimized unlocked tag count updater.
Optimized Menu loading & handling.
2.1.5
Mar 20, 2025
2.1.5
Fixed all tags loading when the player doesn't have permission or view/cost settings are off.
Fixed tag vouchers for version less then < 1.14.
2.1.4
Mar 19, 2025
2.1.4
This build has been in development for a few months now, if you want to get instant updates I host dev snapshots in my discord way before posting updates on spigot etc.
This version now supports 1.21.4.
- Updated NBTAPI to 1.14.1
- Updated Folia to 1.21.4
Additions:
- Nexo Support(nexo-<id> - without the <>). (This has not yet been tested as I do not own the plugin)
- Gradients & Rainbow formats to the plugin, you can use these anywhere you want.
- Custom Placeholders feature for each tag, this will allow you to output placeholder strings where ever you want.
- Multiple hex support in gradient format.
- "BOLD, ITALIC & UNDERLINE" support to both gradient & rainbow formats.
- reset-command to be editable in messages.yml.
Bug Fixes:
- Issue with the /tags givevoucher command.
- Lore not properly updating.
- Automatically detect if the player doesn't permission to a tag, therefore resetting their active tag to "None".
- Search system not working in latest versions.
- Fixed data-cache from breaking data syncing across server when enabled.
- order not properly sorting.
- Description placeholder not assigning all lines for tag.
Changes:
- Removed TokensManager Support due to being outdated & conflicting with the plugin.
2.1.2
Nov 25, 2024
2.1.2
I will be adding Nexo Support once its been fully released.
Updated NBTAPI to 2.14.0
Updated ItemsAdder API
Added 40+ premade default tags.
Added back interaction for personal tags menu if on page 0.
Fixed some tab complete arguments.
Fixed permission message on commands not getting the messages.yml "no-permission".
Fixed command tab complete showing tab args to player with no permissions to that command. (Player now needs the specific command permission to see tab complete for /tags)
Fixed Custom model data on variant tags.
Fixed selected message not assigned in personal tags menu.
2.1.1
Nov 10, 2024
2.1.1
Fixed multiple incompatible scheduler errors for folia Support.
> Vouchers should now be working as intended.
> Update-Checker should now be working as intended.
> Animated tags schedulers.
Fixed Itemsadder(itemsadder-<id>) not working for category item materials.
2.1.0
Nov 6, 2024
2.1.0
Added option to enable specific tag cost in tags.yml, this allows you to choose what tags are buyable individually without having to enable the full category. Category Cost will override this option if enabled (Should update into tags.yml automatically)
2.0.13
Nov 4, 2024
2.0.13
Added Search feature, this allows players to search any tag without having to look through all pages (Follow the instructions below to properly implement search feature)
Fixed updater version giving null value.
Add this item to your guis.yml > under items:
search:enable: trueslot: 45displayname: '&e&lSearch Tags'material: 'OAK_SIGN'custom-model-data: 0lore:- '&7Search for tags!'
Add these messages to your messages.yml > under messages:
search-invalid-1: '%prefix% &7Invalid Search, search a tag name or category.'search-invalid-2: '%prefix% &7Invalid Search, line 2 is empty.'[/code]
2.0.12
Nov 4, 2024
2.0.12
Changed merge-free config file to get free-tags.yml. (change your free ST tags.yml to free-tags.yml if you want to merge from free to premium.)
Changed saving/loaded console alerts for editor/auto-saving actions to be silent, you can see how many tags are loaded in /tags debug or /tags list
Added Auto Tags Validator to prevent tags from loading with missing/invalid values from tags.yml
Added ptags-disabled for messages.yml to be editable for `/mytags.
Fixed/Recoded Command framework, this fixes aliases from spamming chat.
Fixed some indexing for tags.
Fixed merge function needing auto option needed for /tags merge.
Fixed compiling for java 8.
2.0.11
Oct 18, 2024
2.0.11
Oct 17, 2024
2.0.11
Fixed help command not showing commands.
Fixed Tab Complete for commands (Only works with the main command.)
2.0.10
Oct 14, 2024
2.0.10
!! IF YOU'RE UPDATING FROM 2.0.9 OR BELOW MAKE SURE YOU CHECK THE GITHUB RESOURCES FIRST, THIS VERSION CONTAINS NEW CONFIGURATION CONTENT FOR ALL CONFIGS. !!
v1.21.1 Version Support
Compiled in Java 8 for wider server support.
New Features
- Tag Variants: Allows unlimited sub-tags for each tag.
- Bungee Messaging Sync: Synchronize tags across servers (default is off).
- Slot customization in GUIs, with support for multiple slots using slots.
- Control tag locations in menus for better organization.
- Customizable main command.
- Global lore for easier mass-editing.
- Local SQL caching for slow connections, ensuring sync is unaffected.
- Unified color formatting, with two new hex formats: <&#HEXCOLOR> and <#HEXCOLOR>.
- Multi-line descriptions and support for [broadcast] in custom items.
- Free tags available for users with the 'none' permission.
New Integration Merges
- AlonsoTags and EternalTags can now be merged.
New Economy Types
- Added support for EXP_LEVELS and TOKENMANAGER.
Additional updates
- Animated tag speed for individual tags.
- %command% placeholder for help messages.
Fixes
- Addressed version/debug issues, merge manager problems, console errors, editor navigation, HikariCP improvements, and command alias bugs.
Removed Option (REWORKED)
- The hide-next-item option has been removed, with its functionality reworked.
2.0.9.1
Aug 26, 2024
2.0.9.1
Added support for prefixes for messages.yml messages from 2.0.9.
Fixed instant deactivation-click bug when selecting a tag it would instant reset.
Fixed error of invalid tag check still trying to receive tag data for vouchers.
2.0.9
Jul 17, 2024
2.0.9
This version to contains new file contents in more than 1 configurations, please check the github for updated files.
Added a option to deactivate tag when clicking the activated tag again. (Uses the reset message)
Added help message to be editable for '/tags help' in messages.yml.
Added more messages into messages.yml to be editable. *Please report any that I've missed.*
Added hide-next-item in config.yml, this option will allow you to keep the "next-item" always shown if false.
Fixed voucher item giving enchant error.
2.0.8
Jul 12, 2024
2.0.8
Updated to 1.20.6 + 1.20.1
Updated to all latest dependencies & libs.
Fixed Enchant issue for active-tag.
Fixed Config issue regenerating default tags on restart.
2.0.7
May 18, 2024
2.0.7
This build contains new features that you need to add, see new updated config files;
[url]https://github.com/NoScapeDev/SupremeTags-Premium[/url]
Updated Support for 1.20.5 + 1.20.6
Updated all dependencies for SupremeTags.
Added Support for Folia.
Added more messages to be editable in messages.yml!
Redesigned how files are loaded, fixes issue where old config values would re-generate when removed.
Added ability to add custom aliases for /tags command!
Added optional -s to /tags givevoucher command to silence out received messaged. usage: /tags givevoucher <player> <identifier> (-s)
Fixed merge functions not including new content from latest spigot builds (from /tags merge)
Fixed cache null error on server close.
Fixed lore condition not assigning locked-lore when costs are enabled.
Fixed console command error.
