ImageFrame

Speak a language that is not supported by ImageFrame yet? We would appreciate it if you contribute on Crowdin! ***

About

Want to display information on your server in a fancy way?
Or maybe you want to display a nice animated TV screen in your home base?
_Then this is the plugin for you!_

Want HD and Full-color Images?
Check out ImageFrame Client, the complimentary mod for ImageFrame!

Videos

Want video demonstrations? Here are some videos made by some awesome people!
Video by ServerMiner in English: <iframe width="630" height="354" src="https://www.youtube.com/embed/N0PnFbWPD1A"></iframe>

Video by KasaiSora in English: <iframe width="630" height="354" src="https://www.youtube.com/embed/uoppEyy4xow"></iframe>

Features

1. Load Images onto Maps and Item Frames

• Load images from URLs!
• PNG, JPEG, WEBP & GIFs are supported!
• Get them in Map form or _directly_ on Item Frames! (Select your Item Frames with the smart selection tool!)
• Automatic image fitting means your images won't be stretched!

2. Even Works with Animated GIFs!

• Images will be animated if they are GIFs!
• Animated up to 1/20 of a second!
• Animation tasks run asynchronously

</img>

3. Define Custom Width and Height

• Have your image span across multiple maps
• Automatic image fitting works across all sizes too!
• Ideal for displaying on Item Frames!

^ These metro platform signs look awesome, don't they? Put together with ImageFrame and invisible glowing item frames!

4. Add Overlays to Regular Vanilla Maps!

• Create an image map with a regular vanilla map in your hand
• Or across multiple maps via selecting them in item frames!

^ Notice the extra text with a blue background at the top of the map?

5. Combined ImageMap for Easy Placement!

• Get an entire multi-part ImageMap as one combined item!
• Automatically searches for space to place the ImageMap on an Item Frame wall (or floor/ceiling)
• The clicked Item Frame is treated as top-left if there is enough space
• When broken, the whole combined map is removed with a single combined map returned!
• Respect Item Frame protections on other plugins! (via calling Bukkit events)

</img>

^ The hearts particle is from _another plugin_ which listens to the EntityDamageEvent
^ Built-in Invisible Item Frames System

6. Refresh Maps Easily!

• Refresh _all copies_ of the same image map from the URL source in one simple command!
• Ideal for displaying information that you'll have to update across your server every once a while, without having to go and replace every single one

</img>

^ I've uploaded and replaced the TNT block with the grass block at the source URL, and I am holding 1 of the 4 maps in my hand

7. Add Map Markers To Your Images!

• Any map icon can be used! Such as the mansion and temple icons on Vanilla cartographer maps!
• They can also have an optional line of text below them
• Configurable max markers per map
• Ideal for marking locations on custom image maps!

8. Survival Friendly

• Require players _in survival_ to have empty maps in their inventory to be able to create image maps (using player commands)
• Even works when directly creating images on Item Frames or getting the Combined ImageMap item!
• Configurable in the config

9. Easy to Keep Track and Manage

• Commands available to help you (both as players and admins) manage your (or everybody's) created image maps
• Ability to give access to ImageMaps to other players!
• Different permission levels for different players you decided to share maps with.
• Such as listing all maps of a player, renaming etc.
• Option to set an image creation limit per player (Can be different for each player!)
• Option to set a maximum size for a single image frame! (Customizable as always)
• Migration available for ImageMap, ImageOnMap and DrMap (Message me for more plugin support requests)

10. Invisible Item Frames

• Built-in support for survival-friendly invisible item frames!
• Splash item frame items with invisibility potions to obtain.
• Can adjusted in the config.

</img>

11. Languages

• All player-facing messages are translated to different languages depending on the player's client language.
• If the language you speak is not yet supported, please contribute on Crowdin so we can build a better plugin for everyone together!

12. Complementary Mod

• Check out this complementary mod, which lets you see images in HD, full colours, and more!

13. Multi-Server Support

• With MySQL storage support, you can have the same maps across multiple servers in your server network! (Plugin does not need to be installed on the Bungeecord/Velocity proxy)

Dependencies

• None!