Alteration/Chromatic enchantment

Items with chromatic enchantments can only be altered by live merchants. (They are not compatible with the scroll system.)

Merchants who work on the underlying item may be willing and able to alter items that have this enchantment. However, only a merchant who specializes in this enchantment can add custom colors, change the messaging, or add the enchantment to an item that does not already have it.

Compatibility

This script is compatible with nearly any unscripted, unenchanted item, as long as it makes sense for the material (no color-changing sungold or moonsilver).

It’s also compatible with cambrinth, provided that your design doesn’t imply that the cambrinth is changing colors.

Customization Options

Tap/Look

You can include the color token in the item’s adjective, tap, and/or look.

If using the color as the adjective, it must be the entire adjective, as some colors take up the entire 15 characters. If you have any custom colors that are longer than 15 characters, then the color cannot be used as the adjective.

If your design requires a/an before the name of the color, the script can automatically change the indefinite article to match the current color.

The color counts toward the character limits of the tap (80) and look (500). So make sure you’re within those limits even when the longest color is active. (The longest default color is 15 characters, but custom colors can be longer.)

The color token cannot be capitalized.

If the entire item does not change colors, you can specify the part that does. For example, you could have the “buttons on” your shirt change colors. If specifying a custom component, you will generally need to end with a preposition, because the default messaging is formatted as “the [component] your [item].”

You can also use the item’s previous color in the appear or examine. This allows dual-color items, but there is no way to choose these colors independently. You’ll always see the last two colors that were rubbed or turned. Also, there is no dynamic article support for the old color, so if you are writing a design that uses it, write it in a way that does not need a/an before the color.

Messaging

You can customize the messaging that is displayed when you RUB or TURN your item to change its color. Custom messaging should be primarily chromatic in nature, although the item can briefly emit light.

This messaging cannot exceed 300 characters.

In the messaging, you can reference:

• the old color
• the new color
• the item’s adjective
• the item’s noun
• the item’s appear
• the component that changes colors (if it’s something other than the entire item)
• your name and pronouns (for the messaging shown to other players)

Custom Colors

The number of custom colors that you can add depends on the tier of your item, which you can check by studying.

Tier	Venue	Max Custom Colors
muted	24/7 shops and treasure drops	0
bright	merchant and feeder 4	5
vibrant	Hollow Eve and quest incidentals	7
radiant	quest end prizes	15

It is best to avoid choosing custom colors that are in the list of default colors.