Kit Guide

Overview
Important notes

FastDL on server

If you want to use custom assets on your dedicated server you need a fastdl setup on a webserver, because sending the files to players directly through the game server is extremely slow.

To enable custom assets on your server or to test them locally open 'iosoccer\cfg\autoexec.cfg' and change `svcustomassets 0` to `svcustomassets 1`.

If you expose your listen server to the internet for other players to join you should change the value back to 0 when you're done testing.

Unique folder names

Once you've published an asset you MUST use a different folder name for updates for that asset (e.g. \_v2). The game only checks by file name if an asset file already exists on the player's PC. If you update the asset without using a different folder name (even if it's just for fixing a typo), the players who have the old version of your asset will never get the new version.

Official files are exempt from this rule because they are updated directly through Steam.

Texture formats

Please closely follow the guidelines for texture formats and dimensions listed in this guide. Using wrong formats can result in much bigger file sizes taking longer to download for players.

Team kit

Files
'iosoccer\materials\models\player\custom\teamkits\{team}{kit}{author}': Path to team kit
'keeper.vtf': Keeper texture
'kitdata.txt': Metadata
'outfield.vtf': Outfield texture
'teamcrest.vtf': Team crest texture
`shirtandshortsfrontnumber\_atlas.tga [optional]`: Custom font bitmap for shirt and shorts front number
`shirtandshortsfrontnumber\_atlas.txt [optional]`: Custom font atlas for shirt and shorts front number
`shirtbackname\_atlas.tga [optional]`: Custom font bitmap for shirt back name
`shirtbackname\_atlas.txt [optional]`: Custom font bitmap for shirt back name
`shirtbacknumber\_atlas.tga [optional]`: Custom font bitmap for shirt back number
`shirtbacknumber\_atlas.txt [optional]`: Custom font bitmap for shirt back number

kitdata.txt example

Folder: 'iosoccer\materials\models\player\custom\teamkits\superstarsaway1718nicelad'

KitData
{

```
   Name			"Away 17/18"
   Author			"Nicelad"
   Tags			"ISC 17, cup"	  // [Optional] Separate tags by commas

```

```
   PrimaryColor 		"88 191 217 255"  // Red Green Blue Alpha
   SecondaryColor 		"255 255 255 255"

```

```
   Team
   {
       Code 			"STARS"
       ShortName 		"Stars"
       LongName 		"Superstars"
       IsClub 			1		// 0: National team | 1: Club
       IsReal 			0		// 0: Real team | 1: Made up team
       FifaCountryCode 	"ENG"		// [Optional] Home country of the club
   }

```

```
   Outfield
   {
       HasCollar		1	// [Optional] 0: Collar off | 1: Collar on

```

```
       ShirtName
       {
           FillColor 		"0 0 0 255"
           OutlineColor	"255 255 255 255"
           HorizontalOffset 	0		// -: Move name left | +: Move name right
           VerticalOffset 	0		// -: Move name down | +: Move name up
       }

```

```
       ShirtBackNumber
       {
           FillColor 		"0 0 0 255"
           OutlineColor	"255 255 255 255"
           HorizontalOffset 	0
           VerticalOffset 	0
       }

```

```
       ShortsNumber
       {
           IsOnRightLeg	0
           FillColor 		"255 255 255 255"
           OutlineColor	"255 255 255 255"
           HorizontalOffset 	0
           VerticalOffset 	0
       }

```

```
       ShirtFrontNumber		// [Optional] Usually only for national teams
       {
           FillColor 		"0 0 0 255"
           OutlineColor	"255 255 255 255"
           HorizontalOffset 	0
           VerticalOffset 	0
       }
   }

   Keeper
   {
       HasCollar	        1

       ShirtName
       {
           FillColor 		"0 0 0 255"
           OutlineColor	"0 0 0 255"
           HorizontalOffset 	0
           VerticalOffset 	0
       }

```

```
       ShirtBackNumber
       {
           FillColor 		"0 0 0 255"
           OutlineColor	"0 0 0 255"
           HorizontalOffset 	0
           VerticalOffset 	0
       }

```

```
       ShortsNumber
       {
           IsOnRightLeg	0
           FillColor 		"0 0 0 255"
           OutlineColor	"0 0 0 255"
           HorizontalOffset 	0
           VerticalOffset 	0
       }

```

```
       ShirtFrontNumber
       {
           FillColor 		"0 0 0 255"
           OutlineColor	"255 255 255 255"
           HorizontalOffset 	0
           VerticalOffset 	0
       }
   }

```

}

Textures

To edit the textures use Photoshop or any other software that can properly handle .psd files (GIMP might have issues with it).

Use VTFEdit[nemesis.thewavelength.net] to convert your textures to VTF.

All

Import settings:

[img]https://i.imgur.com/xYEgP14.png[/img]
[img]https://i.imgur.com/zRdgOGj.png[/img]

Kit

Template: https://drive.google.com/file/d/0B7WcU1X8aDdlS0Vscl8wVE5DYWs/view?usp=sharing

Source format: 24 bit .tga (RGB, 3 channels)

Import settings:

[img]https://i.imgur.com/u8kMkYk.png[/img]

Team crest

Bayern[/i]Munich#/media/File:LogoFCBayern\_M%C3%BCnchen.svg]b]Template:[/b] Visit a team's Wikipedia page to get a high quality team crest like [this[/url]Source format: 32 bit .tga (RGB + Alpha, 4 channels)Import settings:[img]https://i.imgur.com/wocKkrs.png[/img]VTF flags:[img]https://i.imgur.com/nnvstyq.png[/img]
Shoes
Template: https://drive.google.com/file/d/0B7WcU1X8aDdlZkhVdUV4RHUtWGM/view?usp=sharingSource format: 24 bit .tga (RGB, 3 channels)Import settings:[img]https://i.imgur.com/Jc3jynE.png[/img]
Keeper gloves
Template: https://drive.google.com/file/d/0B7WcU1X8aDdlRzBpZ1huejZ0ZEU/view?usp=sharingSource format: 24 bit .tga (RGB, 3 channels)Import settings:[img]https://i.imgur.com/Jc3jynE.png[/img]
Model Viewer
Model viewer is a really useful tool to view your created skins on the IOS model.[img]https://i.imgur.com/QSMEq2v.png[/img]Setting up model viewer is simple following [url]these easy steps.[en.wikipedia.org]

Kit name and number fonts

You can create a font atlas texture to use a custom typeface on your kit.

Tool

Download and install version 1.13 of AngelCode's Bitmap Font Generator at http://www.angelcode.com/products/bmfont/.

Configuration
Download and extract the configuration files at https://drive.google.com/file/d/0B7WcU1X8aDdlU1Z6WFZ3ZkFROEE/view?usp=sharing.

Workflow
1. Open Bitmap font generator
1. Menu: Options → Load configuration -> name.bmfc (or number\_back.bmfc or number\_front.bmfc):

* Automatically sets the legal characters for the name or number

1. Menu: Options → Font Settings:

* Select your font here and play around with the height and outline thickness settings

1. Menu: Options → Visualize:

* Preview the font characters

1. Menu: Options → Save configuration as...:

* Save your font settings

1. Menu: Options → Save bitmap font as...:

* "shirtbackname\_atlas" for name fonts
* "shirtbacknumber\_atlas" for back number fonts
* "shirtandshortsfrontnumber\_atlas" for shirt and short front number fonts

1. Rename the ".fnt" file extension to ".txt" (e.g. "shirtbackname\_atlas.fnt" → "shirtbackname\_atlas.txt")
1. Remove the "\_0" part of the ".tga" (e.g. "shirtbacknameatlas0.tga" → "shirtbackname\_atlas.tga")
1. Copy the generated ".fnt" and ".tga" files to your team kit folder (next to kitdata.txt)

Important: If the program generates more than one ".tga" file (e.g. "\_1.tga"), you have to increase the width a