Where can it be used?

Turn any image into a grid of MineSkin-powered head textures, then use it in chat, TAB header/footer, prefixes/suffixes, nametags, holograms, titles, scoreboard and other. Image Display is perfect for server logos, icons, decorations, rank visuals, hologram art, lobby branding, and other visual UI elements without forcing a resource pack.

Features

• Display images without a resource pack
• Auto convert PNG/JPG/JPEG/WEBP images into player-head components. You don't need to manually crop images - the plugin will do it for you!
• You don't need to mess with resource bundles or search for glyphs, just upload your images and use a single placeholder!
• Use images with simple placeholders like:

%imagedisplay_<image_name>%

• Works in any chat through ProtocolLib component replacement
• Uses local JSON image cache after generation
• Permission control for usage
• Fallback text for unsupported clients

Spoiler

Clients before version 1.21.9 cannot see such images. For them, you can specify a fallback text in the config

How to add and use any image?

1. Upload your image

Put your image into:

plugins/ImageDisplay/pictures/

⚠️ Make sure the image size is a multiple of 8 pixels.

Examples:

16x16
32x32
64x8
64x64
80x8
96x8
128x64
128x128
256x128

2. Specify your MineSkin API key in the plugin configuration It's free: You can get it here

Paste API key to:

mineskin-api-key: "here"

3. Generate the image data

Run the command:

/imagedisplay generate your_image_name.png

4. Wait generation

Wait for a chat message about successful generation, or check the console.

5. Use the placeholder

Use the generated placeholder anywhere supported:

%imagedisplay_your_image_name%

Permissions

Every generated image gets its own permission node:

imagedisplay_<id>

Example:

%imagedisplay_logo%

requires:

imagedisplay_logo

This permission check is applied only when players try to use Image Display placeholders in chat. I plan to expand the permissions in the future.

Required plugins

Image Display requires:

• PlaceholderAPI — for placeholders
• ProtocolLib — for image display and detection client version

Optional:

• ViaVersion — useful for for detection client version

How it works?

Image Display takes an image, splits it into 8x8 pixel tiles, sends those tiles to MineSkin, and receives signed player head textures.

The plugin then stores the result in local JSON cache files. After generation, the server does not need to process the original image again. The placeholder simply renders the cached head components. Image Display is designed to be lightweight during normal server usage.

Tested and works with plugins:

• TAB
• Chatty
• ChatEx
• Citizen
• FancyNPC
• DeluxeHub
• LuckPerms
• EssentialsX
• EssentialsX Chat
• FancyHolograms
• LPC-Minimessage
• DecentHolograms

and more....

Notes

• If you use plugin TAB then has default MiniMessage support enabled for components — image rendering not work in prefixes/suffixes. Disable it in TAB config:

components:
  minimessage-support: false

Then run the command

/tab reload

• Support for multiple localizations
• I recommend fonts: Minecraftia, Press Start 2P or any bitmap-style.