Префиксы

Другой подход в сравнении с примером Теги. Вместо записи в meta это меню управляет членством в группах LuckPerms. Каждый префикс соответствует одной группе; при выборе префикса игрок удаляется из других групп префиксов и добавляется в выбранную. Взаимная исключимость встроена.

средний

Фичи: addGroupremoveGroupbulk-actionpermission-ruleexclusive-selection

Требует: LuckPerms

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

menu.conf

# Префиксы - выбор префикса через группы LuckPerms
# Docs: https://abstractmenus.github.io/docs/ru/examples/cosmetics/prefixes
# Open: /ame_prefixes
# Requires: LuckPerms

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

title: "&6Выбери свой префикс"
size: 3

activators {
  command: "ame_prefixes"
}

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

  # Каждый префикс - это группа LuckPerms. Клик добавляет игрока в эту группу
  # (и удаляет из остальных, чтобы активным был только один префикс).

  {
    slot: 11
    material: GREEN_WOOL
    name: "&a[Member]"
    lore: [
      "&7Стандартный префикс."
      "&7Бесплатный для всех игроков."
    ]
    click {
      actions {
        bulk: [
          { removeGroup: "ame_prefix_donor" }
          { removeGroup: "ame_prefix_admin" }
          { addGroup: "ame_prefix_member" }
        ]
        sound: ${successSound}
        message: "&aПрефикс установлен: [Member]."
        closeMenu: true
      }
    }
  }

  {
    slot: 13
    material: GOLD_INGOT
    name: "&6[Donor]"
    lore: [
      "&7Префикс донатера."
      "&7Доступен для поддержавших проект."
      "",
      "&8Требуется право донатера"
    ]
    rules { permission: "abstractmenus.donator" }
    click {
      actions {
        bulk: [
          { removeGroup: "ame_prefix_member" }
          { removeGroup: "ame_prefix_admin" }
          { addGroup: "ame_prefix_donor" }
        ]
        sound: ${successSound}
        message: "&6Префикс установлен: [Donor]."
        closeMenu: true
      }
    }
    denyActions: ${denyNoPerm}
  }

  {
    slot: 15
    material: NETHERITE_INGOT
    name: "&c[Admin]"
    lore: [
      "&7Префикс администратора."
      "",
      "&8Требуется право администратора"
    ]
    rules { permission: "abstractmenus.admin" }
    click {
      actions {
        bulk: [
          { removeGroup: "ame_prefix_member" }
          { removeGroup: "ame_prefix_donor" }
          { addGroup: "ame_prefix_admin" }
        ]
        sound: ${successSound}
        message: "&cПрефикс установлен: [Admin]."
        closeMenu: true
      }
    }
    denyActions: ${denyNoPerm}
  }

  ${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.

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

• Действия addGroup / removeGroup для членства в группах LuckPerms
• Использование bulk для нескольких removeGroup + addGroup в одном клике
• Префиксы более высоких рангов закрыты пермишенами

Зачем bulk

При каждом выборе префикса последовательно выполняются три действия:

bulk: [
  { removeGroup: "ame_prefix_member" }
  { removeGroup: "ame_prefix_donor" }
  { addGroup: "ame_prefix_admin" }
]

Нельзя написать removeGroup: ... дважды на верхнем уровне блока actions {} - ключи объекта в HOCON должны быть уникальными. bulk оборачивает последовательность действий, каждый элемент - своя группа действий.

Этот паттерн (удалить все остальные, добавить эту) гарантирует, что игрок состоит ровно в одной группе префикса. Без удалений у игрока накапливается членство в группах и выходит несколько префиксов одновременно.

Теги vs Префиксы

Два способа управлять префиксом в чате:

• Теги (lpMetaSet) - гибкие, тонкая настройка, без иерархии групп. Подходят для чисто косметических символов.
• Префиксы (addGroup) - интегрируются с группами LuckPerms, наследуют права от группы, дружат с плагинами чата, читающими %luckperms_prefix%. Подходят, когда префикс должен ещё и давать дополнительные права.

Большинство серверов использует второй вариант для цвета имени в чате и первый - для дополнительного декоративного тега.

Настройка

Перед использованием меню создай группы LuckPerms:

/lp creategroup ame_prefix_member
/lp group ame_prefix_member meta addprefix 50 "&a[Member] "

/lp creategroup ame_prefix_donor
/lp group ame_prefix_donor meta addprefix 100 "&6[Donor] "

/lp creategroup ame_prefix_admin
/lp group ame_prefix_admin meta addprefix 1000 "&c[Admin] "

Числовой вес (50, 100, 1000) задаёт приоритет, когда у игрока несколько префиксов - больший выигрывает. Это меню всё равно держит ровно один префикс, поэтому вес тут особо не важен, но привычку выставлять его лучше иметь.

Попробовать

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