Circular Rendering

Circular Rendering

English | 中文

Это мод для Fabric, который меняет отрисовку чанков на круглую (или эллиптическую) форму вокруг игрока.
По умолчанию он отрисовывает чанки в пределах идеального круга (радиус = дальность прорисовки × 16 блоков).
При желании можно масштабировать левый/правый радиус, чтобы получился эллипс — так отсекается больше чанков по бокам, а видимость вперёд/назад остаётся прежней. Это снижает нагрузку на GPU и повышает FPS, не влияя на игровую механику.

Возможности

• Отрисовывает чанки по кругу с центром на игроке (поведение по умолчанию).

• Опциональная эллиптическая отрисовка: радиус вперёд/назад остаётся неизменным, а левый/правый радиус масштабируется настраиваемым коэффициентом (renderRadiusScale).

  • При renderRadiusScale = 1.0 это идеальный круг.
  • При renderRadiusScale < 1.0 получается эллипс (уже по бокам).
• Опциональное ограничение по вертикали: ограничить отрисовку определённым числом слоёв чанков выше и ниже игрока.
• Загрузка чанков (обновление логики) остаётся квадратной, так что все чанки по-прежнему загружаются и обновляются.
• Пресеты и режим Custom: быстро переключайтесь между готовыми конфигурациями (Balanced, Performance, Aggressive) или выберите Custom, чтобы свободно настроить все параметры.

• Совместим с Sodium:

  • Если Sodium установлен, настройки появляются в экране настроек графики.
  • Без Sodium мод работает самостоятельно через JSON-файл конфигурации.
• Не влияет на сущности и другие объекты — затрагивается только отрисовка чанков.

Зависимости

• Обязательно: Fabric Loader ≥0.18.4
• Опционально: Sodium 0.8.6+ (для настройки через GUI в игре)

Установка

1. Установите Fabric Loader.
2. Скачайте последний `circular-rendering-.jar` со страницы Releases.
3. Положите JAR в папку mods.
4. (Опционально) Установите Sodium, если хотите слайдеры настроек и пресеты прямо в игре.

Настройка

Если установлен Sodium

1. Откройте Настройки → Настройки графики.
2. Прокрутите вниз до раздела Circular Rendering.

Пресеты

• Выпадающий список Render Preset:

  • Balanced: Render Radius Scale = 100%, ограничение по вертикали выключено (ванильное поведение, но всё равно оптимизировано).
  • Performance: Render Radius Scale = 80%, ограничение по вертикали включено, 10 слоёв.
  • Aggressive: Render Radius Scale = 40%, ограничение по вертикали включено, 3 слоя.
  • Custom: все слайдеры разблокируются, позволяя свободно настроить параметры ниже.

При выборе пресета, отличного от Custom, его параметры применяются автоматически, а ручные настройки блокируются.

Ручные настройки (доступны только при выбранном пресете «Custom»)

• Render Radius Scale (10% – 100%):

  • 100% = идеальный круг (радиус = дальность прорисовки × 16).
  • Меньшие значения уменьшают левый/правый радиус, превращая круг в эллипс и отсекая больше чанков по бокам.

• Enable Custom Vertical Range (переключатель) — при включении можно задать:

  • Vertical Range (1–32 слоя): число слоёв чанков (по 16 блоков каждый) для отрисовки выше и ниже игрока.

Без Sodium

Мод создаёт JSON-файл конфигурации по пути config/circular-rendering.json.
Пример содержимого:

{
  "renderRadiusScale": 1.0,
  "enableVerticalRange": false,
  "verticalRange": 16,
  "preset": "BALANCED"
}

• renderRadiusScale – число с плавающей точкой от 0.1 до 1.0.

  • 1.0 = идеальный круг.
  • < 1.0 = эллипс (уже по бокам).
• enableVerticalRange – булево значение, включает ограничение по вертикали, когда true.
• verticalRange – целое число (1–32), число слоёв чанков для отрисовки выше и ниже игрока (каждый слой = 16 блоков).

• preset – одно из "BALANCED", "PERFORMANCE", "AGGRESSIVE" или "CUSTOM".

  • Если пресет не "CUSTOM", три ручных параметра игнорируются и используются значения пресета.
  • Если пресет "CUSTOM", ручные параметры используются ровно так, как заданы.

Изменения вступают в силу после перезапуска игры или перезагрузки чанков.

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

• Ванильный режим (без Sodium): Мод внедряется в LevelRenderer.cullTerrain и фильтрует список чанков, используя форму, заданную формулой:

  (forward² / a²) + (right² / b²) ≤ 1

  где a = view distance × 16 (фиксированный радиус вперёд/назад), а b = a × renderRadiusScale (радиус влево/вправо).
  Когда b = a, форма представляет собой круг. Если включён вертикальный диапазон, также проверяются слои Y чанков.

• Режим Sodium: Точка внедрения зависит от версии Minecraft:

  • MC 26.1.2 и выше: Мод перенаправляет вызов testDistance внутри OcclusionCuller.visitNode. Это заменяет стандартную цилиндрическую проверку расстояния Sodium на эллиптическую формулу прямо в обходе графового отсечения окклюзии, сохраняя всю структуру отсечения.
  • MC 26.1.1 и ниже: Мод внедряется в OcclusionCuller.isWithinRenderDistance и возвращает false для чанков за пределами эллипса (или вертикального диапазона), эффективно отфильтровывая их из видимого набора Sodium.

Оба подхода влияют только на отрисовку чанков; загрузка чанков остаётся квадратной, поэтому игровая механика (Redstone, ИИ сущностей и т.д.) работает нормально везде.

Совместимость

• Статус поддержки версий Minecraft:

• Полностью совместим с Sodium 0.8.6+ (оба мода можно использовать вместе).
• Должен быть совместим с большинством других модов, которые не сильно изменяют отрисовку чанков. Если возникнут проблемы, пожалуйста, сообщите о них.

Сборка из исходного кода

Клонируйте репозиторий и выполните:

./gradlew build

Собранный JAR будет находиться в build/libs/.

Лицензия

Этот проект распространяется под лицензией MIT. Подробности см. в файле LICENSE.