Skip to content

Painter

Painter hero image

The Painter can be used to paint objects in different colors and apply various visual materials to them.

Equipping the Painter

Through a keybinding

The Painter's default equip keybind is E. You can change this in the Options menu.

Switching from the Builder?

If you press too long with the Builder equipped before swapping to the Painter, the game will interpret your press of the key as a hold, and you will end up bringing up the enlarged painter menu instead.

Through the Tool Wheel

Hold G to access the Tool Wheel. This temporarily frees your mouse.

Drag your cursor to the top-right corner of the tool wheel.

Painter on the top-right corner of the Tool Wheel

Painter on the top-right corner of the Tool Wheel

Release G to equip the Painter.

Painter interface

Painter interface

Painter interface

  • The bottom right of your screen will contain the following user interface elements:

    • The key-binding for equipping the Painter or opening the advanced color and material selector
    • The current selected color and material
    • The server palette (up to 16 columns with 16 colors per column)

Selecting colors (simple)

You can use the Mouse Scroll Wheel to navigate up/down the palette vertically and select your color.

Navigating palette vertically

  • Scrolling down from the last color of a column will move forward to the first color of the next column.
  • Scrolling up from the first color of a column will move back to the last color of the previous column.

To navigate horizontally on the palette, you can hold Left Ctrl and:

Navigating palette horizontally

  • Scroll the Mouse Scroll Wheel up to select the color left of the current color.
  • Scroll the Mouse Scroll Wheel down to select the color right of the current color.

Observe the bottom right of your screen. There is the server palette there.

Use your cursor to hover over the color you want and click it.

Selecting a color using the freed mouse cursor on the on-screen palette

Selecting colors and material (advanced)

Hold E for atleast half a second to open the advanced color and material selector. This will also temporarily free your cursor if you have Free Cursor off.

Enlarged painter menu with color, material and material intensity

On the left, you will have the whole palette, enlarged. Click the Left Mouse Button on one of these colors to select them as the current color.

On the right is the material selector and the material intensity slider. You can choose one of the following materials:

  • Plastic material icon Plastic
    No intensity support
  • Glass material icon Glass
    Intensity affects opacity
  • Transparent plastic material icon Transparent Plastic
    Intensity affects opacity
  • Glow material icon Glow
    Intensity affects emission level
  • Metallic material icon Metallic
    Intensity affects roughness
  • Hologram material icon Hologram
    Intensity affects opacity

To adjust the current material intensity, hold the Left Mouse Button on the slider knob and move your mouse up or down to select the material intensity you want for the current selected material. Release the Left Mouse Button when you are done.

When you are done selecting a color, a material or material intensity, simply release E.

Color and material support

Bricks support color, material and material intensity painting.

Entities on the other hand only support color painting.

Object Type Color Material Intensity
Bricks Yes Yes Yes
Entities Yes No No

Painting objects

Hold the Left Mouse Button to start painting objects.

Bricks before painting

Bricks after painting

Release the Left Mouse Button once you are done with painting objects.

Every brick or entity you have painted within the same Left Mouse Button hold period will count as one history (undo/redo) action unless you have the Merge Paint Stroke Undo option disabled.

Painting with material only

Hold Left Ctrl and hold the Left Mouse Button to start painting bricks with material only. Observe how the selected color is blue, but we're only painting the Metallic material.

Bricks before painting with material only

Bricks after painting with material only

While holding Left Ctrl, the Painter will paint both the current material and the current material intensity level, but not the current color.

Release the Left Mouse Button once you are done with painting bricks.

Note

Holding Left Ctrl to paint with material only will not affect how entities are painted. They are still painted with the currently selected color.

Fill painting

To fill paint bricks with the Painter, simply aim at a brick and hold Left Alt then click the Left Mouse Button.

Bricks before fill painting

Bricks after fill painting

Let go of Left Alt once you're done fill painting.

Fill painting is based on brick boundaries. This produces great results for most cases. Provided the bricks' bounding box edges or vertices collide in some way, fill painting will work as shown on the diagram below.

Bricks colliding

Warning

Fill painting does not use brick collision shapes to calculate if a brick's physically touching each other. This may result in edge cases and undesirable behavior where fill painting is applied to several bricks on accident.

Wedges' bounding boxes colliding

Fill painting with material only

To fill paint bricks with the current material and intensity only, aim at a brick, hold Left Ctrl and Left Alt at the same time, then click the Left Mouse Button.

Bricks before fill painting with material only

Bricks after fill painting with material only

Let go of Left Ctrl and Left Alt once you're done fill painting.

Picking colors

Use the Middle Mouse Button on bricks or parts of entities to pick their color, material and intensity.

Observe on the bottom right corner as the current color swatch changes.

Picking colors with the middle mouse button


Configuration

Merge Paint Stroke Undo

Enabled by default. This merges painting of individual bricks or parts of entities into consolidated actions. Disabling this option breaks down painting of individual bricks or parts of an entity into multiple detailed actions.

Note

Undo/redo actions will be split between entities and bricks regardless if the Merge Paint Stroke Undo option is enabled or disabled.

Painting with Merge Paint Stroke Undo on

Painting with Merge Paint Stroke Undo off