InternationalQuests

Система ежедневных и еженедельных квестов для Minecraft сервера с удобным графическим интерфейсом (GUI).

⚠️ ВАЖНОЕ УСЛОВИЕ ИСПОЛЬЗОВАНИЯ

Данный плагин защищён пользовательской лицензией. Вы можете собирать и использовать его на своих серверах, но вам ЗАПРЕЩАЕТСЯ:

• Выкладывать файл плагина (.jar) или исходный код на сторонних сайтах, форумах, в Discord и т.д.
• Продавать, перепродавать или распространять плагин любым другим способом.

Полный текст лицензии с подробностями доступен в файле LICENCE.md.

📋 Возможности

• Ежедневные и еженедельные квесты — гибкая настройка в YAML-файлах
• Графический интерфейс (GUI) — удобное меню для просмотра и сдачи квестов
• Интеграция с InternationalLevel — награда игроков опытом и уровнями
• Система наград — деньги, опыт, предметы, команды от консоли
• Автоматическая привязка к датам — квесты автоматически обновляются каждый день/неделю
• Полная кастомизация — сообщения, меню, квесты — всё в конфигах

🔧 Требования

• Minecraft сервер версии 1.21+
• Java 17 или выше (для запуска сервера)
• JDK 17 или выше (для сборки плагина из исходников)
• InternationalLevel (опционально, для награждения опытом и уровнями)

🚀 Открытие проекта в IntelliJ IDEA

Пошаговая инструкция, которая подойдет даже новичку.

Шаг 1. Склонируйте репозиторий

Выполните в терминале:

git clone https://github.com/MrDevive/InternationalQuests.git

Шаг 2. Откройте проект в IDEA

• Запустите IntelliJ IDEA
• На экране приветствия нажмите Open (или File → Open в уже открытом проекте)
• Выберите папку, в которую вы склонировали репозиторий, и нажмите OK

Шаг 3. Настройте JDK

Проект требует Java 17 или новее. Если IDEA попросит выбрать SDK:

• Нажмите File → Project Structure → Project
• В разделе SDK выберите установленную версию Java 17+

Шаг 4. Дождитесь загрузки зависимостей

Проект использует Maven (файл pom.xml). IDEA обычно подхватывает его автоматически и скачивает все нужные библиотеки. Процесс можно увидеть в строке состояния внизу.

Если загрузка не началась автоматически:

• Нажмите на значок Maven справа
• Нажмите кнопку обновления (⟳)

🛠️ Сборка плагина

После того как проект открыт и настроен, вы можете собрать его в работающий .jar файл.

Через Maven (рекомендуется):

1. Откройте панель Maven (обычно справа, значок m)
2. Раскройте свой проект → Lifecycle
3. Дважды кликните на package
4. Готовый .jar файл вы найдете в папке target/

Через IDEA:

1. Нажмите Build → Build Artifacts...
2. Выберите InternationalQuests:jar → Build

📥 Установка на сервер

1. Поместите файл .jar из папки target/ в папку plugins/ вашего сервера Minecraft
2. Запустите (или перезапустите) сервер — плагин создаст папку InternationalQuests/ с конфигами
3. Настройте квесты, сообщения и гуи в YAML-файлах (см. раздел Конфигурация)
4. Перезагрузите плагин командой /quests reload или перезапустите сервер

⚙️ Конфигурация

Плагин создаёт несколько конфигурационных файлов в папке plugins/InternationalQuests/:

Файл	Назначение
config.yml	Основные настройки
message.yml	Все сообщения игрокам
DailyQuests.yml	Настройка ежедневных квестов
WeeklyQuests.yml	Настройка еженедельных квестов
quest_gui.yml	Настройка главного GUI меню
quest_gui_daily.yml	Настройка GUI для ежедневных квестов
quest_gui_weekly.yml	Настройка GUI для еженедельных квестов

Пример настройки квеста в DailyQuests.yml:

quests:
  kill_zombies:
    type: KILL_MOBS
    entity: ZOMBIE
    target: 10
    name: "&a&lУбийца зомби"
    description: "&7Убейте 10 зомби"
    reward_commands:
      - "give {player} diamond 1"
      - "give {player} emerald 5"
    reward_display:
      - "&6✦ 1 алмаз"
      - "&6✦ 5 изумрудов"
    chance: 0.8
    icon: DIAMOND_SWORD

🛠️ Команды и права

Команда	Описание	Право (permission)
/quests	Открыть главное GUI меню квестов	internationalquests.use
/quests reset <daily/weekly/all>	Сбросить прогресс (всем или себе)	internationalquests.admin
/quests reload	Перезагрузить все конфиги	internationalquests.admin

❓ Часто задаваемые вопросы (FAQ)

Вопрос: Можно ли использовать плагин на коммерческом сервере?

Ответ: Да. Вы можете использовать плагин на любом сервере, включая коммерческие проекты.

Вопрос: Могу ли я изменить код плагина под себя?

Ответ: Да, для личного использования на своём сервере. Но вы не имеете права распространять модифицированную версию без письменного разрешения автора.

Вопрос: Как создать свой квест?

Ответ: Скопируйте существующий квест в файле DailyQuests.yml или WeeklyQuests.yml и измените параметры (название, цель, количество, награды).

Вопрос: Плагин не видит InternationalLevel. Что делать?

Ответ: InternationalLevel опционален. Без него плагин не будет поддерживать тип квестов GAIN_EXPERIENCE, но вся остальная функциональность будет работать.

Вопрос: Как часто обновляются квесты?

Ответ: Ежедневные квесты сбрасываются каждый день в 00:00, еженедельные — каждый понедельник в 00:00. Время можно настроить в config.yml.

Вопрос: Что делать, если GUI не открывается?

Ответ: Проверьте, что у игрока есть право internationalquests.use, а также убедитесь, что файлы quest_gui.yml, quest_gui_daily.yml и quest_gui_weekly.yml существуют и не содержат ошибок в синтаксисе.

Вопрос: Можно ли добавить свои типы наград?

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

📄 Лицензия

Этот проект защищён пользовательской лицензией.

• ✅ Вы можете скачивать, собирать и использовать плагин на своих серверах
• ❌ Вы НЕ можете распространять или продавать плагин (в исходном или скомпилированном виде) без письменного разрешения автора

Подробности в файле LICENCE.md.

---

© 2026 Devive. Все права защищены.