CrankShaft (Кранкшафт)

Мод для Майнкрафт на Fabric и NeoForge — неофициальный порт Flywheel, который отвечает за производительный рендеринг инстансов. Он поддерживает OpenGL и Vulkan, работает с шейдерами Iris и помогает корректно отображать несколько прозрачных объектов друг над другом.

Возможности

• Автоматически выбирает подходящий для видеокарты рендерер; доступны Vulkan- и OpenGL-режимы, включая режимы с отсечением невидимых объектов на GPU.
• Рендерит инстансы через активный шейдер-пак Iris, в том числе в проходе теней.
• Поддерживает несколько методов независимой от порядка прозрачности (OIT): auto, wavelet, kbuffer, mlab и abuffer. Они улучшают наложение стекла, воды и других полупрозрачных объектов.
• Может объединять прозрачный ландшафт чанков — воду, стекло и лёд — с прозрачными инстансами.
• В связке с Sodium умеет рендерить непрозрачный ландшафт с отсечением на GPU.
• В архив мода входит Vanillate: дополнительный рендеринг ванильных мобов и блочных сущностей через инстансы. Он выключен, пока его не включат в конфиге.

Как пользоваться

Команды работают на стороне клиента, а изменённые ими параметры сохраняются в конфиге.

• /flywheel backend — показать используемый рендерер.
• /flywheel backend <id> — выбрать рендерер вручную; /flywheel backend DEFAULT возвращает автоматический выбор.
• /flywheel terrain off|translucent|opaque|full — настроить обработку ландшафта. translucent обрабатывает только прозрачные блоки, opaque — непрозрачные, full — оба типа.
• /flywheel oit — показать параметры прозрачности.
• /flywheel oit mode auto|wavelet|kbuffer|mlab|abuffer — выбрать метод OIT.
• /flywheel oit layers <0-32> — задать число слоёв для активного метода; большее значение точнее отображает глубокие слои прозрачности, но сильнее нагружает GPU.
• /flywheel oit reset — вернуть число слоёв к исходным значениям.
• /flywheel oit exactweather true|false — настроить смешивание дождя и снега с прозрачными объектами.
• /flywheel lightSmoothness <mode> — выбрать сглаживание освещения: flat, tri_linear, smooth или smooth_inner_face_corrected.
• /flywheel limitUpdates on|off — реже обновлять далёкие инстансы.
• /flywheel debug info — вывести сведения о рендерере, настройках и числе объектов.
• /flywheel debug gpuTimer on|off|once|summary — показать время работы GPU по этапам рендеринга.

При включённом шейдер-паке Iris мод использует варианты рендереров iris_. Шейдер-паки с контрактом Colorwheel могут использовать его собственную обработку прозрачности; для остальных шейдер-паков инстансы выводятся обычными программами пакета.

Настройки

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

Чтобы включить Vanillate, укажите "enabled": true в config/vanillin.json на Fabric либо enabled = true в config/vanillin-client.toml на NeoForge. В этом же файле можно отдельно включать и отключать рендеринг конкретных мобов и блочных сущностей.

Для Vulkan выберите «Vulkan» в меню «Настройки графики» игры и перезапустите Майнкрафт. На NeoForge дополнительно установите earlyWindowControl = false в config/fml.toml. Шейдеры Iris работают только с OpenGL.

Требования и совместимость

Нужен Fabric с Fabric API либо NeoForge, а также Java 25 или новее. Sodium нужен для режимов ландшафта opaque и full, а также для рендереров с меш-шейдерами. Iris требуется для работы с шейдер-паками.

Режимы opaque и full требуют Sodium и рендерер с обработкой на GPU. Если подходящий режим не поддерживается видеокартой, мод переключается на совместимый вариант.