Переход на версию 26.1 26.1.2

Рекомендации по переносу на Minecraft 26.1 - последнюю версию игры.

WARNING

Эта страница написана для версии 26.1.2. Документация для более старых версий может быть неполной.

Версия Minecraft 26.1 не обфусцирована, как и её предварительные версии. Учитывая это, вам нужно будет сделать больше изменений в ваших скриптах сборки, чем обычно, чтобы обновиться под неё.

INFO

В этих документах говорится о миграция с версии 1.21.11 на 26.1. Если вы ищете другую миграцию, переключитесь на целевую версию с помощью выпадающего списка в правом верхнем углу.

Предварительные условия

Если ваш мод всё ещё использует маппинги Yarn от Fabric, сначала необходимо перевести ваш мод на официальные маппинги Mojang перед портированием до 26.1.

Если вы используете IntelliJ IDEA, вам также нужно будет обновить её до версии 2025.3 или выше для полной поддержки Java 25.

Обновление скрипта сборки

Для начала обновите ваши gradle/wrapper/gradle-wrapper.properties, gradle.properties и build.gradle до новейших версий. Если у вас возникнут проблемы, рекомендуется обратиться к Экземпляру Fabric мода.

1. Обновите Gradle до новейшей версии, выполнив следующую команду: ./gradlew wrapper --gradle-version latest
2. Обновите Minecraft, Fabric Loader, Fabric Loom и Fabric API внутри gradle.properties (рекомендовано) или внутри build.gradle. Рекомендованные версии компонентов Fabric можно найти на сайте разработки Fabric.
3. Вверху build.gradle измените используемую версию Loom с id "fabric-loom" на id "net.fabricmc.fabric-loom". Если Loom указан в settings.gradle, замените его и там.
4. Уберите строку с mappings из секции зависимостей внутри build.gradle.
5. Замените любые экземпляры modImplementation, modCompileOnly илиmodApi на implementation, compileOnly иapi.
6. Удалите или замените все моды под версии ниже 26.1 с версиями, совместимыми с этим обновлением.
   • Все моды под Minecraft 1.21.11 или ниже не будут работать на 26.1, даже как зависимости для компиляции.
7. При необходимости обновите заголовок вашего расширителя доступа или модификатора классов заменив named наofficial.
8. Установить совместимость Java на 25, вместе 21.
9. Замените все упоминания remapJar на jar.
10. Обновить проект Gradle с помощью кнопки обновления в правом верхнем углу IntelliJ IDEA. Если эта кнопка не отображается, вы можете очистить кэш, выполнив ./gradlew --refresh-dependencies.

Обновление кода

После того, как вы обновили скрипт сборки до 26.1, вы можете пройтись по вашему моду и обновить изменённый код, чтобы сделать его совместимым со снапшотом.

• Fabric для Minecraft 26.1 на блоге Fabric'а](https://fabricmc.net/2026/03/14/261.html) содержит объяснения изменений высокого уровня, сделанных для Fabric API 26.1.
• Руководство по портированию под Fabric API перечисляет переименования Fabric API в снапшотах 26.1 для соответствия названиям Mojang.
• Java Edition 26.1 на Minecraft Wiki — неофициальное краткое описание содержания обновления.
• _ Основы миграции модов с Minecraft 1.21.11 до 26.1_ от NeoForge описывает миграцию с 1.21.11 до 26.1, обращая внимание только на изменениях в ванильном коде.