ImageFrame

Transform Your Server with Images!

Want to decorate your Minecraft server with informational displays or create impressive television screens with animation? ImageFrame is exactly what you need!

Demonstration Videos

See how the mod works in action:

Main Features

Loading Images onto Maps and Frames

Load images directly from the internet! Supports PNG, JPEG, WEBP formats and even animated GIFs. Use the intelligent selection tool to place images directly on item frames or create maps with images. Automatic scaling ensures your images won't be stretched.

Animated GIF Images

Animated GIF files come to life in the game! Animation works at up to 20 frames per second and runs asynchronously without loading the server.

Customizable Sizes

Create images of any size by distributing them across multiple maps. Automatic scaling works for all sizes, perfect for placement on item frames.

Metro station signs look amazing, don't they? Created with ImageFrame and invisible glowing item frames!

Overlays on Regular Maps

Add images on top of regular vanilla maps. Simply hold a map in your hand or select frames for overlay placement.

Notice the additional text with blue background at the top of the map?

Combined Maps for Convenience

Get multi-component images as a single item! The system automatically searches for placement space on walls, floors, or ceilings. When broken, a single combined map is returned. Compatible with frame protection systems of other plugins.

Image Updates

Update all copies of one image from the source URL with one simple command! Perfect for displaying information that needs regular updating across the entire server.

Markers on Images

Add any marker icons, including mansions and temples from cartographer maps. Can add a caption to the marker. Configurable maximum number of markers per map.

Survival Support

In survival mode, players need empty maps to create images. Configurable in settings.

Management and Tracking

Commands for managing created images. Ability to share access with other players with different permission levels. Customizable image creation limits and maximum sizes. Data migration from ImageMap, ImageOnMap, and DrMap.

Multilingual Support

All messages for players can be customized to your preferences.

Dependencies

Requires installation of ProtocolLib (latest version compatible with your server).

Installation

1. Place ImageFrame.jar in the plugins folder along with required dependencies
2. Start the server
3. Edit configuration if necessary
4. Restart server if configuration changes were made

Commands

Legend:
For ""/"" arguments,
You can access other players' maps with permission
through this syntax:
":"

For example: /if get LOOHP:map combined

Administration:

/imageframe reload - Reloads the plugin
/imageframe update - Checks for updates

Player:

/imageframe select - Selects item frames for image placement
/imageframe create     - Creates new image on map
/imageframe create   selection - Creates new image and places in selected frames
/imageframe create     combined - Creates new image and gets combined item
/imageframe overlay   - Creates overlay on regular Minecraft map
/imageframe overlay   selection - Creates overlay on map in selected frames
/imageframe clone   - Creates copy of existing image
/imageframe clone   selection - Creates copy and places in selected frames
/imageframe clone   combined - Creates copy and gets combined item
/imageframe playback  pause - Pauses animation
/imageframe playback  jumpto  - Jumps to specific animation second
/imageframe refresh [optional:image_name] [optional:new_url] - Updates image from source URL
/imageframe info - Gets information about held map
/imageframe get  - Gets existing image
/imageframe get  selection - Places existing image in selected frames
/imageframe get  combined - Gets existing image in combined form
/imageframe delete  - Deletes existing image
/imageframe rename   - Renames image
/imageframe list - Lists all created images
/imageframe marker add   <0-15>

Moderation:

/imageframe list  - Lists player's images
/imageframe adminsetcreator   - Changes image creator
/imageframe adminmigrate  - Migrates data from supported plugins

Permissions

permissions:
  imageframe.create:
    default: true
    description: Allows players to create new images
  imageframe.create.animated:
    default: op
    description: Allows players to create animated images
  imageframe.overlay:
    default: true
    description: Allows players to overlay images on regular maps
  imageframe.clone:
    default: true
    description: Allows players to create copies of their images
  imageframe.select:
    default: true
    description: Allows players to select item frames
  imageframe.marker:
    default: true
    description: Allows players to add and remove markers
  imageframe.marker.unlimited:
    default: op
    description: Allows players to add unlimited markers
  imageframe.refresh:
    default: true
    description: Allows players to update images
  imageframe.rename:
    default: true
    description: Allows players to rename images
  imageframe.info:
    default: true
    description: Allows players to view image information
  imageframe.list:
    default: true
    description: Allows players to view their image list
  imageframe.list.others:
    default: op
    description: Allows players to view other players' images
  imageframe.delete:
    default: true
    description: Allows players to delete their images
  imageframe.get:
    default: true
    description: Allows players to get their images
  imageframe.setaccess:
    default: true
    description: Allows players to change access permissions to their images
  imageframe.adminbypass:
    default: true
    description: Bypasses all access restrictions
  imageframe.adminsetcreator:
    default: op
    description: Allows changing creator of any image
  imageframe.admindelete:
    default: op
    description: Allows deleting any images
  imageframe.adminmigrate:
    default: op
    description: Allows migrating data from supported plugins
  imageframe.update:
    default: op
    description: Allows receiving update notifications