QuestLogs

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

QuestLogs — это комплексная система квестов и испытаний для серверов Minecraft. Плагин позволяет администраторам создавать задания различных типов, от простых действий до сложных цепочек с предусловиями. Игроки взаимодействуют с заданиями через графический интерфейс (GUI) в виде сундука, а их прогресс и общая статистика автоматически сохраняются в локальной базе данных SQLite.

Функциональные возможности

Плагин поддерживает несколько типов заданий, которые можно назначить игрокам:

• Исследование: прохождение определенного расстояния (например, 5000 блоков).
• Добыча: сбор конкретного количества руды (алмазов или железа).
• Бой: уничтожение определенного количества мобов (зомби или скелетов).
• Крафт: создание предметов, таких как палки или факелы.
• Строительство: установка определенного количества блоков (например, булыжника).

Цепочки квестов и статистика

Для создания линейного прогресса предусмотрена система предусловий. Администраторы могут настроить цепочки, где доступ к следующему заданию открывается только после завершения предыдущего (например, последовательность от «Новичка» до «Мастера»).

Все действия игроков отслеживаются в базе данных SQLite и включают:

• Общее время игры (в текущей сессии и суммарно).
• Количество исследованных, добытых, сломанных и установленных блоков.
• Список созданных предметов по типам.
• Количество убитых мобов по видам.
• Завершенные квесты и победы в испытаниях.

Временные испытания и награды

Плагин автоматически запускает серверные соревнования — временные испытания. По умолчанию предусмотрено 10 испытаний, которые проводятся каждый час в течение 5 минут. Среди них встречаются спринты по добыче камня, поиск алмазов, охота на зомби и строительство. Три лучших игрока получают награды, которые могут включать предметы, зачарованные книги (например, Удача III, Прочность, Починка) или очки опыта.

Награды настраиваются в формате YAML и могут содержать любые предметы и любые уровни чар.

rewards:
  DIAMOND: 5
  IRON_INGOT: 16
  ENCHANTED_BOOK:
    enchantments:
      FORTUNE: 3
xp_reward: 500

Настройка интерфейса и конфигурация

Администраторы могут полностью кастомизировать GUI-интерфейс квестов, задавая позиции слотов и иконки для каждого задания. Плагин использует несколько YAML-файлов для управления всеми аспектами:

• config.yml: основные настройки и интервалы уведомлений.
• quests.yml: определения всех квестов.
• challenges.yml: пул испытаний и расписание их запуска.
• progress.yml: автоматически генерируемые данные о прогрессе игроков.

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

gui_slot: 10      # Place in specific inventory slot
gui_icon: DIAMOND_PICKAXE  # Use custom item as icon

Команды

Все команды поддерживают автодополнение (tab completion).

Команды для игроков

Игроки могут использовать следующие команды для взаимодействия с системой:

• /questbook — открывает GUI-интерфейс квестов
• /queststats [player] — показывает статистику игрока
• /challenge — отображает информацию о текущем испытании

Команды для администраторов

Для управления плагином администраторам доступны:

• /questadmin reload — перезагружает конфигурационные файлы
• /questadmin complete — вручную завершает квест для игрока
• /challengeadmin start — запускает конкретное испытание
• /challengeadmin list — выводит список всех доступных испытаний