Linkwright: мост совместимости модов для Minecraft

Linkwright для Minecraft чинит несовместимость модов и версий загрузчика: проверяет связи, адаптирует мелкие изменения и запускает игру.

Linkwright: мост совместимости модов для Minecraft

Знакомая ситуация: сборка из трёхсот модов работала идеально, вы обновили один мод — и игра отказывается стартовать. Причина обычно банальна: один мод требует версию 1.3 другого, а у вас стоит 1.2. Или мод ждёт конкретный билд NeoForge, Forge или Fabric Loader, а у вас уже новее. Linkwright создан именно для таких случаев. Он проверяет, совместимы ли моды друг с другом, и если да — позволяет игре запуститься, аккуратно адаптируя мелкие расхождения прямо при загрузке. Файлы модов при этом не редактируются.

Как работает Linkwright

При каждом запуске игры Linkwright выполняет несколько шагов. Сначала он находит невыполненные правила версий — между модами или на уровне загрузчика. Затем проверяет каждый класс, метод и поле, которые один мод использует из другого, включая миксины. Если изменение можно исправить ровно одним безопасным способом, Linkwright его адаптирует. Если всё сходится — игра стартует. Если нет, вы получаете обычную ошибку плюс отчёт с объяснением, чего не хватает. Сборка из 300+ модов проверяется примерно за секунду.

Что исправляется автоматически

  • Блокировки версии загрузчика: мод принимает только старый NeoForge, Forge или Fabric Loader, а у вас новее — Linkwright проверяет всё, что мод использует из загрузчика, и разрешает запуск. Работает и в обратную сторону для небольших разрывов.
  • Новые параметры: метод получил дополнительные входные данные — Linkwright заполняет их значениями, которые у мода уже есть.
  • Изменённые типы: значение сменило тип, например число стало более широким — выполняется конвертация без потерь.
  • Изменения интерфейсов: обязательный метод поменял типы — добавляется новая версия со ссылкой на старую.
  • Новые возвращаемые значения: метод теперь возвращает что-то ещё — Linkwright это игнорирует.
  • Удалённые параметры: методу нужно меньше входных данных — лишние опускаются.
  • Обёрнутые значения: значение передаётся внутри Supplier, Optional или Holder — Linkwright его разворачивает.
  • Поля и геттеры: поле заменено геттером или сеттером, или наоборот — используется то, что существует сейчас.
  • Переименованные геттеры: getName() стал name() или обратно — Linkwright следует за новым именем.
  • Перемещённые классы: класс переехал в другой пакет того же мода — мод направляется по новому адресу.
  • Статические изменения: метод стал статическим или перестал — вызов корректируется.
  • Дубликаты модов: один и тот же мод лежит в папке дважды, обычно старая версия после обновления. Linkwright оставляет копию, добавленную последней, даже если она старее, а вторую переименовывает в .jar.disabled. В лаунчере она отобразится как отключённая, и её можно вернуть.

О чём Linkwright предупреждает

Некоторые проблемы исправить нельзя, но Linkwright честно указывает на них в логе и отчёте. Это неверная версия Java: мод собран под более новую Java, чем запускает игра. А также дубликаты, которые не получается упорядочить, — например, на серверах, где не фиксируется время добавления файлов, или на NeoForge 21.9 и новее, где NeoForge сам загружает высшую версию.

Реальные примеры

CBC Aeronautics Missiles плюс Create: Radars 5 — Radars добавил новый параметр в один метод. Linkwright проверил остальные 124 связи и исправил оба вызова. Power Grid плюс TFMG 1.2 — TFMG изменил способ хранения позиций блоков, и Linkwright конвертирует их в обе стороны.

Безопасность по умолчанию

Linkwright никогда не угадывает. Если возможных исправлений больше одного или нет ни одного, ошибка остаётся. Каждая правка сначала тестируется: исправленный класс проверяется в памяти до запуска игры, и при неудаче используется обычная ошибка вместо краша. Мод уважает авторов: намеренную несовместимость он не трогает. Данные не теряются — значения конвертируются, только когда ничего не утрачивается. Все решения записываются в logs/linkwright-report.txt.

Если вы не хотите вручную подбирать файлы, лаунчер foxygame.net подбирает нужную сборку Linkwright под вашу версию игры и загрузчик автоматически, а сам мод доступен в его каталоге дополнений.

Какую версию скачать

  • Forge 1.17.1 и новее либо любой NeoForge: linkwright-1.3.1.jar
  • Forge 1.13.2–1.16.5: linkwright-1.13-1.16.5-1.3.1.jar
  • Forge 1.7.10–1.12.2: linkwright-1.7.10-1.12.2-1.3.1.jar
  • Fabric, любая версия: linkwright-fabric-1.3.1.jar

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

Поместите jar в папку mods. Мод работает на клиенте, на сервере или на обоих сразу, и версии не обязаны совпадать. Linkwright запускается раньше других модов, поэтому на некоторых версиях его не видно в списке модов в игре — это нормально. Учтите: для подключения к серверу версии остальных модов у клиента и сервера всё равно должны совпадать.

Fabric: один дополнительный шаг

Fabric проверяет версии модов до запуска любых модов, поэтому Linkwright нужно стартовать чуть раньше. Добавьте один Java-аргумент: -javaagent:mods/linkwright-fabric-1.3.1.jar. Если номер версии в имени файла другой, измените название. В Prism Launcher или MultiMC это делается через Edit Instance, затем Settings и вкладка Java — включите JVM arguments и впишите аргумент. В официальном лаунчере: Installations, Edit, More Options, добавьте в начало JVM Arguments. На сервере аргумент ставится в команду запуска перед -jar. Проверка простая: ищите в логе строки, начинающиеся с Linkwright. Сообщение «Linkwright is installed but not active» означает, что аргумент отсутствует или имя файла не совпадает.

Настройки

Файл конфигурации создаётся по пути config/linkwright.toml, и значения по умолчанию подходят почти всем. Параметр mode принимает значения auto (исправлять и одобрять), report (только отчёт) и off. bridgeCalls со значением false разрешает только точные совпадения без правок. ignore задаёт пары модов, которые не трогать. disableDuplicates со значением false оставляет только предупреждение о дубликатах. olderLoaderBuilds со значением false игнорирует моды, требующие более поздний билд загрузчика. forceApprove разрешает пары даже при найденных проблемах — это может уронить игру.

Ограничения и требования

Linkwright проверяет совместимость модов, а не то, что делает код: метод с другим поведением, но тем же видом, пройдёт проверку. Удалённые или переименованные в нечто новое методы не исправляются, перемещённые классы отслеживаются только при сохранении имени. Если моду нужен более новый релиз загрузчика, например NeoForge 21.2 при 21.1, Linkwright его не трогает — обновите загрузчик. Проверяются только более поздние билды того же релиза.

Требования: Forge для Minecraft 1.7.10–26.x, NeoForge любой версии, Fabric Loader 0.14 или новее для Minecraft 1.14–26.x. Другие моды не нужны, Quilt пока не поддерживается. Если вы нашли пару модов, которую Linkwright должен исправить, но не исправляет, сообщите об этом на GitHub и приложите logs/linkwright-report.txt.

Вывод

Linkwright — это практичный инструмент для тех, кто собирает большие сборки и устал от ошибок версий после каждого обновления. Он не заменяет здравый смысл и не чинит всё подряд, но снимает большинство мелких конфликтов между модами и загрузчиком. Скачать Linkwright стоит хотя бы для того, чтобы один раз увидеть, сколько проблем в вашей сборке решается за секунду — без правки файлов и без риска потерять данные.