Messages

Conversion tools:
www.kartracing-pro.com/?page=downloads

Track tools:
www.kartracing-pro.com/?page=downloads

Track creation and integration manual:
http://docs.piboso.com/wiki/

Paints are used to change liveries of kart and driver.

To add an helmet paint:
1) Download the templates: http://www.kartracing-pro.com/?page=downloads
2) Create a texture named helmet.tga or helmet.bmp
3) download PaintEd: http://www.kartracing-pro.com/?page=downloads
4) create the directory structure driver/helmets/sk6/paints
5) Using PaintEd, convert the texture to a paint, saving it in the previously created "paints" folder.

To change helmet's visor:
1) Create two textures, named visor.tga and visor#2.tga ( for rain )
2) Move them to the same folder of helmet's texture
3) Using PaintEd, convert the textures to a paint.


Inside Kart Racing Pro, when in "viewer" mode ( click on the dot in the bottom-right corner of main menu ), it is possible to reload a paint from disk pressing the 'r' key.

1) Extract english.str from ui.pkz ( PKZ files are renamed ZIP files ) to a temporary directory.

2) Rename english.str to the name of the new language.
For example Francais.str or Deutsch.str

3) Translate strings

STR is a text file containing all strings used in the sim, using the following format:
ID
String
ID
String
ID
String
...

"TT_" IDs are used for tooltips
"GG_" IDs are used for the inline guide

4) Create a new directory named UI in Kart Racing Pro installation directory
For example: "c:\Program Files\Kart Racing Pro\ui\"

5) Move the new STR file to UI directory

6) Start Kart Racing Pro and select the new language ( Start -> Profiles -> Language ) to check that everything is correct.

7) Please report any problem like:
- Not enough space in user interface for a translated string
- A single ID used in multiple places while different translations would be needed

[NOTE: if a client runs on the same PC, port 54410 cannot be used.]

To start a dedicated server, launch kart.exe with the following params:

Code Select Expand

kart.exe -dedicated (port number) [-set params (config_file)]
for example:

Code Select Expand

kart.exe -dedicated 54410 -set params dedicated.ini


NOTE: if a client runs on the same PC, port 54410 cannot be used.


Configuration file must be in installation path.
If not set SERVER.INI is used.

Format:

Code Select Expand

[connection]
name =
maxclient =
password =
admin_password =
bandwidth = ; 0 -> very low, 1 -> low, 2 -> medium, 3 -> high, 4 -> very high
max_ping = ; milliseconds. 0 -> no limit
whitelist = ; the filename of the whitelist
blacklist = ; the filename of the blacklist
polls_disable = ; if set to 1, polls are disabled
location = ; information about server location
MOTD = ; message of the day. Use "/r" to split the message in multiple lines.

[export]
results =  ; "html", "xml" or "both". If set it will automatically export results at the end of the last session
directory = ; the directory where results will be saved ( must exist )
units =  ; 0 -> metric units, 1 -> US units, 2 -> UK units
prefix = ; filename prefix of results
incremental = ; 0 or 1. If set to 1, results are exported at the end of each session
contacts = ; 1 -> contacts between karts are added to the XML export, 2 -> contacts with walls are exported, too

[replay]
save = ; 0 or 1, If set to 1 it will automatically save the full replay at the end of the race
directory = ; the directory where replays will be saved ( must exist )
prefix = ; filename prefix of replays

[event]
name = ; the name of the event ( optional )
track = ; track ID ( for ex. Lonato )
track_layout = ; track layout ( for ex. Short ). Empty -> Default;
category = ; kart category allowed. Empty -> Open. Multiple categories can be set with a slash in between. For example: KF1/FS250/F100
allowed_karts = ; list of ID of allowed karts, separated by a slash. For example: t_kf1/ms_kf1

[rating]
class = ; A -> 2000+, B -> 1600-1999; C -> 1200-1599; D -> 800-1199

[weather]
realistic = ; 0 or 1, if set to 1, following params are ignored
conditions = ; 0 -> sunny, 1 -> cloudy, 2 -> rainy
temperature = ; air temperature, celsius
wind_direction = ; 0 -> north, 1 -> north-east, 2 -> east, ..., 7 -> north-west
wind_speed = ; meters/second
track_conditions = ; 0 -> dry, 1 -> wet ( values in between like 0.5 are allowed )

[settings]
force_cockpit = ; 0 or 1
no_aids = ; 0 or 1
limited_tyre_sets = ; 0 or 1
fixed_setup = ; 0 or 1
fixed_setup_file = ; the name ( without the extension ) of the fixed setup file. It must exist for all allowed karts, otherwise the default setup is used
fixed_setup_dir = ; the directory where to load the fixed setups. For example: C:\Users\"your user name"\Documents\PiBoSo\Kart Racing Pro\profiles\"your profile"\setups
no_tucking = ; 0 or 1

[race]
testing_day = ; 0 or 1, if set to 1, the following race settings are unused
quick_race = ; 0 or 1, if set to 1, practice, sighting lap and warmup lap are skipped
practice_length = ; minutes
qualify_length = ; minutes
warmup_length = ; minutes
warmup_lap = ; 0 or 1
start = ; 0 -> default, 1 -> force the standing start, 2 -> force the rolling start
race_length = ; % of full length
race_use_laps = ; 0 or 1. If set to 1, race_laps is used instead of race_length
race_laps = ; number of race laps
restart_delay = ; server restart time in seconds. The default is 300, 5 minutes. If set at zero, there is no restart
pause = ; 0 or 1. If set to 1, the event is paused and saved at the end of "pause_session"
pause_session = ; practice, qualify, prefinal or final
pause_directory = ; the directory where data is saved. The default is "resume"
resume = ; the file to load to resume an event
save = ; 0 or 1. If set to 1, the event is saved at the end of "save_session". If "pause" is set, this setting is ignored
save_session = ; practice, qualify, prefinal or final
save_directory = ; the directory where data is saved. The default is "resume"

[live]
enable = ; 1 or 2 to enable live timing. If set to 1, data is sent through UDP packets ( more info: http://forum.kartracing-pro.com/index.php?topic=2134.0 ). If set to 2, data is written to a local file
port = ; the UDP port ( only used with "enable = 1" )
password = ;  ( only used with "enable = 1" )
file = ; the name of the file to write  ( only used with "enable = 2" )
track_position = ; 0 or 1. If set to 1, the track centerline and the position of all bikes are written, too ( only used with "enable = 2" )
contacts = ; 1 -> contacts between kartss are written, 2 -> contacts with walls are written, too ( only used with "enable = 2" )

[remote_admin]
enable = ; 1 to enable remote admin ( more info: http://forum.kartracing-pro.com/index.php?topic=7736.0 )
port = ; the UDP port
password =

[dynamicsurface]
disable = ; 0 or 1. If set to 1, the dynamic track surface is disabled
persistent = ; 0 or 1. If set to 1, the dynamic track surface is not reset between events

[polls]
disable_during_races = ; 0 or 1. It set to 1, polls are disabled during races

NOTE: To minimize join lag, please make sure to restrict the allowed kart categories as much as possible

It is possible to set up to 9 additional tracks, in the "events" section:

Code Select Expand

track2=
track2_layout=
track3=
track3_layout=
...
...
track10=
track10_layout=
The server will move to the next at each restart and wrap to the first after the last.
The same track and layout can be repeated multiple times in the 10 "slots".

The whitelist and blacklist use a text file using the following format:

Code Select Expand

[entry0]
guid = ........

[entry1]
guid = ........

[entry2]
steamid = ........
The GUID can be read in the "Profiles" page.
Optionally, it is possible to replace "guid" with "steamid", to use the Steam ID number instead.
Whitelist only: it is possible to set, for each entry, the race number, the name, a prefix to the name ( for example a team "tag" ) and the kart.
Also, it is possible to set a custom string, up to 18 character long, that is added to the XML results export.

Code Select Expand

[entry0]
guid = ........
race_number = ...
name = ...
name_prefix = ...
kart_id = ...
extra = ........

In the dedicated server text input, it is possible to type text that will be sent to the connected clients. It can be a personal message: http://forum.kartracing-pro.com/index.php?topic=7939.msg52700#msg52700
It is also possible to send commands: http://forum.kartracing-pro.com/index.php?topic=7939.msg52703#msg52703
Additional commands:
- "!restart" to reset the server
- "!whitelist update" to reload the whitelist file
- "!blacklist update" to reload the blacklist file
- "!admin" followed by client's name ( or #race number) to promote a client to admin
Text can be sent to the dedicated server from remote, too: http://forum.kartracing-pro.com/index.php?topic=7736.0


NOTE: a license is not needed to start a dedicated server.

There are a few settings that are only available manually editing profile.ini file that is located in profile directory under "profiles" in "My Documents"\PiBoSo\Kart Racing Pro\ save path.

Code Select Expand


map_shadow_disable = 1

under "gfx" section to disable track shadows.

[The DLL must be compiled for 64 bit.]

It is possible to write a DLL that receives data from the simulated kart in realtime.

Example source code can be downloaded at http://www.kartracing-pro.com/?page=downloads

Please note that all function calls are blocking, so control should be returned to simulation as soon as possible to avoid framerate issues.

The DLL must be compiled for 64 bit.

The plugin must have the file extension renamed to DLO and it must be copied to the "plugins" directory in Kart Racing Pro installation folder.

NOTE: a license is not needed to add plugins.

Kart Racing Pro uses UDP ports 54400 and 54410 for network protocol.
It also needs to send a DNS query ( port 53 ).