lwjgl3ify

lwjgl3ify адаптирует Minecraft 1.7.10 для работы на современных версиях Java и библиотеке LWJGL3, включая встроенную систему раннего запуска плагинов RetroFuturaBootstrap.

lwjgl3ify обеспечивает совместимость Minecraft 1.7.10 с современными средами выполнения, позволяя использовать библиотеки LWJGL3 и версии Java 17 и выше. Проект также включает в себя RetroFuturaBootstrap — гибкую систему плагинов для ранней загрузки.

Для начала работы необходимо поместить основной JAR-файл в папку mods/. Запуск производится стандартным способом через Java 8, после чего при старте появится окно для выбора современной версии Java и настройки параметров JVM для соответствующей установки. Если окно не появляется, рекомендуется вручную установить актуальную версию Java (рекомендуются 17 или 21 версии).

Пользователи могут изменять параметры окна, ввод мыши, свойства контекста OpenGL и другие расширенные настройки в конфигурационном файле config/lwjgl3ify.cfg, который создается после первого запуска, либо через меню «lwjgl3ify Mod Options» в самой игре.

Несмотря на стремление к максимальной совместимости, некоторые модификации могут работать некорректно. В случае возникновения проблем рекомендуется проверить список известных ошибок в трекере проекта или создать новый отчет с приложением логов и отчета о сбое (crash report).

Для настройки сервера необходимо сначала установить рабочую версию Forge. Затем поместите JAR-файл мода и необходимые зависимости (UniMixins, Hodgepodge, GTNHLib) в папку mods/. Также потребуется файл forgePatches.jar.

Поместите forgePatches.jar в папку с исполняемыми файлами сервера (рядом с forge-universal и minecraft_server.jar) и переименуйте его в lwjgl3ify-forgePatches.jar. Используйте файл java9args.txt из исходников проекта для запуска.

java -Xmx6G -Xms6G @java9args.txt -jar lwjgl3ify-forgePatches.jar nogui

Серверы типов Thermos, Crucible или Hybrid не поддерживаются.

Проект использует комплексный подход для поддержки новых сред, включающий следующие компоненты:

• Перезагрузчик игры для модификации списка библиотек в classpath и установки LWJGL3.
• Специальный JAR-файл для сервера с измененным манифестом Class-Path.
• Замена launchwrapper с механизмом обнаружения classpath, совместимым с Java 9+.
• Использование флагов add-opens для обеспечения работы рефлексии в системных внутренних структурах JVM.
• Shim-слой для перенаправления вызовов API LWJGL2 на соответствующие вызовы LWJGL3.
• Заглушки для классов org/lwjgl/*, удаленных в LWJGL3 (например, Display), для поддержки метаданных Mixin.
• Асм-трансформеры для переименования обращений к LWJGL, исправления ошибок javac 8 и замены удаленных API (например, javax/xml/bind на jakarta/xml/bind).

Мод включает специфические патчи Forge для корректной работы в Java 17+, исправляя проблемы с аннотациями, обработкой классов и загрузчиками. Также реализованы производительные улучшения:

• Загрузчик изображений на базе STB_image, работающий значительно быстрее стандартного.
• Сшивка текстур на основе STB_rectpack, позволяющая практически мгновенно объединять десятки тысяч текстур в атлас.