ImageFrame Fabric Port
High-performance, server-side Fabric port of ImageFrame. Place HD images & animated GIFs on maps and walls with zero client-side mods required!
Автор: reyhe662433,6 тыс.7обновлён 22 сент. 2026 г.
ДекорМеханики игрыУтилиты
Описание
ImageFrame (Fabric Port)
A high-performance, universal Fabric port of the popular Spigot plugin ImageFrame by LoohpJames. Put images and animated GIFs on maps and walls with native high-definition (HD) support!
This project is a hybrid (Universal) mod: it functions completely server-side for vanilla clients, while offering native HD map rendering, instant HD GIF animation synchronization, and inventory item preview tooltips when installed on the client.
Important Disclaimer & Maintenance
- Support & Maintenance: This port was created for a private server with friends. As such, do not expect regular updates, active maintenance, or guaranteed bugfixes.
- Future Updates: While support is not guaranteed, critical bugs or compatibility updates might be released if they are needed for our personal server.
- Original Creator Invitation: If the original author (LoohpJames) wishes to adapt, use, or merge any part of this Fabric port code into the official project, they are warmly welcomed and encouraged to do so!
- Fabric Port Developer: Developed and optimized for Fabric by reyhe66243.
- Credits: Huge credits to LoohpJames for the original Spigot plugin design, asset loaders, and architecture.
Universal Architecture & Client Compatibility
Use this exact same mod JAR on both the server and client. Do not use the original client mod, as this port relies on an updated, GIF-compatible networking architecture.
- Vanilla Clients: Can connect without installing any client-side mod. Maps will display smoothly in standard Minecraft resolution (128x128).
- Modded Clients (with this mod): Automatically perform a background handshake with the server to request native High-Definition (HD) image textures, instant HD GIF animation frame synchronization, and inventory hover tooltips.
Mod Compatibility & Optimization Notes
If you use ImmediatelyFast, you must disable its map atlas optimization feature:
- Set
"map_atlas_generation": falseinside yourconfig/immediatelyfast.jsonfile. - Reason: ImmediatelyFast's
map_atlas_generationforces all map textures into a low-resolution 128x128 atlas, which overrides and crops HD textures. Disablingmap_atlas_generationallows ImageFrame to render in full HD while ImmediatelyFast continues optimizing 99% of your other graphics performance (fonts, HUD, signs, GUI, buffers). - This mod includes automatic detection logic to attempt disabling this setting at launch.
Configuration & Permissions
ImageFrame on Fabric features a streamlined, fully functional config/ImageFrame/config.yml and 1:1 permission parity with the original Spigot plugin.
Key Configuration Options
RequireEmptyMaps: Require survival players to hold empty maps (width * height) to create or retrieve image maps.MaxSize: Limit map dimensions (in blocks) to prevent server lag.PlayerCreationLimit: Limit the maximum number of maps each player or group can create.RestrictImageUrl: Domain whitelist (e.g. Imgur, Discord CDN) to restrict where players can download images from.CombinedByDefault: Automatically give combined map items instead of separate map tiles when running/imageframe get <name>.InvisibleFrame: Configure survival potion splash conversions for invisible item frames.
Permissions & LuckPerms
Compatible with LuckPerms via fabric-permissions-api-v1 and native Minecraft OP levels (user commands default to Level 0 / all players):
| Command / Feature | Permission Node | Default Access |
|---|---|---|
/imageframe create | imageframe.create | All players |
/imageframe get | imageframe.get | All players (own maps) |
| Manage others' maps | imageframe.get.others, imageframe.delete.others | OP Level 2 |
/imageframe delete | imageframe.delete | All players (own maps) |
/imageframe rename | imageframe.rename | All players (own maps) |
/imageframe refresh | imageframe.refresh | All players (own maps) |
/imageframe playback | imageframe.playback | All players |
/imageframe select | imageframe.select | All players |
/imageframe list | imageframe.list | All players (shows own maps) |
| View all server maps | imageframe.list.others | OP Level 2 |
| Map creation limit tier | imageframe.createlimit.<group> | Custom tiers in config |
| Unlimited map creation | imageframe.createlimit.unlimited | OP Level 2 |
| Full admin bypass | imageframe.admin | OP Level 2 |
/imageframe reload | imageframe.reload | OP Level 2 |
/imageframe language | imageframe.admin | OP Level 2 |
Галерея
Последние версии
Все версии →release
ImageFrame Fabric Port 2.1.3
2.1.322 сент. 2026 г.1,5 тыс.Minecraft: 26.1.2, 26.2, 26.3fabric
Что нового
- **`/imageframe refresh` fixed** — re-downloads and re-renders the existing map in place (same name, size and map IDs). Optional new URL; restores the previous URL on failure.
- **`/imageframe overlay` implemented** — composites an image over existing vanilla maps (held map or selected frames), keeping the map background where the image is transparent. Reuses the existing map IDs and consumes no empty maps.
- **Combined maps on floors/ceilings** — combined map placement now works on floors and ceilings, and the clicked frame can be any cell of the grid.
- **Spigot-parity command behavior:**
- `combinedByDefault` respected in `create`/`clone`/`get`; `combined` takes precedence over `selection`.
- `get ... selection` consumes empty maps.
- Only empty item frames are filled; occupied frames return the map item to the player with a warning.
- `delete` converts the deleted map's items in your inventory back into empty maps.
- `create`/`overlay`/`clone`/`refresh` now report failure correctly.
- **Creation hardening** — width/height must be at least 1; consumed empty maps are refunded if creation fails.
- **`playback ... jumpto`** now uses the real per-frame delays.
- **Languages** — dynamic `/imageframe language` suggestions, localized selection messages, and new `en_us` keys are merged into existing installs.
- **Fixed client crash on 26.2** when hovering over maps/paintings (`RenderPipelines` moved packages in 26.3). The same jar now works on **26.1.2, 26.2 and 26.3**.
- **Fixed `/imageframe select`** — it selected both corners at once (always 1x1).
- **Floor/ceiling selections** — now report the correct size (2x2 no longer says 4x1).
- **Selection mode** — can be re-armed with a single command (stale corners no longer swallow clicks).
- **Fixed map creation silently doing nothing** — dedicated async pool (the GIF animation loop could starve downloads), world/player changes on the server thread, failures reported, and failed creations cleaned up (no more blank vanilla maps).
- **Permissions** — if a permission provider throws, fall back to vanilla OP levels instead of breaking commands/join.
- **Combined maps** — no longer consumed when placement fails.
release
ImageFrame Fabric Port 2.1.1
2.1.118 сент. 2026 г.149Minecraft: 26.1.2, 26.2, 26.3fabric
Что нового
* **Fixed WorldEdit Incompatibility (#6):** Bundled all missing TwelveMonkeys ImageIO dependencies to prevent `NoClassDefFoundError` crashes when loading alongside WorldEdit.
* **Minecraft 26.3 Support:** Verified and updated dependencies for full compatibility across Minecraft 26.1.2 through 26.3.
* **Cleaned Dependencies:** Removed unused legacy Spigot database and web server libraries, resulting in a lighter and cleaner mod jar.
release
ImageFrame Fabric Port 2.1.0
2.1.010 сент. 2026 г.170Minecraft: 26.1.2, 26.2fabric
Что нового
* **LuckPerms & 1:1 Spigot Permissions:** Full support for standard permission nodes (`imageframe.create`, `imageframe.get`, `imageframe.delete.others`, `imageframe.admin`, etc.) with vanilla OP fallbacks.
* **Map Ownership & Anti-Grief:** Survival players can only access and delete their own maps unless granted `.others` or admin permissions.
* **Survival Empty Maps Requirement:** When `RequireEmptyMaps: true` is set, players must have empty maps in inventory to create or get maps.
* **Cleaned & Active Configuration:** Fixed `config.yml` generation, removed obsolete Spigot-only options (such as the legacy web server and MySQL), and hooked up all settings (`MaxSize`, `PlayerCreationLimit`, URL whitelist, timeouts).
* **Live Reload:** `/imageframe reload` now reloads both configuration and translations without server restarts.
release
ImageFrame Fabric Port 2.0.2
2.0.226 авг. 2026 г.351Minecraft: 26.1.2, 26.2fabric
Что нового
* **Fixed Combined Map Placement:** Right-clicking item frames with a combined ImageFrame map item now correctly places all map tiles across the grid (supports both modern map items and legacy Spigot paper items).
* **Added `/imageframe get <name> separated`:** You can now retrieve all individual separated map tiles of an ImageFrame even if it was created as combined.
* **Combined Frame Breaking:** Breaking a placed combined ImageFrame now properly returns the combined map item.
release
ImageFrame Fabric Port 2.0.1
2.0.125 авг. 2026 г.36Minecraft: 26.1.2, 26.2fabric
Что нового
This patch fixes connection issues, standardizes all commands and messages to English by default, and unifies builds into a single universal JAR for Minecraft 26.x.
* Removed premature map packet bursts on player connect; maps are now streamed naturally via proximity.
* Added channel capability checks (`ServerPlayNetworking.canSend`) to ensure custom network payloads are never sent to vanilla or Bedrock clients.
* **Language System & English Defaults:**
* Standardized all command syntax, arguments, autocompletions (`<name>`, `<url>`, `<width>`, `<height>`, etc.), and help messages to **100% English (`en_US`) by default** (matching the original Spigot plugin 1:1).
* Integrated official Crowdin translation support with automatic translation updates in `config/imageframe/language/`.
* Added `/imageframe language <lang>` and `/imageframe reload` commands to easily change languages on the fly.
* In-game client toasts now automatically adapt to the player's client language (English, Spanish, German, French, Chinese, etc.).
* **Unified 26.x Release:**
* A single JAR now natively supports **Minecraft 26.1.2, 26.2, and future 26.x versions**.
release
ImageFrame Fabric Port 26.1.2-2.0
26.1.2-2.011 авг. 2026 г.87Minecraft: 26.1.2fabric
Что нового
# ImageFrame v2.0 - Universal HD & GIF Update
Major release introducing Universal Mod architecture, native HD client rendering, and instant HD GIF synchronization!
### Features & Improvements
* **Universal Mod Architecture:** Single JAR for both Server and Client! Functions completely server-side for Vanilla players while delivering full HD features when installed on the client.
* **Native High-Definition (HD) Renderer:** Crisp HD image maps rendered thread-safely on the client render thread.
* **Instant HD GIF Synchronization:** Multi-frame HD textures are pre-cached in memory and synchronized with zero network lag or screen flickering.
* **ImmediatelyFast Compatibility:** Automatic detection and compatibility adjustment for ImmediatelyFast (`map_atlas_generation: false`).
* **Inventory Preview Tooltips:** Hover preview tooltips for single maps, map grids, and paintings directly inside inventory screens.
* **Upstream Fixes:** Resolved `/imageframe refresh` command issues for local images and maps with missing URLs.
release
ImageFrame Fabric Port 26.2-2.0
26.2-2.011 авг. 2026 г.294Minecraft: 26.2fabric
Что нового
# ImageFrame v2.0 - Universal HD & GIF Update
Major release introducing Universal Mod architecture, native HD client rendering, and instant HD GIF synchronization!
### Features & Improvements
* **Universal Mod Architecture:** Single JAR for both Server and Client! Functions completely server-side for Vanilla players while delivering full HD features when installed on the client.
* **Native High-Definition (HD) Renderer:** Crisp HD image maps rendered thread-safely on the client render thread.
* **Instant HD GIF Synchronization:** Multi-frame HD textures are pre-cached in memory and synchronized with zero network lag or screen flickering.
* **ImmediatelyFast Compatibility:** Automatic detection and compatibility adjustment for ImmediatelyFast (`map_atlas_generation: false`).
* **Inventory Preview Tooltips:** Hover preview tooltips for single maps, map grids, and paintings directly inside inventory screens.
* **Upstream Fixes:** Resolved `/imageframe refresh` command issues for local images and maps with missing URLs.
release
ImageFrame Fabric Port 26.2-1.2
26.2-1.212 июл. 2026 г.340Minecraft: 26.2fabric
Что нового
Sync upstream commits and update versioning
release
ImageFrame Fabric Port 26.1.2-1.2
26.1.2-1.212 июл. 2026 г.120Minecraft: 26.1.2fabric
Что нового
Sync upstream commits and update versioning
beta
ImageFrame Fabric Port 2026.2.0-fabric
2026.2.0-fabric22 июн. 2026 г.260Minecraft: 26.2fabric
Что нового
- Change DedicatedServerModInitializer to ModInitializer to fix
- Remove unsupported marker and setaccess commands
- Update to Minecraft 26.2, support LAN, sync upstream commits
- Fix Brigadier auto-complete empty string bug