Distant Horizons API — библиотека для разработчиков модов [1.12.2 — 26.3]

Мод Distant Horizons API предоставляет программный интерфейс для разработчиков, позволяя взаимодействовать с другими модами, использующими возможности рендеринга и визуализации дистанционных объектов в Minecraft. Актуальная версия API — 7.2.0. Этот мод не предназначен для обычных игроков и не добавляет контент непосредственно в игру. Вместо этого он включает в себя исходный код и классы, которые незаменимы для разработчиков, создающих свои модификации, которые могут использовать функции Distant Horizons. Он совместим с загрузчиками Fabric, Forge и NeoForge.

🛠️ Что добавляет

Distant Horizons API включает в себя несколько ключевых возможностей для разработчиков:

• Интерфейсы и классы: Содержит необходимые классы, которые дают доступ к возможностям рендеринга, не переписывая код модов.
• Безопасный доступ к методам: Позволяет избежать использования потенциально небезопасных методов, таких как доступ к внутренним классам.
• Направление и диапазон глубины: Перечисления EDhApiDepthDirection и EDhApiDepthRange описывают, использует ли Distant Horizons прямое или обратное Z-рендеринг, а методы IDhApiRenderProxy.getDepthDirection() и IDhApiRenderProxy.getDepthRange() возвращают эти данные прямо из игры.
• Понятные настройки в конфигурации: Метод IDhApiConfigValue.setValue(value, apiUserDisplayName) позволяет передать имя твоего мода, чтобы в интерфейсе настроек было видно, кто именно управляет параметром.
• Совместимость с множеством модов: Мод может работать с другими популярными модами, такими как Sodium и OptiFine, расширяя возможности модификации.
• Документация и примеры: Полная документация и примеры проектов помогают разработчикам быстро освоить использование API.
• Поддержка работы на нескольких версиях: Поддержка различных версий Minecraft, включая 1.21.11, 1.21.10, 1.21.8 и ниже, вплоть до 1.12.2.

Обрати внимание: в версии 7.2.0 метод IDhApiConfigValue.setValue(value) объявлен устаревшим. Используй вместо него setValue(value, apiUserDisplayName) — иначе в интерфейсе конфигурации значение отобразится как «UNKNOWN» и в лог попадёт предупреждение.

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

Distant Horizons API поддерживает следующие версии Minecraft:

• 1.12.2, 1.16.5, 1.17.1, 1.18.2
• 1.19.2, 1.19.4
• 1.20.1, 1.20.2, 1.20.4, 1.20.6
• 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.10, 1.21.11
• 26.1, 26.1.1, 26.1.2, 26.2, 26.3

Поддерживаемые загрузчики:

• Fabric
• Forge
• NeoForge

Зависимости не требуются, так как данный мод представляет собой библиотеку. Он может работать совместно с Sodium, OptiFine и другими. Конфликтов с известными модами не обнаружено.

📥 Как установить

Следуй этим шагам, чтобы установить Distant Horizons API:

1. Сначала установи подходящий загрузчик: Fabric, Forge или NeoForge.
2. Скачай мод с официального сайта (по ссылке ниже) и помести .jar файл в папку mods.
3. Запусти игру и убедись, что мод работает правильно.
4. Для получения дополнительных возможностей, можешь установить моды, такие как Sodium или OptiFine.

👍 Плюсы и минусы

Как и у любого мода, у Distant Horizons API есть свои плюсы и минусы:

• Плюсы:
  • Широкие возможности для разработчиков.
  • Не требует дополнительных зависимостей для установки.
  • Поддерживает несколько загрузчиков.
  • Актуальное API 7.2.0 с понятными инструментами для рендеринга и настроек.
• Минусы:
  • Не предназначен для обычных игроков, требует навыков программирования.
  • Отсутствие контента для игрового процесса.
  • Может не подходить для начинающих разработчиков.

❓ Частые вопросы

1. Нужно ли устанавливать дополнительные моды для использования Distant Horizons API?

Нет, Distant Horizons API можно использовать независимо, но совместимость с другими модами, такими как Sodium или OptiFine, расширяет функционал.

2. Как я могу получить помощь по использованию Distant Horizons API?

Все необходимые инструкции и документацию можно найти на официальной вики.

3. Где я могу найти примеры использования API?

Примеры проектов доступны на GitLab, что позволит тебе увидеть, как интегрировать API в свои моды.

4. Что изменилось в версии 7.2.0?

В API появились перечисления EDhApiDepthDirection и EDhApiDepthRange, методы getDepthDirection() и getDepthRange() в IDhApiRenderProxy, а также перегрузка setValue(value, apiUserDisplayName). Старый вариант setValue(value) устарел и больше не рекомендуется к использованию.

История обновлений

14.11.2026 — Обновлена версия API до 7.2.0, добавлены сведения о новых перечислениях EDhApiDepthDirection и EDhApiDepthRange, методах getDepthRange() и getDepthDirection() и об устаревании setValue(value). Актуализирован список поддерживаемых версий Minecraft.