VulkanModNeoForge

Русский

VulkanMod NeoForge — клиентский мод для Minecraft, который заменяет стандартный конвейер рендеринга OpenGL на настоящую нативную реализацию Vulkan. Это порт оригинального VulkanMod — мода для Fabric/Quilt — на загрузчик модов NeoForge, специально нацеленный на Minecraft 1.21.

В отличие от решений-обёрток вроде Zink, VulkanMod не просто накладывает Vulkan поверх OpenGL. Вместо этого он перехватывает вызовы OpenGL Minecraft в реальном времени и транслирует их напрямую в операции Vulkan, обеспечивая подлинную замену движка рендеринга, которая использует возможности современных GPU и снижает нагрузку на CPU.

Мод полностью локализован на китайский для интерфейса настроек и внутриигровых сообщений, что упрощает китайскоязычным игрокам настройку параметров и понимание подсказок. Особая благодарность проекту VulkanMod Translations от scully06 за предоставленный ресурспак с китайской локализацией.

Оригинальный VulkanMod — экспериментальный проект, который привносит в Minecraft Java Edition совершенно новый воксельный движок рендеринга на основе Vulkan, стремясь заменить стандартный рендерер OpenGL 3.2 и повысить производительность. VulkanMod NeoForge переносит этот движок в экосистему NeoForge.

Ключевые особенности

• Полная замена движка рендеринга — перехватывает вызовы OpenGL и транслирует их в операции Vulkan в реальном времени
• Настоящий нативный Vulkan — не обёртка; напрямую использует API Vulkan для рендеринга
• Целевая платформа — Minecraft 1.21 с NeoForge 21.0.167+
• Текущая версия — 0.5.1-dev+3
• Лицензия — LGPL-3.0
• Требования к GPU — поддержка Vulkan 1.2 или выше
• Китайская локализация — полный китайский перевод экрана настроек и интерфейса

Технические особенности

• Прямая замена классов GL — заменяет классы OpenGL Minecraft (такие как GL11, GL14, GL15 и т. д.) на уровне байт-кода, перенаправляя все вызовы рендеринга на бэкенд Vulkan без ресурсоёмких слоёв перехвата.
• Управление жизненным циклом экземпляра Vulkan, устройства и swapchain
• Выделение памяти через Vulkan Memory Allocator (VMA)
• Преобразование шейдеров GLSL в SPIR-V в реальном времени через ShaderC
• Оптимизация рендеринга ландшафта на основе чанков
• Несколько алгоритмов отсечения чанков
• Режим косвенной отрисовки для снижения нагрузки на CPU
• Нативная поддержка Wayland
• Выбор GPU

VKNConfig — конфигурация при загрузке

VKNConfig — это низкоуровневая система конфигурации, которая применяет настройки до полной инициализации мода. В отличие от внутриигровых настроек графики (сохраняемых в vulkanmod_settings.json), VKNConfig управляет поведением при загрузке, которое влияет на то, как мод загружается и взаимодействует с NeoForge.

Конфигурация хранится в config/vkn-boot-config.json и включает три ключевые опции:

• forceReapplyGLMixins — принудительно повторно применяет GL-миксины. Полезно для совместимости с модами или отладки.
• useVulkanTransformers — включает или отключает конвейер трансформеров Vulkan. Отключение может снизить производительность, но помочь при определённых крашах.
• hideVulkanLibs — скрывает внутренние модули библиотеки Vulkan из внутриигрового списка модов, сохраняя экран модов чистым.

Эти настройки считываются при запуске. Если файл не существует, он автоматически создаётся со значениями по умолчанию. Опция hideVulkanLibs при включении удаляет записи "vulkan-libs" из списка модов через рефлексию, гарантируя, что они не появятся в интерфейсе.

Границы системы

Управляет:

• Жизненным циклом экземпляра Vulkan, устройства и swapchain
• Выделением памяти через VMA
• Преобразованием шейдеров GLSL в SPIR-V
• Оптимизацией рендеринга ландшафта на основе чанков
• Слоями совместимости OpenGL для GUI и постобработки

Не управляет:

• Игровой логикой Minecraft, тиками или ИИ сущностей
• Сетевыми операциями или серверной частью
• Событиями шины модов NeoForge, не связанными с рендерингом

Важные замечания

• Этот мод работает только на клиенте.
• Моды, напрямую вызывающие OpenGL, могут привести к крашу игры.
• Поддержка шейдеров всё ещё в разработке.
• Это полная переработка движка рендеринга, а не слой совместимости.

简体中文

VulkanMod NeoForge — это клиентский мод для Minecraft, заменяющий стандартный конвейер рендеринга OpenGL на настоящую нативную реализацию Vulkan. Этот проект — порт оригинального VulkanMod (мода для Fabric/Quilt) под загрузчик модов NeoForge с поддержкой Minecraft 1.21.

В отличие от таких обёрток, как Zink, VulkanMod не просто накладывает OpenGL поверх Vulkan, а в реальном времени перехватывает вызовы OpenGL от Minecraft и напрямую транслирует их в операции Vulkan, обеспечивая настоящую замену движка рендеринга с полным использованием возможностей современных GPU и снижением нагрузки на CPU.

Интерфейс настроек и внутриигровые подсказки мода полностью переведены на китайский, что упрощает китайским игрокам настройку параметров и понимание функций. Особая благодарность проекту VulkanMod Translations (автор scully06) за предоставленные ресурсы локализации.

Оригинальный VulkanMod — экспериментальный проект, привносящий в Minecraft Java Edition новый воксельный движок рендеринга на основе Vulkan, призванный заменить стандартный рендерер OpenGL 3.2 для повышения производительности. VulkanMod NeoForge переносит этот движок в экосистему NeoForge.

Основные особенности

• Полная замена движка рендеринга — перехват вызовов OpenGL в реальном времени с преобразованием в операции Vulkan
• Настоящий нативный Vulkan — не обёртка, а прямое использование Vulkan API для рендеринга
• Целевая платформа — Minecraft 1.21 с NeoForge 21.0.167+
• Текущая версия — 0.5.1-dev+3
• Открытая лицензия — LGPL-3.0
• Требования к GPU — поддержка Vulkan 1.2 или выше
• Китайская локализация — интерфейс настроек и UI полностью переведены на китайский

Технические особенности

• Прямая замена GL-классов — замена классов OpenGL Minecraft (таких как GL11, GL14, GL15 и т. д.) на уровне байт-кода, с перенаправлением всех вызовов рендеринга на бэкенд Vulkan, что позволяет избежать слоя перехвата с серьёзными потерями производительности.
• Управление жизненным циклом экземпляра Vulkan, устройства и цепочки обмена
• Выделение памяти через Vulkan Memory Allocator (VMA)
• Преобразование шейдеров из GLSL в SPIR-V в реальном времени через ShaderC
• Оптимизация рендеринга ландшафта на основе чанков
• Несколько алгоритмов отсечения чанков
• Режим непрямой отрисовки для снижения нагрузки на CPU
• Нативная поддержка Wayland
• Выбор GPU

VKNConfig — конфигурация при запуске

VKNConfig — это низкоуровневая система конфигурации, которая вступает в силу до полной инициализации мода. В отличие от внутриигровых графических настроек (сохраняемых в vulkanmod_settings.json), VKNConfig управляет поведением при запуске, которое влияет на сам процесс загрузки мода и на то, как мод взаимодействует с NeoForge.

Файл конфигурации находится в config/vkn-boot-config.json и содержит три ключевых параметра:

• forceReapplyGLMixins: принудительно повторно применяет GL Mixin. Может использоваться для решения проблем совместимости модов или для отладки.
• useVulkanTransformers: включает или отключает конвейер Vulkan-трансформеров. Отключение может снизить производительность, но помогает решить некоторые проблемы с крашами.
• hideVulkanLibs: скрывает внутренние модули библиотек Vulkan из внутриигрового списка модов, поддерживая его в чистоте.

Эти настройки считываются при запуске игры. Если файл конфигурации отсутствует, он создаётся автоматически с значениями по умолчанию. Когда включён параметр hideVulkanLibs, мод через рефлексию удаляет связанные с «vulkan‑libs» записи модов из списка, чтобы они не отображались в UI.

Границы системы

Отвечает за:

• Управление жизненным циклом экземпляра Vulkan, устройства и цепочки обмена
• Выделение памяти через VMA
• Преобразование шейдеров из GLSL в SPIR-V
• Оптимизацию рендеринга ландшафта на основе чанков
• Слой совместимости с OpenGL для GUI и постобработки

Не отвечает за:

• Игровую логику Minecraft, тики или ИИ сущностей
• Сетевые операции или серверную часть
• События шины модов NeoForge, не связанные с рендерингом

Важные замечания

• Этот мод работает только на клиенте.
• Моды, напрямую вызывающие OpenGL, могут привести к крашу игры.
• Поддержка шейдеров всё ещё в разработке.
• Это полная переработка движка рендеринга, а не слой совместимости.