Бауыржан Сейит

Buyer 1.2.0 — продвинутый скупщик для Minecraft

  1. Основная информация

Название плагина: Buyer Версия плагина: 1.2.0 Файл: "Buyer-1.2.0.jar" Платформа: Paper 26.3 Язык интерфейса: русский Поддержка цветов: HEX "&#RRGGBB" и обычные цвета "&" Экономика: Vault + любой совместимый экономический плагин.

Плагин должен представлять собой полноценного скупщика предметов с красивыми GUI, большим количеством товаров, настраиваемыми ценами, автопродажей, бустами, головами и отдельными действиями на ЛКМ и ПКМ.

Главное требование: нужен рабочий исходный код и готовый JAR без ошибок компиляции и критических ошибок при запуске. Не использовать заглушки вместо реализованных функций.

---

  1. Команды плагина

Основные команды

  • "/buyer" — открыть главное меню скупщика.
  • "/buyer open <игрок>" — открыть скупщика указанному игроку.
  • "/buyer reload" — перезагрузить конфигурации.
  • "/buyer editor" — открыть редактор скупщика.
  • "/buyer prices" — посмотреть цены предметов.
  • "/buyer autosell" — включить или выключить автоскупщик.
  • "/buyer boost" — посмотреть активные бусты.
  • "/buyer help" — список команд.

Права

  • "buyer.use" — использовать скупщика.
  • "buyer.autosell" — использовать автоскупщик.
  • "buyer.boost" — получать бонусы от бустов.
  • "buyer.admin" — доступ к административным командам.
  • "buyer.reload" — перезагружать конфигурацию.
  • "buyer.editor" — открывать редактор.
  • "buyer.open.others" — открывать меню другим игрокам.

Обычный игрок должен иметь доступ к "/buyer" без административных прав.

---

  1. Главное меню скупщика

Команда "/buyer" открывает красивое меню размером 54 слота.

Внешний вид

  • Тёмный фон из стеклянных панелей.
  • Золотые, белые и цветные декоративные элементы.
  • Разные головы для каждой категории.
  • HEX-градиенты в названиях.
  • Красивое описание предметов в lore.
  • Звуки при открытии меню, нажатии кнопок и продаже.
  • Информация о балансе игрока.
  • Информация об активном бусте.
  • Кнопки навигации.
  • Кнопка помощи.
  • Кнопка автоскупщика.
  • Кнопка закрытия меню.

Не заполнять всё меню одинаковыми предметами. Интерфейс должен выглядеть аккуратно и профессионально.

Категории главного меню

  1. Лут и ресурсы.
  2. Руды и минералы.
  3. Драгоценные материалы.
  4. Дроп мобов.
  5. Фермерство.
  6. Растения и урожай.
  7. Дерево и древесина.
  8. Данжи и редкий лут.
  9. Автоскупщик.
  10. Бусты продажи.
  11. Информация и помощь.

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

Все категории должны настраиваться через конфигурацию.

---

  1. Красивые головы для меню

Использовать разные текстуры голов для оформления категорий.

Цвета и оформление

  • Лут и ресурсы — золотая голова.
  • Руды — оранжевая или жёлтая голова.
  • Драгоценности — голубая голова.
  • Мобы — красная голова.
  • Фермерство — зелёная голова.
  • Дерево — коричневая голова.
  • Данжи — тёмно-фиолетовая голова.
  • Автоскупщик — бирюзовая голова.
  • Бусты — фиолетовая голова.
  • Информация — синяя голова.
  • Назад — бирюзовая голова.
  • Закрытие — красная голова.
  • Помощь — отдельная информационная голова.

Требования к головам

  1. Для каждой категории можно указать собственную текстуру.
  2. Поддерживать текстуры через Base64.
  3. Разрешить изменять название и описание каждой головы.
  4. Разрешить выбирать слот для каждой головы.
  5. Добавить настройку свечения предметов, если оно поддерживается выбранным способом.
  6. Если текстура не загрузилась или указана неверно, использовать запасной предмет.
  7. Все текстуры хранить в конфигурации "menus.yml".

Не оставлять в готовом плагине нерабочие значения вроде "BASE64_TEXTURE". Если нужны Base64-текстуры, предоставить реальные значения либо использовать корректный механизм их настройки.

---

  1. ЛКМ и ПКМ — основные функции

Реализовать отдельную обработку левой и правой кнопок мыши.

На товаре в меню

ЛКМ — быстрая продажа:

  • Продать 1 единицу предмета.
  • Если у игрока нет предмета, показать сообщение.
  • Если продажа прошла успешно, начислить деньги.
  • Обновить меню и количество доступных предметов.

ПКМ — открыть меню предмета:

  • Открыть подробное меню выбранного товара.
  • Показать цену за одну единицу.
  • Показать количество предметов в инвентаре.
  • Показать общую стоимость доступных предметов.
  • Предложить продать выбранное количество.

Действия должны настраиваться отдельно для каждой категории и каждого предмета.

Пример описания предмета

Название:

"&#FFEA70&lАЛМАЗ"

Описание:

  • "&#A0A0A0Цена: &#70FF70$250"
  • "&#A0A0A0В инвентаре: &#FFFFFF12 шт."
  • "&#8CFF70ЛКМ &7— продать 1 шт."
  • "&#70CFFFПКМ &7— открыть меню предмета"

Цена "$250" является примером и должна изменяться через конфигурацию.

---

  1. Подробное меню предмета

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

Информация

  • Название предмета.
  • Иконка предмета.
  • Цена за одну единицу.
  • Количество в инвентаре.
  • Общая стоимость.
  • Активный множитель продажи.
  • Итоговая стоимость с учётом буста.

Кнопки продажи

  • Продать 1 шт.
  • Продать 16 шт.
  • Продать 32 шт.
  • Продать всё.
  • Включить или выключить автоскупщик для предмета.
  • Назад.
  • Закрыть меню.

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

ЛКМ и ПКМ на кнопках

  • ЛКМ по кнопке продажи — выполнить продажу.
  • ПКМ по кнопке продажи — запросить подтверждение, если подтверждение включено.
  • ЛКМ по кнопке автоскупщика — переключить его состояние.
  • ЛКМ по кнопке «Назад» — вернуться в предыдущую категорию.
  • ЛКМ по кнопке закрытия — закрыть меню.

При необходимости добавить отдельную настройку подтверждения продажи редких и дорогих предметов.

---

  1. Категория «Лут и ресурсы»

Добавить как можно больше распространённых ресурсов Minecraft.

Основные материалы

  • Камень.
  • Булыжник.
  • Глубинный сланец.
  • Гранит.
  • Диорит.
  • Андезит.
  • Земля.
  • Каменистая земля.
  • Гравий.
  • Песок.
  • Красный песок.
  • Глина.
  • Кирпичи.
  • Обсидиан.
  • Плачущий обсидиан.
  • Блоки мха.
  • Блоки грязи.
  • Песчаник.
  • Красный песчаник.
  • Кварцевые блоки.
  • Призмарин.
  • Морской фонарь.
  • Аметистовые блоки.

Дополнительные материалы

  • Верёвки-паутины.
  • Костры.
  • Бумага.
  • Книги.
  • Кожа.
  • Перья.
  • Чернила.
  • Светящиеся чернила.
  • Кости.
  • Порох.
  • Гнилая плоть.
  • Слизь.
  • Магматический крем.
  • Эндер-жемчуг.
  • Снежки.
  • Снежные блоки.
  • Соты.
  • Пчелиные бутылочки.
  • Панцири черепах.
  • Прочие полезные ресурсы.

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

---

  1. Категория «Руды и минералы»

Добавить все подходящие руды и материалы для продажи.

Руды

  • Угольная руда.
  • Глубинная угольная руда.
  • Железная руда.
  • Глубинная железная руда.
  • Медная руда.
  • Глубинная медная руда.
  • Золотая руда.
  • Глубинная золотая руда.
  • Редстоуновая руда.
  • Глубинная редстоуновая руда.
  • Лазуритовая руда.
  • Глубинная лазуритовая руда.
  • Алмазная руда.
  • Глубинная алмазная руда.
  • Изумрудная руда.
  • Глубинная изумрудная руда.
  • Незерская кварцевая руда.
  • Незерская золотая руда.
  • Древние обломки.

Слитки и минералы

  • Уголь.
  • Древесный уголь.
  • Железный слиток.
  • Золотой слиток.
  • Медный слиток.
  • Алмаз.
  • Изумруд.
  • Лазурит.
  • Редстоун.
  • Кварц Нижнего мира.
  • Незеритовый лом.
  • Незеритовый слиток.
  • Самородки железа.
  • Самородки золота.
  • Самородки меди.
  • Аметистовые осколки.

Блоки ресурсов

  • Блок угля.
  • Блок железа.
  • Блок золота.
  • Блок меди.
  • Блок алмазов.
  • Блок изумрудов.
  • Блок лазурита.
  • Блок редстоуна.
  • Кварцевый блок.
  • Незеритовый блок.

Для всех товаров задать отдельные цены.

---

  1. Категория «Драгоценные материалы»

Добавить отдельную категорию для дорогих предметов:

  • Алмазы.
  • Изумруды.
  • Незеритовые слитки.
  • Древние обломки.
  • Золотые блоки.
  • Алмазные блоки.
  • Изумрудные блоки.
  • Зачарованные золотые яблоки.
  • Звёзды Незера.
  • Элитры.
  • Тотемы бессмертия.
  • Шалкеровые панцири.
  • Сердца моря.
  • Кристаллы Энда.
  • Драконье дыхание.
  • Прочие редкие предметы.

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

---

  1. Категория «Дроп мобов»

Добавить товары, получаемые с мобов.

Обычный дроп

  • Гнилая плоть.
  • Кости.
  • Стрелы.
  • Порох.
  • Нити.
  • Паучьи глаза.
  • Слизь.
  • Магматический крем.
  • Эндер-жемчуг.
  • Перья.
  • Кожа.
  • Сырая говядина.
  • Сырая свинина.
  • Сырая баранина.
  • Сырая курятина.
  • Сырая крольчатина.
  • Кроличья шкурка.
  • Чернильные мешки.
  • Светящиеся чернильные мешки.
  • Медовые соты.
  • Панцири черепах.

Редкий дроп

  • Стержни ифритов.
  • Слёзы гаста.
  • Огненный порошок.
  • Золотые самородки.
  • Золотые слитки.
  • Черепашьи щитки.
  • Фантомные мембраны.
  • Осколки эха.
  • Черепа скелетов-иссушителей.
  • Прочие предметы, выпадающие с мобов.

Требования

  • Каждый предмет имеет отдельную цену.
  • Все цены изменяются через "prices.yml".
  • Возможность отключить отдельные предметы.
  • Поддержка любых предметов, которые существуют в целевой версии Paper.
  • Не добавлять несуществующие материалы в код.

---

  1. Категория «Фермерство»

Добавить товары для фермеров.

Урожай и растения

  • Пшеница.
  • Семена пшеницы.
  • Морковь.
  • Картофель.
  • Свёкла.
  • Семена свёклы.
  • Арбузные ломтики.
  • Арбузные блоки.
  • Тыквы.
  • Сахарный тростник.
  • Кактусы.
  • Бамбук.
  • Какао-бобы.
  • Сладкие ягоды.
  • Светящиеся ягоды.
  • Яблоки.
  • Золотые яблоки.
  • Сушёная ламинария.
  • Ламинария.
  • Морские огурцы.
  • Грибы.
  • Свёкольный суп.
  • Тыквенный пирог.
  • Хлеб.
  • Сахар.
  • Сахарная пудра не требуется, если такого предмета нет в игре.
  • Сено.
  • Мёд.
  • Бутылочки мёда.

Цветы и другие растения

  • Одуванчики.
  • Маки.
  • Васильки.
  • Тюльпаны.
  • Орхидеи.
  • Аллиумы.
  • Ландыши.
  • Подсолнухи.
  • Сирень.
  • Пионы.
  • Розовые лепестки.
  • Лепестки хоруса.
  • Лоза.
  • Плакучая лоза.
  • Споровый цветок.
  • Мох.
  • Азалия.
  • Цветущая азалия.
  • Все стандартные цветы Minecraft.

Функции

  • Продажа урожая.
  • Продажа семян.
  • Продажа растений.
  • Настраиваемые цены.
  • Быстрая продажа через ЛКМ.
  • Подробное меню через ПКМ.
  • Автопродажа выбранных товаров.

---

  1. Категория «Дерево и древесина»

Добавить древесину всех стандартных видов.

Виды дерева

  • Дуб.
  • Ель.
  • Берёза.
  • Джунгли.
  • Акация.
  • Тёмный дуб.
  • Мангровое дерево.
  • Вишня.
  • Бледный дуб.
  • Багровое дерево Нижнего мира.
  • Искажённое дерево Нижнего мира.

Для каждого вида добавить, если соответствующие предметы существуют в целевой версии:

  • Бревно.
  • Очищенное бревно.
  • Древесину.
  • Доски.
  • Палочки.
  • Ступеньки.
  • Плиты.
  • Заборы.
  • Калитки.
  • Двери.
  • Люки.
  • Кнопки.
  • Таблички.
  • Подвесные таблички.
  • Саженцы.
  • Листья.

Каждый товар должен иметь собственную цену и возможность отключения.

---

  1. Категория «Данжи и редкий лут»

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

Примеры:

  • Осколки эха.
  • Музыкальные пластинки.
  • Зачарованные книги.
  • Золотые яблоки.
  • Зачарованные золотые яблоки.
  • Тотемы бессмертия.
  • Шалкеровые панцири.
  • Кристаллы Энда.
  • Звёзды Незера.
  • Сердца моря.
  • Кондуиты.
  • Драконье дыхание.
  • Незеритовые улучшения.
  • Шаблоны кузнечного дела.
  • Ключи испытаний.
  • Зловещие ключи испытаний.
  • Прочие редкие предметы из структур.

Редкий лут должен настраиваться отдельно. Нельзя автоматически продавать такие предметы без разрешения владельца сервера.

---

  1. Автоскупщик

Добавить полноценную систему автоматической продажи.

Возможности

  • Включение и выключение через GUI.
  • Команда "/buyer autosell".
  • Автопродажа выбранных предметов.
  • Настройка отдельных товаров для автопродажи.
  • Настройка задержки между проверками.
  • Настройка минимального количества предметов.
  • Настройка исключений.
  • Отображение состояния в меню.
  • Уведомление о полученных деньгах.
  • Настройка режима без сообщений.

Важные правила

  • Автоскупщик не должен удалять предметы, которые не входят в список разрешённых товаров.
  • Не продавать предметы, которые находятся в защищённых меню или контейнерах.
  • Не продавать экипировку и предметы с пользовательскими данными без специального разрешения.
  • При отключённом автоскупщике предметы не продаются.
  • Не начислять деньги дважды за одну продажу.

---

  1. Система бустов продажи

Добавить возможность увеличивать стоимость товаров.

Примеры бустов

  • x1.5 — +50%.
  • x2.0 — удвоенная цена.
  • x2.5 — +150%.
  • x3.0 — утроенная цена.

Значения являются примерами и должны настраиваться.

Возможности

  • Временные бусты.
  • Персональные бусты.
  • Общие серверные бусты.
  • Настройка длительности.
  • Настройка множителя.
  • Настройка разрешённых категорий.
  • Возможность включать и отключать бусты через конфигурацию.
  • Отображение оставшегося времени.
  • Уведомление при активации и завершении буста.

Итоговая стоимость должна рассчитываться правильно с учётом цены, количества и множителя.

Пример:

Цена предмета — 100 монет. Количество — 10. Буст — x2.

Итоговая выплата: 100 × 10 × 2 = 2000 монет.

Не применять один и тот же множитель несколько раз к одной продаже.

---

  1. Меню помощи

В главном меню должна быть отдельная голова «Помощь».

При нажатии открывается красивое меню с объяснением управления.

Текст помощи

  • "&#FFEA70&lПОМОЩЬ"
  • "&#FFFFFFЛКМ &7— быстрая продажа 1 предмета"
  • "&#70CFFFПКМ &7— подробное меню товара"
  • "&#8CFF70Продать всё &7— продажа всех доступных предметов"
  • "&#D580FFАвтоскупщик &7— автоматическая продажа"
  • "&#FFD95AБусты &7— увеличение цены продажи"
  • "&#FF7070Редкие предметы &7— проверяйте перед продажей"

Добавить кнопку «Назад», возвращающую игрока в главное меню.

Весь текст должен редактироваться через "messages.yml" или "menus.yml".

---

  1. Редактор скупщика

Команда "/buyer editor" открывает административное меню.

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

Возможности редактора

  • Добавление товара.
  • Удаление товара.
  • Изменение цены.
  • Изменение названия.
  • Изменение описания.
  • Выбор категории.
  • Выбор слота.
  • Включение и отключение товара.
  • Настройка ЛКМ.
  • Настройка ПКМ.
  • Включение и отключение автопродажи товара.
  • Настройка подтверждения продажи.
  • Настройка головы категории.
  • Настройка буста.
  • Настройка оформления меню.

Редактирование товара

Администратор выбирает предмет, затем может изменить:

  • Материал.
  • Название.
  • Описание.
  • Цену за единицу.
  • Категорию.
  • Слот.
  • Разрешение на продажу.
  • Возможность автопродажи.
  • Действие на ЛКМ.
  • Действие на ПКМ.
  • Требование подтверждения.
  • Отображение предмета в GUI.

После изменений редактор должен корректно сохранять данные в конфигурацию.

Если настройка некорректна, показать понятную ошибку, а не ломать меню.

---

  1. Настройка цветов HEX

Поддерживать формат:

"&#RRGGBB"

Примеры:

  • "&#FFEA70" — золотой.
  • "&#FFD95A" — жёлтый.
  • "&#8CFF70" — зелёный.
  • "&#70CFFF" — голубой.
  • "&#D580FF" — фиолетовый.
  • "&#FF7070" — красный.
  • "&#FFFFFF" — белый.
  • "&#A0A0A0" — серый.

Также поддерживать стандартные коды:

  • "&0"–"&9".
  • "&a"–"&f".
  • "&l" — жирный текст.
  • "&o" — курсив.
  • "&n" — подчёркивание.
  • "&m" — зачёркивание.
  • "&r" — сброс форматирования.

HEX-цвета должны работать в:

  • Названиях меню.
  • Названиях предметов.
  • Lore.
  • Сообщениях.
  • Уведомлениях.
  • Описаниях голов.
  • Меню редактора.
  • Меню бустов.

---

  1. Конфигурационные файлы

Создать отдельные YAML-файлы.

"config.yml"

Основные настройки:

  • Версия конфигурации.
  • Название плагина.
  • Настройки экономики.
  • Настройки GUI.
  • Звуки.
  • Автоскупщик.
  • Безопасность.
  • Логирование.
  • Настройки продажи.

"prices.yml"

Содержит список товаров и цены.

Пример:

items:

DIAMOND: enabled: true category: ores price: 250.0 autosell: true confirm: false

EMERALD: enabled: true category: ores price: 180.0 autosell: true confirm: false

NETHERITE_INGOT: enabled: true category: valuables price: 5000.0 autosell: false confirm: true

ANCIENT_DEBRIS: enabled: true category: valuables price: 1500.0 autosell: false confirm: true

Цены приведены как пример. Администратор должен иметь возможность менять их.

"menus.yml"

Содержит:

  • Размеры меню.
  • Названия.
  • Слоты.
  • Иконки.
  • Головы.
  • Текстуры.
  • Описания.
  • HEX-цвета.
  • Декоративные панели.
  • Кнопки навигации.
  • Действия ЛКМ и ПКМ.

Пример настройки действий:

click-actions: enabled: true

item: left: action: sell amount: 1 right: action: open_item_menu

sell-buttons: left: action: confirm_sell right: action: confirm_sell confirmation: true

autosell: left: action: toggle_autosell

back: left: action: go_back

close: left: action: close

"messages.yml"

Содержит все сообщения плагина:

  • Продажа выполнена.
  • Недостаточно предметов.
  • Нет разрешения.
  • Предмет отсутствует в инвентаре.
  • Автоскупщик включён.
  • Автоскупщик выключен.
  • Буст активирован.
  • Буст завершён.
  • Конфигурация перезагружена.
  • Ошибка настройки.
  • Ошибка экономики.

"boost.yml"

Содержит:

  • Названия бустов.
  • Множители.
  • Длительность.
  • Тип буста.
  • Разрешённые категории.
  • Сообщения.
  • Звуки.

"categories.yml"

Содержит:

  • Список категорий.
  • Названия.
  • Иконки.
  • Текстуры голов.
  • Слоты.
  • Описания.
  • Список товаров.
  • Доступность категорий.

"players.yml"

Если необходимо хранить индивидуальные настройки игроков:

  • Состояние автоскупщика.
  • Персональные бусты.
  • Пользовательские настройки.
  • Другие данные, которые должны сохраняться между перезапусками.

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

---

  1. Безопасность продажи

Это обязательная часть разработки.

  1. Нельзя начислять деньги без фактического удаления предметов.
  2. Нельзя продавать один предмет несколько раз одним нажатием.
  3. Проверять количество предметов непосредственно перед продажей.
  4. Корректно учитывать одинаковые предметы в нескольких слотах.
  5. Не продавать предметы из чужого инвентаря.
  6. Не разрешать забирать декоративные предметы из GUI.
  7. Блокировать перемещение предметов внутри меню.
  8. Блокировать Shift-click, перетаскивание и другие способы обхода интерфейса.
  9. Не выполнять продажу при закрытии меню.
  10. Не допускать дублирования денег из-за двойного клика.
  11. Не продавать неподдерживаемые предметы.
  12. Проверять корректность цены.
  13. Запрещать отрицательные и некорректные цены.
  14. Не допускать ошибок при отключении экономики.
  15. Защищать редкие предметы настройками подтверждения.
  16. Корректно обрабатывать перезапуск сервера.
  17. Не использовать устаревшие или несуществующие API.
  18. Все GUI-события должны корректно обрабатываться на серверном потоке.

Продажа должна проходить по безопасной схеме: проверить предметы и цену, удалить ровно указанное количество, выполнить начисление через экономическую систему и обновить меню. При ошибке необходимо корректно обработать операцию и не допускать повторной выплаты.

---

  1. Vault и экономика

Плагин должен интегрироваться с Vault.

Требования:

  • Проверка наличия Vault при запуске.
  • Проверка доступности экономического провайдера.
  • Использование стандартного API экономики.
  • Корректное начисление средств.
  • Поддержка дробных значений, если их разрешает экономика.
  • Сообщение администратору при отсутствии экономического провайдера.
  • Запрет продажи, если начисление денег невозможно.
  • Не создавать собственную валюту вместо Vault.

В "plugin.yml" правильно указать зависимость или мягкую зависимость в соответствии с выбранной реализацией.

---

  1. Производительность
  • Не сканировать весь инвентарь каждый тик без необходимости.
  • Не создавать бесконечные повторяющиеся задачи.
  • Корректно удалять задачи при выходе игрока или выключении плагина.
  • Не перезагружать конфигурацию при каждом клике.
  • Не обращаться к файлам на диске при каждом действии игрока.
  • Кэшировать необходимые данные.
  • Не допускать утечек памяти из-за открытых меню.
  • Поддерживать одновременную работу нескольких игроков.
  • Сохранять настройки игроков корректно.

---

  1. Требования к совместимости
  • Целевая платформа: Paper 26.3
  • Использовать Java-совместимую версию, необходимую для целевой сборки сервера.
  • Использовать корректный "pap
Kodari AI
KodariOct 10 at 9:38 pm 2
Buyer
Продвинутый скупщик предметов для Paper 26.3 с красивыми GUI-меню, поддержкой HEX-цветов и Vault-экономики. Плагин включает 10 настраиваемых категорий товаров, быструю продажу по ЛКМ, подробное меню предмета по ПКМ, систему автоскупщика с индивидуальной настройкой товаров, временные бусты продажи с множителями, редактор для администраторов, подтверждение продажи редких предметов и полную безопасность транзакций. Все цены, меню, головы, текстуры и сообщения настраиваются через отдельные YAML-файлы. Поддерживает русский интерфейс, звуковые эффекты, декоративные панели и градиентные названия.
  1. Создам Paper-плагин Buyer с интеграцией Vault и отдельными YAML-конфигурациями.

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

  3. Добавлю команды, редактор, русские сообщения, HEX-цвета и настройки категорий.

Создан исходный проект Buyer 1.2.0 для Paper: GUI с русскими сообщениями и HEX-цветами, продажа через Vault, каталог и цены в YAML, персональный автоскупщик, глобальные и личные бусты, Base64-головы с запасными иконками и редактор товаров.

Важно: каталог — стартовый набор, а не полный перечень всех предметов из задания. Редактор позволяет добавлять предмет из руки и менять основные параметры товара; действия ЛКМ/ПКМ пока заданы кодом, а не настраиваются через click-actions в menus.yml. Для продаж на сервере нужны Vault и совместимый экономический плагин.

Чтобы получить JAR в Kodari: нажмите Compile в верхней панели (на телефоне: ⋮ → Compile Project), затем Compile в открывшемся окне. После успешной сборки скачайте JAR кнопкой Download.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
manifest.kod
Code
17 1,628
src/main/java/ru/kodari/buyer/BuyerPlugin.java
package ru.kodari.buyer;

import net.milkbowl.vault.economy.Economy;
import org.bukkit.command.CommandSender;
import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;

import java.io.File;
import java.text.DecimalFormat;
import java.text.DecimalFormatSymbols;
import java.util.HashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.UUID;

public final class BuyerPlugin extends JavaPlugin {
    private BuyerService service;
    private BuyerMenu menu;
    private YamlConfiguration messages;
    private final Map<UUID, EditorInput> editorInputs = new HashMap<>();
    private Economy economy;

    @Override
    public void onEnable() {
        getDataFolder().mkdirs();
        saveDefaultConfig();
        for (String file : List.of("messages.yml", "menus.yml", "prices.yml", "categories.yml", "boost.yml", "players.yml"))
            if (!new File(getDataFolder(), file).exists()) saveResource(file, false);
        loadMessages();
        service = new BuyerService(this);
        service.reload();
        menu = new BuyerMenu(this, service);
        BuyerCommand command = new BuyerCommand(this, service, menu);
        getCommand("buyer").setExecutor(command);
        getCommand("buyer").setTabCompleter(command);
        getServer().getPluginManager().registerEvents(new BuyerListener(this, menu), this);
        long interval = Math.max(1L, getConfig().getLong("autosell.interval-seconds", 5L)) * 20L;
        getServer().getScheduler().runTaskTimer(this, service::tickBoosts, 20L, 20L);
        getServer().getScheduler().runTaskTimer(this, service::autosellOnlinePlayers, interval, interval);
        getLogger().info("Buyer 1.2.0 включён.");
    }

    @Override
    public void onDisable() {
        editorInputs.clear();
    }

    public void reloadBuyer() {
        reloadConfig();
        loadMessages();
        service.reload();
        menu.reload();
    }

    private void loadMessages() {
        messages = YamlConfiguration.loadConfiguration(new File(getDataFolder(), "messages.yml"));
    }

    public BuyerService getService() { return service; }
    public BuyerMenu getMenu() { return menu; }
    public Economy getEconomy() { return economy == null ? serviceEconomy() : economy; }
    private Economy serviceEconomy() { return service == null ? null : getRegisteredEconomy(); }
    private Economy getRegisteredEconomy() {
        net.milkbowl.vault.economy.Economy economy = getServer().getServicesManager().load(Economy.class);
        this.economy = economy;
        return economy;
    }

    public String formatMoney(double value) {
        DecimalFormatSymbols symbols = DecimalFormatSymbols.getInstance(Locale.US);
        DecimalFormat format = new DecimalFormat("#,##0.##", symbols);
        return format.format(value) + getConfig().getString("economy.currency-symbol", "$ ").trim();
    }

    public void sendRaw(CommandSender sender, String key) {
        String prefix = messages.getString("prefix", "");
        sender.sendMessage(TextUtil.color(prefix + messages.getString(key, "&cСообщение не настроено: " + key)));
    }

    public void send(CommandSender sender, String key, Map<String, String> placeholders) {
        String value = messages.getString(key, "&cСообщение не настроено: " + key);
        for (Map.Entry<String, String> entry : placeholders.entrySet())
            value = value.replace("%" + entry.getKey() + "%", entry.getValue());
        sender.sendMessage(TextUtil.color(messages.getString("prefix", "") + value));
    }

    public void sendLines(CommandSender sender, String key) {
        for (String line : messages.getStringList(key)) sender.sendMessage(TextUtil.color(line));
    }

    public void beginEditorInput(Player player, String material, String field) {
        if (!player.hasPermission("buyer.editor")) { sendRaw(player, "no-permission"); return; }
        editorInputs.put(player.getUniqueId(), new EditorInput(material, field));
        player.closeInventory();
        String message = switch (field) {
            case "editor_price" -> "editor-prompt-price";
            case "editor_name" -> "editor-prompt-name";
            default -> "editor-prompt-lore";
        };
        sendRaw(player, message);
    }

    public EditorInput getEditorInput(UUID uuid) { return editorInputs.get(uuid); }
    public void clearEditorInput(UUID uuid) { editorInputs.remove(uuid); }
    public record EditorInput(String material, String field) { }
}