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:
Code:
%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
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 imagePut your image into:
Code:
plugins/ImageDisplay/pictures/
Make sure the image size is a multiple of 8 pixels.Examples:
Code:
16x16
32x32
64x8
64x64
80x8
96x8
128x64
128x128
256x1282. Specify your MineSkin API key in the plugin configuration
It's free: You can get it here
Paste API key to:
Code:
mineskin-api-key: "here"3. Generate the image data
Run the command:
Code:
/imagedisplay generate your_image_name.png4. Wait generation
Wait for a chat message about successful generation, or check the console.
5. Use the placeholder
Use the generated placeholder anywhere supported:
Code:
%imagedisplay_your_image_name%Permissions
Every generated image gets its own permission node:
Code:
imagedisplay_<id>Example:
Code:
%imagedisplay_logo%requires:
Code:
imagedisplay_logoThis 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:
YAML:
components:
minimessage-support: falseThen run the command
Code:
/tab reload- Support for multiple localizations
- I recommend fonts: Minecraftia, Press Start 2P or any bitmap-style.
