UltimateTags 1.3.0
The ultimate solution for tags on your server. Don't limit your players to a single tag!
With this plugin you can allow your players to choose one or more configured tags that can be displayed in the chat or anywhere you can use PlaceholderAPI placeholders. If your chat makes use of minimessage to build the format you can even apply hover or click events to the tags.
Features
- Allow your players to select one or more tags.
- MiniMessage formatting support! (Allows you to use Hex colors, gradient, rainbow, transitions and more)
- Support for PaperMC's Folia.
- Lock tags to a specifc server.
- In-game editor. Create and edit tags in-game using command or gui.
- Limit the amount of tags your players can select. You can set a default value in the config but also define a limit using permissions.
- Customizable tag permissions.
- Velocity support. Click here for more information.
Plugin Integrations
- PlaceholderAPI - Legacy Placeholder system.
- MiniPlaceholders - Modern placeholder system.
- ItemsAdder - Custom items and emoji integration.
- Oraxen - Custom items and emoji integration.
- Nexo - Custom items.
- NametagEdit - Player name tags and tab names system.
- libreforge - Configuration based effects system.
- NetworkManager - UltimateTags placeholders in NetworkManager on Velocity.
Database Support
- SQLite
- MySQL
- MariaDB
Use MySQL or MariaDB to sync data between servers.
Import from
- NetworkManager
- DeluxeTags
- EternalTags
Documentation
https://networkmanager.gitbook.io/ultimatetags/
Commands
- /tag - Opens the tag selector
- /tag help - Show all tag commands including arguments
- /tag manage [tag] - Opens menu to manage tags (create, edit or delete tags)
- /tag reload - Reload config files and the tags from the database.
- /tag create [name] [tag] [description] [server] - Create new tag. (Since this command takes multiple arguments you can use spaces if you wrap the argument with quotes. Example: /tag create newtag ultimatetag "<red>Ultimate Tag" "<gray>The Ultimate tag")
- /tag delete <tag> - Delete tag.
- /tag settag <tag> <newtag> - Redefine the tag itself
- /tag setdescription <tag> <newdescription> - Redefine the description of a tag
- /tag setserver <tag> <newserver> - Redefine the server of a tag (set to all for all servers)
- /tag setpermission <tag> <newpermission> - Redefine the permission of a tag
- /tag addtag <player> <tag> - Add a tag to a player
- /tag removetag <player> <tag> - Remove a tag from a player
- /tag clear <player> - Clear the selected tags of a player
- /tag export - Export all tags to a yaml file.
- /tag import <file> [--overwrite] - Import tags from file.
- /tag import plugin <DeluxeTags, NetworkManager> - Import tags from DeluxeTags or NetworkManager.
%ultimatetags_tag% - Placeholder to return the selected tag(s) in minimessage format
%ultimatetags_tag_legacy% - Placeholder to return the selected tag(s) in legacy format (Doesn't support hover, click, etc)
%ultimatetags_tag_has_tag% - Placeholder that will return yes if the player has selected at least one tag or no if the player doesn't have any tag selected.
%ultimatetags_tags_selected% - Placeholder that will return the amount of tags a player has selected.
%ultimatetags_tags_<limit>% - Placeholder to return the selected tags in minimessage format but will limit the amount of tags
%ultimatetags_tags_legacy_<limit>% - Placeholder to return the selected tags in legacy format but will limit the amount of tags
%ultimatetags_tags_total%
%ultimatetags_tags_available%
Note: This plugin does not format your chat. You'll need a plugin that does this for you!
Now I have selected both the hero and Noob tag. (Thanks to minimessage you can apply hover or click events to tags, but your chat plugin must support minimessage. This does not work with the legacy placeholders!)
storage:
type: SQLITE
host: localhost
port: 3306
database: ultimatetags
username: ultimatetags
password: ultimatetags
properties:
useUnicode: true
characterEncoding: utf8
tags:
separator: " "
defaultLimit: 0
hideLocked: false
# Allows the plugin to add or remove tags from the player depending on their permissions.
force: false
# Set tag as default for new players. Use tag name.
default: ''
command:
name: tag
aliases:
- tags
servername: ''
config-version: 7tag:
selected: "You selected the <name> tag."
unselected: "You unselected the <name> tag."
maximumTagsReached: "You've reached the maximum amount of tags that you can select."
noneSelected: "You don't have any tags selected."
noPermission: "<red>I'm sorry, but you do not have permission to perform this command.<br>Please contact the server administrators if you believe that this is in error."
config-version: 2MenuTitle: <red>Tag Selector
UpdateInterval: 0
MenuSize: 54
Menu:
LockedTagItem:
ItemData:
- material:BARRIER
- 'name:<white>Tag: <yellow><name>'
- 'lore:<tag>'
- 'lore:<description>'
- 'lore:'
- 'lore:<red>Locked'
UnlockedTagItem:
ItemData:
- material:NAME_TAG
- 'name:<white>Tag: <yellow><name>'
- 'lore:<tag>'
- 'lore:<description>'
- 'lore:'
- 'lore:<green>Click to select this tag.'
SelectedTagItem:
ItemData:
- material:NAME_TAG
- 'name:<white>Tag: <yellow><name>'
- 'lore:<tag>'
- 'lore:<description>'
- glow:true
PreviousPageItem:
ItemData:
- material:ARROW
- 'name:<white><bold>Previous'
- 'lore:<gray>Go back to the previous page.'
Position: 45
NextPageItem:
ItemData:
- material:ARROW
- 'name:<white><bold>Next'
- 'lore:<gray>Open the next page.'
Position: 54
CloseMenuItem:
ItemData:
- material:CHEST
- 'name:<white><bold>Close'
- 'lore:<gray>Close the menu.'
Position: 49
ClearTagsItem:
ItemData:
- material:PlAYER_HEAD
- skull:%player_name%
- 'name:<white><bold>Clear tags'
- 'lore:<gray>Clear the tags you selected.'
Position: 51
SearchMenuItem:
ItemData:
- material:COMPASS
- 'name:<white><bold>Search Tag'
- 'lore:<gray>Search tags by name.'
Position: 47
If you have any suggestion please use the discussion section to post your suggestion and not the review section.
You can also contact me on Discord: pilske
