Плагин HoodBuyer | GUI-скупщик с уровнями, ротацией предметов и бустерами 1.0.0

Описание​

HoodBuyer — скупщик предметов с полностью настраиваемым GUI, системой уровней по категориям и прогрессией, которая заставляет игрока фармить, а не просто сдавать всё подряд.

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

• Категории. Каждая категория (мобы, шахты, растения, любые свои) — отдельный YAML-файл со списком предметов: материал, цена, требуемый уровень, XP, редкость.
• Уровни категорий. Дорогие предметы закрыты до нужного уровня. Чтобы поднять уровень, игроку выдаётся персональный набор требований («продай N булыжника, N угля...»), количество считается как requirement-base × requirement-multipliers[уровень].
• Персональная ротация. Набор требований генерируется индивидуально для каждого игрока: сид от UUID + случайный выбор редкости по весам (weight), так что у всех разный путь прокачки.
• Бустеры. За продажи начисляется XP; по достижении порога включается множитель монет на ограниченное время (по умолчанию 1.5x → 2x → 2.5x → 3x). Таймер тикает в реальном времени прямо в открытом меню, по истечении бустер сбрасывается.
• Автопродажа. Включается по одному предмету (СКМ) или сразу на всю категорию одной кнопкой. Работает фоновой задачей с настраиваемым интервалом, опционально с уведомлением в чат.
• Гибкое GUI. Меню описываются в YAML: размер, заголовок, слоты, предметы, кастомные головы по base64, звуки. Слоты продажи задаются списком sale-slots, предметы категории раскладываются по ним автоматически.
• Оформление. Поддержка &-кодов, HEX (#FF9900) и градиентов (gradient#FFD166:#FF9900:Текст) в названиях и лоре.
• Все тексты в конфигах. messages.yml + шаблоны лора для разблокированных/заблокированных предметов.

Действия для кнопок меню

OPEN_MENU, OPEN_CATEGORY, OPEN_DELUXEMENU, CONSOLE_COMMAND, PLAYER_COMMAND, PLAY_SOUND, BOOSTER_INFO, PROGRESS_INFO, TOGGLE_AUTOSELL_ALL

Управление в меню продажи

• ЛКМ — продать 1 шт.
• ПКМ — продать стак
• Shift+ЛКМ — продать всё из инвентаря
• СКМ — вкл/выкл автопродажу этого предмета

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

Внутри меню: %xp%, %xp_to_next%, %booster%, %booster_timer%, %booster_time%, %autosell_state%, %level_<категория>%, %state% (аналогично в фигурных скобках: {xp} и т.д.).
В шаблонах предметов: {price}, {booster}, {total}, {rarity_name}, {auto_state}, {required_level}.
PlaceholderAPI (экспансия hoodbuyer, регистрируется автоматически): %hoodbuyer_booster% — текущий множитель, %hoodbuyer_autosell% — ON/OFF, %hoodbuyer_progress% — таймер бустера мм:сс. Сторонние плейсхолдеры PAPI также раскрываются внутри меню.

Хранение данных

plugins/HoodBuyer/playerdata/<uuid>.json — прогресс, уровни, ротация, требования, настройки автопродажи. Целостность данных проверяется при загрузке: новые категории и требования достраиваются автоматически.

Установка

1. Установить Vault и любой плагин экономики.
2. Закинуть HoodBuyer.jar в plugins/, перезапустить сервер.
3. Настроить config.yml, категории и меню, применить /hb reload.