🎨 Color#

#bs.color:help

Convert colors to your preferred format.

🔧 Functions#

You can find below all the function available in this module.

Rgb to int#

#bs.color:rgb_to_int

Convert a color from rgb to int.

Inputs
(macro variable) color: array

A 3D vector representing the rgb color (example: [0,255,128]).

Outputs
(storage) bs:out color.rgb_to_int: int

The color as an integer.

Example

Update the color of a leather armor piece using the rgb color format.

# Summon a test subject with a leather helmet
summon minecraft:zombie ~ ~ ~ {ArmorItems:[{},{},{},{id:"minecraft:leather_helmet",Count:1b}]}

# Change the helmet color of all zombie to red
function #bs.color:rgb_to_int {color:[255,0,0]}
execute as @e[type=minecraft:zombie] store result entity @s ArmorItems[3].tag.display.color int 1 run data get storage bs:out color.rgb_to_int

Convert a color from rgb to int.

Inputs
(storage) bs:in color.rgb_to_int.color: array

A 3D vector representing the rgb color (example: [0,255,128]).

Outputs
(storage) bs:out color.rgb_to_int: int

The color as an integer.

Example

Update the color of a leather armor piece using the rgb color format.

# Summon a test subject with a leather helmet
summon minecraft:zombie ~ ~ ~ {ArmorItems:[{},{},{},{id:"minecraft:leather_helmet",Count:1b}]}

# Compute the int representation of a pure red color
data modify storage bs:in color.rgb_to_int.color set value [255,0,0]
function #bs.color:rgb_to_int

# Change the helmet color of all zombie to red
execute as @e[type=minecraft:zombie] store result entity @s ArmorItems[3].tag.display.color int 1 run data get storage bs:out color.rgb_to_int

Convert a color from rgb to int.

Inputs
(scores) $color.rgb_to_int.[r,g,b] bs.in

The 3 vector elements representing the rgb color.

Outputs
(score) $color.rgb_to_int bs.out

The color as an integer.

Example

Update the color of a leather armor piece using the rgb color format.

# Summon a test subject with a leather helmet
summon minecraft:zombie ~ ~ ~ {ArmorItems:[{},{},{},{id:"minecraft:leather_helmet",Count:1b}]}

# Compute the int representation of a pure red color
scoreboard players set $color.rgb_to_int.color.r bs.in 255
scoreboard players set $color.rgb_to_int.color.g bs.in 0
scoreboard players set $color.rgb_to_int.color.b bs.in 0
function #bs.color:rgb_to_int

# Change the helmet color of all zombie to red
execute as @e[type=minecraft:zombie] store result entity @s ArmorItems[3].tag.display.color int 1 run scoreboard players get $color.rgb_to_int bs.out

Input / Output flexibility

All version use the same function tag. It allow to use any input and ouput source you want. For example, you can input the RGB using score and get the output in the storage.

Be careful, if serveral inputs are given, lower priority inputs will be overwritten. Macro variable have the highest priority, then storage and finally score.

If you are searching for the best performances, you can use function bs.color:rgb_to_int/score to bypass flexibility interfaces (but then you only have score input and output).

Credits: theogiraudet, Aksiome

Int to rgb#

#bs.color:int_to_rgb

Convert a color from int to rgb.

Inputs
(macro variable) color: int

The color as an integer.

Outputs
(storage) bs:out color.int_to_rgb: array

A 3D vector representing the rgb color (example: [0,255,128]).

Convert a color from int to rgb.

Inputs
(storage) bs:in color.rgb_to_int.color: int

The color as an integer.

Outputs
(storage) bs:out color.int_to_rgb: array

A 3D vector representing the rgb color (example: [0,255,128]).

Convert a color from int to rgb.

Inputs
(score) $color.int_to_rgb.color bs.in

The color as an integer.

Outputs
(scores) $color.int_to_rgb.[r,g,b] bs.out

The 3 vector elements representing the rgb color.

Example

Get the rgb color of a piece of armor.

# Get the rgb representation of a dropped armor piece
function #bs.color:int_to_rgb with entity @e[type=item,tag=my_armor,limit=1] tag.display

Input / Output flexibility

All version use the same function tag. It allow to use any input and ouput source you want. For example, you can input the RGB using score and get the output in the storage.

Be careful, if serveral inputs are given, lower priority inputs will be overwritten. Macro variable have the highest priority, then storage and finally score.

If you are searching for the best performances, you can use function bs.color:int_to_rgb/score to bypass flexibility interfaces (but then you only have score input and output).

Credits: theogiraudet, Aksiome

💬 Did it help you?

Feel free to leave your questions and feedbacks below!