Skip to content

Color tool

SolidBlock edited this page Sep 7, 2026 · 2 revisions

Left-click to record a color into this item from a block, and right-click a block to apply the color on it.

When left-clicking to record the color of the block, if the picked block is not a custom-colored block, the color will be its map color, which may differ from what it looks, for example, glass is black.

Right-click on a customizable colored block to set its color. If the block is not customizable colored, but has a corresponding custom-colored block in this mod (e.g., stone → colored stone), the block will be converted. When converting to custom-colored blocks, the initial color will be the map color of the original block, so it is normal its color differs from the color presented in custom-colored blocks.

Color tools can have different opacities, color mixture type, and modification amount.

The opacity is controlled by component mishanguc:opacity, where the type is float. Provided in the creative inventory are tools with opacity 0.5, 0.25 and 0.1 with the normal color mixture type.

The color mixture type is controlled by component mishanguc:color_mixture_type, and supports the following values:

  • normal (default): Normally changes block color.
  • random: Randomly sets block color.
  • invert: Sets block color to an opposite color.
  • hue: Set the hue of block color to the hue of a specified color, and saturation and luminosity remains.
  • hue_and_saturation: Set the hue and saturation of block color to hue and saturation of a specified color, and luminosity remains.
  • hue_rotate: Rotates the hue of block color. When using while holding Shift, the rotation will be in an opposite direction.
  • saturation_change: Increases the saturation of block color. When using while holding Shift, the saturation will be decreased.
  • brightness_change: Increases the luminosity of block color. When using while holding Shift, the luminosity will be decreased.

In the inventory, except for normal which provides multiple tools with different opacity, each of the above provides one tool.

Amount of modification applied to color is controlled by component mishanguc:color_change_amount, where the type is float, and is used to specify the amount of modification to hue, saturation or luminosity. In the items in creative inventory, hue rotation amount is 1/24 by default, and saturation and luminosity's modification amount is 0.1 by default.

Note: If you decrease the saturation to 0 (gray) with color tool that modifies saturation, or change the luminosity to 0 (black) or 1 (white) with color tool that modifies luminosity, then the color's hue will be 0 or 1 (red), and saturation will be 0. For example, if you decrease the saturation to 0, and then increase it, it will only be red. If you change luminosity to 0 or 1 and then increase or decrease it, it will be only gray.

The item can be used in Survival Mode and has the durability of 1024. Each usage wears off one durability. Picking color does not wear off durability.

Clone this wiki locally