Iceberg mod: что это и какую версию устанавливать

Что такое Iceberg

Iceberg — библиотека событий, вспомогательных классов и утилит для модов AHilyard и других проектов. Она не добавляет самостоятельный игровой цикл. Пользователь устанавливает её, когда Legendary Tooltips, Advancement Plaques, Item Borders или другой мод объявляет зависимость. Если после одиночной установки ничего не изменилось, это ожидаемое поведение.

Отдельные страницы Fabric и Neo/Forge

На CurseForge Forge и NeoForge собраны на одной странице, а Fabric вынесен отдельно. На Modrinth платформы могут отображаться вместе. Не скачивайте первый найденный файл по общему названию. Сначала определите loader активного профиля, затем откройте правильную официальную страницу и отфильтруйте версию Minecraft.

Как выбрать версию

Сопоставьте Minecraft, loader и диапазон Iceberg, указанный зависимым модом. Версия библиотеки не обязана совпадать с номером основного проекта. Старые ветки могут иметь другую структуру jar и набор API. Для модпака используйте manifest, а не заменяйте зависимость самым новым релизом без проверки совместимости.

Установка

Остановите игру, положите один официальный jar в mods активного экземпляра и добавьте требующий мод. Не распаковывайте архив. После запуска откройте latest.log и проверьте регистрацию Iceberg. Если библиотека загрузилась, но функция отсутствует, изучите журнал основного мода и его конфигурацию: Iceberg не включает его контент.

Клиент и сервер

Официальная библиотека рассчитана на обе стороны, но потребность определяется зависимым проектом. Визуальные tooltip-моды могут быть клиентскими, а общая механика — требовать серверный jar. Следуйте environment основного мода. Не переносите все клиентские дополнения на dedicated server: это может вызвать обращение к отсутствующим графическим классам.

Ошибка requires Iceberg

Прочитайте требуемый диапазон и mod id, удалите старую копию и скачайте файл для своей платформы. Проверьте активную папку лаунчера. Forge, NeoForge и Fabric jars не взаимозаменяемы. Если два мода требуют несовместимые ветки, обновите или откатите один проект, а не держите две версии Iceberg одновременно.

Duplicate mod и неправильная страница

Duplicate mod id означает, что в mods лежат две копии. Они могут иметь разные названия из отдельных CurseForge-страниц. Оставьте только файл текущего loader. Если загрузчик сообщает invalid mod file, проверьте расширение, целостность загрузки и платформу. Не переименовывайте Fabric jar в Forge — содержимое от этого не меняется.

ClassNotFound и NoSuchMethod

ClassNotFound обычно указывает на отсутствующую библиотеку или неверную платформу. NoSuchMethod чаще означает несовместимые поколения Iceberg и зависимого мода. Найдите первый caused by, сравните версии и верните рабочую группу. Ошибка может проявиться при открытии tooltip или advancement, поэтому запишите точное действие до сбоя.

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

Сохраните mods, config и мир. Обновляйте Iceberg вместе с модами, которые используют её события и helpers. Сначала запустите тестовый профиль и откройте проблемный экран. При ошибке откатите всю изменённую группу. Не удаляйте конфигурацию без backup: несовместимый метод не исправляется сбросом пользовательских настроек.

Диагностика

Укажите Minecraft, Java, loader, Iceberg, зависимый мод и сторону запуска. Приложите полный latest.log или server log, ссылку на официальный файл и шаги воспроизведения. Создайте минимальный профиль. Если он работает, возвращайте остальные моды партиями, чтобы обнаружить конфликт рендера, tooltip или событий.

Быстрая проверка перед началом

iceberg mod minecraft: Сверь версию игры, загрузчик и зависимости. Добавляй моды небольшими группами и сохраняй журнал, чтобы быстро найти причину вылета.

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