Voxel Particles

В ванильном Minecraft частицы — это плоские карточки, которые всегда повёрнуты к камере. Voxel Particles превращает каждую из них в небольшую 3D-модель, собранную из пикселей самого спрайта. Каждая спрайтовая частица, ванильная или из модов, подхватывается автоматически (даже из ресурспаков). ## Демонстрация ### Частицы разрушения блока ### Дым костра с настоящей глубиной ### Крошки от съеденной еды ### Частицы эффектов зелий ### Частицы из модов (для примера — Fire Staff из Wizards) ### Сравнение включённого и выключенного эффекта ### Настройки в игре ## Возможности - Любые частицы, любые моды. Ванильные и модовые спрайтовые частицы становятся 3D без дополнительной поддержки. - Настоящие крошки. Частицы блоков и предметов сохраняют свой кусочек текстуры и его форму. - Четыре типа движения. Нет, лёгкое покачивание (по умолчанию), вращение и кувыркание. - Физические обломки. Падающие крошки кувыркаются в воздухе и ложатся плашмя на землю. - Любой ресурспак. Пользовательские текстуры становятся 3D так же, как ванильные. - Знает, когда отступить. Далёкие и крошечные частицы остаются плоскими, меши кэшируются, а сторожевой таймер приостанавливает эффект на несколько секунд, если он вдруг становится слишком затратным. ## Совместимость | Мод или контент | Статус | |---|---| | Sodium | Работает | | Iris и шейдерпаки | Работает | | Пользовательские ресурспаки | Работает | | Частицы из других модов | Работает | > Одно исключение: частицы, которые рисуют собственную геометрию вместо спрайта, остаются как есть. > Например, эффекты ударов из Better Combat остаются плоскими.

Конфигурация

Меняйте настройки в игре через Mod Menu или редактируйте config/voxelparticles.json. | Параметр | По умолчанию | Что делает | |---|---|---| | enabled | true | Включает и выключает весь эффект | | maxResolution | 16 | Детализация: максимальный размер модели по стороне, от 4 до 64 | | lodDistance | 64 | Частицы дальше этого числа блоков рисуются плоскими, 0 — без ограничения | | excludedSprites | см. ниже | Id спрайтов, которые всегда остаются плоскими, * работает как подстановочный знак | У частиц блоков, предметов и прочих есть свои разделы: blocks, items и particles. В них одинаковые параметры: | Параметр | По умолчанию | Что делает | |---|---|---| | enabled | true | Делает этот вид частиц 3D | | motion | SWAY | BILLBOARD (повёрнуты к камере, как в ванили), SWAY, SPIN или TUMBLE | | depth | 1.0 (3.0 для блоков) | Толщина, от 0.1 до 4. При 1.0 каждый пиксель — куб | | shading | 1.0 | Насколько бока темнее лицевой стороны, от 0 до 1 | | motionSpeed | 1.0 | Скорость покачивания, вращения и кувыркания, от 0 до 5 | | tumbleDebris | true | Крошки кувыркаются в воздухе и ложатся плашмя (только для blocks и items) | json { "blocks": { "depth": 3.0, "motion": "TUMBLE" }, "items": { "depth": 1.0, "motion": "TUMBLE" }, "particles": { "depth": 0.3, "motion": "SWAY" } }

Как оставить частицу плоской

Крупные эффекты вроде взмахов и взрывов лучше смотрятся плоскими, поэтому несколько спрайтов исключены из коробки: json "excludedSprites": [ "minecraft:sweep_*", "minecraft:sonic_boom_*", "minecraft:flash", "minecraft:explosion_*", "minecraft:shriek", "minecraft:vibration", "minecraft:missingno" ] Добавьте id любого другого спрайта частицы, который хотите оставить плоским, например "somemod:glow".

## Разработка

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

Gradle должен работать на Java 25 (используемая версия Loom этого требует). Сам мод нацелен на Java 21 или 25 в зависимости от версии Minecraft. sh ./gradlew dist # все цели, jar-файлы попадают в dist/ ./gradlew build -Ptargets=1.21.4-fabric # одна цель Структура проекта: | Путь | Содержимое | |---|---| | core/ | Код, не затрагивающий Minecraft | | `mc//| Слои API, общие для нескольких версий Minecraft | |loader/| Точки входа загрузчиков | |versions//| По одной цели на каждую версию;version.properties` перечисляет используемые слои |