Image Display

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

!(https://cdn.modrinth.com/data/cached_images/e55327925971fd1170e1160e43bc7068da0778aa.png)

## How to add and use any image?

1. Upload your image

Put your image into:

```text plugins/ImageDisplay/pictures/ ```

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

2. Specify your MineSkin API key in the plugin configuration It's free: (https://mineskin.org/apikey)

Paste API key to:

``` mineskin-api-key: "here" ```

3. Generate the image data

Run the command:

```text /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:

```text %imagedisplay_your_image_name% ```

## Permissions

Every generated image gets its own permission node:

```text imagedisplay_ ```

```text %imagedisplay_logo% ```

```text 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:

(https://modrinth.com/plugin/placeholderapi) — for placeholders (https://github.com/dmulloy2/ProtocolLib/releases/tag/dev-build) — for image display and detection client version

(https://modrinth.com/plugin/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....

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: false ```

Then run the command

```text /tab reload ``` Support for multiple localizations I recommend fonts: Minecraftia, Press Start 2P or any bitmap-style.