IconFlux: как выгрузить иконки предметов из Minecraft
Вы когда-нибудь ловили себя на мысли, что иконка алмаза из инвентаря выглядела бы идеально в вики, гайде или на странице модпака? Проблема в том, что скриншот всегда даёт лишние пиксели фона, а вручную вырезать прозрачность по краям — та ещё морока. Именно для этого существует IconFlux — клиентский инструмент, который читает рендер самой игры и выгружает иконки предметов в аккуратные PNG и APNG. Поскольку изображение строится движком, а не сторонним конвертером, результат совпадает с тем, что вы видите в инвентаре, вплоть до последнего блика.
Что умеет IconFlux
Мод работает исключительно на стороне клиента: серверу ничего не нужно знать о ваших экспериментах. В основе лежит простой принцип — IconFlux берёт уже загруженные ресурсы и рендерит предмет так, как это делает игра, после чего сохраняет картинку с корректной прозрачностью. Анимации при этом не теряются: для предметов с динамической текстурой вы получаете APNG, где каждый кадр взят из игры, плюс статичный _static.png с нулевого кадра.
Отдельного упоминания заслуживает поддержка модельных слоёв. Если предмет собран из layer0, layer1 и так далее, слои композируются перед записью, поэтому иконка выглядит как в игре, а не как одна случайная текстура. Всё это делает IconFlux для Minecraft удобным решением для авторов контента, датапакеров и просто игроков, которые любят порядок в своих заметках.
Совместимость версий и загрузчик
IconFlux распространяется как клиентский мод для загрузчика Fabric. Заявлена поддержка Minecraft 1.20.1, 1.21.1, а также веток 26.1.2, 26.2 и 26.3. Важно понимать разницу между ними, потому что она напрямую влияет на качество экспорта анимаций.
Почему версии ведут себя по-разному
На 26.x игра предоставляет список состояний анимации, который можно читать и записывать через рефлексию. Это позволяет дождаться нулевого кадра и зафиксировать состояние перед каждым снимком. На 1.21.1 и 1.20.1 анимацией управляет непрозрачный TextureAtlasSprite$Ticker, который не отдаёт номер кадра, поэтому экспорт стартует с произвольного момента и может пропускать кадры при подтормаживаниях. Если точность критична, используйте команду rawanim — она не проходит через рендер и ведёт себя одинаково на всех поддерживаемых версиях.
Как установить и сделать первый экспорт
Установка стандартная для Fabric-модов: кладём файл в папку mods и запускаем игру. Если не хочется возиться с путями и зависимостями, в лаунчере foxygame.net доступна установка в один клик — достаточно выбрать IconFlux в каталоге дополнений, и лаунчер сам подберёт подходящую сборку под вашу версию Minecraft. После запуска проверьте, что мод загрузился, введя /iconflux help: если в чате появилась справка, всё на месте.
Дальше лучше всего создать суперплоский мир на сложности Peaceful. Никакие мобы и случайный рельеф не будут отвлекать, а длинный список предметов экспортируется в тишине. Для одиночного рендера, например алмаза, хватит команды /iconflux export minecraft diamond auto auto 128. Для точной анимации используйте /iconflux rawanim. Готовые файлы ищите в .minecraft/IconFlux, а результаты rawanim — в .minecraft/IconFlux/rawanim.
Основные параметры команд
- namespace — идентификатор мода (minecraft, crycraft или любой другой) либо ключевое слово all для всех предметов сразу.
- item — путь предмета, например diamond; пространство имён подставляется автоматически.
- properties — уточнение варианта в квадратных скобках, например [grade=3]; сейчас читается только grade.
- frames — auto или число от 1 до 256; по умолчанию следует значению из mcmeta текстуры.
- mode — auto, forceinterpolate или forcenointerpolate, то есть записывать ли промежуточные подкадры.
- size — сторона иконки от 16 до 512 пикселей, по умолчанию 128.
Тонкости, о которых стоит знать заранее
Во время экспорта открывается экран прогресса, и персонаж не может двигаться. Это нормально: нажмите ESC, чтобы отменить операцию, — уже записанные файлы останутся на месте. Перед нарезкой кадров мод оценивает расход памяти и отклоняет задачи, которые превышают 256 МБ, называя проблемные предметы прямо в чате.
С интерполяцией есть нюанс. Текстуры с флагом interpolate в игре плавно смешивают кадры, а режим auto сохраняет только реальные, из-за чего анимация может казаться чуть резче. Хотите мягкость — передайте forceinterpolate или воспользуйтесь rawanim. Помните и о скорости: каждая анимация — это серия снимков и записей на диск, поэтому большие пространства имён обрабатываются долго. Начните с одного предмета, оцените результат, а потом запускайте пакетную выгрузку.
Ещё два ограничения: анимации длиннее 256 кадров или с кадром, который держится дольше двух секунд, сохраняются как статичное изображение — такие предметы лучше экспортировать по одному. И не забывайте, что права на текстуры, модели и анимации принадлежат их авторам: IconFlux лишь читает уже загруженные клиентом ресурсы, а использовать выгрузки стоит только там, где у вас есть на это разрешение.
Итог
IconFlux закрывает узкую, но болезненную задачу: получить чистые иконки предметов Minecraft без скриншотов, обрезки и ручной сборки кадров. Поддержка Fabric, версии от 1.20.1 до 26.x, контроль памяти и честный рендер из игры делают его удобным инструментом для документации, модпаков и оформления контента. Скачать IconFlux несложно, а освоив пару команд, вы уже через минуту будете складывать готовые PNG и APNG в аккуратную папку.