# Enhanced Color Selection for Farming Simulator 25 (by w33zl)

Using this mod you can add new colors that are globally available in the game:
A) Additional default pre-defined colors, available everwhere where default colors are enabled (or always if using the Unlimited Color Configurations mod)
B) Additional default custom colors, available everwhere where default colors are enabled (or always if using the Unlimited Color Configurations mod)
C) Additional rim colors, available on any vehicles with one or more rim color Configurations defined
D) Additional colors available for other mods, e.g. you can define custom colors that you can the reference from other mods
E) You can even overwrite an existing color template defined by the base game by simply adding a new template with the same name (e.g. "RIM_DEFAULT")


##[ GENERAL INSTRUCTIONS ]#####################################################

1. Extract the mod zip archive to the mods folder
   - The newly extracted 'FS25_EnhancedColorSelection' folder is from now on referred to as 'working folder'
2. Prepare your color(s), use one of these methods or a combination of both, the choice is yours:
   1. Define your own custom color (see section '2.1. Create custom color')
   2. Use any of the hundreds of existing brand colors found in the 'data\shared\brandMaterialTemplates.xml' file
3. [optional] Add color to default colors table (see section '3. Add default color')
4. [optional] Add color to rim colors table (see section '4. Add rim color')
5. If desired, you can compress the contents of the 'FS25_EnhancedColorSelection' folder to a zip archive again, and then delete the working folder
   -  While optional in general, this step is -mandatory- if you want to use the mod in multiplayer
6. Enjoy your new colors


##[ 2.1. CREATE CUSTOM COLOR ]#################################################

1. Follow the instructions found in the 'General Instructions' section
2. Edit the 'modDesx.xml' file in the working folder
3. Create a new <template name="YOUR_COLOR_NAME" /> node in the <materialTemplates> section
4. Save 'modDesx.xml'

Note: this new color is now available for other mods to use, and if you want to apply it to most vehicles in the game, follow the instruction in section '3. Add default color' or '4. Add rim color'.

Example of a custom color in 'modDesc.xml':
    <modDesc>
        ...
        <materialTemplates>
            ...
            <template name="PITCH_BLACK" title="This is pure black" colorScale="0 0 0" parentTemplate="calibratedGlossPaint" />
        </materialTemplates>
    </modDesc>


##[ 3. ADD DEFAULT COLOR ]#####################################################

Using this method you can either add your own custom color or add any of the already existing hundreds of pre-defined colors in the game to be available in the default colors selection for vehicles.

1. Follow the instructions found in the 'General Instructions' section
2. Edit the 'EnhancedColorSelection.lua' file in the working folder
3. Add a new row at the end of the Lua table 'DEFAULT_BASEGAME_COLORS' (just above the line '}' ending the table) using the name of the desired color wrapped in double quotations marks ("") and ending the line with a comma (','), e.g: "YOUR_COLOR_NAME",
5. Save 'EnhancedColorSelection.lua'

Example of Lua table before adding your custom color:
    local DEFAULT_BASEGAME_COLORS = {
        "PITCH_BLACK",
        "VOLVO_YELLOW1",
        "VOLVO_BM_RED1",
    } -- >> note: add your own default colors above this line <<

Example of Lua table after adding your custom color:
    local DEFAULT_BASEGAME_COLORS = {
        "PITCH_BLACK",
        "VOLVO_YELLOW1",
        "VOLVO_BM_RED1",
        "YOUR_COLOR_NAME",
    } -- >> note: add your own default colors above this line <<


##[ 4. ADD RIM COLOR ]#####################################################

Using this method you can either add your own custom color or add any of the already existing hundreds of pre-defined colors in the game to be available in the rim colors selection for vehicles.

1. Follow the instructions found in the 'General Instructions' section
2. Edit the 'EnhancedColorSelection.lua' file in the working folder
3. Add a new row at the end of the Lua table 'ADDITIONAL_RIM_COLORS' (just above the line '}' ending the table) using the name of the desired color wrapped in double quotations marks ("") and ending the line with a comma (','), e.g: "YOUR_COLOR_NAME",
5. Save 'EnhancedColorSelection.lua'

Example of Lua table before adding your custom color:
    local ADDITIONAL_RIM_COLORS = {
        "RIM_ALUMINUM_POLISHED",
        "KUBOTA_ORANGE1"
    } -- >> note: add your own rim colors above this line <<

Example of Lua table after adding your custom color:
    local ADDITIONAL_RIM_COLORS = {
        "RIM_ALUMINUM_POLISHED",
        "KUBOTA_ORANGE1"
        "YOUR_COLOR_NAME",
    } -- >> note: add your own rim colors above this line <<



