ImageFrame | Load Images on Maps & Item Frames! | Support GIFs! | Map Markers! | Survival Friendly -----
Put images on maps and walls!![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FE44B65n.gif)
Consider donating!
It helps me keep on supporting my plugins while keeping them free! Click me!
Looking for places to host your new Minecraft server? Look no further than BisectHosting! (25% off inside!)
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FbZFlwMO.png)
Before being a plugin developer, I've actually used BisectHosting before. Their servers run smoothly (when given enough RAM, of course) and they respond to their support tickets super fast, 24/7. They continued to assist me swiftly own downloading my data and worlds even after my server had expired!
With BisectHosting, you'll be able to get your own server in just a few clicks!
Interested? Then here's a deal for you!
Click the banner or the link below to get a 25% discount off your first month when buying any of their gaming servers!
It also supports my development as well, take it as an alternative way to donate while getting your very own Minecraft server as well!
P.S. Using the link or clicking the banner rather than the code supports me more! (Costs you no extra!)
https://www.bisecthosting.com/loohp
![[IMG]](/proxy/image?url=https%3A%2F%2Fwww.bisecthosting.com%2Fpartners%2Fcustom-banners%2Ffc7f7b10-8d1a-4478-a23a-8a357538a180.png)
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FFEUiMQB.png)
Join the discord server here!
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FB6WT3lB.png)
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!
Videos
Want video demonstrations? Here are some videos made by some awesome people!
Video by ServerMiner in English:
Video by KasaiSora in English:
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!
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2F0Lq4v2u.png)
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]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2Fll7sf4o.gif)
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!
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2Fbjo3pHS.png)
^ 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!
![[IMG]](/proxy/image?url=https%3A%2F%2Fimgur.com%2F6KI1SfV.png)
^ 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]](/proxy/image?url=https%3A%2F%2Fimgur.com%2FRwuHWrp.gif)
^ The hearts particle is from another plugin which listens to the EntityDamageEvent
^ Invisible Item Frames by SurvivalInvisiframes
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]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FKNNhXwf.gif)
^ 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!
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FU1k3Yiz.png)
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2Fo8QI3N4.png)
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, DrMap and ImageOnMap (Message me for more plugin support requests)
10. Languages
- All messages presented to your players are customizable to your liking!
Dependencies
- None!
Installation
1. Put ImageFrame.jar into the plugins folder along with the required dependencies
2. Start the server
3. Edit the config (if you need to)
4. Restart the server (if you changed something in the config in step 3)
Development Builds
Jenkins
Showcase Server
Want to see the plugin in action?
Code (Text):
IP: mc.loohpjames.com
![[IMG]](/proxy/image?url=https%3A%2F%2Fapi.loohpjames.com%2Fserverbanner.png%3Fip%3Dmc.loohpjames.com%26width%3D918%26name%3DIP%3A%2520mc.loohpjames.com)
Commands
Legend:
Code (Text):
For command "<name>"/"<image_name>" arguments,
You can access another players map **if you have permission**
through this syntax:
"<player>:<name>"
For example: /if get LOOHP:map combined
You can access another players map **if you have permission**
through this syntax:
"<player>:<name>"
For example: /if get LOOHP:map combined
Administration:
Code (Text):
/imageframe reload - Reloads the plugin
/imageframe update - Check for updates
/imageframe update - Check for updates
Player:
Code (Text):
/imageframe select - Select item frames to put image maps on
/imageframe create <name> <url> <width> <height> - Create a new image map
/imageframe create <name> <url> selection - Create a new image map and put it directly in your selected item frames
/imageframe create <name> <url> <width> <height> combined - Create a new image map and get its Combined ImageMap item
/imageframe overlay <name> <url> - Create a new image map that adds an overlay on a Minecraft Vanilla map you are holding
/imageframe overlay <name> <url> selection - Create a new image map that adds an overlay on a Minecraft Vanilla map in your selected item frames
/imageframe clone <name> <new_name> - Create a new image map with the same properties as the old one
/imageframe clone <name> <new_name> selection - Create a new image map with the same properties as the old one and put it directly in your selected item frames
/imageframe clone <name> <new_name> combined - Create a new image map with the same properties as the old one and get its Combined ImageMap item
/imageframe playback <name> pause - Toggle pause for an animated image map
/imageframe playback <name> jumpto <seconds> - Jump to a specific second for an animated image map
/imageframe refresh [optional:image_name] [optional:new_url] - Refresh a map you've created from source url
/imageframe info - Get info related to the image map you are holding
/imageframe get <name> - Get a self-created pre-existing image map
/imageframe get <name> selection - Put a self-created pre-existing image map directly on your selected item frames
/imageframe get <name> combined - Get a self-created pre-existing image map in its Combined ImageMap form
/imageframe delete <name> - Delete a self-created pre-existing image map
/imageframe rename <name> <new_name> - Rename a self-created pre-existing image map
/imageframe list - List all self-created pre-existing image maps
/imageframe marker add <image_name> <marker_name> <direction:0-15> <marker_type> [optional:caption] - Add a marker to your map
/imageframe marker remove <image_name> <marker_name> - Remove a marker from your map
/imageframe marker clear <image_name> - Clear all markers from your map
/imageframe setaccess <name> <player> <permission> - Set access permission of other players for your map
/imageframe create <name> <url> <width> <height> - Create a new image map
/imageframe create <name> <url> selection - Create a new image map and put it directly in your selected item frames
/imageframe create <name> <url> <width> <height> combined - Create a new image map and get its Combined ImageMap item
/imageframe overlay <name> <url> - Create a new image map that adds an overlay on a Minecraft Vanilla map you are holding
/imageframe overlay <name> <url> selection - Create a new image map that adds an overlay on a Minecraft Vanilla map in your selected item frames
/imageframe clone <name> <new_name> - Create a new image map with the same properties as the old one
/imageframe clone <name> <new_name> selection - Create a new image map with the same properties as the old one and put it directly in your selected item frames
/imageframe clone <name> <new_name> combined - Create a new image map with the same properties as the old one and get its Combined ImageMap item
/imageframe playback <name> pause - Toggle pause for an animated image map
/imageframe playback <name> jumpto <seconds> - Jump to a specific second for an animated image map
/imageframe refresh [optional:image_name] [optional:new_url] - Refresh a map you've created from source url
/imageframe info - Get info related to the image map you are holding
/imageframe get <name> - Get a self-created pre-existing image map
/imageframe get <name> selection - Put a self-created pre-existing image map directly on your selected item frames
/imageframe get <name> combined - Get a self-created pre-existing image map in its Combined ImageMap form
/imageframe delete <name> - Delete a self-created pre-existing image map
/imageframe rename <name> <new_name> - Rename a self-created pre-existing image map
/imageframe list - List all self-created pre-existing image maps
/imageframe marker add <image_name> <marker_name> <direction:0-15> <marker_type> [optional:caption] - Add a marker to your map
/imageframe marker remove <image_name> <marker_name> - Remove a marker from your map
/imageframe marker clear <image_name> - Clear all markers from your map
/imageframe setaccess <name> <player> <permission> - Set access permission of other players for your map
Moderation:
Code (Text):
/imageframe list <player> - List a player's pre-existing image maps
/imageframe adminsetcreator <image_id> <player> - Change the creator of an image map
/imageframe adminmigrate <ImageMap/DrMap/ImageOnMap> - Migrate data from the selected and supported third-party plugin
/imageframe adminsetcreator <image_id> <player> - Change the creator of an image map
/imageframe adminmigrate <ImageMap/DrMap/ImageOnMap> - Migrate data from the selected and supported third-party plugin
Code (YAML):
permissions:
imageframe.create:
default : true
description : Allow players to create new image maps
imageframe.create.animated:
default : op
description : Allow players to create new animated image maps
imageframe.overlay:
default : true
description : Allow players to overlay images on Vanilla maps
imageframe.clone:
default : true
description : Allow players to make deep copies of their own image maps
imageframe.select:
default : true
description : Allow players to select item frames
imageframe.marker:
default : true
description : Allow players to add and remove markers on image maps
imageframe.marker.unlimited:
default : op
description : Allow players to add unlimited markers on image maps
imageframe.refresh:
default : true
description : Allow players to refresh image maps
imageframe.rename:
default : true
description : Allow players to rename image maps
imageframe.info:
default : true
description : Allow players to view image map data
imageframe.list:
default : true
description : Allow players to list all image maps they've created
imageframe.list.others:
default : op
description : Allow players to list all image maps a player have created
imageframe.delete:
default : true
description : Allow players to delete an image map they've created
imageframe.get:
default : true
description : Allow players to get an image map they've created
imageframe.setaccess:
default : true
description : Allow players to change access permissions of their image maps
imageframe.adminbypass:
default : true
description : Bypass all access restrictions and allow users to use and modify any image map
imageframe.adminsetcreator:
default : op
description : Allow players to change the creator of any image map via the image map id
imageframe.admindelete:
default : op
description : Allow players to delete any image map via the image map id
imageframe.adminmigrate:
default : op
description : Allow players to migrate maps from supported plugins to ImageFrame
imageframe.update:
default : op
description : Allows you receive update messages
imageframe.create:
default : true
description : Allow players to create new image maps
imageframe.create.animated:
default : op
description : Allow players to create new animated image maps
imageframe.overlay:
default : true
description : Allow players to overlay images on Vanilla maps
imageframe.clone:
default : true
description : Allow players to make deep copies of their own image maps
imageframe.select:
default : true
description : Allow players to select item frames
imageframe.marker:
default : true
description : Allow players to add and remove markers on image maps
imageframe.marker.unlimited:
default : op
description : Allow players to add unlimited markers on image maps
imageframe.refresh:
default : true
description : Allow players to refresh image maps
imageframe.rename:
default : true
description : Allow players to rename image maps
imageframe.info:
default : true
description : Allow players to view image map data
imageframe.list:
default : true
description : Allow players to list all image maps they've created
imageframe.list.others:
default : op
description : Allow players to list all image maps a player have created
imageframe.delete:
default : true
description : Allow players to delete an image map they've created
imageframe.get:
default : true
description : Allow players to get an image map they've created
imageframe.setaccess:
default : true
description : Allow players to change access permissions of their image maps
imageframe.adminbypass:
default : true
description : Bypass all access restrictions and allow users to use and modify any image map
imageframe.adminsetcreator:
default : op
description : Allow players to change the creator of any image map via the image map id
imageframe.admindelete:
default : op
description : Allow players to delete any image map via the image map id
imageframe.adminmigrate:
default : op
description : Allow players to migrate maps from supported plugins to ImageFrame
imageframe.update:
default : op
description : Allows you receive update messages
Default Config
Latest Config with Descriptions
![[IMG]](/proxy/image?url=https%3A%2F%2Fbstats.org%2Fsignatures%2Fbukkit%2FImageFrame.svg)
Notes:
I only guarantee that the plugin works perfectly and with full features in the latest version of spigot and paper
Mainly because I am a student and my time is limited, sadly you can't live with just doing what you like, writing plugins, life just doesn't work like what we all wanted
Older versions are just "supported", so they might be missing a few features or hooks, but generally should work just fine.
Nevertheless, do your own testing to be sure, just like any other plugin on this forum.
Report problems on discord (recommended) or in the discussion, not in a review. Thanks
Resource Information
Author:
----------
Total Downloads:
54,297
First Release:
Nov 1, 2022
Last Update:
Dec 13, 2024
Category:
---------------
All-Time Rating:
32 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings