?️ ImageFrame Client Reloaded
将你的 Minecraft 地图变成艺术品。 此模组让你能够以原貌查看高清、全彩的地图图像——不再只有模糊的 16 色像素画。
在安装了 ImageFrame 插件的服务器上游玩?每张地图、画作和图像墙都会以清晰的原生分辨率和真彩色渲染。你甚至可以通过 /ifc 命令直接从游戏内上传自己的图片。
✨ 功能特性
HD 原生分辨率地图渲染
当服务器发送全彩、高分辨率的地图数据时,该模组会用实际图像的原生分辨率替换原版 128x128、16 色的地图纹理。适用于物品展示框、地图墙、手持状态——任何渲染地图的地方都能生效。
GIF 动画支持
自动检测服务器发送的 GIF 动画,并使用 Java 内置的 GIF 解析器在游戏中将其渲染为动画纹理。
物品栏工具提示预览
- 已填充的地图 — 在物品栏中实时预览任意已填充地图的 64x64 缩略图。
- 图像地图 — 对于 ImageFrame 的多格图像物品(带有
CombinedImageMap 数据的纸张),会在工具提示中以正确比例渲染整个地图图块网格。
- 画作 — 放置前预览画作的艺术图案。
图像管理器 GUI (/ifc)
打开图形界面,直接在游戏内管理服务器图像:
- 浏览 — 查看所有已上传的图像及其名称和文件大小。
- 上传 — 通过系统文件对话框选择本地 PNG/JPG/GIF 文件,选择图块尺寸(宽度 x 高度,单位为地图图块数),然后发送到服务器。
- 删除 — 从服务器移除图像。
- 刷新 — 从服务器重新加载图像列表。
- 变换 — 在上传前旋转 90 度或水平/垂直翻转图像。
高级磁盘缓存
下载的 HD 地图纹理会缓存到磁盘 <gameDir>/imageframeclient/cache/ 中。
- 基于 TTL 的过期机制 — 旧的缓存文件会自动清理(可配置,默认 7 天)。
- 大小限制 — 缓存增长不会超过可配置的限制(默认 100 MB),优先删除最旧的文件。
- 后台定期运行清理任务以保持整洁。
高质量图像缩放
当图像超过配置的最大分辨率时,使用双三次插值(抗锯齿)替代最近邻插值,从而产生显著更平滑的下采样效果。
按服务器独立配置
为每个服务器覆盖模组设置——在一个服务器上的配置更改不会影响其他服务器。覆盖配置存储在 <gameDir>/imageframeclient/server_overrides.json 中。
服务器 ↔ 客户端同步
该模组通过 NeoForge 自定义数据包与 ImageFrame 插件通信。当服务器上的图像更新时,客户端会自动同步跟随。
多语言支持
界面完全可翻译。自带英文和俄文翻译。通过创建 lang/<code>.json 文件即可轻松添加你自己的语言。
可配置的性能选项
限制最大 HD 图像分辨率(128-4096 像素或原生),以平衡视觉质量与 GPU 内存占用。可单独切换地图/画作预览以及服务器通知。精细调整缓存 TTL 和大小限制。
? 快速开始
- 在客户端安装该模组(NeoForge 1.21.1)
- 加入安装了 ImageFrame 插件的服务器
- 完成——HD 地图将自动生效。尝试输入
/ifc 上传你自己的图像。
? 截图
所有选项均为客户端侧,可通过 NeoForge 模组设置屏幕或 config/imageframeclient-client.toml 访问:
通用设置
| 选项 |
默认值 |
描述 |
useNativeResMapImages |
true |
启用来自服务器的 HD 全彩地图图像 |
maxImageSize |
NATIVE |
最大分辨率上限(128, 256, 512, 1024, 2048, 4096 或 NATIVE) |
previewMapsInTooltip |
true |
在物品栏工具提示中显示地图预览 |
previewPaintingsInTooltip |
true |
在物品栏工具提示中显示画作预览 |
notifyWhenServerSupports |
true |
在支持 ImageFrame 的服务器上显示通知横幅 |
缓存设置
| 选项 |
默认值 |
描述 |
cacheTtlDays |
7 |
保留缓存 HD 纹理的最大天数(0 = 永久) |
cacheMaxMb |
100 |
缓存最大大小(MB)(0 = 无限制) |
? 指令
| 指令 |
功能 |
/ifc |
打开图像管理器——浏览、上传和删除服务器图像 |
⚡ 性能
HD 图像在大面积地图墙上可能会消耗大量内存。请使用 最大图像大小 配置选项来限制分辨率。该模组高效地打包和缩放图像,且磁盘缓存意味着你每次登录时不需要重新下载所有内容。
该模组通过 NeoForge 自定义数据包与 ImageFrame 服务器插件通信:
- 服务器 -> 客户端:HD 图像数据、分块传输、图像地图详情、更新信号
- 客户端 -> 服务器:HD 图像请求、图像地图详情请求、图像管理(列表/上传/删除)
管理协议允许客户端 GUI 列出、上传和删除服务器上的图像,并以兼容 ImageFrame 插件的格式存储它们。
GIF 图像由客户端检测并通过客户端刻处理程序进行动画播放——无需服务端修改。
? 致谢
最初由 LOOHP 为 Fabric 开发。由 Wakcedon 分支并移植至 NeoForge。
基于 LOOHP 开发的 ImageFrame 服务器插件构建。
?️ ImageFrame Client Reloaded
Turn your Minecraft maps into art. This mod lets you see HD, full-color images on maps exactly as they were meant to look — no more blurry 16-color pixel art.
Play on a server with the ImageFrame plugin? Every map, painting, and image wall will render in crisp native resolution with true colors. You can even upload your own pictures straight from the game using /ifc.
✨ What You Get
HD Native Resolution Map Rendering
When the server sends full-color, high-resolution map data, the mod replaces the vanilla 128x128, 16-color map texture with the actual image at its native resolution. Works in item frames, on map walls, in hands — everywhere maps are rendered.
GIF Animation Support
Animated GIFs sent by the server are detected automatically and rendered as animated textures in-game using Java's built-in GIF parser.
Inventory Tooltip Previews
- Filled Maps — See a live 64x64 preview of any filled map in your inventory.
- Image Maps — For ImageFrame's multi-tile image items (paper with
CombinedImageMap data), renders the full grid of map tiles in the tooltip at the correct scale.
- Paintings — Preview a painting's artwork before placing it.
Image Manager GUI (/ifc)
Opens a graphical interface for managing server images directly in-game:
- Browse — View all uploaded images with names and file sizes.
- Upload — Select a local PNG/JPG/GIF file via system file dialog, choose tile dimensions (width x height in map tiles), and send it to the server.
- Delete — Remove images from the server.
- Refresh — Reload the image list from the server.
- Transform — Rotate 90, flip horizontally/vertically before uploading.
Advanced Disk Cache
Downloaded HD map textures are cached to disk in <gameDir>/imageframeclient/cache/.
- TTL-based expiration — Old cache files are automatically cleaned up (configurable, default 7 days).
- Size limit — Cache stops growing past a configurable limit (default 100 MB), deleting oldest files first.
- Background cleanup runs periodically to keep things tidy.
High-Quality Image Scaling
When images exceed the configured maximum resolution, bicubic interpolation (anti-aliased) is used instead of nearest-neighbor, producing significantly smoother downscaled results.
Per-Server Configuration
Override mod settings per server — config changes on one server don't affect others. Overrides are stored in <gameDir>/imageframeclient/server_overrides.json.
Server ↔ Client Sync
The mod talks to the ImageFrame plugin through NeoForge custom payloads. When images update on the server, your client follows along automatically.
Multi-Language Support
Fully translatable interface. Ships with English and Russian translations. Easily add your own language by creating a lang/<code>.json file.
Configurable Performance
Limit the maximum HD image resolution (128-4096px or native) to balance visual quality against GPU memory usage. Toggle map/painting previews and the server notification individually. Fine-tune cache TTL and size limits.
? Quick Start
- Install the mod on your client (NeoForge 1.21.1)
- Join a server that has the ImageFrame plugin installed
- That's it — HD maps work automatically. Try
/ifc to upload your own images.
? Screenshots
All options are client-side and accessible via the NeoForge mod settings screen or config/imageframeclient-client.toml:
General
| Option |
Default |
Description |
useNativeResMapImages |
true |
Enable HD full-color map images from the server |
maxImageSize |
NATIVE |
Maximum resolution cap (128, 256, 512, 1024, 2048, 4096, or NATIVE) |
previewMapsInTooltip |
true |
Show map previews in inventory tooltips |
previewPaintingsInTooltip |
true |
Show painting previews in inventory tooltips |
notifyWhenServerSupports |
true |
Show a toast on servers with ImageFrame |
Cache
| Option |
Default |
Description |
cacheTtlDays |
7 |
Maximum days to keep cached HD textures (0 = forever) |
cacheMaxMb |
100 |
Maximum cache size in MB (0 = unlimited) |
? Commands
| Command |
What it does |
/ifc |
Open the Image Manager — browse, upload, and delete server images |
⚡ Performance
HD images can be memory-intensive on large map walls. Use the Max Image Size config option to cap resolution. The mod packs and scales images efficiently, and the disk cache means you're not re-downloading everything on every login.
This mod communicates with the ImageFrame server plugin via NeoForge custom payloads:
- Server -> Client: HD image data, multipart transfers, image map details, update signals
- Client -> Server: HD image requests, image map detail requests, image management (list/upload/delete)
The management protocol allows the client GUI to list, upload, and delete images on the server, storing them in a format compatible with the ImageFrame plugin.
GIF images are detected by the client and animated via a client tick handler — no server-side changes needed.
? Credits
Originally by LOOHP for Fabric. Forked and ported to NeoForge by Wakcedon.
Built against ImageFrame server plugin by LOOHP.
评论 0
登录后参与评分
还没有评论,来抢沙发吧