\block
Manages blocks.
\block| Dflt USM Sec Lvl: | admin |
|---|---|
| Dflt Required Tags: | canUseChatCommands |
| Categories: | world, blocks |
| Version: | 0.2.7-alpha.36 |
| Undo Supported: | N/A |
| Functional: | Yes |
| Deprecated: | No |
Syntax ​
\block
\block <block: ({facing}|{^}|~)|x y z> ...
... get color ...... <colorSpace: rgba|rgb> <unit: hex|frac|dec|decr>... <colorSpace: {hsl}|{hsluv}|({hsv}|{hsb})|{hsi}|{hpluv}|{AdobeRGB}|{CIELuv}|{CIExyY}>
... get filllevel... get liquidtype... get waterlogged... get state <stateId: string>... get states... get tags... get component <componentId: {waterContainer}|{lavaContainer}|{snowContainer}|{potionContainer}>
... set color ...... rgba hex <hexRGBAColor: RRGGBBAA|RGBA>... rgba frac <red: float[min=0.0,max=1.0]> <green: float[min=0.0,max=1.0]> <blue: float[min=0.0,max=1.0]> <alpha: float[min=0.0,max=1.0]>... rgba dec <red: int[min=0,max=255]> <green: int[min=0,max=255]> <blue: int[min=0,max=255]> <alpha: int[min=0,max=255]>... rgba decr <red: float[min=0.0,max=255.0]> <green: float[min=0.0,max=255.0]> <blue: float[min=0.0,max=255.0]> <alpha: float[min=0.0,max=255.0]>... rgb hex <hexRGBAColor: RRGGBB|RGB>... rgb frac <red: float[min=0.0,max=1.0]> <green: float[min=0.0,max=1.0]> <blue: float[min=0.0,max=1.0]>... rgb dec <red: int[min=0,max=255]> <green: int[min=0,max=255]> <blue: int[min=0,max=255]>... rgb decr <red: float[min=0.0,max=255.0]> <green: float[min=0.0,max=255.0]> <blue: float[min=0.0,max=255.0]>... hsl <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <lightness: float[min=0.0,max=100.0]>... hsv <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <value: float[min=0.0,max=100.0]>... hsb <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <brightness: float[min=0.0,max=100.0]>... bin <red: binary> <green: binary> <blue: binary>... clear
... set filllevel <fillLevel: int[min=0,max=6]>... debug
Subcommands ​
get color ​
Displays the color of the liquid in the block, only works on cauldrons.
Syntax
get color <colorSpace: {rgba}|{rgb}> <unit: {hex}|{frac}|{dec}|{decr}>
get color <colorSpace: {hsl}|{hsluv}|({hsv}|{hsb})|{hsi}|{hpluv}|{AdobeRGB}|{CIELuv}|{CIExyY}>
Arguments
<colorSpace: {rgba}|{rgb}>: {<string>}
Whether to display the color in the RGB or RGBA color space.
If rgba is specified, the color will include the alpha value.
If rgb is specified, the color will not include the alpha value.
Must be one of the following:
rgbargb
<colorSpace: {hsl}|{hsluv}|({hsv}|{hsb})|{hsi}|{hpluv}|{AdobeRGB}|{CIELuv}|{CIExyY}>: {<string>}
What color space to display the color in.
Must be one of the following:
hslhsluvhsvhsbhsihpluvAdobeRGBCIELuvCIExyY
Note: In this command, hsv and hsb are the same thing.
<unit: {hex}|{frac}|{dec}|{decr}>: {<string>}
What unit to display the rgb/rgba color in.
Must be one of the following:
hex- hexadecimal, ex.#FE932BFFor#FE932Bfrac- fractional, this displays the raw values returned by thefluidColorproperty of theliquidContainercomponent, ex.0.996 0.576 0.168 1.0or0.996 0.576 0.168dec- decimal, this displays the raw values returned by thefluidColorproperty of theliquidContainercomponent multipled by 255 and rounded to the nearest integer, ex.254 147 43 255or254 147 43decr- decimal, this displays the raw values returned by thefluidColorproperty of theliquidContainercomponent multiplied by 255 without rounding, ex.254 147 43 255or254 147 43
get filllevel ​
Displays the fill level of the block, only works on cauldrons. The fill level is a number between 0 and 6, where 0 is empty and 6 is full.
Syntax
get filllevel
set color ​
Sets the color of the liquid in the block, only works on cauldrons.
Syntax
set color rgba hex <hexRGBAColor: RRGGBBAA|RGBA> - Sets the color of the liquid in the block to the specified RGBA hex color.
set color rgba frac <red: float[min=0.0,max=1.0]> <green: float[min=0.0,max=1.0]> <blue: float[min=0.0,max=1.0]> <alpha: float[min=0.0,max=1.0]> - Sets the color of the liquid in the block to the specified RGBA fractional color.
set color rgba dec <red: int[min=0,max=255]> <green: int[min=0,max=255]> <blue: int[min=0,max=255]> <alpha: int[min=0,max=255]> - Sets the color of the liquid in the block to the specified rounded RGBA decimal color.
set color rgba decr <red: float[min=0.0,max=255.0]> <green: float[min=0.0,max=255.0]> <blue: float[min=0.0,max=255.0]> <alpha: float[min=0.0,max=255.0]> - Sets the color of the liquid in the block to the specified unrounded RGBA decimal color.
set color rgb hex <hexRGBAColor: RRGGBB|RGB> - Sets the color of the liquid in the block to the specified RGB hex color.
set color rgb frac <red: float[min=0.0,max=1.0]> <green: float[min=0.0,max=1.0]> <blue: float[min=0.0,max=1.0]> - Sets the color of the liquid in the block to the specified RGB fractional color.
set color rgb dec <red: int[min=0,max=255]> <green: int[min=0,max=255]> <blue: int[min=0,max=255]> - Sets the color of the liquid in the block to the specified rounded RGB decimal color.
set color rgb decr <red: float[min=0.0,max=255.0]> <green: float[min=0.0,max=255.0]> <blue: float[min=0.0,max=255.0]> - Sets the color of the liquid in the block to the specified unrounded RGB decimal color.
set color hsl <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <lightness: float[min=0.0,max=100.0]> - Sets the color of the liquid in the block to the specified HSL color.
set color hsv <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <value: float[min=0.0,max=100.0]>
set color hsb <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <brightness: float[min=0.0,max=100.0]>
set color bin <red: binary> <green: binary> <blue: binary>
set color clear
Arguments
Option: set color rgba hex <hexRGBAColor: RRGGBBAA|RGBA>
<hexRGBAColor: RRGGBBAA|RGBA>: RRGGBBAA or RGBA
The hex color to set the liquid to.
ex. FE932B76 or F927
Option: set color rgba frac <red: float[min=0.0,max=1.0]> <green: float[min=0.0,max=1.0]> <blue: float[min=0.0,max=1.0]> <alpha: float[min=0.0,max=1.0]>
<red: float[min=0.0,max=1.0]>: float
The red component of the color to set the liquid to.
Must be between 0 and 1.
ex. 0.5
<green: float[min=0.0,max=1.0]>: float
The green component of the color to set the liquid to.
Must be between 0 and 1.
ex. 0.5
<blue: float[min=0.0,max=1.0]>: float
The blue component of the color to set the liquid to.
Must be between 0 and 1.
ex. 0.5
<alpha: float[min=0.0,max=1.0]>: float
The alpha component of the color to set the liquid to.
Must be between 0 and 1.
ex. 0.5
Option: set color rgba dec <red: int[min=0,max=255]> <green: int[min=0,max=255]> <blue: int[min=0,max=255]> <alpha: int[min=0,max=255]>
<red: int[min=0,max=255]>: int
The red component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127
<green: int[min=0,max=255]>: int
The green component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127
<blue: int[min=0,max=255]>: int
The blue component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127
<alpha: int[min=0,max=255]>: int
The alpha component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127
Option: set color rgba decr <red: float[min=0.0,max=255.0]> <green: float[min=0.0,max=255.0]> <blue: float[min=0.0,max=255.0]> <alpha: float[min=0.0,max=255.0]>
<red: float[min=0.0,max=255.0]>: float
The red component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127.5
<green: float[min=0.0,max=255.0]>: float
The green component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127.5
<blue: float[min=0.0,max=255.0]>: float
The blue component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127.5
<alpha: float[min=0.0,max=255.0]>: float
The alpha component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127.5
Option: set color rgb hex <hexRGBAColor: RRGGBB|RGB>
<hexRGBAColor: RRGGBB|RGB>: string
The hex color to set the liquid to.
ex. FE932B or F92
Option: set color rgb frac <red: float[min=0.0,max=1.0]> <green: float[min=0.0,max=1.0]> <blue: float[min=0.0,max=1.0]>
<red: float[min=0.0,max=1.0]>: float
The red component of the color to set the liquid to.
Must be between 0 and 1.
ex. 0.5
<green: float[min=0.0,max=1.0]>: float
The green component of the color to set the liquid to.
Must be between 0 and 1.
ex. 0.5
<blue: float[min=0.0,max=1.0]>: float
The blue component of the color to set the liquid to.
Must be between 0 and 1.
ex. 0.5
Option: set color rgb dec <red: int[min=0,max=255]> <green: int[min=0,max=255]> <blue: int[min=0,max=255]>
<red: int[min=0,max=255]>: int
The red component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127
<green: int[min=0,max=255]>: int
The green component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127
<blue: int[min=0,max=255]>: int
The blue component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127
Option: set color rgb decr <red: float[min=0.0,max=255.0]> <green: float[min=0.0,max=255.0]> <blue: float[min=0.0,max=255.0]>
<red: float[min=0.0,max=255.0]>: float
The red component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127.5
<green: float[min=0.0,max=255.0]>: float
The green component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127.5
<blue: float[min=0.0,max=255.0]>: float
The blue component of the color to set the liquid to.
Must be between 0 and 255.
ex. 127.5
Option: set color hsl <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <lightness: float[min=0.0,max=100.0]>
<hue: float[min=0.0,max=360.0]>: float
The hue of the color to set the liquid to.
Must be between 0 and 360.
ex. 180
<saturation: float[min=0.0,max=100.0]>: float
The saturation of the color to set the liquid to.
Must be between 0 and 100.
ex. 50
<lightness: float[min=0.0,max=100.0]>: float
The lightness of the color to set the liquid to.
Must be between 0 and 100.
ex. 50
Option: set color hsv <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <value: float[min=0.0,max=100.0]> or set color hsb <hue: float[min=0.0,max=360.0]> <saturation: float[min=0.0,max=100.0]> <brightness: float[min=0.0,max=100.0]>
_BE2.png){kind=icon}
This syntax option describes a planned feature.
It has not appeared in any development versions yet, but is planned to be included in a future update.
<hue: float[min=0.0,max=360.0]>: float
The hue of the HSV/HSB (hue, saturation, value/brightness) color to set the liquid to.
Must be between 0 and 360.
ex. 180
<saturation: float[min=0.0,max=100.0]>: float
The saturation of the HSV/HSB (hue, saturation, value/brightness) color to set the liquid to.
Must be between 0 and 100.
ex. 50
<value: float[min=0.0,max=100.0]>: float or <brightness: float[min=0.0,max=100.0]>: float
The value/brightness of the HSV/HSB (hue, saturation, value/brightness) color to set the liquid to.
Must be between 0 and 100.
ex. 50
Option: set color bin <red: binary> <green: binary> <blue: binary>
This syntax option describes a planned feature.
It has not appeared in any development versions yet, but is planned to be included in a future update.
<red: binary>: binary
The red component of the color to set the liquid to.
Must be a binary number between 0 and 11111111 (0 and 255 in decimal).
ex. 10110101 (181 in decimal)
<green: binary>: binary
The green component of the color to set the liquid to.
Must be a binary number between 0 and 11111111 (0 and 255 in decimal).
ex. 10110101 (181 in decimal)
<blue: binary>: binary
The blue component of the color to set the liquid to.
Must be a binary number between 0 and 11111111 (0 and 255 in decimal).
ex. 10110101 (181 in decimal)
set filllevel ​
Sets the fill level of the liquid in the block to the specified value.
Syntax
set filllevel <fillLevel: int[min=0,max=6]>
Arguments
<fillLevel: int[min=0,max=6]>: int
The fill level of the liquid in the block to set.
Must be between 0 (empty) and 6 (full).
ex. 3
debug ​
This section describes a planned feature.
It has not appeared in any development versions yet, but is planned to be included in a future update.
Displays debug information about the block.
Examples ​
- Set the color of the water in the cauldron you are looking at to #87CEEB:
\block facing set color rgba hex 87CEEBFF
- Refill the liquid in the cauldron you are looking at:
\block facing set filllevel 6
Result ​
| Command | Trigger | Result | |
|---|---|---|---|
Any | The command is incomplete, or any argument is not specified correctly. | Unparseable | |
Any | You specified `block`, `^`, or `~` for the block parameter, and you are not facing a block. | Failed | |
| Any | Otherwise | Successful | |
History ​
| Debug Sticks | |||||||
|---|---|---|---|---|---|---|---|
| v1.24.0 | release | Added | |||||