Mosaikin

Mosaikin (Mosaic + Skin) lets you create high-resolution or animated image walls in Minecraft using player heads and display entities, completely without client mods or resource packs.

"Wanderer" - Minecraft Pixel Art vs Original Painting

---

Features

• Create high-quality image displays
• Displays can be freely scaled, rotated and translated, allowing for any in-game size of graphics you need
  • Low-res sources can be rendered at a smaller in-world size to appear sharper.
• Supports GIFs and videos (videos via the companion converter)
• Companion web editor and file converter for easy setup and preview
• Highly optimized merging of player heads and textures
  • Automatically combines e.g. solid-colored background into a single scaled-up player head
  • Intelligently splits up textures and packs up to 6 image chunks per skin, so each MineSkin upload covers 6 cells
• Smart playback that swaps cube faces on existing heads instead of resending skins, minimizing bandwidth per frame
• Extensive documentation
• Easy chat UI for setup
• Wide range of options for each display, both in-game and on the companion website
• Powered by MineSkin

---

Important Note: This plugin requires a MineSkin API key. A paid subscription is strongly recommended if you're making more than a few still displays.

Disclosure: I (inventivetalent) own and manage both this plugin and MineSkin.

---

Companion Converter Website

Use Cases

• Hub signs advertising games
• Animated arrows or graphics to guide players
• High-resolution text labels / sign alternatives
• Custom pixel art, without requiring a resource pack

Getting Started

Please see the docs for a full Getting Started guide

• Download the .jar and drop it into your plugins folder
• Restart the server
• Get an API key from MineSkin
• Edit the plugin config.yml, and set the API key
• Restart/reload the server
• Use /mosaikin create and follow the steps to create your first display (run /mosaikin for a list of commands)

Limitations

• Generating the skin signatures for player heads takes time. Paid MineSkin plans make this much faster, but generation will still take somewhere between a couple of minutes up to a few hours for very large images or long animations. check the unique head estimate before starting skin generation. start small to get a feel for how long it takes.
  • But: Skins only need to be generated once and the data is stored locally. Unless you change the image or density, you can pause generation and resume without having to wait for the whole thing again.
• Playback of animations can take up a lot of bandwidth. It's recommended to limit the size and length of animations, as well as the number of animated displays in the same area.
• Displays with a lot of player heads (sometimes referred to as cells) can cause significant clientside performance issues (low FPS). Try to keep the number of heads as low as the image resolution allows. Prefer scaling down the wall to increase detail. It's recommended to use the converter web tool to preview the image and number of heads required.
  • Images with a lot of details will require more unique heads.
  • Repeated textures or solid-color backgrounds are preferable, as they can be deduplicated or even merged into bigger chunks.
• Due to Minecraft's TPS, animation playback is limited to 20FPS
• This plugin is primarily intended for server owners/admins to set up global signage, images, etc. — not for players to create their own displays, due to the performance implications.

Creation of this plugin was heavily AI-assisted.

---

This plugin collects anonymous usage statistics via bStats. You can disable this by setting metrics.enabled: false in config.yml.