IFC Reloaded

🗺️ ImageFrame Client Reloaded

Преврати карты Minecraft в искусство. Этот мод позволяет видеть HD-изображения в полном цвете на картах именно такими, какими они должны быть — больше никакого размытого 16-цветного пиксель-арта. Играешь на сервере с плагином ImageFrame? Каждая карта, картина и стена с изображениями будет отображаться в чётком нативном разрешении с настоящими цветами. Ты даже можешь загружать свои картинки прямо из игры через /ifc.

✨ Что ты получаешь

HD-рендеринг карт в нативном разрешении

Когда сервер отправляет полноцветные карты в высоком разрешении, мод заменяет ванильную текстуру карты 128x128 с 16 цветами на настоящее изображение в его нативном разрешении. Работает в рамках для картин, на стенах из карт, в руках — везде, где отображаются карты.

Поддержка GIF-анимации

Анимированные GIF-файлы, отправленные сервером, определяются автоматически и отображаются как анимированные текстуры в игре с помощью встроенного парсера GIF в Java.

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

• Заполненные карты — живое превью 64x64 любой заполненной карты в твоём инвентаре.
• Карты-изображения — для многоблочных предметов-изображений ImageFrame (бумага с данными CombinedImageMap) отображает всю сетку тайлов карты в подсказке в правильном масштабе.
• Картины — превью artwork картины до её размещения.

GUI менеджера изображений (/ifc)

Открывает графический интерфейс для управления серверными изображениями прямо в игре:

• Просмотр — просматривай все загруженные изображения с именами и размерами файлов.
• Загрузка — выбери локальный PNG/JPG/GIF файл через системный диалог, задай размеры тайлов (ширина x высота в тайлах карты) и отправь на сервер.
• Удаление — удаляй изображения с сервера.
• Обновление — перезагружай список изображений с сервера.
• Трансформация — поворот на 90, отражение по горизонтали/вертикали перед загрузкой.

Продвинутый дисковый кэш

Скачанные HD-текстуры карт кэшируются на диск в `/imageframeclient/cache/`.

• Истечение по TTL — старые файлы кэша автоматически очищаются (настраивается, по умолчанию 7 дней).
• Лимит размера — кэш перестаёт расти после настраиваемого лимита (по умолчанию 100 МБ), удаляя сначала самые старые файлы.
• Фоновая очистка запускается периодически для поддержания порядка.

Высококачественное масштабирование изображений

Когда изображения превышают заданное максимальное разрешение, используется бикубическая интерполяция (со сглаживанием) вместо ближайшего соседа, что даёт значительно более гладкие результаты при уменьшении.

Конфигурация для каждого сервера

Переопределяй настройки мода для каждого сервера — изменения конфига на одном сервере не влияют на другие. Переопределения хранятся в `/imageframeclient/server_overrides.json`.

Синхронизация сервер ↔ клиент

Мод общается с плагином ImageFrame через кастомные payload-пакеты NeoForge. Когда изображения обновляются на сервере, твой клиент подхватывает изменения автоматически.

Поддержка нескольких языков

Полностью переводимый интерфейс. Поставляется с английским и русским переводами. Легко добавить свой язык, создав файл `lang/.json`.

Настраиваемая производительность

Ограничь максимальное разрешение HD-изображений (128-4096px или нативное), чтобы сбалансировать качество картинки и использование памяти GPU. Отключай превью карт/картин и уведомление о сервере по отдельности. Настраивай TTL кэша и лимиты размера.

🔧 Быстрый старт

1. Установи мод на клиент (NeoForge 1.21.1)
2. Зайди на сервер с установленным плагином ImageFrame
3. Вот и всё — HD-карты работают автоматически. Попробуй /ifc, чтобы загрузить свои изображения.

📸 Скриншоты

Все опции клиентские и доступны через экран настроек мода NeoForge или config/imageframeclient-client.toml:

Общие

Кэш

🎯 Команды

⚡ Производительность

HD-изображения могут быть требовательны к памяти на больших стенах из карт. Используй опцию конфига Max Image Size, чтобы ограничить разрешение. Мод эффективно упаковывает и масштабирует изображения, а дисковый кэш избавляет от повторной загрузки всего при каждом входе. Этот мод общается с серверным плагином ImageFrame через кастомные payload-пакеты NeoForge:

• Сервер -> Клиент: данные HD-изображений, многочастные передачи, детали карт-изображений, сигналы обновления
• Клиент -> Сервер: запросы HD-изображений, запросы деталей карт-изображений, управление изображениями (список/загрузка/удаление) Протокол управления позволяет клиентскому GUI просматривать, загружать и удалять изображения на сервере, сохраняя их в формате, совместимом с плагином ImageFrame. GIF-изображения определяются клиентом и анимируются через обработчик тиков клиента — изменения на стороне сервера не нужны.

📜 Благодарности

Изначально создан LOOHP для Fabric. Форкнут и портирован на NeoForge пользователем Wakcedon. Собран на основе серверного плагина ImageFrame от LOOHP.