Плагин GUI Abstract Menus [1.17.5-beta]

Описание плагина Abstract Menus:​

Abstract Menus - это плагин Spigot, с помощью которого можно создавать простые или сложные интерактивные меню. Основное отличие этого плагина от других подобных в больших возможностях по настройке и оптимизации меню и большом количестве инструментов для создания сложных графических интерфейсов. Этот плагин может легко заменить большинство плагинов для создания графического интерфейса, а также некоторые другие простые плагины только с графическим интерфейсом.

Основные понятия плагина Abstract Menus:​

Файл "Меню:​

Файл, находящийся в папке menus в каталоге плагина AbstractMenus. В файле меню можно описать одно или несколько меню.

Тип данных.:​

Один из способов описания некоторых данных с помощью синтаксиса HOCON.

Активатор:​

Событие, вызвавшее открытие меню.

Правило:​

Условие. Например, есть ли у игрока разрешение, деньги и т.д.

Действие:​

Действие, которое может быть выполнено. Например, действие givePermission дает игроку некоторое разрешение.

Item:​

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

Placeholder:​

Часть текста, заключенная в %, которая заменяется на некоторые данные, например, на ник игрока.

Связки:​

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

Переменная:​

Любое текстовое или числовое значение, сохраняемое в базе данных плагина с возможностью его изменения или использования через placeholders.

Шаблон:​

Любой блок или параметр в файле, который может быть вставлен в любое место файла меню. Шаблоны существуют в первую очередь для того, чтобы исключить копирование целых блоков, например, пунктов, и для удобства редактирования меню в будущем.

Анимационный кадр (Animation frame):​

Блок анимации, содержащий заданные в кадре элементы и другие полезные параметры.

Каталог:​

Динамическая коллекция некоторых объектов, используемых для генерации меню.

Экстрактор значений (Value Extractor):​

Поставщик значений, который принимает контекстный объект-заполнитель и возвращает некоторое значение этого объекта. Обычно используется активаторами и каталогами.

Контекстный объект (placeholder):​

Специальный провайдер, который использует один из экстракторов значений для предоставления некоторых свойств контекстных объектов через провайдеры. Например, плацехолдеры активаторов (%activator_<extractor_placeholder>%).

Команды плагина Abstract Menus:​

/am open <Название_меню> — Открыть меню без активаторов.
/am open <Название_меню> <Ник Игрока> — Открыть меню для некоторого игрока без активаторов.
/am reload — Перезагрузить все меню из папки menus. For full plugin reloading we advice you reload server.
/am serve — Слушать обновления файлов и автоматически перезагружать меню. Use it only while you developing menus.
/var get <Название> — Вывести значение глобальной переменной.
/var set <Название> <Значение> — Создать или изменить глобальную переменную.
/var set <Название> <Значение> <true/false replace protection> — Создание или изменение глобальной переменной с защитой от изменений.
/var set <Название> <Значение> <Время> — Создание или изменение временной глобальной переменной.
/var set <Название> <Значение> <Время> <true/false replace protection> — Создать или изменить временную глобальную переменную с защитой от изменений.
/var rem <Название> — Удалить глобальную переменную.
/var inc <Название> <Номер> — Увеличить числовую глобальную переменную.
/var dec <Название> <Номер> — Уменьшить числовую глобальную переменную.
/var mul <Название> <Номер> — Умножение числовой глобальной переменной.
/var div <Название> <Номер> — Делить числовую глобальную переменную.
/varp get <Ник Игрока> <Название> — Вывести значение персональной переменной.
/varp set <Ник Игрока> <Название> <Значение> — Создать или изменить персональную переменную.
/varp set <Ник Игрока> <Название> <Значение> <true/false replace protection> — Создать или изменить персональную переменную с заменой защиты.
/varp set <Ник Игрока> <Название> <Значение> <Время> — Создание или изменение временной персональной переменной.
/varp set <Ник Игрока> <Название> <Значение> <Время> <true/false replace protection> — Создать или изменить временную персональную переменную с заменой защиты.
/varp rem <Ник Игрока> <Название> — Удалить персональную переменную.
/varp inc <Ник Игрока> <Название> <Номер> — Увеличить числовую персональную переменную.
/varp dec <Ник Игрока> <Название> <Номер> — Уменьшить числовую персональную переменную.
/varp mul <Ник Игрока> <Название> <Номер> — Умножение числовой персональной переменной.
/varp div <Ник Игрока> <Название> <Номер> — Разделить числовую персональную переменную.

Права плагина Abstract Menus:​

am.admin - Разрешить использование всех команд, описанных выше.

Поддержка внешних плагинов в плагине Abstract Menus:​

• Vault - Поддержка любого плагина Economy на сервере. Необходим для того, чтобы действия и правила могли манипулировать балансом игрока.
• PlaceholderAPI - Множество заполнителей вместо значений по умолчанию.
• LuckPerms - Для всех действий и правил, использующих разрешения и группы.
• WorldGuard - Необходим для активаторов, использующих регионы WG.
• Citizens - Необходим для корректной работы NPC-активаторов.
• HeadDatabase - Позволяет получить любую голову из большой базы данных в качестве предмета.
• MMOItems - Вы можете получить любой предмет из этого плагина.
• SkinsRestorer - Предназначен для действий по изменению/сбросу скина игрока.
• ItemsAdder - Принимает стек пользовательских предметов, определяемых в реестре плагина по их именному id
• Oraxen - Принимает пользовательский стек предметов, определяемый плагином Oraxen

Установка плагина Abstract Menus:​

1. Скачайте плагин.
2. Выключите сервер
3. Переместите файл .jar в папку /plugins/ вашего сервера.
4. Запустите сервер.
5. Готово.