Tags

The chat/tags.yml file allows you to define custom player tags that appear in the chat (usually after the player's name). Players can select their active tag using the /tags command.

GUI Configuration

Customize the appearance of the tags selection menu.

• title: The display name of the GUI. Supports MiniMessage.
• rows: The number of rows in the GUI (1-6).
• fill-empty: Set to true to fill empty slots with a background item.
• fill-material: The material used for the background filler.

Defining Tags

Each tag consists of a display name, a permission, and an item configuration for the GUI.

Example Tag:

crown:
  display: "<gradient:#FFD700:#FFA500>♛</gradient>"
  permission: "solaritychat.tag.crown"
  item:
    material: GOLD_INGOT
    name: "<gradient:#FFD700:#FFA500>♛</gradient> <white>Crown Tag"
    lore:
      - '<dark_gray>Player Tags'
      - ''
      - '<gold>What is this?'
      - '<gray>Show off your royal status!'

• display: How the tag will actually appear in the chat when used with the %tag% (or %solaritychat_tag%) placeholder.
• permission: The permission required for a player to select and use this tag.
• item: Configures the item that represents this tag in the selection GUI.

Using Tags in Chat

To show a player's selected tag in their chat format, you must include the %tag% (or %solaritychat_tag%) placeholder in your chat/format.yml.

Example format.yml:

suffix:
  text: '%luckperms_suffix% %tag%'