From Starbounder - Starbound Wiki
Jump to: navigation, search
An example of armor dye
Dyeing is the process of recoloring armor using dye.[1] All dyes are craftable and can be removed using a Dye Remover, which will restore the armor to its default coloring.

To use dye pick it up and right-click on the item. If the item is dyeable it will change colour appropriately, both on the inventory icon and in game.

Colors available:

Internal Functions

Note: This technical section pertains to modding!

An example of how clothing is saved internally (left), how it is viewed in-game (centre), and how it is viewed when dyed red (right). Note how the shoes stay the same colour throughout all three pictures.

A dye works as an augment, applying a permanent status to a specified item when used. However, the dyes themselves do not recolour the item. Instead, the item itself has a section of code in their ".head", ".legs", ".chest", or ".back" JSON file, which tells the game what colour pixels to replace with other colours when the dye is applied.

In the game's files, the clothing and clothing icons themselves are not stored in the colour values you see in-game. Instead, all pixels that are to be affected when dye is applied are stored in the following four colours as hexidecimal code:

Light Tan (#ffca8a), Dark Tan (#e0975c), Light Brown (#a85636), and Dark Brown (#6f2919)

When a dye such as, for example, Red Dye is applied to an item, these hexidecimal colour values are replaced with other hexidecimal colour values. What colour replaces the default tans and browns are defined in the item file itself. Any colour not defined in said file will not be recoloured.


  1. http://playstarbound.com/a-brief-look-at-what-weve-been-working-on-this-week/
Armor & Costume Dyes
Black DyeBlue DyeBrown DyeDye RemoverGreen DyeGrey DyeOrange DyePink DyePurple DyeRed Dye
White DyeYellow Dye