Nether API

Мод Nether API для Minecraft 1.12.2

Nether API — это библиотека-мод для Minecraft 1.12.2, предназначенная для создания и объединения генерации биомов и структур в Нижнем мире и Энде. Она предоставляет инструменты для разработчиков, позволяющие добавлять кастомную атмосферу, звуки, частицы и условия генерации для любых биомов. Мод решает проблему разрозненных генераторов биомов, унифицируя старые подходы и исправляя критические баги с откликом и логикой мира. Также он включает значительные улучшения совместимости с популярными модами, такими как BetterNether и Biomes O' Plenty, исправляя каскадные проблемы генерации и улучшая производительность.

Основная цель и унификация генерации

Основная задача Nether API — предоставить единую систему для генерации биомов и структур в Нижнем мире и Энде. До появления этой библиотеки разные моды использовали собственные, часто конфликтующие алгоритмы генерации, что приводило к нестабильности и ошибкам. Nether API объединяет эти подходы, предоставляя общий интерфейс для создания новых биомов с кастомными условиями, весами генерации, цветом тумана и музыкальными треками. Это позволяет авторам модов сосредоточиться на дизайне мира, не переписывая базовую логику генерации.

API для разработчиков: создание атмосферы и биомов

Библиотека предлагает расширенные возможности для создания уникальной атмосферы в любом биоме, а не только в Нижнем мире или Энде. Разработчики могут настроить пассивные фоновые звуки, звуки темноты и спавн пассивных частиц, используя события BiomeAmbienceEvent. Для создания новых биомов доступны настройки веса генерации через NetherAPIRegistryEvent, цвет тумана через NetherAPIFogColorEvent, а также кастомные типы поверхности, заполнители чанков и условия вырезания пещер. Особое внимание уделено деталям генерации: можно задать условия появления Хоровых растений, Городов Энда и Малых островов Энда, а также создать несколько взвешенных подбиомов и краевых биомов.

Генерация структур и новые типы растений

Наряду с биомами, Nether API позволяет создавать кастомные структуры, которые могут генерироваться между чанками, как Крепости Нижнего мира. Для них можно настроить свойства спавна сущностей и условия генерации. Все зарегистрированные структуры автоматически поддерживают команду /locate и проверяют наличие других структур, чтобы избежать пересечений. Также библиотека вводит новые типы растений (EnumPlantTypes), которые автоматически применяются к модовым блокам, имитирующим Энд-камень или Нетхер-рак. Это обеспечивает совместимость растений из разных модов с соответствующими почвами: PlantUtils.END_PLANT_TYPE для Энда, PlantUtils.NETHER_PLANT_TYPE для Нетхер-рака и Песка Души, а также специфические типы для каждого блока.

Улучшения совместимости с BetterNether и Biomes O' Plenty

Одной из ключевых функций Nether API является глубокое взаимодействие с модом BetterNether. Мод полностью заменяет псевдо-биомовую систему BetterNether на реальные биомы, что значительно улучшает производительность за счет исключения лишних обновлений блоков. Это также решает проблемы каскадной генерации. Для Biomes O' Plenty (BOP) библиотека добавляет опции, чтобы жидкости (Кровь и Мёд) не испарялись при выливании в Нижнем мире, а также разрешает генерацию биомов BOP независимо от типа мира. Исправляются каскадные ошибки генерации динамических деревьев, шипов и лавы, а также предотвращается удаление тумана из Энда и Нижнего мира.

Исправления багов и улучшения логики мира

Nether API устраняет множество известных проблем Minecraft и других модов. Исправлена логика начального спавна игрока, предотвращая появление в лаве или высоко над землей. Решена проблема MC-10369 с отсутствием спавна частиц (например, при создании голема или слиянии жидкостей). Также исправлен баг MC-31681, при котором туман и облака затемнялись под блоками. Введена возможность отключать спавн первого Дракона Энда через конфиг, при этом портал и яйцо дракона остаются функциональными. Дракон больше не может разрушать блоки с сопротивлением Obsidian и факелы у портала. Логика отклика теперь учитывает точки спавна постелей во всех измерениях, что решает проблемы с возрождением в модах вроде The Aether.

Совместимость с Journey Into The Light и Natura

Для мода Journey Into The Light (JITL) библиотека исправляет все каскадные ошибки генерации Нижнего мира и проблемы со спавном сущностей. Сущности JITL теперь спавнятся только в соответствующих биомах (например, Hell Cow в Blood Forest), а не в базовом биоме Ад. Производительность генерации улучшена, а спам в логах от исправленных ID спавнеров устранен. Взаимодействие с Natura ограничено: особенности Нижнего мира генерируются только в базовом биоме Ад, чтобы не нарушать баланс, хотя это можно настроить через GroovyScript.

Поддержка Nethercraft Classic и NetherEx

Nethercraft Classic получает новый биом "Glowing Grove", куда переносятся все его особенности. Модифицируются регистры сущностей для исправления поведения снарядов, а темные зомби теперь вызываются через SummonAidEvent в Нижнем мире. Яйца слизней больше не спавнят сущностей на клиенте. Для NetherEx библиотека активирует ранее неиспользуемые настройки генерации песка и гравия и исправляет проверку размеров структур, предотвращая каскадные ошибки.

Совместимость со Stygian End

Библиотека поддерживает все версии модов серии Stygian End. В их биомы больше не генерируются Хоровые растения и Города Энда (это можно включить через конфиг). Исправлены каскадные ошибки генерации канопа и вулканов, а особенности биома Acidic Plains теперь появляются только на Энд-обсидиане.

Увеличение высоты Нижнего мира

Одной из продвинутых возможностей является возможность сделать Нижний мир высотой в 256 блоков. Эта функция выключена по умолчанию и рекомендуется только для новых миров или после сброса старого Нижнего мира. При активации необходимо настроить конфигурации совместимых модов (Biomes O' Plenty, Natura, Nethercraft Classic и др.), чтобы они корректно генерировали свои особенности в новом объеме. Все моды, использующие Nether API как зависимость, автоматически получают поддержку этой функции.

Технические детали и установка

Nether API работает как библиотека, требуя установки на клиент и сервер. Она не имеет внешних зависимостей и не использует миксины. Файл распространяется через собственные зеркала, так как прямое распространение материалов не разрешено. Для разработчиков модпаков, желающих добавить этот мод в сборку, рекомендуется использовать File Director, чтобы избежать повторной загрузки файлов. Мод поддерживает только версию Minecraft 1.12.2 и загрузчик Forge.

Связанные материалы

• Lithostitched — похожий мод
• Dynamic Trees Plus — похожий мод
• Dynamic Trees - Biomes O' Plenty — похожий мод