Appearance
Using the Converter
The Mosaikin Converter is a companion web tool that prepares images and animations for use with the Mosaikin plugin. Everything runs entirely in your browser — your files are never uploaded to a server.
Use the converter to:
- Control the output size and head count of a wall before committing to generation
- Convert animated GIFs, videos, and other multi-frame formats
- Preview roughly how many player heads your image will require
- Trim, crop, and adjust export settings before committing to a generation
When to Use the Converter
You must use the converter for:
- Animated WebP, APNG
- Video files (MP4, WebM, MOV)
The converter is optional but recommended for:
- Any image you want to resize before importing
- Animated GIFs (can also be loaded via direct URL, but the converter lets you trim and adjust settings)
- Still images you want to crop or adjust
You can skip the converter for:
- Simple still images (PNG, JPEG) that you're linking directly via URL
Supported Input Formats
| Format | Type |
|---|---|
| PNG | Still image |
| JPEG | Still image |
| WebP (static) | Still image |
| GIF | Animation |
| Animated WebP | Animation |
| APNG (animated PNG) | Animation |
| MP4 / H.264 | Video |
| WebM / VP9 | Video |
| MOV | Video (codec-dependent) |
Audio is ignored — only the video frames are exported.
Export Settings
Output Size
A slider that sets the pixel dimensions of the exported image. Drag left to reduce output size — the preview updates live and the head count estimate updates as you drag.
- Snaps to the 8-pixel head-chunk grid, so every value aligns cleanly with the plugin's chunking.
- Respects the active fit mode (crop, fit, or stretch) and crop tool selection.
- Smaller output = fewer heads = faster generation and better in-world performance. Use this as your primary knob for controlling head count.
TIP
The in-game /mosaikin <name> scale command changes how large the wall appears in the world without modifying the image pixels. The converter's Output size control is different — it bakes the dimensions into the exported archive and directly controls how many heads are generated.
Decode Cap (Advanced)
Limits the maximum dimension of the source before decoding. Options: Original, 4K (2160px), 1440p, 1080p, 720p, 480p, 360p, 240p, 144p, 96px, 64px.
This is a memory-safety cap for very large inputs — it keeps huge sources from choking the browser during decode. It forces a full re-decode when changed. For controlling output size and head count, use the Output size slider above instead.
Trim
For multi-frame sources, trim the animation to a subrange. Set the start frame and end frame to export only the portion you need.
Shorter animations generate significantly fewer heads.
Density
Pixels per block — controls how many source pixels map onto one Minecraft block of wall width. This affects the wall's physical block size in the world, not the number of heads generated (use Output size for that).
| Value | Block size effect | Head count effect |
|---|---|---|
| 8 | Each 8×8 chunk = 1 block; largest wall | No change |
| 16 (default) | Matches vanilla block textures | No change |
| 32 | Smaller blocks | No change |
| 64 | Very small blocks | No change |
Head count is determined by output pixel dimensions and frame count — not by density. Density is saved into the exported archive and automatically applied when you load it in-game with /mosaikin <name> image.
Density affects the wall's in-game block size, not head count
To reduce the number of heads generated, lower the Output size above. Density only changes how large each head's image region appears as Minecraft blocks.
Fit Mode
How to resize the source to match the target aspect ratio.
| Mode | Behavior |
|---|---|
| Crop (default) | Preserves aspect ratio; center-crops any excess |
| Fit | Preserves aspect ratio; pads remaining area with transparency |
| Stretch | Ignores aspect ratio; stretches to fill exactly |
Crop Tool
When Crop fit mode is active, drag the crop handles to select exactly which region of the source to use. The crop is applied before export and the plugin does not need to re-apply it in-game.
Playback Speed
Sets a playback speed multiplier for the exported animation. This value is saved into the archive and automatically applied when loaded in-game. 1.0 = normal speed, 2.0 = double speed.
Bit Depth
Controls color reduction. Default is 8 bits (full color). Lower values snap pixel colors to a smaller palette, producing a posterized look. Useful for very stylized or pixel-art content.
| Bit depth | Colors available |
|---|---|
| 8 (default) | Full color (no reduction) |
| 4 | 16 levels per channel |
| 2 | 4 levels per channel |
| 1 | 2 levels per channel (black and white) |
Grid Overlay
Toggles a visual overlay showing the 8×8 pixel head chunk grid in the preview. Useful for understanding how the image will be divided into heads.
Exporting
Click Export to download a .zip file containing the processed frames and settings.
Option A — Download and host it yourself
Host the file somewhere publicly accessible (a file host, your server, etc.) and load it in-game:
/mosaikin <name> image https://your-host.com/export.zipOr if the file is on your server:
/mosaikin <name> image file:///path/to/export.zipOption B — Upload for direct plugin pickup
After exporting, you can optionally upload the archive to get a temporary link that the plugin can fetch directly — no file hosting required.
Check Also upload for plugin pickup below the export button. You will need to:
- Confirm that you understand the archive will be uploaded to a server
- Complete a quick bot-check (Cloudflare Turnstile)
- Click Upload & get link
The link expires after 1 hour. Copy it and use it immediately:
/mosaikin <name> image https://...Privacy
Only the packaged archive ZIP is uploaded — your original source file never leaves your browser. Sharing is off by default and requires explicit opt-in. The upload is deleted automatically after 1 hour.
Using Direct URLs Instead
For simple still images and GIFs, you can skip the converter entirely and point the plugin at a public URL:
/mosaikin <name> image https://example.com/image.gifSupported direct URL formats: PNG, JPEG, GIF, WebP (static), BMP, TIFF.
When using direct URLs, configure density and other settings manually before generating:
/mosaikin <name> density 16