Один клиент - все моды: как установить Forge и LiteLoader вместе | Руководства Майнкрафт - полные гайды для новичков и опытных игроков

Все для Minecraft
Полезные статьи
Руководства
Один клиент – все моды: как установить Forge и LiteLoader вместе

Опытные игроки знают: Forge нужен для мощных модов на механику, а LiteLoader – для небольших клиентских утилит (мини-карт, индикаторов FPS, чат-твиков). Проблема в том, что стандартные установщики обоих API по умолчанию создают разные профили в лаунчере – моды LiteLoader не видят Forge, и наоборот.

Мы расскажем, как объединить их в один клиент, чтобы моды обоих фреймворков работали одновременно. Метод проверен на версиях 1.8-1.12.2. Мы будем действовать вручную, без сомнительных сторонних патчеров.

Что такое Forge и LiteLoader и зачем их объединять

Совмещение Forge и LiteLoader в одном клиенте Minecraft позволяет одновременно использовать крупные моды, легкие визуальные или интерфейсные дополнения. Эти загрузчики изначально не были рассчитаны на совместную работу. Но их можно объединить при правильной настройке.

Minecraft Forge – это основной загрузчик модов, который используется для установки глобальных модификаций: новых блоков, мобов, механик, измерений.

LiteLoader – облегченный загрузчик, предназначенный для небольших модов, которые не требуют глубокой интеграции в игру. Это миникарты, улучшения отображения, HUD-интерфейсы и клиентские утилиты.

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

Подготовка к установке

В первую очередь проверьте версию Minecraft – Forge и LiteLoader должны строго совпадать по версии игры. Например, Forge 1.12.2 и LiteLoader 1.12.2. Даже небольшое несовпадение приведет к крашу.

Что понадобится для установки:

официальный лаунчер Minecraft (или любой сторонний с поддержкой custom versions);
установщик Forge (с сайта files.minecraftforge.net) под вашу версию игры;
LiteLoader (с сайта liteloader.com/versions) точно под ту же версию игры;
любой архиватор (7-Zip, WinRAR или штатный ZIP в Windows);
текстовый редактор (Блокнот, Notepad++).

Важное предупреждение: LiteLoader не выпускается для версий новее 1.12.2 официально. Для современных версий (1.16+) используют его форк – MixerLoader или аналоги. Но инструкция по установке одна.

Перед установкой позаботьтесь о резервной копии. Обязательно скопируйте папку minecraft и сохраните миры (saves). Это защитит от потери данных при ошибках.

Установите Forge как основу

Сначала поставьте обычный профиль Forge:

Скачайте Forge с официального сайта.
Найдите файл формата .jar (например: forge-1.12.2-installer.jar).
Запустите файл двойным кликом.
В установщике Forge, выберите пункт «Install client».
Укажите путь к папке – C:\Users\Имя\AppData\Roaming\.minecraft или /Library/Application Support/minecraft на macOS.
Нажмите ОК и дождитесь окончания установки.

После этого запустите лаунчер, создайте профиль с версией forge и проверьте, что он работает, загрузив главное меню. Это позволит сгенерировать все библиотеки. После успешной установки в лаунчере появится профиль Forge.

Установите LiteLoader

LiteLoader устанавливается похожим способом, но с некоторыми нюансами.

Скачайте LiteLoader под нужную версию
Запустите .jar файл
В окне установки выберите Install LiteLoader.
Укажите ту же папку .minecraft.
Подтвердите установку.

После этого появится отдельный профиль LiteLoader. Он будет использовать чистую версию игры (без Forge).

Один клиент - все моды: как установить Forge и LiteLoader вместе

Локализуйте файлы Forge

Закройте лаунчер. Перейдите в папку .minecraft/versions. Там вы увидите папку с названием типа forge-1.12.2-14.23.5.2860. Скопируйте полностью эту папку и переименуйте копию, например: forge-1.12.2-liteloader.

Внутри этой новой папки переименуйте JSON-файл и JAR-файл так же, как названа папка.
То есть было:

forge-1.12.2-14.23.5.2860.json
forge-1.12.2-14.23.5.2860.jar

Стало:

forge-1.12.2-liteloader.json
forge-1.12.2-liteloader.jar

Лаунчер идентифицирует версию по имени папки и внутреннему ID в JSON. Это создаст чистый слот для гибридной сборки. Теперь, когда все необходимые файлы установлены, можно переходить к ручной интеграции LiteLoader в сборку Forge.

Редактируйте JSON и привяжите LiteLoader

Откройте JSON-файл (forge-1.12.2-liteloader.json) в текстовом редакторе. Найдите строку «id». Она сейчас указывает на старое имя версии. Измените ее на новое имя папки:

"id": "forge-1.12.2-liteloader"

Теперь найдите раздел «libraries». В самом конце перед закрывающей скобкой ] добавим библиотеку LiteLoader. Вот пример для 1.12.2:

{
  "name": "com.mumfrey:liteloader:1.12.2-SNAPSHOT"
}

Если у вас точный билд (например, liteloader-1.12.2-0.8.0), то:

{
  "name": "com.mumfrey:liteloader:0.8.0"
}

Но просто прописать название недостаточно. Нужно, чтобы JAR-файл LiteLoader физически лежал в папке libraries. Поэтому делаем так:

скачайте установщик LiteLoader (.jar);
откройте его архиватором, не запуская;
внутри найдите папку libraries и извлеките из нее весь путь com/mumfrey/liteloader/версия/ – там будет liteloader-версия.jar;
скопируйте эту вложенную структуру в .minecraft/libraries/com/mumfrey/liteloader/версия/.

После этого в JSON строка «name»: «com.mumfrey:liteloader:0.8.0» будет корректно указывать на существующий JAR.

Правите аргументы запуска

Это главный секрет установки. LiteLoader требует добавления специальных параметров в «minecraftArguments» или в «arguments» (для новых версий).

Для версий 1.12.2 и старше (поле minecraftArguments):

Найдите в JSON строку «minecraftArguments». Она уже содержит Forge-аргументы. Добавьте в самый конец:

--tweakClass com.mumfrey.liteloader.launch.LiteLoaderTweaker

Пример итоговой строки:

"minecraftArguments": "--username ${auth_player_name} --version ${version_name} --gameDir ${game_directory} --assetsDir ${assets_root} --assetIndex ${assets_index_name} --uuid ${auth_uuid} --accessToken ${auth_access_token} --userType ${user_type} --versionType ${version_type} --tweakClass net.minecraftforge.fml.common.launcher.FMLTweaker --tweakClass com.mumfrey.liteloader.launch.LiteLoaderTweaker"

Обратите внимание: сначала идет твикер Forge, потом LiteLoader. Это очень важно. Если поменять порядок, игра не запустится.

Для версий 1.13+ (поле arguments)

Здесь структура сложнее. В раздел «arguments» → «game» добавьте объект:

{
  "value": "--tweakClass com.mumfrey.liteloader.launch.LiteLoaderTweaker",
  "rules": [
    {
      "action": "allow",
      "features": {
        "is_quick_play": false
      }
    }
  ]
}

Скопируйте модули LiteLoader

LiteLoader использует папку mods для своих .litemod-файлов, но может требовать отдельную директорию liteloader/mods. Для совместимости создайте внутри .minecraft папку liteloader, а в ней – mods. Туда отправьте .litemod файлы.

Обычные Forge-моды остаются в .minecraft/mods.

Первый запуск и проверка

Запустите лаунчер, выберите профиль forge-1.12.2-liteloader. Загрузитесь в мир и откройте меню модов (кнопка «Mods» в главном меню). Вы должны увидеть:

Minecraft Forge (версия …)
LiteLoader (версия …)

Теперь установите любой .litemod (например, VoxelMap) и обычный Forge-мод. Оба должны работать одновременно.

Частые ошибки и их решение

Ошибка 1: Tweak class not found

Это означает, что библиотека LiteLoader не загрузилась. Проверьте:

правильно ли вы скопировали JAR в .minecraft/libraries/com/mumfrey/liteloader;
совпадает ли версия в name и имя папки с JAR-файлом;
не перепутали ли порядок твикеров (Forge должен быть первым).

Ошибка 2: Игра запускается, но LiteLoader не виден в списке модов

Основная причина – неправильный minecraftArguments или вы забыли добавить –tweakClass. Также проверьте, что вы не используете одновременно с OptiFine в режиме –tweakClass – там может быть конфликт. Для OptiFine + LiteLoader + Forge порядок: Forge, LiteLoader, OptiFine.

Ошибка 3: Вылет при загрузке мира с NoSuchMethodError

Это несовместимость версий. LiteLoader должен быть строго под ту же сборку Forge. Для версий новее 1.12.2 используйте MixerLoader. Он устанавливается аналогично, но с другими именами классов.

Ошибка 4: Черный экран или вылет из игры

Частые причины – конфликт модов или установка устаревших модификаций. Удалите последние установленные моды, проверяя их по одному.

Ошибка 5: LiteLoader не работает

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

Теперь у вас единый клиент, где Forge-моды и LiteLoader-моды мирно сосуществуют. Не забывайте: при обновлении Forge процедуру придется повторить. Всегда делайте резервную копию папки versions перед экспериментами.

Теги: