{"id":85580,"date":"2026-06-05T00:18:32","date_gmt":"2026-06-04T21:18:32","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/"},"modified":"2026-06-05T00:18:32","modified_gmt":"2026-06-04T21:18:32","slug":"interactiveimage","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/","title":{"rendered":"InteractiveImage"},"content":{"rendered":"

# InteractiveImage<\/p>\n

A Paper plugin that turns ImageFrame maps into interactive UI panels \u2014 hover detection, visual effects, and click actions, all configured in-game.<\/p>\n

\n

<\/p>\n<\/div>\n

## Requirements<\/p>\n

| Dependency | Version |
\n|—|—|
\n| Paper (or fork) | 1.21+ |
\n| ImageFrame by LOOHP | latest |
\n| Java | 21+ |<\/p>\n

## Installation<\/p>\n

1. Drop `InteractiveImage.jar` into your server’s `plugins\/` folder.
\n2. Make sure **ImageFrame** is installed.
\n3. Restart the server.<\/p>\n

No `config.yml` is generated. All settings are per-frame and stored in `plugins\/InteractiveImage\/iiamge.json`.<\/p>\n

## Commands<\/p>\n

| Command | Description |
\n|—|—|
\n| `\/ii` | Toggle editor mode on\/off |
\n| `\/ii on` \/ `\/ii off` | Explicitly set editor mode |
\n| `\/ii reload` | Reload data and restart scanners |<\/p>\n

**Aliases:** `iimage`, `iiimage`, `interactiveimage`
\n**Permission:** `interactiveimage.admin` (default: op)<\/p>\n

## In-Game Editor<\/p>\n

1. Run `\/ii` to enter editor mode.
\n2. Look at an ImageFrame item frame and **right-click** it to open the GUI.
\n3. Configure the frame’s effects, activation distances, visibility, and click actions.
\n4. Run `\/ii` again to exit editor mode.<\/p>\n

## Effects<\/p>\n

Each frame can have any combination of these effects applied when a player looks at it:<\/p>\n

– **Glow** \u2014 highlights the frame with a configurable color and mode (`FRAME` or `BLOCK`)
\n– **Glint** \u2014 item-enchantment-style shimmer on the frame
\n– **Hidden frame block highlight** \u2014 reveals the block behind a hidden item frame
\n– **ActionBar** \u2014 displays a message in the action bar with a configurable format and refresh rate
\n– **Title** \u2014 sends a title\/subtitle with configurable fade-in, stay, and fade-out durations
\n– **BossBar** \u2014 shows a boss bar with configurable text, color, style, and progress<\/p>\n

All effects support per-frame overrides on top of server-wide defaults.<\/p>\n

## Click Actions<\/p>\n

Actions fire when a player left-clicks or right-clicks a configured frame. Each action is a string in one of these formats:<\/p>\n

| Format | Behavior |
\n|—|—|
\n| `console:` | Runs the command as the console |
\n| `player:` | Runs the command as the clicking player |
\n| `` | Same as `player:` |<\/p>\n

Actions support placeholders that are replaced at runtime (e.g. player name, map name).<\/p>\n

**Example actions:**
\n“`
\nconsole:say %player% clicked the map
\nplayer:warp spawn
\n“`<\/p>\n

## Per-Frame Configuration<\/p>\n

Each frame rule supports:<\/p>\n

– `title` \u2014 display name
\n– `cooldownTicks` \u2014 cooldown between action triggers
\n– `cancelInteract` \u2014 whether to cancel the interact event
\n– `onRightClick` \/ `onLeftClick` \u2014 action lists
\n– `activation` \u2014 override hover distance, click distance, and hover-required-for-click
\n– `effects` \u2014 override glow color\/mode, frame visibility, ActionBar, Title, and BossBar settings<\/p>\n

## Building<\/p>\n

“`bash
\n.\/gradlew build
\n“`<\/p>\n

Output jar will be in `build\/libs\/`.<\/p>\n","protected":false},"excerpt":{"rendered":"

Turns ImageFrame maps into interactive UI panels \u2014 hover detection, visual effects, and click actions, all configured in-game.<\/p>\n","protected":false},"featured_media":85581,"template":"","meta":{"_minecraft_slug":"interactiveimage","_minecraft_project_id":"L1EkgHY9","_minecraft_author":"iM5LB1","_minecraft_license":"MIT","_minecraft_downloads":21,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"interactiveimage.zip","_minecraft_size_bytes":521053,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:42:16.414555Z","_minecraft_date_created":"2026-04-30T20:29:55.567868Z","_minecraft_date_modified":"2026-05-13T18:01:26.349539Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/interactiveimage","_minecraft_icon_attachment_id":85581,"_minecraft_imported_at":"2026-06-04T21:18:33+00:00","_minecraft_import_hash":"e605b781c20d340805c5e9e2e7f41ae0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,122,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-85580","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-magic","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nInteractiveImage - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"InteractiveImage - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Turns ImageFrame maps into interactive UI panels \u2014 hover detection, visual effects, and click actions, all configured in-game.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/github.com\/iM5LB\/InteractiveImage\/blob\/main\/interactiveImage.gif?raw=true\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/\",\"name\":\"InteractiveImage - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/interactiveimage-icon-0e57d4ba164aaa267522c86e8534c0d1cc304ef5.gif\",\"datePublished\":\"2026-06-04T21:18:32+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/interactiveimage-icon-0e57d4ba164aaa267522c86e8534c0d1cc304ef5.gif\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/interactiveimage-icon-0e57d4ba164aaa267522c86e8534c0d1cc304ef5.gif\",\"width\":475,\"height\":475},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/interactiveimage\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"InteractiveImage\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"InteractiveImage - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/","og_locale":"en_US","og_type":"article","og_title":"InteractiveImage - Minecraft","og_description":"Turns ImageFrame maps into interactive UI panels \u2014 hover detection, visual effects, and click actions, all configured in-game.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/github.com\/iM5LB\/InteractiveImage\/blob\/main\/interactiveImage.gif?raw=true","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/","name":"InteractiveImage - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/interactiveimage-icon-0e57d4ba164aaa267522c86e8534c0d1cc304ef5.gif","datePublished":"2026-06-04T21:18:32+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/interactiveimage-icon-0e57d4ba164aaa267522c86e8534c0d1cc304ef5.gif","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/interactiveimage-icon-0e57d4ba164aaa267522c86e8534c0d1cc304ef5.gif","width":475,"height":475},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/interactiveimage\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"InteractiveImage"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/85580","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/85581"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=85580"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=85580"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=85580"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=85580"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}