Setting up Tags

Setting up tags items.

All options

#### EXAMPLE
#tags:
#  example:
#    # The format you want the tag to have
#    tag: "&4&lOwner &8&l|&7"
#    # Information that will appear instead of %tag_info% in gui
#    info: "Owner tag"
#    enabled: true # ALL TAGS WITHOUT THIS SETTING ARE ENABLED
#
#    # These options are not needed. For example if you want something special for one specific tag
#    permission: "specialperm.tag.owner"
#    # Special Name, used instead of path name. 
#    # Example: official name is superTag05 but you don't want player to see this. So you can use this.
#    name: "SuperExample"
#
#    # Special actions when tag is selected
#    select:
#      commands: []
#      messages: []
#    
#    # You can find all item options here: https://github.com/TheDevTec/TheAPI/wiki/ItemMaker
#    item:
#      type: "DIAMOND" # YOU ALWAYS NEED TYPE IF YOU WANT TO CHANGE SOMETHING (just name or lore).
#      # displayName will be on material in GUI
#      displayName: "&7&l» %tag_name%"
#      lore: []
#      # If you want to have HEAD as item, you need to set type to "PLAYER_HEAD"¨
#      # and use these settings:
#      head: 
#        type: ""
#        owner: ""

tags:
  default:
    tag: "&7&lPlayer &8&l|&7"
    info: "Default tag"
    enabled: true # ALL tags enabled unless specified otherwise

There is no need to use all available settings. The only think you need to set is tag's format.

tags:
  default:
    tag: "THIS"

All other settings are completely optional. But this page is going to show you some examples anyway.

Some examples

Example 1

We're starting slowly

tags:
  default:
    tag: "&7&lPlayer &8&l|&7"
    info: "Default tag"
    enabled: true # ALL tags enabled unless specified otherwise

What is info? As you can see in GUI.yml. In default item's lore is something like %tag_info%. So the text you write under the path info is gona replace placeholder %tag_info%. In menu this is gona look like this:

Example 2

Some special commands and messages? What?

tags:
  example:
    tag: "&eExample tag &8&l|&7"
    select:
      commands:
      - "say Selected Exampe tag"
      messages:
      - "Custom message! You selected Eample tag!! Wooo!!"

Yes. You can add special commands and messages. These are executed after selecting the tag.

Example 3 - Boring type change

Just changing type of an item that will be in the menu.

tags:
  devtec:
    tag: "!#15de95&lDevTec!#12f3e6 &7&l|"
    item:
      type: "EMERALD"

Changing type from default material to EMERALD material.

Example 4 - Custom Head

Custom head? WHAT?! Yes!

You can use heads. You can use ItemMaker settings to create even more advanced items. This can also be used for GUi.yml items (and in all of our other projects).

tags:
  superSteve:
    tag: "&c&lSuper&f&lSteve &7&l|"
    name: "Super Steve" # "Super Steve" looks better than "superSteve" right? :D
    item:
      type: "PLAYER_HEAD"
      head:
        type: "VALUES"
        owner: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTlmNGQ4YjlkZjJmOGMzZjBhYTNlNDAwOTFmNzhmZTc3OTc4Y2FkY2IwMGFjMmY0OWU4ZTIxNWI4NTIwMzZlNSJ9fX0="

This head is using values from https://minecraft-heads.com/. Item type must always be set as PLAYER_HEAD or this won't work. Possible types of heads are:

Type	Owner
PLAYER	Owner is player, so put here some player's name? If you want the head of player who just opened menu, put %player% here.
VALUES	Values generated from https://minecraft-heads.com/
URL	Ling to head image
HDB	ID from HeadDatabase plugin. Can be also found on https://minecraft-heads.com/ page but won't work without plugin 😄

This example is also using custom name. Oficial Iientification name is superSteve but name that will be used instead of %tag_name% is "Super Steve"

Example 5 - Full customization

Changing everything!

tags:
  custom:
    tag: "&2&lTotalyCustom &7&l|"
    info: "Fully modified tag!"
    name: "To modify or not to modify..."
    item:
      type: "SUNFLOWER"
      displayName: "&4&l» %tag_format% &4&l«"
      lore:
      - "&7Format: &f%tag_format%"
      - "&7Info:"
      - "  &7• &f%tag_info%"
      - "  &7• %tag_status%"
      - ""
      - "%tag_format% &7%player%"

This example is changing name, item, lore and even displayName of menu item.

---

Older versions

Version 1.1

We recomend updating plugin to more recent version!

Link to downloable jar file: here

Default Tags.yml (Plugin version 1.1)

Tags.yml file

#    EXAMPLE:
#Tags:
#  example:
#    # Tag format that it will use
#    Tag: "&4&lOwner &8&l|&7"
#    # Information that will appear in GUI. Use %info% for this text to appear.
#    Info: "Owner tag"
#    # You can enable or disable tag
#    Enabled: true
#
#    # This options are not needed. Just if you want something special for one specific tag...
#    Permission: "specialperm.tag.owner"
#    Name will be on material in GUI
#    Name: ""
#    Lore: []
#    Type: "DIAMOND"
#    Head: ""
#    Select:
#      Commands: []
#      Messages: []

Tags:
  Owner:
    Tag: "&4&lOwner &8&l|&7"
    Info: "Owner tag"
    Enabled: true

Examples:

Example #1

This example uses Default tag format from Config.yml (also older one)

Tags:
  Example1:
    Tag: "&4&lOwner &8&l|&7"
    Info: "Owner tag"

Example #2

This example is using more settings. (custom name, material, lore)

Tags:
  Example2:
    Tag: "&6&lCustomTag &8&l|&7"
    Info: "Custom tag"
    Name: "&6&lCustomTag &8&l|&7"
    Lore:
   - "&7This is CustomTag!!!"
    - "&7"
    - "%tag% %player%"
    Type: "DIAMOND"

Example #3

This example is using head from the Head Database plugin.

Tags:
  Tag2:
    Tag: "!#12aa00&lAmazing tag!#02bbdc &8&l|&7"
    Info: "Amazing tag"
    Head: "hdb:13476"

Other head options here