Теги

На многих серверах рядом с ником в чате показывается тег - небольшой символ, который читается из ключа LuckPerms meta. Это меню позволяет игроку выбрать нужный тег: меню записывает выбранный символ в этот meta-ключ. Подключи плагин форматирования чата, который читает %luckperms_meta_ame_tag% (или другой плейсхолдер, который ждёт твой форматтер), и тег появится в чате.

средний

Фичи: lpMetaSetlpMetaRemovepermission-ruleVIP-tier

Требует: LuckPerms

Открыть: /ame_tags Скопировать

menu.conf

# Выбор тега - теги-префиксы на основе LuckPerms meta
# Docs: https://abstractmenus.github.io/docs/ru/examples/cosmetics/tags
# Open: /ame_tags
# Requires: LuckPerms

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

title: "&6Выбери свой тег"
size: 3

activators {
  command: "ame_tags"
}

# Переиспользуемый обработчик клика для применения тега. Каждый тег ссылается на него с переопределённой строкой тега.
applyTag {
  actions {
    lpMetaSet {
      metaList: [
        { key: "ame_tag", value: "%selected_tag%" }
      ]
    }
    sound: ${successSound}
    closeMenu: true
  }
}

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

  # Тег-сердце
  {
    slot: 11
    material: RED_DYE
    name: "&c♥ Сердце"
    lore: ["&7Розовое сердце рядом с твоим ником."]
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&c♥" }]
        }
        sound: ${successSound}
        message: "&cТег установлен на &c♥"
        closeMenu: true
      }
    }
  }

  # Тег-звезда
  {
    slot: 12
    material: NETHER_STAR
    name: "&e★ Звезда"
    lore: ["&7Жёлтая звезда."]
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&e★" }]
        }
        sound: ${successSound}
        message: "&eТег установлен на &e★"
        closeMenu: true
      }
    }
  }

  # Тег-корона - только для VIP
  {
    slot: 13
    material: GOLDEN_HELMET
    name: "&6♛ Корона &8(VIP)"
    lore: ["&7Королевская корона.", "", "&8Требуется ранг VIP"]
    rules { permission: "abstractmenus.vip" }
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&6♛" }]
        }
        sound: ${successSound}
        message: "&6Тег установлен на &6♛"
        closeMenu: true
      }
    }
    denyActions: ${denyNoPerm}
  }

  # Тег-череп
  {
    slot: 14
    material: SKELETON_SKULL
    name: "&8☠ Череп"
    lore: ["&7Жуткий череп."]
    click {
      actions {
        lpMetaSet {
          metaList: [{ key: "ame_tag", value: "&8☠" }]
        }
        sound: ${successSound}
        message: "&8Тег установлен на &8☠"
        closeMenu: true
      }
    }
  }

  # Сброс / очистка тега
  {
    slot: 15
    material: BARRIER
    name: "&7Очистить тег"
    lore: ["&7Удалить текущий тег."]
    click {
      actions {
        lpMetaRemove: ["ame_tag"]
        sound: ${clickSound}
        message: "&7Тег удалён."
        closeMenu: true
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates (RU)
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/ru/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cУ вас недостаточно денег."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cНет прав."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cВы на кулдауне. Попробуйте позже."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cЗакрыть"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eНазад"
  lore: ["&7Вернуться в предыдущее меню"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eСледующая страница"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&eПредыдущая страница"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lМеню примера"
  lore: ["&7Добро пожаловать в пак примеров AbstractMenus"]
}

↓ menu.conf ↓ Бандл (.zip)

Бандл включает _shared/templates.conf и INSTALL.txt.

Что показывает пример

• Действие lpMetaSet со списком пар ключ/значение metaList
• Действие lpMetaRemove для очистки тега
• Совмещение бесплатных тегов и тегов под пермишеном в одном меню
• Паттерн с двумя ветками действий: actions { ... } denyActions: ${denyNoPerm} для VIP-тега

Как работает LuckPerms meta

lpMetaSet записывает одно или несколько meta-значений в профиль игрока в LuckPerms:

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

Имя meta-ключа (здесь ame_tag) выбираешь сам - бери что-то специфичное для своего сервера. Значение - это то, что попадёт в чат (в примере - цветной символ). За один вызов можно установить сразу несколько ключей:

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

lpMetaRemove принимает список ключей для удаления:

lpMetaRemove: ["ame_tag"]

Эти действия работают только если в качестве провайдера прав активен LuckPerms. Если активен другой провайдер, действие выведет предупреждение в лог и ничего не сделает - меню не сломается, просто тег не применится.

Показ тега в чате

Установить meta - это половина дела. Форматтер чата должен его прочитать. Большинство плагинов чата (DeluxeChat, ChatFormatter и т.д.) принимают плейсхолдеры PlaceholderAPI вида %luckperms_meta_<key>% в строке формата:

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

Добавь это в конфиг плагина чата, перезапусти - и тег появится рядом с ником.

Попробовать

1. Положи бандл в plugins/AbstractMenus/menus/example/.
2. Выполни /am reload.
3. Введи /ame_tags в игре.
4. Кликни на любой бесплатный тег - meta установится. Проверь через /lp user <ты> meta info (увидишь ame_tag в списке).