Плагин ⚡Questborn⚡Система квестов 1.4.0

ВАЖНО - ПЕРЕД ОБНОВЛЕНИЕМ:

• Сделайте полную резервную копию папки плагина Questborn (особенно конфигов, данных прогресса и файлов игроков) перед обновлением!
• После обновления удалите старый файл config.yml - плагин автоматически создаст новый со всеми свежими настройками.
• Старый файл top.yml больше не используется и его можно полностью удалить - всё перенесено в новый menus.yml.

Новые функции и изменения:

• Новая интеграция с ItemsAdder
  Добавлена возможность использовать кастомные предметы из ItemsAdder в квестах.
  
  Пример использования:
  
  YAML:

  objectives:
      type: ITEM_FISH
      amount: 6
      target-materials:
        - "itemsadder:iasurvival:blue_parrotfish"

  
  
• Полная интеграция с PlaceholderAPI
  Добавлена полная поддержка PlaceholderAPI. Теперь информацию о квестах можно выводить в голограммы, чат, таб-лист, Scoreboard и т.д.
  
  Доступные плейсхолдеры:
  • Код:

    %questborn_quests_completed%

    - общее количество выполненных квестов игроком
  • Код:

    %questborn_status_<id>%

    - статус квеста (ACTIVE, COMPLETED, COOLDOWN, AVAILABLE, UNAVAILABLE)
  • Код:

    %questborn_cooldown_<id>%

    - оставшееся время кулдауна конкретного квеста
  • Код:

    %questborn_active_id%

    - ID текущего активного квеста
  • Код:

    %questborn_active_name%

    - название текущего квеста
  • Код:

    %questborn_active_description%

    - описание текущего квеста
  • Код:

    %questborn_active_stage_current%

    - текущая стадия
  • Код:

    %questborn_active_stage_total%

    - общее количество стадий
  • Код:

    %questborn_active_progress_current%

    - текущий прогресс цели стадии
  • Код:

    %questborn_active_progress_target%

    - целевой прогресс цели стадии
  • Код:

    %questborn_active_progressbar%

    - графическая полоса прогресса
  • Код:

    %questborn_active_objective%

    - текст текущей цели (первая строка)
  • Код:

    %questborn_active_objective-<number>%

    - конкретная строка (например -0, -1 и т.д.)
  
  
• Отображение квеста (Scoreboard & BossBar)
  Добавлено удобное отображение текущего квеста на экране через Scoreboard и BossBar. Всё гибко настраивается в config.yml.
  
  Пример конфигурации:
  
  YAML:

  bossbar:
    enabled: true
    title: "&e{quest_name} &7[{progress}/{target}]"
    color: AUTO
    mode: "STATIC"
    style: SOLID
  
  scoreboard:
    enabled: true
    lines:
      - "&fQuest:"
      - "{quest_name}"
      - "{objective_details}"

  
  
  
  
  
  
  
• Новая система конфигурации меню (menus.yml)
  Старый файл top.yml объединён в единый menus.yml. Теперь можно свободно настраивать размер GUI и точное расположение элементов в каждом меню.
  
  Пример для Top-меню:
  
  YAML:

  menus:
    top:
      rows: 5
      slots:
        players:
          - "10-16"
          - "19-25"
          - "28-34"
      mask:
        - "0-9"
        - "17, 18, 26, 27, 35, 36"
        - "36-44"
      rank-styles:
        1:
          prefix: "<#FFAA00>♛ "
          footer: "<#FFAA00>🏆 TOP 1 LEADER 🏆"

  
  
• Интеграция с SkinsRestorer
  Добавлена небольшая интеграция для улучшенного отображения скинов в лидерборде игроков.
  
  
• Технические улучшения
  • Обновлена и оптимизирована структура конфигурации
  • Мелкий рефакторинг кода и оптимизация производительности

Приятного использования обновления!

Обновлена библиотека, из-за которой ActionBar не работал в версии 1.21.11.

!!! ВАЖНОЕ ЗАМЕЧАНИЕ !!!
Перед использованием этой версии плагина сделайте резервную копию данных плагина. Также удалите существующий файл конфигурации, файлы локализации и пресеты эффектов, чтобы плагин мог сгенерировать новые, обновленные версии этих файлов.

Журнал обновлений

Новая интеграция с NPC (Citizens и FancyNPCs)

Добавлена полная поддержка NPC из плагинов Citizens и FancyNPCs!

- Теперь игроки могут принимать и выполнять задания, взаимодействуя с NPC.

- Индикатор над головой NPC отображает статус доступных заданий.

Новые поддерживаемые версии

• 1.16
• 1.17
• 1.18
• 1.19
• 1.20

Новые настройки в config.yml

Интеграция

YAML:

integration:
  # Включить или отключить интеграцию с NPC
  enabled: true
  # Выберите плагин: CITIZENS или FANCYNPCS
  npc-plugin: FANCYNPCS
  # Режимы:
  # MIXED – работают как команды, так и NPC
  # NPC_ONLY – только NPC (команды отключены)
  # MENU_ONLY – только команды (NPC отключены)
  mode: MIXED

  # Кнопка для взаимодействия с NPC (LEFT / RIGHT)
  interaction-button: RIGHT

Индикаторы над головой NPC

YAML:

npc-indicators:
  enabled: true
  view-distance: 20.0     # Расстояние для наблюдения за указателями
  offset-y: 0.6           # Высота над головой NPC
  icons:
    available: "&6&l!"
    in-progress: "&a&l▣"
    completed: "<#00ff94>&l✔"
    cooldown: "&b⏳"
    locked: "&c&l🔒"
    reward-available: "<#00ff66>&l🎁"

Другие новые настройки

YAML:

gameplay:
  # Разрешенные режимы игры для выполнения заданий
  allowed-gamemodes:
  - SURVIVAL
  - CREATIVE
  - ADVENTURE

YAML:

chat:
  # Отображать подробную информацию (цели + кликабельная ссылка) в сообщениях об активации/этапе
  show-details: true

YAML:

rewards:
  # Если true, награды выдаются автоматически после завершения задания (без получения награды NPC).
  # Если false, игрок должен получить награду (через взаимодействие с NPC или графический интерфейс).
  auto-claim: false

Новые команды
- /quest npc link <typeID> <npcID> – привязать тип задания к NPC
Примеры:

• FancyNPCs: /quest npc link daily joe

• Citizens: /quest npc link daily 1

- /quest npc unlink <typeID> <npcID> – отменить привязку типа задания к NPC
Примеры:

• FancyNPCs: /quest npc unlink daily joe

• Citizens: /quest npc unlink daily 1

- /quest details – открыть подробное представление текущего активного задания

Примечание: Перед привязкой NPC создайте его в Citizens или FancyNPCs и запишите его ID (для Citizens – числовой ID, для FancyNPCs – имя).

Улучшенное меню сведений о задании
Интерфейс сведений о задании полностью переработан – все элементы теперь расположены удобно, красиво и информативно.

Обновлена документация
Документация обновлена в соответствии с текущей версией плагина:
You must be logged in to see this link.
Спасибо за использование Questborn!

Исправленные задания:

• BREWING -Теперь правильно учитывает прогресс при подборе приготовленного зелья.
• STRIP_LOG - Теперь учитывается только при тесании бревна, ранее учитывалось даже при добыче бревна.
• PLANT_SEED - Теперь учитываются как различные семена сельскохозяйственных культур, так и саженцы деревьев.

Изменена иконка активного задания:

• Активное задание теперь помечается зачарованием.
• Выполненное разовое задание теперь отображает иконку задания.

Полностью обновлены встроенные задания:

• 4 новых типа заданий.
• Более 60 новых заданий.

(Эти задания созданы для демонстрации возможностей плагина).

Небольшое исправление локализации.

Исправления:

- Задания типа «starter»:
Проблема: Нарушалась цепочка выполнения встроенных заданий типа «starter», что препятствовало активации последующих заданий.
Исправление: Исправлена внутренняя логика цепочки. Теперь выполнение заданий типа «старт» работает корректно.

- Цель ITEM_CRAFT (Создание предмета):
Проблема: Успешное создание предмета не регистрировалось, если игрок сразу же выбрасывал полученный предмет, наведя на него курсор и нажав Q. Использование Shift для создания нескольких предметов также не регистрировалось.
Исправление: Обновлена логика отслеживания, чтобы действие создания записывалось как успешное в момент создания предмета, до любого управления инвентарем.
Нажатие Q для выбрасывания только что созданного предмета теперь корректно засчитывается в выполнение цели.
Создание нескольких предметов с помощью Shift + Click теперь также регистрируется корректно.

Перед установкой этого обновления НЕОБХОДИМО:

1. Создать полную резервную копию папки плагина.
2. Удалить следующие папки из старого плагина:

• config/
• languages/

3. Эти папки будут автоматически созданы заново при запуске обновленной версии с новой структурой.

Изменения версии

Новые системы
- Добавлена система передачи предметов для заданий
Теперь вы можете настроить получение/сдачу предметов во время выполнения задания.

- Добавлена система этапов заданий
Задания могут иметь несколько последовательных этапов с различными условиями выполнения.

Подробная документация: см. документацию по правильному использованию новых систем.

Типы заданий и примеры
- Добавлены новые типы заданий с поддержкой этапов и передачи предметов.

• При первом запуске плагин автоматически создает демонстрационный тип задания, иллюстрирующий:
• Функциональность этапов
• Механику передачи предметов

Расширение локализации
Добавлена поддержка 5 новых языков:

• pt-BR - португальский (Бразилия)
• fr-FR - французский
• tr-TR - турецкий
• kk-KZ - казахский
• pl-PL - польский

Технические изменения

• Обновлена структура конфигурационных файлов
• Новая структура файлов локализации
• Улучшена система загрузки данных

Примечания

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

Исправлено:

• disabled-for-types в конфигурации - теперь корректно принимает тип и отключает его для отображения в панели действий.
• Цель ITEM_CRAFT - теперь корректно подсчитывает количество созданных предметов.

Изменено:
Цели, основанные на расстоянии, теперь считывают только параметр расстояния.

• Цель ELYTRA_FLY теперь использует distance вместо amount.
• Цель MINECART_TRAVEL теперь использует distance вместо amount.

Основные новые возможности
- Система цепочек заданий - Полная поддержка последовательных цепочек заданий. Новые задания автоматически генерируются в папке плагина при первом запуске.

- Выбор движка заданий - Добавлен параметр engine: (по умолчанию или chain) для определения поведения заданий.

- Визуальная настройка - Установка значков заданий с помощью icon-material: и упорядочивание цепочек заданий с помощью slot: positioning.

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

- Упрощенный режим графического интерфейса - Используйте /quest open list daily --simple для скрытия кнопок "Назад" (идеально подходит для меню NPC).

Изменения в ядре
- Переработка системы разрешений - Все разрешения перенесены из quest.* в questborn.*.

- Обновление журнала запуска - Более чистые и информативные сообщения инициализации.

ВАЖНЫЕ ЗАМЕЧАНИЯ К ОБНОВЛЕНИЮ
Перед установкой этого обновления НЕОБХОДИМО УДАЛИТЬ следующие старые файлы/папки:

• config.yml
• Вся папка language/

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

Краткое описание обновления

• Движок цепочек заданий с автоматической настройкой
• Новое пространство имен разрешений (questborn.*)
• Настройка значка и слота задания
• Параметры оптимизации производительности
• Упрощенный графический интерфейс для интеграции с NPC
• Улучшена структура логирования и конфигурации

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