Development:Color XML

From The Mana World
(Redirected from User:Jaxad0127/Color files)

Color files are files that specify colors that can be used for various purposes. The colors specified in these files are suited for use in Image dyeing and other purposes.

Structure

Color files are in XML format.

<colors>

This is the root element of the file.

<color>

And individual color. Colors have ids, names, and values. The id is the value used to identify the color. The name is a description for the user. The value is the information used by the code. Example (these are the current hair colors):

<colors>
    <color id="0" name="Light Red" value="#8c4b41,da9041,ffffff"/>
    <color id="1" name="Green" value="#06372b,489e25,fdedcc"/>
    <color id="2" name="Red" value="#5f0b33,91191c,f9ad81"/>
    ...
</colors>

Usage

Item Database

In the item database, item elements reference the color files. Example:

<item id="-1" type="hairsprite" colors="colors_hairstyles.xml">
    <sprite gender="male">hairstyle1-male.xml</sprite>
    <sprite gender="female">hairstyle1-female.xml</sprite>
</item>

When the server sends a dyed item, it also sends the color id to use. The client adds the color name to the item name (turning "Cotton Shirt" to "Red Cotton Shirt" for a color named "Red").