# Painting CraftHorizon uses the [MC Paint](https://modrinth.com/datapack/mc-paint) data & resource pack to bring custom paintings to the server. We have condensed [their wiki](https://github.com/Eroxen/MC-Paint-datapack/wiki/) here for your convenience, but please take a look need extra help. *** ## Getting Started To get started, simply throw an Egg at a vanilla painting, then grab the Paint Brush from the bottom of the newly-created Studio! *** ## **Blocks & Items** ### Overview

Item	Description
	Studio: Allows you to create custom paintings. Can be created by throwing an Egg at a vanilla painting.
	Custom Painting: Your artwork! Can be placed anywhere, including on floors and ceilings. Can be obtained by using the Export button in the Studio, which consumes 1 vanilla painting item. When placed down, you can apply several Custom Painting Modifiers to change its look or behaviour. You can wash this item in a cauldron to recycle it back into a vanilla painting
	Paint Bucket: Lets you save additional colours in your palette, and can be used for decoration.
	Easel: Lets you display paintings in style and move them around.
	Paint Brush: Obtained when right-clicking the Studio. Allows you to interact with the painting menus.

### Paint Bucket Paint Buckets are a block that let you save additional colours in your palette. When you are using the Studio, you can right-click a Paint Bucket (while not holding the brush) to set the colour in the bucket as the Studio's active colour. If you right-click while sneaking, it will save the active colour from the Studio into the Paint Bucket. Paint Buckets can be placed off the normal block grid, which allows you to place multiple inside the same block space. Breaking a Paint Bucket will retain the colour inside. You can also set the colour of a Paint Bucket by right-clicking with any Dye item. Furthermore, you can use a Book and Quill to set the colour to an HTML colour code (e.g. #029A2F). **Crafting Recipe:**

### Easel The Easel is an entity which lets you display custom paintings. Simply right-click the Easel with a custom painting to add it to the Easel, and left-click to remove it. Some [Custom Painting Modifiers](#custom-painting-modifiers) will also work for paintings on the easel, as long as you applied them to the painting before putting it on the Easel. You cannot modify paintings while they are on the Easel. Easels are affected by gravity, and can be moved by regular means of moving entities such as water streams, pistons and explosions and minecarts. This allows for all kinds of contraptions, such as painting piston doors, swappable decorations, and anything else you can imagine! You can vertically align the paintings on the Easel by right-clicking with an empty hand. Clicking without sneaking moves the bar up by 1 pixel, clicking while sneaking moves it down. **Crafting Recipe:**

*** ## Studio The Studio is a block which lets you create custom paintings. It can be created by throwing an Egg at a vanilla painting.

### The Menu You can open the Studio's menu by right-clicking with an empty hand. This gives you a Brush, which lets you interact with the menu by moving your cursor and right-clicking. The menu that opens is shown below. #### File Menu Right above the canvas sits the file menu. This shows the name and size of your file, and holds the following buttons: * **Save**: This saves your file. If you haven't named your file yet, it will open the "Save As" menu instead. * **Save As**: This opens a menu where you can choose a name for your file. You can set the name by writing it in the first page of a Book and Quill, and clicking the "Set name from Book and Quill" button with your Brush. Filenames can be between 1 and 24 characters long and must not contain quotes, backslashes, or newlines. * **Load**: This opens a menu where you can browse through all your files. You can load them into the studio to edit them again, and you can delete unwanted old files in this menu. In this menu you can also encode your paintings as a base64 code to share it with others (see [Sharing paintings](https://github.com/Eroxen/MC-Paint-datapack/wiki/Sharing-paintings)). * **New File**: This opens a menu where you can create a new file. The arrows allow you to choose the size of the painting, up to 4x4 blocks. By default the resolution of the painting will be 16x the size in blocks, but you can change this as well. For example, you can have a painting that only has 1 pixel to create a lag-friendly flat coloured painting for your personal void room or green-screen. * **Export**: This gives you a Custom Painting that links to the currently opened file. Make sure your file is saved, or the custom painting will still display the old data. Exporting will consume 1 vanilla painting item. * **Import Code**: This allows you to import a base64 encoded image to your saved paintings. For more information, see: [Sharing paintings](https://github.com/Eroxen/MC-Paint-datapack/wiki/Sharing-paintings). * **Undo**: Undoes the last action. You can press the swap item with offhand key while holding the Brush as a shortcut. * **Redo**: Redoes the last undone action. This is the same shortcut as before, but while holding sneak. #### Colour Picker Left of the canvas sits the colour picker. Here you can choose a colour in [HSV colour space](https://en.wikipedia.org/wiki/HSL_and_HSV) by dragging around the two darts on the Hue ring and the Saturation & Value square. There is a foreground and a background colour, so you can remember two different colours at the same time. You can also select the transparent colour, which functions as an eraser. #### Tools To the right of the canvas sits the tools menu. Here you can select the tool that is applied when you click the canvas. The available tools are: * **Pen**: Places pixels on the canvas. You can select the brush size on the right half of the tool menu. * **Eyedropper**: Chooses the colour at the clicked pixel as the selected colour. ### Files Once a painting is saved, it is stored in a file. Once you save your painting to a file, you can safely break the Studio, place it down somewhere else, and find your file again. Each file is identified by a unique filename, so it is not possible to give two paintings the same name. Two different players can both have a file with the same name, however. *** ## Custom Painting Modifiers When a Custom Painting is placed down in the world, you can apply several modifications to suit your needs. These modifications can be made by right-clicking the painting with an item in your main hand. All items and their effects are listed below. Modifiers with a ✅ in the Studio column can also be applied to a Studio while you have the menu opened. Modifiers with a ✅ in the Easel column will change the appearance of a painting when placed on an Easel.

Item	Effect	Studio	Easel
Shears	Removes the painting background.	✅	✅
Wool	Sets the painting background to the default canvas.	✅	✅
Cobbled Deepslate	Sets the painting background to a blackboard.	✅	✅
Observer	Sets the painting background to a screen.	✅	✅
Tinted Glass	Toggles axis shading on the ink of the painting.	✅	✅
Name Tag	Makes the painting display its name and author when right-clicked with an empty hand, or toggles this off again.	❌	❌
Book & Quill	Makes the painting display the text in the first page of the book when right-clicked with an empty hand, or toggles this off again.	❌	❌
Glow Ink Sac	Renders the ink of the painting as if it was in full block and sky light.	❌	✅
Ink Sac	Removes the glowing effect	❌	✅
Honeycomb	Locks a painting. A locked painting can not be modified or broken by anyone, and only unlocked by the player who locked it.	❌	❌
Axe	Unlocks a painting.	❌	❌
Eye of Ender	Toggles "billboard mode", which makes the painting always rotate against the player's rotation.	❌	❌
Paper	Copies (while sneaking) or pastes (while not sneaking) all the settings of a custom painting.	❌	❌
Ice	Changes the transparency of the painting ink. Hold sneak to reverse direction. (May look strange due to rendering issues in the game)	❌	✅
Compass	Rolls the painting over by 22.5°. Hold sneak to reverse direction.	❌	❌
Spyglass	Changes the view range of the painting. For exact numbers, see the table below.	❌	❌

### View Ranges The actual distance you can see a painting from depends on your [Entity Distance and Render Distance settings](https://minecraft.wiki/w/Options#Video_Settings). These numbers reflect the view range at the default Entity Distance (100%) and a Render Distance of 15 chunks.

Setting	Background visible from	Ink visible from
short	39 blocks	24 blocks
normal	72 blocks	48 blocks
far	145 blocks	96 blocks
very far	160 blocks	160 blocks

## Sharing & Uploading Paintings MC Paint allows you to share paintings between worlds or servers by encoding the data in a [base64](https://en.wikipedia.org/wiki/Base64) text format that can be copied and shared freely. For more information on sharing paintings, please see [the MC Paint wiki](https://github.com/Eroxen/MC-Paint-datapack/wiki/Sharing-paintings). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://classicscraftworks.gitbook.io/crafthorizon/archives/painting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.