✨ ImageMOTD ✨ Use PNG Images as Your Server MOTD |[1.21.9-1.21.11]

WHAT IS IMAGEMOTD?

ImageMOTD replaces the normal two-line server MOTD with a generated image banner on compatible clients.

Create your banner as a normal PNG, place it inside the ImageMOTD folder, run /imagemotd generate, and ImageMOTD handles the conversion for you.

Perfect for server logos, seasonal banners, announcements, launch messages, network branding and clean server-list designs.


IN-GAME PREVIEW



MAIN FEATURES

• Full 264x16 PNG MOTD banners
• Uses the full two-line MOTD image area
• No client-side mod required
• Automatic 264x16 resizing option
• Generated banner caching
• Only changed image tiles need new generation
• Configurable text fallback for unsupported clients
• Optional custom 64x64 server favicon
• Simple generation, status and reload commands
• Optional MineSkin API key support

HOW IT WORKS

A full ImageMOTD banner is 264x16 pixels.

ImageMOTD divides the image into 66 small 8x8 tiles and generates the Minecraft skin textures required to display those tiles in the server-list description.

Once generated, the banner is cached locally.


QUICK SETUP

1. Install ImageMOTD on your Paper or Purpur server.
2. Start the server once.
3. Place your banner here:

Then run:

Check generation progress with:

Once generation has finished, refresh your Minecraft server list to see the banner.


COMMANDS

Aliases:


PERMISSIONS

Default: OP


FALLBACK MOTD

Clients outside the configured full-banner protocol range can automatically receive a normal text MOTD instead.

Default:

You can edit both lines in config.yml.

You can also configure passthrough behavior or enable the alternate PNG fallback renderer.


CONFIGURATION


GENERATION & CACHING

The first full-banner generation can take several minutes because Minecraft skin textures must be generated for the unique 8x8 tiles.

Use:

to follow the progress.

ImageMOTD stores generated tile data in its cache. If you later change only part of your banner, unchanged tiles can be reused instead of being generated again.

MineSkin is used for skin-texture generation. An API key is optional and can be supplied in the configuration if desired.


SERVER ICON SUPPORT

ImageMOTD can also manage the normal Minecraft 64x64 server favicon.

Simply enable it in the configuration and replace:

with your own 64x64 PNG.


COMPATIBILITY

Java: 21

Recommended server software:
Paper / Purpur

Full-banner mode:
Designed for compatible 1.21.9-1.21.11 clients. The protocol range is configurable.

Clients outside the selected range use your configured fallback instead of receiving a broken server-list response.


IMPORTANT

The full image method relies on Minecraft server-list component behavior that is client-version sensitive.

ImageMOTD therefore includes a fallback system rather than forcing the image onto incompatible clients.

The plugin itself does not require a resource pack.


SUPPORT

When reporting an issue, please include:

• ImageMOTD version
• Server software and version
• Client Minecraft version
• Relevant console output

Discord:
https://discord.gg/u3vEFdskEQ