You'll want to create a file just like one of those that can be found in the
"Data\Exported"
folder (after you've run TIM at least once). I suggest using a plain text editor like Notepad to do this.
The file needs to be placed into the "Data"
folder and named "WotData-Something-YourName-1.csv"
, where "Something" is whatever you want to call your property, and "YourName" is the author's name.
The first few lines in this file should look something like this:
WOT-DATA,2
{{EN}},"This is a description"
{{DE}},"Das ist fantastisch"
ussr-SU-14,School Bus
...
The first line is a header. The next two lines describe this property to the user, in English and in German. Both are optional. The last line actually sets the property; the value for the SU-14 arty is "School Bus".
Note that if SU-14 is the only line in the file then only this one tank will have the property set to something; all other tanks will have it blank. If you want instead to "inherit" most of the values from another property, you can simply specify the name of that property and TIM will grab all the other values from it:
WOT-DATA,2
{{EN}},"This is a description"
{{DE}},"Das ist fantastisch"
{{Inherit}},NameShort/Wargaming
ussr-SU-14,School Bus
...
Note that the name of the property consists of two parts, both coming from the filename: if you named your file "WotData-Something-YourName-1.csv", then this property would be referred to as "Something/YourName".
Another feature of these property files is that you can specify several columns in one file. If you do this, however, you'll have to add a mandatory row, {{ID}}, which gives each column a name:
WOT-DATA,2
{{ID}},ArmorPiercing,HighExplosive
{{EN}},"Price of the armor piercing shells","Price of the high explosive shells"
ussr-SU-14,1234,2345
...
Now you have two values specified. These will show up as separate properties in the property source drop-down! Also, if you want to refer to this property in an {{Inherit}} header (and assuming the file was called "WotData-ShellPrice-MrSmith-1.csv"), you'll now have to write "ShellPrice/ArmorPiercing/MrSmith" and "ShellPrice/HighExplosive/MrSmith". Finally, note that the description row now contains two columns too.
You can have an {{ID}} header with just one column, if you want to.
You don't have to specify both values for each tank. You can simply specify a blank for those columns/tanks where you don't have any data.
One last feature of these data files is that you can specify that a property only has effect starting from a specific game version. Game versions are values like "#466", which was the build ID of version 8.7. If you want a certain value to only apply in game version 8.7 and later, simply add #466 at the end of the line:
WOT-DATA,2
ussr-SU-14,490
ussr-SU-14,500,#466
ussr-SU-14,510,#515
...
Now this property will have a value of 490 if you select a game installation older than 0.8.7, 500 for 8.7 itself and 510 for 8.8 and later. This feature is mostly useful for the "WotBuiltIn-1.csv"
file, but I wanted to document its existence for completeness. This is actually a feature of WotDataLib, and it is conceivable that someone might want to use WotDataLib in a context where old game versions matter more than they do for TIM.