Buyer 1.2.0 — продвинутый скупщик для Minecraft
- Основная информация
Название плагина: Buyer Версия плагина: 1.2.0 Файл: "Buyer-1.2.0.jar" Платформа: Paper 26.3 Язык интерфейса: русский Поддержка цветов: HEX "&#RRGGBB" и обычные цвета "&" Экономика: Vault + любой совместимый экономический плагин.
Плагин должен представлять собой полноценного скупщика предметов с красивыми GUI, большим количеством товаров, настраиваемыми ценами, автопродажей, бустами, головами и отдельными действиями на ЛКМ и ПКМ.
Главное требование: нужен рабочий исходный код и готовый JAR без ошибок компиляции и критических ошибок при запуске. Не использовать заглушки вместо реализованных функций.
---
- Команды плагина
Основные команды
- "/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" без административных прав.
---
- Главное меню скупщика
Команда "/buyer" открывает красивое меню размером 54 слота.
Внешний вид
- Тёмный фон из стеклянных панелей.
- Золотые, белые и цветные декоративные элементы.
- Разные головы для каждой категории.
- HEX-градиенты в названиях.
- Красивое описание предметов в lore.
- Звуки при открытии меню, нажатии кнопок и продаже.
- Информация о балансе игрока.
- Информация об активном бусте.
- Кнопки навигации.
- Кнопка помощи.
- Кнопка автоскупщика.
- Кнопка закрытия меню.
Не заполнять всё меню одинаковыми предметами. Интерфейс должен выглядеть аккуратно и профессионально.
Категории главного меню
- Лут и ресурсы.
- Руды и минералы.
- Драгоценные материалы.
- Дроп мобов.
- Фермерство.
- Растения и урожай.
- Дерево и древесина.
- Данжи и редкий лут.
- Автоскупщик.
- Бусты продажи.
- Информация и помощь.
Каждая категория открывает отдельное меню с товарами.
Все категории должны настраиваться через конфигурацию.
---
- Красивые головы для меню
Использовать разные текстуры голов для оформления категорий.
Цвета и оформление
- Лут и ресурсы — золотая голова.
- Руды — оранжевая или жёлтая голова.
- Драгоценности — голубая голова.
- Мобы — красная голова.
- Фермерство — зелёная голова.
- Дерево — коричневая голова.
- Данжи — тёмно-фиолетовая голова.
- Автоскупщик — бирюзовая голова.
- Бусты — фиолетовая голова.
- Информация — синяя голова.
- Назад — бирюзовая голова.
- Закрытие — красная голова.
- Помощь — отдельная информационная голова.
Требования к головам
- Для каждой категории можно указать собственную текстуру.
- Поддерживать текстуры через Base64.
- Разрешить изменять название и описание каждой головы.
- Разрешить выбирать слот для каждой головы.
- Добавить настройку свечения предметов, если оно поддерживается выбранным способом.
- Если текстура не загрузилась или указана неверно, использовать запасной предмет.
- Все текстуры хранить в конфигурации "menus.yml".
Не оставлять в готовом плагине нерабочие значения вроде "BASE64_TEXTURE". Если нужны Base64-текстуры, предоставить реальные значения либо использовать корректный механизм их настройки.
---
- ЛКМ и ПКМ — основные функции
Реализовать отдельную обработку левой и правой кнопок мыши.
На товаре в меню
ЛКМ — быстрая продажа:
- Продать 1 единицу предмета.
- Если у игрока нет предмета, показать сообщение.
- Если продажа прошла успешно, начислить деньги.
- Обновить меню и количество доступных предметов.
ПКМ — открыть меню предмета:
- Открыть подробное меню выбранного товара.
- Показать цену за одну единицу.
- Показать количество предметов в инвентаре.
- Показать общую стоимость доступных предметов.
- Предложить продать выбранное количество.
Действия должны настраиваться отдельно для каждой категории и каждого предмета.
Пример описания предмета
Название:
"&#FFEA70&lАЛМАЗ"
Описание:
- "&#A0A0A0Цена: FFF70$250"
- "&#A0A0A0В инвентаре: &#FFFFFF12 шт."
- "CFF70ЛКМ &7— продать 1 шт."
- "FCFFFПКМ &7— открыть меню предмета"
Цена "$250" является примером и должна изменяться через конфигурацию.
---
- Подробное меню предмета
При нажатии ПКМ на товар открывается отдельное меню.
Информация
- Название предмета.
- Иконка предмета.
- Цена за одну единицу.
- Количество в инвентаре.
- Общая стоимость.
- Активный множитель продажи.
- Итоговая стоимость с учётом буста.
Кнопки продажи
- Продать 1 шт.
- Продать 16 шт.
- Продать 32 шт.
- Продать всё.
- Включить или выключить автоскупщик для предмета.
- Назад.
- Закрыть меню.
Если у игрока меньше предметов, чем указано на кнопке, продавать только доступное количество либо показывать сообщение — поведение должно настраиваться.
ЛКМ и ПКМ на кнопках
- ЛКМ по кнопке продажи — выполнить продажу.
- ПКМ по кнопке продажи — запросить подтверждение, если подтверждение включено.
- ЛКМ по кнопке автоскупщика — переключить его состояние.
- ЛКМ по кнопке «Назад» — вернуться в предыдущую категорию.
- ЛКМ по кнопке закрытия — закрыть меню.
При необходимости добавить отдельную настройку подтверждения продажи редких и дорогих предметов.
---
- Категория «Лут и ресурсы»
Добавить как можно больше распространённых ресурсов Minecraft.
Основные материалы
- Камень.
- Булыжник.
- Глубинный сланец.
- Гранит.
- Диорит.
- Андезит.
- Земля.
- Каменистая земля.
- Гравий.
- Песок.
- Красный песок.
- Глина.
- Кирпичи.
- Обсидиан.
- Плачущий обсидиан.
- Блоки мха.
- Блоки грязи.
- Песчаник.
- Красный песчаник.
- Кварцевые блоки.
- Призмарин.
- Морской фонарь.
- Аметистовые блоки.
Дополнительные материалы
- Верёвки-паутины.
- Костры.
- Бумага.
- Книги.
- Кожа.
- Перья.
- Чернила.
- Светящиеся чернила.
- Кости.
- Порох.
- Гнилая плоть.
- Слизь.
- Магматический крем.
- Эндер-жемчуг.
- Снежки.
- Снежные блоки.
- Соты.
- Пчелиные бутылочки.
- Панцири черепах.
- Прочие полезные ресурсы.
Не добавлять предметы, которые нельзя нормально продать или которые могут привести к ошибкам. Список товаров должен редактироваться.
---
- Категория «Руды и минералы»
Добавить все подходящие руды и материалы для продажи.
Руды
- Угольная руда.
- Глубинная угольная руда.
- Железная руда.
- Глубинная железная руда.
- Медная руда.
- Глубинная медная руда.
- Золотая руда.
- Глубинная золотая руда.
- Редстоуновая руда.
- Глубинная редстоуновая руда.
- Лазуритовая руда.
- Глубинная лазуритовая руда.
- Алмазная руда.
- Глубинная алмазная руда.
- Изумрудная руда.
- Глубинная изумрудная руда.
- Незерская кварцевая руда.
- Незерская золотая руда.
- Древние обломки.
Слитки и минералы
- Уголь.
- Древесный уголь.
- Железный слиток.
- Золотой слиток.
- Медный слиток.
- Алмаз.
- Изумруд.
- Лазурит.
- Редстоун.
- Кварц Нижнего мира.
- Незеритовый лом.
- Незеритовый слиток.
- Самородки железа.
- Самородки золота.
- Самородки меди.
- Аметистовые осколки.
Блоки ресурсов
- Блок угля.
- Блок железа.
- Блок золота.
- Блок меди.
- Блок алмазов.
- Блок изумрудов.
- Блок лазурита.
- Блок редстоуна.
- Кварцевый блок.
- Незеритовый блок.
Для всех товаров задать отдельные цены.
---
- Категория «Драгоценные материалы»
Добавить отдельную категорию для дорогих предметов:
- Алмазы.
- Изумруды.
- Незеритовые слитки.
- Древние обломки.
- Золотые блоки.
- Алмазные блоки.
- Изумрудные блоки.
- Зачарованные золотые яблоки.
- Звёзды Незера.
- Элитры.
- Тотемы бессмертия.
- Шалкеровые панцири.
- Сердца моря.
- Кристаллы Энда.
- Драконье дыхание.
- Прочие редкие предметы.
Редкие предметы должны быть отключены для продажи по умолчанию либо иметь отдельную настройку подтверждения, чтобы игрок не продал их случайно.
---
- Категория «Дроп мобов»
Добавить товары, получаемые с мобов.
Обычный дроп
- Гнилая плоть.
- Кости.
- Стрелы.
- Порох.
- Нити.
- Паучьи глаза.
- Слизь.
- Магматический крем.
- Эндер-жемчуг.
- Перья.
- Кожа.
- Сырая говядина.
- Сырая свинина.
- Сырая баранина.
- Сырая курятина.
- Сырая крольчатина.
- Кроличья шкурка.
- Чернильные мешки.
- Светящиеся чернильные мешки.
- Медовые соты.
- Панцири черепах.
Редкий дроп
- Стержни ифритов.
- Слёзы гаста.
- Огненный порошок.
- Золотые самородки.
- Золотые слитки.
- Черепашьи щитки.
- Фантомные мембраны.
- Осколки эха.
- Черепа скелетов-иссушителей.
- Прочие предметы, выпадающие с мобов.
Требования
- Каждый предмет имеет отдельную цену.
- Все цены изменяются через "prices.yml".
- Возможность отключить отдельные предметы.
- Поддержка любых предметов, которые существуют в целевой версии Paper.
- Не добавлять несуществующие материалы в код.
---
- Категория «Фермерство»
Добавить товары для фермеров.
Урожай и растения
- Пшеница.
- Семена пшеницы.
- Морковь.
- Картофель.
- Свёкла.
- Семена свёклы.
- Арбузные ломтики.
- Арбузные блоки.
- Тыквы.
- Сахарный тростник.
- Кактусы.
- Бамбук.
- Какао-бобы.
- Сладкие ягоды.
- Светящиеся ягоды.
- Яблоки.
- Золотые яблоки.
- Сушёная ламинария.
- Ламинария.
- Морские огурцы.
- Грибы.
- Свёкольный суп.
- Тыквенный пирог.
- Хлеб.
- Сахар.
- Сахарная пудра не требуется, если такого предмета нет в игре.
- Сено.
- Мёд.
- Бутылочки мёда.
Цветы и другие растения
- Одуванчики.
- Маки.
- Васильки.
- Тюльпаны.
- Орхидеи.
- Аллиумы.
- Ландыши.
- Подсолнухи.
- Сирень.
- Пионы.
- Розовые лепестки.
- Лепестки хоруса.
- Лоза.
- Плакучая лоза.
- Споровый цветок.
- Мох.
- Азалия.
- Цветущая азалия.
- Все стандартные цветы Minecraft.
Функции
- Продажа урожая.
- Продажа семян.
- Продажа растений.
- Настраиваемые цены.
- Быстрая продажа через ЛКМ.
- Подробное меню через ПКМ.
- Автопродажа выбранных товаров.
---
- Категория «Дерево и древесина»
Добавить древесину всех стандартных видов.
Виды дерева
- Дуб.
- Ель.
- Берёза.
- Джунгли.
- Акация.
- Тёмный дуб.
- Мангровое дерево.
- Вишня.
- Бледный дуб.
- Багровое дерево Нижнего мира.
- Искажённое дерево Нижнего мира.
Для каждого вида добавить, если соответствующие предметы существуют в целевой версии:
- Бревно.
- Очищенное бревно.
- Древесину.
- Доски.
- Палочки.
- Ступеньки.
- Плиты.
- Заборы.
- Калитки.
- Двери.
- Люки.
- Кнопки.
- Таблички.
- Подвесные таблички.
- Саженцы.
- Листья.
Каждый товар должен иметь собственную цену и возможность отключения.
---
- Категория «Данжи и редкий лут»
Добавить предметы, получаемые при исследовании структур и опасных локаций.
Примеры:
- Осколки эха.
- Музыкальные пластинки.
- Зачарованные книги.
- Золотые яблоки.
- Зачарованные золотые яблоки.
- Тотемы бессмертия.
- Шалкеровые панцири.
- Кристаллы Энда.
- Звёзды Незера.
- Сердца моря.
- Кондуиты.
- Драконье дыхание.
- Незеритовые улучшения.
- Шаблоны кузнечного дела.
- Ключи испытаний.
- Зловещие ключи испытаний.
- Прочие редкие предметы из структур.
Редкий лут должен настраиваться отдельно. Нельзя автоматически продавать такие предметы без разрешения владельца сервера.
---
- Автоскупщик
Добавить полноценную систему автоматической продажи.
Возможности
- Включение и выключение через GUI.
- Команда "/buyer autosell".
- Автопродажа выбранных предметов.
- Настройка отдельных товаров для автопродажи.
- Настройка задержки между проверками.
- Настройка минимального количества предметов.
- Настройка исключений.
- Отображение состояния в меню.
- Уведомление о полученных деньгах.
- Настройка режима без сообщений.
Важные правила
- Автоскупщик не должен удалять предметы, которые не входят в список разрешённых товаров.
- Не продавать предметы, которые находятся в защищённых меню или контейнерах.
- Не продавать экипировку и предметы с пользовательскими данными без специального разрешения.
- При отключённом автоскупщике предметы не продаются.
- Не начислять деньги дважды за одну продажу.
---
- Система бустов продажи
Добавить возможность увеличивать стоимость товаров.
Примеры бустов
- x1.5 — +50%.
- x2.0 — удвоенная цена.
- x2.5 — +150%.
- x3.0 — утроенная цена.
Значения являются примерами и должны настраиваться.
Возможности
- Временные бусты.
- Персональные бусты.
- Общие серверные бусты.
- Настройка длительности.
- Настройка множителя.
- Настройка разрешённых категорий.
- Возможность включать и отключать бусты через конфигурацию.
- Отображение оставшегося времени.
- Уведомление при активации и завершении буста.
Итоговая стоимость должна рассчитываться правильно с учётом цены, количества и множителя.
Пример:
Цена предмета — 100 монет. Количество — 10. Буст — x2.
Итоговая выплата: 100 × 10 × 2 = 2000 монет.
Не применять один и тот же множитель несколько раз к одной продаже.
---
- Меню помощи
В главном меню должна быть отдельная голова «Помощь».
При нажатии открывается красивое меню с объяснением управления.
Текст помощи
- "&#FFEA70&lПОМОЩЬ"
- "&#FFFFFFЛКМ &7— быстрая продажа 1 предмета"
- "FCFFFПКМ &7— подробное меню товара"
- "CFF70Продать всё &7— продажа всех доступных предметов"
- "&#D580FFАвтоскупщик &7— автоматическая продажа"
- "&#FFD95AБусты &7— увеличение цены продажи"
- "&#FF7070Редкие предметы &7— проверяйте перед продажей"
Добавить кнопку «Назад», возвращающую игрока в главное меню.
Весь текст должен редактироваться через "messages.yml" или "menus.yml".
---
- Редактор скупщика
Команда "/buyer editor" открывает административное меню.
Редактор должен позволять изменять основные настройки без ручного редактирования файлов.
Возможности редактора
- Добавление товара.
- Удаление товара.
- Изменение цены.
- Изменение названия.
- Изменение описания.
- Выбор категории.
- Выбор слота.
- Включение и отключение товара.
- Настройка ЛКМ.
- Настройка ПКМ.
- Включение и отключение автопродажи товара.
- Настройка подтверждения продажи.
- Настройка головы категории.
- Настройка буста.
- Настройка оформления меню.
Редактирование товара
Администратор выбирает предмет, затем может изменить:
- Материал.
- Название.
- Описание.
- Цену за единицу.
- Категорию.
- Слот.
- Разрешение на продажу.
- Возможность автопродажи.
- Действие на ЛКМ.
- Действие на ПКМ.
- Требование подтверждения.
- Отображение предмета в GUI.
После изменений редактор должен корректно сохранять данные в конфигурацию.
Если настройка некорректна, показать понятную ошибку, а не ломать меню.
---
- Настройка цветов HEX
Поддерживать формат:
"&#RRGGBB"
Примеры:
- "&#FFEA70" — золотой.
- "&#FFD95A" — жёлтый.
- "CFF70" — зелёный.
- "FCFFF" — голубой.
- "&#D580FF" — фиолетовый.
- "&#FF7070" — красный.
- "&#FFFFFF" — белый.
- "&#A0A0A0" — серый.
Также поддерживать стандартные коды:
- "&0"–"&9".
- "&a"–"&f".
- "&l" — жирный текст.
- "&o" — курсив.
- "&n" — подчёркивание.
- "&m" — зачёркивание.
- "&r" — сброс форматирования.
HEX-цвета должны работать в:
- Названиях меню.
- Названиях предметов.
- Lore.
- Сообщениях.
- Уведомлениях.
- Описаниях голов.
- Меню редактора.
- Меню бустов.
---
- Конфигурационные файлы
Создать отдельные 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"
Если необходимо хранить индивидуальные настройки игроков:
- Состояние автоскупщика.
- Персональные бусты.
- Пользовательские настройки.
- Другие данные, которые должны сохраняться между перезапусками.
Не хранить в этом файле данные, которые можно безопасно получать из других систем.
---
- Безопасность продажи
Это обязательная часть разработки.
- Нельзя начислять деньги без фактического удаления предметов.
- Нельзя продавать один предмет несколько раз одним нажатием.
- Проверять количество предметов непосредственно перед продажей.
- Корректно учитывать одинаковые предметы в нескольких слотах.
- Не продавать предметы из чужого инвентаря.
- Не разрешать забирать декоративные предметы из GUI.
- Блокировать перемещение предметов внутри меню.
- Блокировать Shift-click, перетаскивание и другие способы обхода интерфейса.
- Не выполнять продажу при закрытии меню.
- Не допускать дублирования денег из-за двойного клика.
- Не продавать неподдерживаемые предметы.
- Проверять корректность цены.
- Запрещать отрицательные и некорректные цены.
- Не допускать ошибок при отключении экономики.
- Защищать редкие предметы настройками подтверждения.
- Корректно обрабатывать перезапуск сервера.
- Не использовать устаревшие или несуществующие API.
- Все GUI-события должны корректно обрабатываться на серверном потоке.
Продажа должна проходить по безопасной схеме: проверить предметы и цену, удалить ровно указанное количество, выполнить начисление через экономическую систему и обновить меню. При ошибке необходимо корректно обработать операцию и не допускать повторной выплаты.
---
- Vault и экономика
Плагин должен интегрироваться с Vault.
Требования:
- Проверка наличия Vault при запуске.
- Проверка доступности экономического провайдера.
- Использование стандартного API экономики.
- Корректное начисление средств.
- Поддержка дробных значений, если их разрешает экономика.
- Сообщение администратору при отсутствии экономического провайдера.
- Запрет продажи, если начисление денег невозможно.
- Не создавать собственную валюту вместо Vault.
В "plugin.yml" правильно указать зависимость или мягкую зависимость в соответствии с выбранной реализацией.
---
- Производительность
- Не сканировать весь инвентарь каждый тик без необходимости.
- Не создавать бесконечные повторяющиеся задачи.
- Корректно удалять задачи при выходе игрока или выключении плагина.
- Не перезагружать конфигурацию при каждом клике.
- Не обращаться к файлам на диске при каждом действии игрока.
- Кэшировать необходимые данные.
- Не допускать утечек памяти из-за открытых меню.
- Поддерживать одновременную работу нескольких игроков.
- Сохранять настройки игроков корректно.
---
- Требования к совместимости
- Целевая платформа: Paper 26.3
- Использовать Java-совместимую версию, необходимую для целевой сборки сервера.
- Использовать корректный "pap