ImageStick

ImageStick is an extension for the ImageFrame plugin that simplifies the process of playing slideshows in Minecraft.

It allows you to display a set of images on a "screen" made of item frames, and turn pages by clicking the screen with a stick—just like using a remote to switch slides in a real presentation.

Usage

Step 1: Prepare Images

Place your images (supported formats: PNG, JPG, JPEG, GIF, WEBP) into the following server directory:

plugins/ImageStick/images/<your-folder-name>/

For example, if you want to create a slideshow called presentation, put the images in:

plugins/ImageStick/images/presentation/

Images will be sorted based on the number at the end of the filename (e.g., slide1.png, slide2.png, etc.), so make sure to name them accordingly.

Step 2: Import Images

Run the following command in-game:

/imagestick import <folder> <width> <height>

Width / Height: The size of the screen in item frames (columns × rows).

Example:

/imagestick import presentation 2 2

The plugin will automatically call ImageFrame to import each image as a map and show the progress in the chat.

Step 3: Build the Screen

Place the required number of item frames on a wall. For example, a 2×2 screen requires 4 item frames.

All item frames must be adjacent and facing the same direction.

Step 4: Bind the Screen

Look at the top-left item frame of the screen, then run:

/imagestick bind <folder> <width> <height>

Example:

/imagestick bind presentation 2 2

After binding, the first slide will appear automatically.

Daily Usage

Once the screen is bound, any player with permission can control the slideshow:

Action	Result
Right-click any item frame on the screen while holding a stick	Go to the next slide
Shift + Right-click while holding a stick	Go to the previous slide

The chat will show the current progress, for example:

Slide 3 / 8

Notes

The /imagestick import command must be executed by a player in-game. It cannot be run from the console.
Make sure the server can access the images before importing them. The plugin includes a built-in HTTP file server, so the administrator must ensure the corresponding port is open.
If any item frame on the screen is removed, the slideshow binding will be automatically cleared, and you will need to bind it again.
Slideshow data is saved automatically and will persist after server restarts.

Commands

Command	Description
`/imagestick import <folder> <width> <height>`	Batch import images as ImageFrame maps
`/imagestick bind <folder> <width> <height>`	Bind a screen to an image set
`/imagestick reload`	Reload the configuration

All commands require the permission:

imagestick.use

(Default: OP only)