Платно - Плагин - ⭐ hClansMenuAddon [1.16.X-26.X] ⭐ | Дополнение для плагина hClans

Поддерживаемые версии

1.16
1.17
1.18
1.19
1.20
1.21

Ядра и Прокси

Bukkit
Spigot
Paper

Минимальная версия Java: 17

hClansMenuAddon
Настраиваемое меню клана для серверов с hClans

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

hClansMenuAddon — это аддон для hClans, который добавляет настраиваемое меню клана.

Аддон регистрирует новую подкоманду клана, открывает кастомное GUI, показывает информацию о клане и позволяет создавать кликабельные предметы, которые выполняют настроенные действия.

Меню полностью настраивается через YAML: размер, title, предметы, слоты, материалы, названия, lore, кастомные головы, glow, CustomModelData, click actions и алиасы команды.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Основные возможности

Добавляет подкоманду /clan menu.
Кастомное GUI-меню для hClans.
Настраиваемый размер меню.
Настраиваемый title меню.
Опциональный доступ только для участников клана.
Кастомные предметы в меню.
Поддержка диапазонов слотов.
Настраиваемые материалы.
Кастомные головы и base64-heads.
Настраиваемые названия и lore предметов.
Поддержка CustomModelData.
Поддержка glow.
Скрытие атрибутов предметов.
Действия по клику.
Алиасы команды через конфиг.
Опциональное отображение в tab-complete.
Плейсхолдеры клана в title, названиях предметов и lore.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Как работает

Игрок открывает меню через подкоманду клана:

Код:

/clan menu

Когда команда используется, аддон проверяет, состоит ли игрок в клане, если включена настройка requireClan.

Если игрок может открыть меню, аддон собирает GUI из конфигурации, применяет плейсхолдеры, создаёт все предметы и открывает инвентарь.

Когда игрок кликает по предмету, аддон считывает click action из настройки предмета и выполняет указанные действия.

────────────────────────────────────────

Доступ только для клана

Меню можно ограничить только для игроков, которые состоят в клане.

За это отвечает настройка:

Код:

settings:
  menu:
    requireClan: true

Если игрок не состоит в клане, аддон выполняет actions из секции notInClan.

────────────────────────────────────────

Настройка меню

Размер меню можно задать как стандартный размер Minecraft-инвентаря.

Поддерживаемые размеры:

Код:

Title меню настраивается и поддерживает клановые плейсхолдеры.

Пример:

Код:

settings:
  menu:
    size: 54
    title: "&0Меню клана {clan}"

────────────────────────────────────────

Кастомные предметы

Каждый предмет в меню можно настроить отдельно.

Настройки предметов:

один слот или несколько слотов
диапазоны слотов
материал
количество
название
lore
CustomModelData
glow
скрытие атрибутов
владелец головы
base64-текстура головы
действия по клику

Примеры формата слотов:

Код:

slot: 22

slots:
  - "10-16"
  - "19"
  - "25"

Так можно создавать рамки, кнопки, информационные предметы и навигационные элементы прямо через конфиг.

────────────────────────────────────────

Кастомные головы

Аддон поддерживает кастомные головы через skull API из hClans.

В качестве материала можно использовать base64-head.

Пример:

Код:

material: basehead-BASE64_VALUE

Это позволяет делать более красивые кнопки без отдельного ресурспака.

────────────────────────────────────────

Click actions

Предметы могут выполнять actions при клике.

В стандартной конфигурации используются действия такого формата:

Код:

[MESSAGE]
[PLAYER]
[CLOSE]

Пример:

Код:

actions:
  click:
    - "[PLAYER] execute:/clan storage"
    - "[CLOSE]"

Через предметы можно отправлять игрока к другим клановым командам, открывать другие меню, показывать сообщения или закрывать инвентарь.

────────────────────────────────────────

Типы кликов

Аддон поддерживает разные ключи действий для кликов.

Примеры:

Код:

click
left
right
shift_left
shift_right
middle

Это позволяет задавать разное поведение в зависимости от типа клика.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Конфигурация

Структура стандартной конфигурации:

Код:

settings:
  command:
    visibleInTabComplete: true
    aliases: {}
  menu:
    size: 54
    title: "&0Меню клана {clan}"
    requireClan: true

items:
  info:
    slot: 4
    material: BOOK
    name: "#FDBE00Информация о клане"
    lore:
      - "Клан: {clan}"
      - "Участников: {members}"
      - "Владелец: {owner}"
      - "Уровень: {level}"
    glow: true
    actions: {}

────────────────────────────────────────

Секции actions

Глобальные секции действий:

Код:

notInClan
usage
open

Пример action у предмета:

Код:

items:
  storage:
    slot: 23
    material: CHEST
    name: "Клановое хранилище"
    actions:
      click:
        - "[PLAYER] execute:/clan storage"

────────────────────────────────────────

Плейсхолдеры

Аддон поддерживает плейсхолдеры в title меню, названиях предметов, lore и actions.

Доступные плейсхолдеры:

Код:

{player}
{display}
{uuid}
{clan}
{clanColor}
{members}
{memberCount}
{owner}
{ownerUuid}
{level}

Дополнительные плейсхолдеры также могут обрабатываться через форматирование hClans.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Команды

Основная команда:

Код:

/clan menu

Дополнительные алиасы для подкоманды menu можно настроить в:

Код:

settings.command.aliases

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Права

В текущей версии hClansMenuAddon не добавляет отдельные Bukkit permissions.

Доступ контролируется через:

нахождение игрока в клане
настройку settings.menu.requireClan
права команд, которые выполняются через actions предметов

Если предмет выполняет другую команду, эта команда всё равно может требовать свои права в зависимости от целевого плагина.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Требования

Java 17 или новее.
Minecraft 1.16 или новее.
Сервер, совместимый с Bukkit/Spigot/Paper.
Плагин hClans.

Важно: hClansMenuAddon является аддоном и требует установленный hClans.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Установка

Установите hClans на сервер.
Поместите hClansMenuAddon.jar в папку plugins.
Запустите или перезапустите сервер.
Откройте созданный конфигурационный файл.
Настройте размер меню, title, предметы и actions.
Снова перезапустите сервер или перезагрузите hClans/аддоны в вашем обычном рабочем процессе.

Файл конфигурации:

Код:

plugins/hClansMenuAddon/config.yml

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Примечания

Аддон регистрирует menu как подкоманду клана.
Меню можно скрыть из tab-complete через конфиг.
Меню может требовать наличие клана у игрока.
Все GUI-предметы настраиваются через YAML.
Диапазоны слотов можно использовать для рамок и декора.
Клики по предметам выполняют настроенные actions.
Аддон использует системы hClans для регистрации команд, actions и плейсхолдеров.

Зависимости: hClans - ОБЯЗАТЕЛЬНО

Команды и права: Всё написано выше

Платно Плагин ⭐ hClansMenuAddon [1.16.X-26.X] ⭐ | Дополнение для плагина hClans v1.0

Другие ресурсы пользователя He3HaukaX

Поделиться ресурсом

Мы ценим вашу конфиденциальность