Custom Colors#

Custom Colors define the colors for various particles, fogs, and miscellanea.

Based on the configuration for MCPatcher’s Custom Colors mod.

Location

/assets/minecraft/optifine/color.properties

_images/icon7.png

Different colored potions#

Values only need to be provided for the properties that need to be changed.

_images/settings5.png

Button and tooltip for the option, found in Video Settings ➔ Quality#

The default Minecraft values for each property are given below for convenience.

Note

All property names are case-sensitive

Note

All colors are in hexadecimal RGB (red, green, blue) format, 000000 to ffffff

Note

All paths are relative to assets/minecraft unless otherwise stated

Particles#

Key

Meaning

Default

particle.water

Base water particle color (splashes, bubbles, drops).
Biome water color multiplier is applied to this value
The value should match the color of the resource pack’s base water texture
If the base water texture is grey, in which coloring is via misc/watercolor#.png, this should be set to ffffff

334cff

particle.portal

Base portal particle color.
A random multiplier between 0.4 and 1.0 is applied to all three R, G, B values

ff4ce5

Dimensions#

Key

Meaning

Default

fog.nether

Fog used in the Nether dimension

330707

fog.end

Fog used in The End dimension

181318

sky.end

Color of the sky in The End dimension

282828

Lilypads#

Key

Meaning

Default

lilypad

Single color, used across all biomes

208030

Potion effects#

Final color is the average of these colors, weighted by the level of each potion effect.

Note

potion.water is a plain bottle of water

Key

Default

potion.absorption

2552a5

potion.blindness

1f1f23

potion.confusion

551d4a

potion.damageBoost

932423

potion.digSlowDown

4a4217

potion.digSpeed

d9c043

potion.fireResistance

e49a3a

potion.harm

430a09

potion.heal

f82423

potion.healthBoost

f87d23

potion.hunger

587653

potion.invisibility

7f8392

potion.glowing

94a061

potion.jump

786297

potion.levitation

ceffff

potion.luck

339900

potion.moveSlowdown

5a6c81

potion.moveSpeed

7cafc6

potion.nightVision

1f1fa1

potion.poison

4e9331

potion.regeneration

cd5cab

potion.resistance

99453a

potion.saturation

f82423

potion.unluck

c0a44d

potion.waterBreathing

2e5299

potion.weakness

484d48

potion.wither

352a27

potion.water

385dc6

Spawner egg colors#

Key

Meaning

Default

egg.shell.<entity>

Change the color of the shell of the egg

None

egg.spots.<entity>

Change the color of the spots on the egg

None

<entity> controls what spawn egg the colors apply to Colons must be escaped: egg.spots.minecraft\:creeper=000000”, “None

Map colors#

Block map colors#

Key

Meaning

Default

map.air

Void, unrendered blocks

000000

map.grass

Grass block

7fb238

map.sand

Yellow sand

f7e9a3

map.cloth

Any wool

c7c7c7

map.tnt

TNT block

ff0000

map.ice

Ice, packed ice, blue ice

a0a0ff

map.iron

Iron blocks

a7a7a7

map.foliage

Grass, tall grass, flowers, ferns

007c00

map.clay

Clay

a4a8b8

map.dirt

Dirt, coarse dirt, rooted dirt

976d4d

map.stone

Stone

707070

map.water

Water source, water flowing

4040ff

map.wood

Any planks

8f7748

map.quartz

Any quartz block

fffcf5

map.gold

Gold block

faee4d

map.diamond

Diamond block

5cdbd5

map.lapis

Lapis block

4a80ff

map.emerald

Emerald block

00d93a

map.obsidian

Obsidian block

815631

map.netherrack

Netherrack block

700200

General map colors#

Key

Default

map.white

ffffff

map.orange

d87f33

map.magenta

b24cd8

map.light_blue

6699d8

map.yellow

e5e533

map.lime

7fcc19

map.pink

f27fa5

map.gray

4c4c4c

map.light_gray

999999

map.cyan

4c7f99

map.purple

7f3fb2

map.blue

334cb2

map.brown

664c33

map.green

667f33

map.red

993333

map.black

191919

Terracotta map colors#

Key

Default

map.white_terracotta

d1b1a1

map.orange_terracotta

9f5224

map.magenta_terracotta

95576c

map.light_blue_terracotta

706c8a

map.yellow_terracotta

ba8524

map.lime_terracotta

677535

map.pink_terracotta

a04d4e

map.gray_terracotta

392923

map.light_gray_terracotta

876b62

map.cyan_terracotta

575c5c

map.purple_terracotta

7a4958

map.blue_terracotta

4c3e5c

map.brown_terracotta

4c3223

map.green_terracotta

4c522a

map.red_terracotta

8e3c2e

map.black_terracotta

251610

Nether map colors#

Key

Default

map.crimson_nylium

bd3031

map.crimson_stem

943f61

map.crimson_hyphae

5c191d

map.warped_nylium

167e86

map.warped_stem

3a8e8c

map.warped_hyphae

562c3e

map.warped_wart_block

14b485

Map aliases#

  • map.snow: map.white

  • map.adobe: map.orange

  • map.silver: map.light_gray

  • map.lightBlue: map.light_blue

Sheep colors#

Key

Default

sheep.white

e6e6e6

sheep.orange

ba6015

sheep.magenta

953a8d

sheep.light_blue

2b86a3

sheep.yellow

bea22d

sheep.lime

609517

sheep.pink

b6687f

sheep.gray

353b3d

sheep.light_gray

757571

sheep.cyan

107575

sheep.purple

66258a

sheep.blue

2d337f

sheep.brown

623f25

sheep.green

465d10

sheep.red

84221c

sheep.black

151518

Sheep aliases#

  • sheep.silver: sheep.light_gray

  • sheep.lightBlue: sheep.light_blue

Animal collar colors#

Key

Default

collar.white

f9fffe

collar.orange

f9801d

collar.magenta

c74ebd

collar.light_blue

3ab3da

collar.yellow

fed83d

collar.lime

80c71f

collar.pink

f38baa

collar.gray

474f51

collar.light_gray

9d9d97

collar.cyan

169c9c

collar.purple

8932b8

collar.blue

3c44aa

collar.brown

835432

collar.green

5e7c16

collar.red

b02e26

collar.black

1d1d21

Collar aliases#

  • collar.silver: collar.light_gray

  • collar.lightBlue: collar.light_blue

Dye colors#

Base color for banners, beacon beam, tropical fish, wolf and cat collars

Key

Default

dye.white

f9fffe

dye.orange

f9801d

dye.magenta

c74ebd

dye.light_blue

3ab3da

dye.yellow

fed83d

dye.lime

80c71f

dye.pink

f38baa

dye.gray

474f52

dye.light_gray

9d9d97

dye.cyan

169c9c

dye.purple

8932b8

dye.blue

3c44aa

dye.brown

835432

dye.green

5e7c16

dye.red

b02e26

dye.black

1d1d21

Dye aliases#

  • dye.silver: dye.light_gray

  • dye.lightBlue: dye.light_blue

Text colors#

Miscellaneous#

Key

Meaning

Default

text.xpbar

Experience bar number color

80ff20

text.boss

“Boss Health” text color

ff00ff

text.sign

Sign text color by default

000000

Color codes#

Note

Colors below text.code.15 are for text shadows, if enabled in options

Key

Default

text.code.0

000000

text.code.1

0000aa

text.code.2

00aa00

text.code.3

00aaaa

text.code.4

aa0000

text.code.5

aa00aa

text.code.6

ffaa00

text.code.7

aaaaaa

text.code.8

555555

text.code.9

5555ff

text.code.10

55ff55

text.code.11

55ffff

text.code.12

ff5555

text.code.13

ff55ff

text.code.14

ffff55

text.code.15

ffffff

text.code.16

000000

text.code.17

00002a

text.code.18

002a00

text.code.19

002a2a

text.code.20

2a0000

text.code.21

2a002a

text.code.22

2a2a00

text.code.23

2a2a2a

text.code.24

151515

text.code.25

15153f

text.code.26

153f15

text.code.27

153f3f

text.code.28

3f1515

text.code.29

3f153f

text.code.30

3f3f15

text.code.31

3f3f3f

Resource loading screen#

Key

Meaning

Default

screen.loading

Background color

ffffff

screen.loading.bar

Loading bar background color

ffffff

screen.loading.outline

Loading bar outline color

000000

screen.loading.progress

Loading bar foreground color

e22837

screen.loading.blend

Logo blending mode
Where src, dst, dstA, dstB (in order) are one of:
ZERO, ONE, SRC_COLOR, ONE_MINUS_SRC_COLOR, DST_COLOR, ONE_MINUS_DST_COLOR, SRC_ALPHA, ONE_MINUS_SRC_ALPHA, DST_ALPHA, ONE_MINUS_DST_ALPHA, SRC_ALPHA_SATURATE

None

Other options#

Key

Meaning

Default

clouds

Overrides cloud type
Must be one of: fast, fancy, none

Player-set

xporb.time

Experience orb animation duration, in milliseconds

628

Complete file list#

Below is a full list of files used by Custom Colors.

Note

~ is shorthand for the OptiFine folder (assets/minecraft/optifine)

Key

Meaning

~/color.properties

This file

~/colormap/redstone.png

16 × 1 redstone colors (0: fully off, 15: fully on)

~/colormap/pumpkinstem.png

8 × 1 pumpkin stem colors (0: sprout, 7: fully grown)

~/colormap/melonstem.png

8 × 1 melon stem colors (0: sprout, 7: fully grown)

~/colormap/lavadrop.png

T × 1 lava drop colors (T: age of particle in ticks)

~/colormap/myceliumparticle.png

Any size, random mycelium particle colors

~/colormap/xporb.png

Any size, array of experience orb colors

~/colormap/durability.png

Any size, array of item durability colors

~/colormap/swampgrass.png

256 × 256 swamp grass color palette

~/colormap/swampfoliage.png

256 × 256 swamp foliage color palette

~/colormap/pine.png

256 × 256 spruce tree color palette

~/colormap/birch.png

256 × 256 birch tree color palette

~/colormap/water.png

256 × 256 water color palette

~/colormap/underwater.png

256 × 256 underwater color

~/colormap/underlava.png

256 × 256 underlava color

~/colormap/fog0.png

256 × 256 fog color for the overworld

~/colormap/sky0.png

256 × 256 sky color for the overworld

~/lightmap/world0.png

N × 32 or N × 64 overworld lighting palettes

~/lightmap/world-1.png

N × 32 or N × 64 Nether lighting palettes

~/lightmap/world1.png

N × 32 or N × 64 End lighting palettes

Custom biome palettes#

Note

This setting does not affect the vanilla foliage and grass colormaps in assets/minecraft/textures/colormap

Note

This setting can be overridden per-colormap in each individual properties file in ~/colormap/custom

Custom biome palettes may be assigned to any standard block (one that does not already have its own special color multiplier method). Each custom colormap should have a properties file in ~/colormap/custom.

In Vanilla Minecraft, the grass and leaf textures vary in color depending on the climate of the surrounding biome. This is controlled by two files:

  1. assets/minecraft/textures/colormap/grass.png

  2. assets/minecraft/textures/colormap/foliage.png

Each file is a 256×256 colormap applied to the base grass or leaf texture (which is usually grey).


🆚️ This documentation assumes the latest OptiFine version. Notes are not made for legacy versions (1.8).
🔙️ This documentation is updated to commit 8410499f.
©️ This file is offered without any copyright restrictions. Please copy and modify it to suit your needs. Credit is optional, but appreciated.