Skip to content
AbstractMenus AbstractMenus

Tags

Most servers display a chat tag (a small symbol next to the player’s name) by reading from a LuckPerms meta key. This menu lets players pick which tag they want by writing the chosen symbol to that meta key. Pair with a chat-format plugin that reads %luckperms_meta_ame_tag% (or whatever your chat formatter expects) and the tag shows up in chat.

intermediate
Features: lpMetaSetlpMetaRemovepermission-ruleVIP-tier
Requires: LuckPerms
Open: /ame_tags 
# Tag Selector - LuckPerms meta-based prefix tags
# Docs: https://abstractmenus.github.io/docs/en/examples/cosmetics/tags
# Open: /ame_tags
# Requires: LuckPerms


include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))


title: "&6Choose your tag"
size: 3


activators {
  command: "ame_tags"
}


# Reusable tag-application click handler. Each tag references it with the tag string overridden.
applyTag {
  actions {
    lpMetaSet {
      metaList: [
        { key: "ame_tag", value: "%selected_tag%" }
      ]
    }
    sound: ${successSound}
    closeMenu: true
  }
}


items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }


  # Heart tag
  {
    slot: 11
    material: RED_DYE
    name: "&c♥ Heart"
    lore: ["&7Pink heart symbol next to your name."]
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&c♥" }]
        }
        sound: ${successSound}
        message: "&cTag set to &c♥"
        closeMenu: true
      }
    }
  }


  # Star tag
  {
    slot: 12
    material: NETHER_STAR
    name: "&e★ Star"
    lore: ["&7Yellow star symbol."]
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&e★" }]
        }
        sound: ${successSound}
        message: "&eTag set to &e★"
        closeMenu: true
      }
    }
  }


  # Crown tag - VIP only
  {
    slot: 13
    material: GOLDEN_HELMET
    name: "&6♛ Crown &8(VIP)"
    lore: ["&7Royal crown.", "", "&8Requires VIP rank"]
    rules { permission: "abstractmenus.vip" }
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&6♛" }]
        }
        sound: ${successSound}
        message: "&6Tag set to &6♛"
        closeMenu: true
      }
    }
    denyActions: ${denyNoPerm}
  }


  # Skull tag
  {
    slot: 14
    material: SKELETON_SKULL
    name: "&8☠ Skull"
    lore: ["&7Spooky skull symbol."]
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&8☠" }]
        }
        sound: ${successSound}
        message: "&8Tag set to &8☠"
        closeMenu: true
      }
    }
  }


  # Reset / clear tag
  {
    slot: 15
    material: BARRIER
    name: "&7Clear tag"
    lore: ["&7Remove your current tag."]
    click {
      actions {
        lpMetaRemove: ["ame_tag"]
        sound: ${clickSound}
        message: "&7Tag removed."
        closeMenu: true
      }
    }
  }


  ${buttonClose} { slot: 22 }
]
↓ menu.conf

Bundle includes _shared/templates.conf and INSTALL.txt.

What it teaches

Section titled “What it teaches”
  • The lpMetaSet action with a metaList of key/value pairs
  • The lpMetaRemove action for clearing a tag
  • Mixing free tags with permission-gated premium tags in one menu
  • The dual-action pattern: actions { ... } denyActions: ${denyNoPerm} for the VIP-only tag

How LuckPerms meta works

Section titled “How LuckPerms meta works”

lpMetaSet writes one or more meta values onto the player’s LuckPerms profile:

lpMetaSet {
  metaList: [
    { key: "ame_tag", value: "&c♥" }
  ]
}

The meta key (ame_tag here) is a string of your choosing - pick something server-specific. The value is the actual content (a colored symbol in this example). Multiple meta keys can be set in one action:

metaList: [
  { key: "prefix",    value: "&7[Member]" },
  { key: "ame_tag",   value: "&c♥" },
  { key: "show_role", value: "true" }
]

lpMetaRemove takes a string list of keys to delete:

lpMetaRemove: ["ame_tag"]

These actions only work when LuckPerms is the active permissions provider. If a different provider is active, the action logs a warning and does nothing - so the menu won’t crash, just won’t apply the tag.

Showing the tag in chat

Section titled “Showing the tag in chat”

Setting the meta is half the work. The chat formatter has to read it. Most chat plugins (DeluxeChat, ChatFormatter, etc.) accept PlaceholderAPI %luckperms_meta_<key>% placeholders in their format string:

chatformat: "&8[%luckperms_meta_ame_tag%&8] &f%player_name%: %message%"

Once that’s in your chat plugin’s config, restart, and the tag appears next to the player’s name.

Try it

Section titled “Try it”
  1. Drop the bundle into plugins/AbstractMenus/menus/example/.
  2. /am reload.
  3. Type /ame_tags in-game.
  4. Click any free tag - the meta is set. Verify with /lp user <you> meta info (you’ll see ame_tag in the list).