Плагин Mystic Treasures [2.9]

⚠ Важно​


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


Новое​


  • Интеграция с функцией локатора из 1.21.6
    • Теперь можно включить локатор для сокровищ и настраивать его!
    • На новой панели локатора появится кастомная точка, ведущая игроков к сокровищу
    • Можно настроить цвет и радиус, с которого он будет отображаться игрокам
  • Создан API для разработчиков, позволяющий использовать MysticTreasures в своих плагинах
    • Включает класс HuntAPI для управления охотой, событиями и исключениями
  • Конфиги переработаны: добавлены комментарии, больше объяснений и примеров — теперь они более дружелюбны для новичков

Изменения​


  • Изменён способ выбора локаций для случайных охот
  • Добавлено больше функций очистки, чтобы Хранители Сокровищ и сокровища не сохранялись после жёсткого краша сервера
  • В консоль теперь выводится больше ошибок и информационных сообщений для лучшей наблюдаемости
  • Переработан метод выдачи наград игрокам:
    • Теперь формат позволяет выбрать только один вариант из списка

Исправлено​


  • Ошибка с планировщиком сокровищ
  • Ошибка с Discord Webhook
  • Другие баги

Техническое​


  • Чистка и рефакторинг кода
YAML:
    # ======================================================
    #  AWARD METHOD - You must choose ONLY ONE from the list
    # ======================================================
    #
    # Available options (case-insensitive):
    #
    #  CHEST          - Players get rewards directly from a loot chest - supports reward obfuscation
    #  ALL_PLAYERS    - Every player who participated gets the rewards
    #  HIGHEST_DAMAGE - Only the player with the highest damage dealt gets rewards
    #  TOP_X          - The top X players with the most damage are rewarded
    #                   (Configure the number with 'only-reward-top-x')
    #                 - Example usage: `award-method: TOP_5`
    #  DROP_ON_GROUND - Rewards are dropped on the ground
    #
    # NOTE:
    # - Only ONE award method can be active at a time.
    # - If you misconfigure this option, the plugin will fall back
    #   to a safe default (CHEST).
    #
    award-method: CHEST
Это обновление включает следующие изменения:

Discord Webhook


  • Теперь плагин может отправлять на ваш Discord-сервер настраиваемое сообщение, когда появляется сокровище или когда оно забирается.
  • Для использования добавьте параметр discord-webhook-url в config.yml (например, под click-cooldown), введите ваш URL, а затем отредактируйте файл discord-webhook.json внутри MysticTreasures.jar.
Награды только для топ-игроков

  • С помощью опции only-reward-top-x в treasure.yml (например, под reward-highest-damage) можно выдавать награды только топ-X игрокам, наносящим урон хранителям сокровищ.
  • Более того, теперь можно настроить награды для конкретного места (например, только игроку, занявшему X-ую позицию).
Новые возможности спавна

  • Теперь сокровище можно заспавнить в помещении — установите treasure-spawns-inside в true. Полезно, если нужно заспавнить сокровище под блоками.
Исправления

  • Множество багов, связанных со спавном мобов, сокровищ и их получением, исправлены.
  • Исправлена излишне жёсткая проверка координат при спавне
  • Исправлено: сокровища больше не ломаются, если случайно заспавнились на воде — теперь просто не появляются
Список изменений:
🔹 Добавлены планировщики (schedulers) — теперь можно настраивать появление сокровищ по дням недели, времени и координатам.
 – Поддерживаются дни: daily, monday, tuesday и т.д.
 – Время указывается в 24-часовом формате (например: 18:30)
 – Координаты в формате x:y:z (например: 100:60:33) или random для случайного спавна по обычным настройкам
 – Можно указать несколько расписаний для одного сокровища

⚠️ Планировщики не работают, если не добавить нужный блок в конфиг вручную.

🔹 Исправлено:
– Эффекты грома и взрыва продолжали воспроизводиться после получения сундука
– Баг в меню Treasure Showcase
– Возможность прервать спавн сокровища, что ломало механику
– Если указана опасная локация, сокровище не заспавнится, а в консоли появится сообщение

🔹 Добавлено:
– Больше сообщений при запуске — для отладки
– Новое сообщение в messages.yml:
treasure-stopped-confirmation: "&6&lTreasure&e&lHunt &fwas stopped @ {world}, X: {x}, Z: {z}"
– Статус "активен" для сокровища устанавливается позже в процессе спавна — предотвращает баги
🔹 Исправлены права доступа к ряду команд
🔹 Исправлена поддержка PacketEvents
🔹 Добавлено сообщение об ошибке, если при включённой опции get-rewards-from-chest: true не было загружено ни одной награды — это мешало появлению сундука с сокровищем
ВНИМАНИЕ! Перед обновлением обязательно сделайте резервную копию папки плагина и позвольте плагину пересоздать файлы для чистого запуска. В этой версии очень много изменений — это необходимо для стабильной работы.

Что нового:

[НОВОЕ] Поддержка кастомных предметов:

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

[НОВОЕ] Поддержка Nexo для всех вышеуказанных элементов.

[НОВОЕ] Новый способ получения наград:
Игроки теперь могут открывать сундук и самостоятельно забирать ItemRewards.
Открытие сокровища запускает меню сундука для всех игроков, открывших его.
Можно:
— настроить обфускатор наград (все предметы заменяются на дефолтный блок, чтобы предотвратить воровство лучших)
— ограничить количество одновременно просматривающих игроков
— установить кулдаун на клики (защита от автокликеров)

[НОВАЯ КОМАНДА] /hunt showcase
Открывает меню, где игроки могут увидеть все сокровища, их награды, хранителей и ключи.

[НОВОЕ] Волны (Waves):
Теперь можно задать количество кликов, необходимых для запуска второй волны.
Пример: на 5 клике спавнится вторая волна, на 10 — выдача награды.
Функции:
– шокволны (отталкивают игроков от сокровища)
– респавн хранителей
– эффекты зелий игрокам

[НОВЫЕ ПЛЕЙСХОЛДЕРЫ]
Добавлены новые плейсхолдеры для меню и голограмм, включая топ-3 убийц сокровища.

Дополнительно:
– Настраиваемая защита от падения при входе в радиус сокровища в полёте
– Чёрный список команд возле сокровища
– Обфускатор предметов теперь настраивается в config
– Исправлено множество багов
– Приведён в порядок код
– Частично переработаны плейсхолдеры: %placeholder% заменены на {placeholder}
Привет!

В этой версии добавлено и исправлено следующее:

– Исправлен баг с уведомлением об обновлении
– В config.yml добавлен параметр fall-protection для настройки эффекта планирования при входе в радиус сокровища во время полёта или использования элитр
– Добавлена возможность указывать запрещённые команды в зоне сокровища (настраивается в config.yml)
– Добавлены плейсхолдеры {x-offset} и {z-offset} для экшн-бара и других сообщений — позволяют показывать примерные координаты сокровища вместо точных (точность настраивается в treasure.yml)
– Теперь можно настраивать сообщение о времени перезарядки
– Исправлен баг с командой /hunt reload

Спасибо, что остаётесь с нами!
ВНИМАНИЕ! ПЕРЕД ЗАПУСКОМ СЕРВЕРА НА ЭТОЙ ВЕРСИИ — СДЕЛАЙТЕ РЕЗЕРВНУЮ КОПИЮ ПАПКИ data И УДАЛИТЕ ЕЁ. Плагин должен заново сгенерировать файлы из-за масштабной переработки конфигурации.

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

Неограниченное количество сокровищ на мир
Теперь каждое сокровище хранится в своём treasure.yml. Можно настраивать несколько редкостей для одного мира без ограничений, кроме одного: нельзя запускать более одного сокровища одного типа одновременно (например, можно одновременно активировать Common и Rare, но не две Rare).

Функции TreasureKeepers
— Кастомизация:
• Уникальное имя
• Шанс появления
• Максимальное здоровье
• Эффекты зелий
• Экипировка с зачарованиями
• Кастомный дроп
• Шанс выдачи награды через команды
— Возможность награждать только игрока, нанесящего наибольший урон
— Задержка перед открытием сокровища для игроков
— Настраиваемое имя выпавшего сокровища

Другое
— В action bar теперь отображается ближайшее к игроку активное сокровище
— Исправлены ошибки, оптимизирован код, произведена общая чистка
ВерхНиз