> For the complete documentation index, see [llms.txt](https://mauvemc.gitbook.io/mauvemc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mauvemc.gitbook.io/mauvemc/features/artmap.md).

# ArtMap

ArtMap lets players paint pixel art directly onto Minecraft maps in-game using dyes and special tools. Finished artworks can be saved, displayed in item frames, and browsed by other players.

## **What you need to craft**

You need three things to get started. Use `/artmap` in-game to see all recipes.

* **Easel** - the stand you paint on. 
* **Canvas** - craft with leather, empty maps, and sticks.
* **Paintbrush** - used to save your finished painting.

Optional tools: dyes (your colors), coal (darken a color), feather (lighten a color), sponge (eyedropper/sample a color), paint bucket (fill tool), compass (flip canvas).

## **How to paint**

1. Place an easel by right-clicking the ground.
2. Right-click the easel while holding a canvas to attach it.
3. Right-click the easel again to sit down and enter painting mode.
4. Hold a dye and **left-click** to color one pixel. **Right-click and drag** to draw lines.
5. Crouch (shift) to exit the easel without saving.

**Warning:** Breaking an easel without saving will destroy your unsaved artwork. **ALWAYS** save artwork before logging off as they **reset** after the server restarts.

## **Brush tools**

| Item             | What it does                                                        |
| ---------------- | ------------------------------------------------------------------- |
| **Dye**          | Left click = one pixel, right click + drag = draw lines             |
| **Paint Bucket** | Fill an area with color (hold bucket, color in offhand, left click) |
| **Sponge**       | Eyedropper - left click to sample a color from the canvas           |
| **Coal**         | Darken a pixel (up to 2 times depending on color)                   |
| **Feather**      | Lighten a pixel                                                     |
| **Compass**      | Left click = flip vertically, right click = flip horizontally       |
| **Paintbrush**   | Right click canvas to save your painting                            |

## **Colors**

<figure><img src="https://868686433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZ0mkT7SIaNYPhsxyNVl%2Fuploads%2FJXBS7oIWTTHJ4kw3X62S%2Fimage.png?alt=media&amp;token=15116c43-7696-4f3f-8f74-f1d9f1d79886" alt=""><figcaption></figcaption></figure>

## **Saving your artwork**

When you're done, run `/artmap save <title>.` You'll be prompted to name your artwork. Once saved, it becomes a finished map item you can put in an item frame.

## **Browsing artworks**

Type `/artmap` to open the GUI. From here you can browse saved artworks by player, view your own pieces.