Mapart Helper

If you run into any bugs or rough edges, please report them on the
Issues page — your feedback will be a huge help

---

Mapart Helper aims to make working with maparts as convenient and enjoyable as possible.

The mod generates palette directly from the client, giving you a complete list of blocks
available for each specific color.

It also includes other map-related features, such as saving maps from the world as PNG files or
displaying beams at the north-western positions of map areas.

Supported versions

Version	Status
1.21.8	✔️ Active
1.21.10	⚠️ Last version 0.12.0
1.21.11	✔️ Active
26.1	✔️ Active
1.21.4-5	✔️ Backport* 0.13.1

*Backport versions won't be getting every new update.
They will be updated only for some major versions and critical fixes

---

How to:

🖼️ Create a Mapart:

1. Launch the game with the mod installed
2. Join a world or server
3. Open the Mapart editor screen with the Y key (this can be changed in the settings)
4. Use the user-friendly GUI to create some cool maparts

🎮 Create actual maps from a mapart:

Mapart Helper provides functionality for adjusting an image and converting it to .NBT files. Currently, there are only a few ways to use it to create maps in your world/on your server:

• Use a specific client-side mod for schematics (e.g. Litematica) and use generated .NBT files. Make sure that schematic is placed correctly - northwestern edge of the mapart's schematic (excluding th top row of auxiliary blocks) must be match the northwestern edge of the in-game map (/mart beams might help a little with that). When you have set the schematic you can either start building it in survival or use "placing in the world" if you are a operator;
• Use a specific server-side mod/plugin to create maps from a URL.

If you are having difficulty with this step, I recommend looking for guides on creating mapparts — they should answer most of your questions. If not, I would be glad to help on my Discord.

🎨 Use palette presets:

Palette presets let you quickly switch between different sets of blocks and colors used when creating maparts.
You can manage them in the Presets Editor screen, accessible from the Mapart editor screen.

Each preset is stored as a separate .json file inside
{game root folder}/config/mapart-helper/presets.

You can:

• Create and edit presets directly from the GUI.
• Add presets manually by placing .json files into the folder — this is also how
  you can share your presets with others.

All presets are also listed in the config/mapart-helper/palette_presets.json file, which maps preset filenames
to their display names.
You can use this file to quickly identify a specific preset and to safely change its filename.

If you change any of these files or add new presets while playing the game, make sure to update the data in-game — either by pressing the
“Update from files” button in the Presets Editor, or by running /mart palette update.

---

Commands

The following commands can be used everywhere, including servers:

• /mart — Shows a list of commands in the chat
• /mart save frame [filename] — Saves the map's image you are looking at to the saved_maps folder
• /mart save hand [filename] — Saves the map's image you are looking at to the saved_maps folder
• /mart save selection [filename] — Saves the image from the selection area to the saved_maps folder
• /mart beams — Toggles displaying the beams at the map areas' north-western points
• /mart palette regenerate — Regenerates blocks palette
• /mart palette update — Updates palette and presets from config files

There are also several miscellaneous singleplayer-only commands, almost for debugging or for some unique cases:

• /mart-creative palette give-map-palette — Fills the holding filled map with the image of the complete palette
• /mart-creative palette place <height> — Places all blocks from the generated blocks palette into the world
  from the current map area's starting coordinates and at the given y-coordinate

---

Rebane's MapartCraft

As someone who builds maparts in survival, I have always used this great website for that purpose.
So, of course, the main idea for this
mod was inspired by MapartCraft.
As a novice modder, I decided to create a similar tool, but integrated directly into the game.

Mapart Helper is an alternative that provides
in-game GUI for the same purposes, with some differences
and its own features.

MapartCraft and Mapart Helper use different programming languages,
algorithms, and logic. For this reason, the results may and will differ,
especially when it comes to image preprocessing.
Please keep this in mind if you want to use both tools for the same mapart.

---

Official links to download the mod

• Modrinth
• Curseforge
• GitHub

Contacts

• GitHub: https://github.com/Redheris/Mapart-Helper/issues
• Discord: Server