InteractiveImage

A Paper plugin that turns ImageFrame maps into interactive UI panels — hover detection, visual effects, and click actions, all configured in-game.

Requirements

| Dependency | Version |
|---|---|
| Paper (or fork) | 1.21+ |
| ImageFrame by LOOHP | latest |
| Java | 21+ |

Installation

1. Drop InteractiveImage.jar into your server's plugins/ folder.
2. Make sure ImageFrame is installed.
3. Restart the server.

No config.yml is generated. All settings are per-frame and stored in plugins/InteractiveImage/iiamge.json.

Commands

| Command | Description |
|---|---|
| /ii | Toggle editor mode on/off |
| /ii on / /ii off | Explicitly set editor mode |
| /ii reload | Reload data and restart scanners |

Aliases: iimage, iiimage, interactiveimage
Permission: interactiveimage.admin (default: op)

In-Game Editor

1. Run /ii to enter editor mode.
2. Look at an ImageFrame item frame and right-click it to open the GUI.
3. Configure the frame's effects, activation distances, visibility, and click actions.
4. Run /ii again to exit editor mode.

Effects

Each frame can have any combination of these effects applied when a player looks at it:

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

All effects support per-frame overrides on top of server-wide defaults.

Click Actions

Actions fire when a player left-clicks or right-clicks a configured frame. Each action is a string in one of these formats:

| Format | Behavior |
|---|---|
| console:<command> | Runs the command as the console |
| player:<command> | Runs the command as the clicking player |
| <command> | Same as player: |

Actions support placeholders that are replaced at runtime (e.g. player name, map name).

Example actions:

console:say %player% clicked the map
player:warp spawn

Per-Frame Configuration

Each frame rule supports:

• title — display name
• cooldownTicks — cooldown between action triggers
• cancelInteract — whether to cancel the interact event
• onRightClick / onLeftClick — action lists
• activation — override hover distance, click distance, and hover-required-for-click
• effects — override glow color/mode, frame visibility, ActionBar, Title, and BossBar settings

Building

./gradlew build

Output jar will be in build/libs/.