readme.txt for ballcaps folder
------------------------------

Ballcap texture
---------------

Whenever a ballcap is "painted" for the first time when starting a new game or changing the ballcap design, the game creates a texture based on one of the templates (default_ballcap_texture_*.png), which you can find in the folder /data/ballcaps. Don't change those files!

If you want to create customized textures for certain teams, do the following:

- go to folder /data/ballcaps
- make a copy of one of the default ballcap template files
- rename the copy to caps_TEAMNAME_TEAMNICKNAME.png (change TEAMNAME and TEAMNICKNAME to your team's names)
Remove all dots in the team name and nickname, and replace all spaces with underlines.
- edit the file as you like.

You can leave the new ballcap texture file in the folder (/data/ballcaps). This will allow all new leagues you create in OOTP to use the texture for a team with the same name. 

Or, if you prefer to use the texture in a single save only, then move the file to that league's save folder (/data/saved_games/GAMENAME/ballcaps). Then only teams in only that saved game will use the new texture.

When the game looks for a texture, it will first look in the league folder and use a texture file if it exists. If there is no file, it will look into the global folder (/data/ballcaps) and if it finds a texture file for the team there, it will be copied into the league folder and used from there in the future.
If no file is found at all, the game will load one randomly selected template file (/data/ballcaps/default_ballcap_texture_*.png) and "paint" the texture using the team colors.

The 5 five segments are used as followed:
1. top left: the lower side of the visor
2. below that the front part of the cap
3. right of that the upper side of the visor
4. the two parts at the bottom are the right and left side of the cap, which together also form the back of the cap
5. the circle is the knob on top of the cap

Ballcap logo file + individual colors
-------------------

If there is a file named caps_logo_TEAMNAME_TEAMNICKNAME.png (remove all dots in the team name and nickname, and replace all spaces with underlines) in /data/ballcaps, it will be used as the logo for the caps of that team when starting a new game. Otherwise the secondary (small) team logo is used. If it's not present the main team logo will be used.

You can define 3 colors for the ballcap (main, visor, stripes) in the team settings in the game. You can also add the color information (red green blue channels per color) to the caps logo file. 

Without color code prefixes (see below) the number of color codes in the filename can be between 0 and 2, all for the home ballcap. Just add the 6 character (2 per channel, 00-FF, HEX) or 9 characters (3 per channel, 000-255, RGB) color codes for each color (main, visor) like this:

caps_logo_TEAMNAME_TEAMNICKNAME_FFFFFF_000000_sometext.png (change TEAMNAME and TEAMNICKNAME to your team's names)
FFFFFF will be the main color. It's the color code for white color.
000000 will be the visor color. It's the color code for black color.

caps_logo_TEAMNAME_TEAMNICKNAME_255255255_000000000_sometext.png (change TEAMNAME and TEAMNICKNAME to your team's names)
255255255 will be the main color. It's the color code for white color.
000000000 will be the visor color. It's the color code for black color.

"sometext" is optional and can be any text, like your name or the name of the logo set or whatever, it will be ignored by the game.

While adding only up to 2 color codes (as described above) will affect only the home ballcap, starting with OOTP 23 more color codes can be defined in the filename:

Ballcap main color		C1H	C1A
Ballcap visor color		C2H	C2A
Ballcap pin stripes color	C3H	C3A

"H" will change home ballcap and "A" the away ballcap colors. All 6 colors can be defined in the filename in any order.
These prefixes should be added before the color codes, followed by 6 characters (00-FF, HEX) or 9 characters (000-255, RGB) color codes:

caps_logo_TEAMNAME_TEAMNICKNAME_C2A112233_C3H334455_C1A889900_sometext.png (change TEAMNAME and TEAMNICKNAME to your team's names)
Away ballcap visor color will be changed to 112233 (HEX color code), home ballcap stripes color to 334455 and away ballcap main color to 889900.

HEX and RGB color codes can be mixed in the filename. If defining the same color twice the last color code will be used.
Other prefixes will be ignored when loading ballcap logo file.

See /data/logos/_readme.txt for more details.


Alternate uniforms properties
-------------------

Besides colors for home and away ballcaps it is now also possible to specify colors codes and other properties in the filenames of alternate uniform textures.

The scheme is:

caps_TEAMNAME_TEAMNICKNAME_ALTERNATEUNIFORMNAME__WEEKDAYS_HA-SWITCHES_COLOR1_COLOR2_COLOR3.png

where

TEAMNAME		is the name of the team.
TEAMNICKNAME		is the nickname of the team.
ALTERNATEUNIFORMNAME	is the name of the alternate uniform.
WEEKDAYS 		are the weekdays the selected uniform will be used. 3 letter per day (Mon, Tue, Wed, Thu, Fri, Sat, Sun), can be specified individually: MonSun, in a range: Mon-Fri, Sun-Tue, or both: Wed-SatMon. The order does not matter.
HA-SWITCHES		set "h" to use the selected uniform for home games, "a" for away games, both "ha" for home and away games, or leave it blank to not change the existing options.
COLOR1-3		are the max. 3 colors of the ballcap in HEX (6 characters, 3x 00-FF) or RGB (9 characters, 3x 000-255) color codes. No prefixes are needed that are used in logo filename (C1H etc.). First color will change ballcap main color, second the visor color and third the pin stripes color in that order.

Note the double underscore ("__") after the name of the alternate uniform. This is needed as both the team name and uniform name can consist of several words.
As the home-away switches and weekdays are a uniform (contains ballcap, jersey, pants ...) property, changing these values when loading a ballcap texture will change it also for other items (jersey, pants ...) of this uniform.
All codes and names are optional. The codes will be parsed and used while loading a texture through the uniforms dialog in the game only when a double underscore ("__") is found in the filename.


Examples: 

- caps_city_nickname_alt_123__Fri-MonSun_h_ff4422_007755.png		when loading this texture the selected uniform will be changed to be worn on Friday, Saturday, Sunday and Monday for home games. Ballcap main color will be changed to ff4422 and visor color to 007755, pin stripes color will remain the same.
- something__TueThu.png							when loading this texture the selected uniform will be changed to be worn on Tuesday and Thursday, home-away options will remain the same, colors stay unchanged.
- caps_city_alt__Wed_ha_123123123.png					when loading this texture the selected uniform will be changed to be worn on Wednesday for home and away games. Ballcap main color will be changed to 123123123.

Note that theses codes will not be parsed when automatically load/update uniforms through an XML file, see /data/colors/_readme.txt for more details.