CrankShaft

Требует Create & CrankShaft Bridge для работы с Create Fly и Create Adapted

О моде

CrankShaft — это неофициальный порт Flywheel на Minecraft 26.2, продолжающий работу Jozufozu и команды Engine-Room, а также собственный бэкпорт CrankShaft на 1.12.2. Работает на NeoForge и Fabric. Поддержка шейдерпаков Iris — это адаптация Colorwheel: контракт шейдерпаков Colorwheel и wavelet OIT, перестроенные на рендерере CrankShaft. Мод не связан с Flywheel, Colorwheel или их мейнтейнерами, не одобрен и не поддерживается ими. Баги в CrankShaft — это баги CrankShaft, а не их — пожалуйста, сообщайте о них здесь.

Вместе с CrankShaft поставляется Vanillate — аналог Vanillin для 26.2: инстансный рендеринг ванильных сущностей и блочных сущностей через Flywheel. Он встроен в jar CrankShaft и по умолчанию отключён — пока вы его не включите, он ничего не регистрирует, и ванильный рендеринг работает как обычно. Включите его через "enabled": true в config/vanillin.json (Fabric) или enabled = true в config/vanillin-client.toml (NeoForge). После этого отдельные сущности и блочные сущности можно включать или отключать для каждой записи в том же файле.

Возможности

• OpenGL и Vulkan. Нативные бэкенды для обоих графических API Minecraft 26.2, выбираются автоматически.
• Шейдерпаки Iris. Инстансная графика рендерится через собственные программы активного шейдерпака, включая его проход теней, вместо того чтобы отключаться.
• Order-independent transparency (OIT). Перекрывающиеся полупрозрачные инстансы смешиваются корректно без сортировки. Доступно пять методов; см. OIT.
• Интеграция с ландшафтом. Полупрозрачный ландшафт чанков по умолчанию участвует в том же OIT, что и инстансы. С Sodium CrankShaft также может отсекать и отрисовывать непрозрачный ландшафт на GPU; см. Ландшафт.

Требования

• Minecraft 26.2 с NeoForge или Fabric (+ Fabric API) и Java 25+.
• Опционально: Sodium 0.9.2 или новее, но ниже 0.10. Нужен для режимов ландшафта opaque/full и бэкендов с mesh-шейдерами.
• Опционально: Iris для шейдерпаков (собран против 1.11.4). Требует OpenGL.

Бэкенды

CrankShaft выбирает лучший поддерживаемый бэкенд для вашего железа. /flywheel backend показывает или меняет его.

Если запрошенный бэкенд не поддерживается, CrankShaft переключается на следующий поддерживаемый. Пока активен шейдерпак, выбор нативного бэкенда OpenGL выбирает его аналог iris_.

Vulkan

Minecraft 26.2 может рендерить через Vulkan: Options → Video Settings → Graphics API → Vulkan, затем перезапустите игру. CrankShaft определяет рендерер Vulkan и переключается на свои бэкенды Vulkan; никаких настроек CrankShaft не требуется.

На NeoForge также установите earlyWindowControl = false в config/fml.toml. Экран загрузки NeoForge работает только на OpenGL, и без этого изменения игра не запустится на Vulkan.

Функции рендеринга одинаковы на обоих API; только поддержка шейдерпаков требует OpenGL.

Шейдерпаки Iris

С Iris и включённым шейдерпаком CrankShaft переключается на свои бэкенды iris_ и рендерит инстансы через собственные программы пака, включая тени. Ничего настраивать не нужно.

• Паки, реализующие контракт шейдерпаков Colorwheel (программы clrwl_ и colorwheel.properties), используют его напрямую, включая его OIT там, где пак его включает.
• Встроенные адаптеры восполняют пробелы в конкретных паках (см. ниже). Адаптер проверяет фактические исходники шейдеров пака, а не его имя файла или версию. Если пак изменился, адаптер пропускается целиком, и пак возвращается к общему пути.
• Другие паки рендерят инстансы через свои стандартные программы, без OIT.
• Под шейдерпаком OIT следует собственным настройкам пака; /flywheel oit mode применяется только к бэкендам без Iris.

Протестированные шейдерпаки:

Инстансы, отрисованные через пак, могут немного отличаться от того, что выдал бы собственный рендерер пака.

Экспериментальные опции, по умолчанию выключены, включаются аргументами Java в вашем лаунчере:

Команды

Команды клиентские; изменённые ими настройки сохраняются в файл конфигурации. Автодополнение по Tab перечисляет все варианты.

Порядконезависимая прозрачность

wavelet — всегда приближение. kbuffer, mlab и abuffer — однопроходные методы вставки и точны, пока ни у одного пикселя не больше полупрозрачных фрагментов, чем бюджет слоёв (K, или N для abuffer). После превышения бюджета kbuffer отбрасывает лишние фрагменты независимо от глубины, mlab объединяет самые дальние слои, а abuffer отбрасывает самые дальние. abuffer к тому же точен только пока не исчерпан его пул фрагментов — 8 на экранный пиксель по всему кадру. Больше слоёв сохраняет точность более глубоких стопок витражного стекла ценой более высокой нагрузки на GPU.

В OpenGL методы вставки работают на GPU-driven бэкендах (indirect, gl_mesh_shader); instancing всегда использует wavelet. Без fragment-shader interlock mlab откатывается к wavelet.

Режимы ландшафта

GPU-driven бэкенды — это indirect, gl_mesh_shader, vk_indirect и vk_mesh_shader. На других бэкендах или без Sodium opaque ведёт себя как off, а full — как translucent.

Настройка

Команды записывают те же файлы, которые вы можете редактировать вручную: config/crankshaft.json на Fabric, config/flywheel-client.toml на NeoForge. Настройки: backend, limitUpdates, workerThreads, useCommonPool, а в flw_backends: lightSmoothness, terrain и настройки OIT.