BuyerPlugin — это функциональный плагин для серверов Minecraft (API 1.16+), который добавляет NPC или меню скупщика с динамическим ассортиментом, системой лимитов, множителями и авто-продажей.
---
## 🚀 Основные функции
1. Динамический ассортимент (Rotation):
* Автоматическое обновление товаров каждые X минут.
* Случайный выбор предметов из общего каталога (
all-items).* Настройка минимального и максимального количества товаров.
2. Система лимитов (Limits):
* Ограничение на количество скупаемых предметов за один период.
* Индивидуальные лимиты для ценных ресурсов (алмазы, незерит).
* Защита экономики сервера от перепроизводства.
3. Система множителей (Multipliers):
* Прогрессия игрока: чем больше продаешь, тем выше уровень.
* Бонус к цене до +100% (на 10 уровне).
* Автоматическое отслеживание прогресса в базе данных.
4. Авто-продажа (Auto-Sell):
* Фоновая продажа предметов из инвентаря.
* Настраиваемый интервал (по умолчанию 2 секунды).
* Режим "Белого списка" (Whitelist) для продажи только определенных ресурсов.
5. Современный GUI с RGB:
* Поддержка HEX-цветов (
#RRGGBB).* Красивая анимация кнопок и информационных панелей.
* Полная русификация названий предметов.
---
## 💻 Команды и Права
| Команда | Описание | Алиасы | Права |
| :--- | :--- | :--- | :--- |
|
/buyer | Открыть главное меню скупщика | seller, скупщик | нет ||
/buyer reload | Перезагрузить конфигурацию | — | buyer.admin ||
/buyer rotate | Обновить ассортимент вручную | — | buyer.admin ||
/buyer reset | Сбросить лимиты скупки | — | buyer.admin ||
/buyer clearmultipliers | Сбросить уровни всех игроков | — | buyer.admin |---
## 🛠 Настройка (config.yml)
### Экономика
yaml
economy:
type: "money" money, eco # Тип используемой экономики### Ротация (Ассортимент)
yaml
rotation:
enabled: true
update-interval: 60 # Интервал в минутах
min-items: 10
max-items: 20### Авто-продажа
yaml
auto-sell:
enabled: true
interval: 2 # Секунды
whitelist-mode: false # Если true, продает только из списка whitelist---
## 📂 Техническая структура
Плагин написан на Java и использует модульную архитектуру:
* com.buyerplugin.Main — Точка входа.
* BuyerManager — Ядро логики (цены, лимиты, инвентарь).
* MultiplierManager — Система уровней и бонусов.
* BuyerGUI — Визуальный интерфейс и обработка кликов.
* ConfigManager — Система сохранения данных и настроек.
---
## 🎨 Примеры HEX-цветов в конфиге
*
#00FF00 — Ярко-зеленый (Успех)*
#FF0000 — Красный (Ошибка/Внимание)*
#FFAA00 — Оранжевый (Информация)---