Мод Odyssey Quests 1.1.13 +0.0.1

Odyssey Quests — мод для создания древовидных систем заданий в сборках Minecraft. Он позволяет авторам модпаков подготавливать завершаемые квесты, включать их в сборку и предоставлять игрокам последовательный маршрут прохождения. Категории проекта — adventure и utility.

В основе ресурс назван Odyssey Quests, тогда как официальный текст и JAR используют Heracles; причина различия не указана. Авторы — MsRandom, AlexNijjar и ThatGravyBoat. Лицензия и SPDX-идентификатор — MIT.

Назначение​

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

Задания заявлены как выполнимые. Точные условия, награды, формат данных, редактор и команды не перечислены, поэтому конкретный набор средств авторинга не подтвержден.

Скриншоты и внешний вид​

Аудитория и сценарии выбора​

Основная аудитория — авторы сборок, структурирующие цели и этапы прохождения, а также игроки, проходящие подготовленное дерево.

Odyssey Quests подходит, если необходимо:

• представить задания в связанной древовидной форме;
• снабдить квесты описаниями;
• включить готовые квестовые данные в распространяемую сборку;
• учитывать завершение задач;
• использовать один квестовый компонент на клиенте и сервере;
• работать на Minecraft 1.20 или 1.20.1 с поддерживаемым загрузчиком.

Наличие готовой кампании в чистой установке не подтверждено: содержимое должен подготовить создатель сборки.

Совместимость​

Подтверждены Minecraft 1.20.1 и 1.20. Поддерживаются Fabric и Forge, для которых предоставлены разные файлы. Клиент и сервер отмечены как required, поэтому мод должен присутствовать на обеих сторонах.

Выбор выполняется по сочетанию платформы и версии:

• Fabric — файл для Minecraft 1.20.1;
• Forge — файл для Minecraft 1.20;
• два платформенных JAR не нужно помещать в одну установку;
• Fabric-файл не заявлен для Forge, а Forge-файл — для Fabric;
• поддержка NeoForge и других загрузчиков не подтверждена.

Версии 1.20 и 1.20.1 нельзя считать взаимозаменяемыми без проверки артефакта.

Файлы и контроль целостности​

Для Fabric указан:

• Heracles-fabric-1.20.1-1.1.13.jar;
• версия 1.1.13, размер 1 411 990 байт;
• SHA-512: a4b2575cab35827a031c8d73de1b822ec90dae925fc31d86f6367c96ead57b1f1c58a3cf15c747afaee942ece23529110ea1d5d47ef173389c837c013d23eff7;
• SHA-1: 9a9213acbbe2d10ed12087978653253f0a4754c6.

Для Forge указан:

• heracles-forge-1.20-0.0.1.jar;
• версия 0.0.1, размер 672 263 байта;
• SHA-512: 7ea0184626bd16bd9a251ea7fa30ec10bbc1629ed59ee0f83fd9eaf6ce3184d7718a744e95c740e42fa7e5a52671b6f42371644f9ad449ee6d2a1dbee30a602c;
• SHA-1: 7c32bb366513644a6c1e8ef629f06773db069a93.

Файлы получены по официальному HTTPS, сверены по хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся, поэтому поведение в игре не подтверждено.

Зависимости​

В выбранных метаданных обязательными указаны Resourceful Lib с идентификатором G1hIVOrD и Fabric API с идентификатором P7dR8mSH. Точные версии библиотек не приведены.

Перечень не распределен между JAR. Поэтому нельзя утверждать, что Fabric API нужен Forge-варианту: зависимости следует сопоставлять с конкретным артефактом.

Установка​

JAR помещается в папку mods совместимой установки Minecraft. Поскольку обе стороны обязательны, соответствующий платформе файл нужен клиенту и серверу.

Практический порядок:

• Закрыть клиент и остановить сервер.
• Сохранить мир, папку конфигурации и текущий набор модов.
• Выбрать Fabric 1.20.1 либо Forge 1.20.
• Проверить имя, размер и хеш JAR.
• Добавить подтвержденные зависимости выбранного варианта.
• Поместить мод в mods клиента и сервера.
• Включить подготовленные квестовые данные в сборку.
• Сначала запустить тестовую копию.

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

Проверка результата​

Успешный запуск — только первый этап. Проверять следует весь квестовый сценарий:

• клиент и сервер загружаются без ошибки отсутствующей зависимости;
• обе стороны используют подходящий JAR;
• дерево заданий доступно игроку;
• описания отображаются;
• тестовая задача распознает выполнение;
• повторное подключение не вызывает ошибки чтения данных;
• журнал не содержит исключений, связанных с Odyssey Quests или Heracles.

Совместимость следует подтверждать в копии целевой сборки.

Ограничения​

Подтвержденный диапазон ограничен версиями 1.20 и 1.20.1. Нет данных о более новых выпусках, NeoForge, миграции квестов, формате хранения прогресса, встроенном редакторе или совместимости с другими квестовыми системами.

Также не подтверждены:

• готовая кампания в чистой установке;
• конкретные награды и условия;
• административные команды;
• система прав;
• автоматический импорт из другого мода;
• одинаковый набор возможностей у версий 1.1.13 и 0.0.1.

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

Безопасное обновление​

Резервная копия должна включать JAR, конфигурационную папку, мир и список версий. Автоматическая миграция не гарантирована.

Перед обновлением:

• Зафиксируйте версии Minecraft, загрузчика, мода и библиотек.
• Сохраните рабочие JAR и квестовые данные.
• Проверьте новый файл по хешу.
• Обновите клиент и сервер согласованно.
• Не меняйте одновременно загрузчик и квестовые данные без отдельного теста.
• Проверьте короткую ветку и ранее доступные задания.

Предыдущий комплект сохраняют до завершения проверки.

Откат​

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

Формат прогресса не описан, поэтому сохранение состояния между версиями не гарантировано. Надежнее копировать весь экземпляр.

Диагностика​

Если мод не запускается или дерево отсутствует, проверьте:

• Соответствует ли JAR загрузчику.
• Совпадает ли версия Minecraft.
• Есть ли мод на клиенте и сервере.
• Установлены ли обязательные зависимости выбранного артефакта.
• Нет ли одновременно Fabric- и Forge-файлов.
• Совпадают ли размер и хеш.
• Включены ли в сборку квестовые данные.
• Какая первая содержательная ошибка записана в журнале.

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

Лицензия и авторство​

Проект распространяется по MIT. Авторы — MsRandom, AlexNijjar и ThatGravyBoat. Локализация разрешена при соблюдении лицензии; при распространении сохраняют название, авторство и лицензионные сведения. Имя Heracles оставляют в оригинальных именах файлов. Редакционные выводы авторам не приписывают.

FAQ​

Почему JAR называется Heracles?​

Такое имя используют предоставленные файлы и официальный исходный текст, хотя ресурс в фактической основе назван Odyssey Quests. Причина различия не указана.

Нужен ли мод на обеих сторонах?​

Да. Клиент и сервер отмечены как required.

Какой файл предназначен для Fabric?​

Heracles-fabric-1.20.1-1.1.13.jar для Minecraft 1.20.1.

Какой файл предназначен для Forge?​

heracles-forge-1.20-0.0.1.jar для Minecraft 1.20.

Появятся ли готовые задания сразу?​

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

Нужен ли Fabric API версии Forge?​

Общий перечень зависимостей не распределен по JAR. Из предоставленных данных нельзя делать вывод, что Fabric API требуется Forge-файлу.

Проверены ли файлы запуском?​

Нет. Выполнены загрузка по официальному HTTPS, сверка хешей и статическая проверка архивов; динамический запуск не проводился.