Documentation



Site Map

I. Commands from LFS
II. Settings / INI Config File
III. XML Exportation Format
IV. Error Messages



Commands from LFS




There are 3 Commands availible you can use to communicate with Live for Stats from inside the game:


Settings / INI Config File




All Settings can be changed in the Settings Dialog (LFS path if itīs not right by clicking "Start LFS") but they could be changed in the ini File too.


Ini File


[main]
lfs = <Path to LFS.exe>
systemstart = <0 | 1>
outputname = <Output Filename with Tags>
outputpath = <Path for the files>
lfsparameters = <Parameter you want LFS to start with>

[network]
serverport = <InSim Port (Server)>
clientport = <Listening Port (Client)>
adminpw = <The admin password you needed if set in LFS>

[extra]
ftpaddr = <Address of a ftp server>
httpaddr = <URL of the ftp server folder you have access to the files>
ftpuser = <Username for the ftp account>
ftppw = <Password for this user>

[options]
noplayerreset = <controls if a player gets a reset (default is 0 (no - do reset))>
timeinhundreds = <controls if time should be shown in hundreds of seconds (default is 0 (no))>



lfs


Thats the Path to Live for Speed, it can be set automatically on the first start by clicking on "Start LFS" in the next dialog LFS.exe can be selected. The path will be saved and on next starts LFS will be started immediately.


systemstart


With this Live for Stats can be started with Windows on default itīs disabled (0) It can be enabled by set it on in the Settings Dialog or write 1 instead of 0 into the INI- File.


outputname


This helps to customize the Output filename.
There are several Tags availible create a dynamic filename with information of time and of the race
All text not in such a tag will be in the filename too.
Here two examples:
stats_[DATE]_[TIME]_[TRACK]_[MODE+].xml -> stats_060928_201501_KY1_qualify60.xml
stats4CLRS530_track_[TRACK]_player_[PLAYER]_[NOTAG].xyz -> stats4CLRS530_track_BL2_player_3_[NOTAG].xyz


outputpath


path all outputfiles will be saved to.
If the value is empty or path cannot be found, the default value (.\xmlstats\) will be used


lfsparameters


The parameter you want to start LFS with
You can see a list in the file commands.txt in you \LFS\docs folder<\br> For default there is only one tag [INSIM] itīs for activation of insim you can delete this if you activate insim in the config or manually in LFS.
Maybe you have to test in wich order the parameter have to be given to LFS.


serverport


The port Insim will be initialized with and hearing to (default 35743)


clientport


The port this program will listen to (packages from Insim) (default 35742)


ftpaddr


An optional ftp address. Every gernerated stats file will be automatically uploaded to this address


httpaddr


Itīs the http address you have or want to have access to the files, often it donīt differs from ftp address but for example my real ftpaddr ist &qout;packer-online.de/liveforstats&qout; instead I want to use: http://liveforstats.de.vu/ wich shows to the folder in the ftp account.
Thats interesting for the log wich gives you one link to the xml file and one to the LFS Report (generated website)


ftpuser


The user who has access to the server


ftppw


Password for this User.
NOTE: The password is unvisible in the settings dialog but its normal visible in the ini file.


noplayerreset


It conrols if a player should get a reset or not. Normaly it should be 0 cause a player should get a stats reset for disconnects and flying to pit. But in longer races the rules are normally that you can continue racing after a dissconnect and get only one +lap for flying to pit. Before this option you ever get totally wrong results, but if you get it to 1 you will get again good results
There are 3 Values you can enter:
0 -> The default Every drive gets a reset for a disconnect
1 -> No reset! After a disconnect the capturing will continue.
2 -> The same then 1, but if another driver with the same clantag reconnects the capturing will also continue


timeinhundreds


For default the time will be exported to the xml file in the format: (HH:)mm:ss:hh:tt but sometimes its better in automatic use to have only one number so timeinhundreds gives the time in hundreds of seconds. This can be done, because (at this time) LFS donīt use thousands.



XML Exportation Format






output


Version of the newest xml format


program


Version of the latest Live for Stats release


readflags


Shows you how to read the xml file

1 = timeinhundreds was activated
2 = xml file includes the new information pit list, penalty list, player flag list (not only one entry), flag counter... (this flag isnīt total important, because you have not really to now that to read the file without errors. You only know that the above listed things are empty or 0)

NOTE: its a flag so it could be 0,1,2 or 3


HOST


Name of the Multiplayer- Server the Race was on. Only availible in Realtime NOT in mpr (multiplayer replay). There and in Singleplayer it is empty


LFSVERSION


The LFS version the report was captured with for example: 0.5U30


TRACKNAME


Its a short name form of the LFS Tracks (3 characters)
The short form with its track and the config are named here: List is from the german manual

TOTALLAPS


Its normally the total lap count but it can not ever read so easy
Here is the description from the LFS InSim manual

0              : practice
1-99        : number of laps... laps = rl
100-190 : 100 to 1000 laps... laps = (rl - 100) * 10 + 100
191-238 : 1 to 48 hours... hours = rl - 190


WEATHER


A number 0, 1... the meaning depends on the track:

Blackwood South City Fearn Bay Autocross Kyoto Ring Westhill Aston


WIND


0 = off
1 = weak
2 = strong


QUALMINS


Length of the Qualify up to 60 (minutes)
You can use it to indicate if its a Race or Qualify (for race QUALMINS = 0)


PLAYERCOUNT


Number of players in this XML output file.


SPLITCOUNT


Number of splits of the track.
Every lap should have this split count. But if the program started in a race in process the first lap can have less splits.


LFSID


Itīs the unique ID LFS gives every player. Shouldnīt be important for normal use.
But maybe for someone using another Addon.
New behavior: If the ID is -1 it shows that the player disconnected in race


NAME


The Playername up to 23 characters. In the name you have a color code.
A new color begins with ^. The number behind this describes the color: If there is no color code at the beginning it is grey


UNAME


the user name (23 characters), a player is registered with (in LFS) you can look up the lfsworld stats with it for example. This name is unique and there are no color codes in.


STARTORDER


This is the start list 1 is pole...
So in a race this is the qualify result, if it had been driven.
But in one case in this tag could be appears "Rejoined" this means a player was in race, disconnected and joined it again.


OVERALLPOS


Result position in a race and in the qualify. 1 is victory or pole.


TOTALTIME


Result time of a race. In qualify it isnīt set (00:00:00:00:00)
The format is HH:mm:ss:hh:tt (could be only in seconds (unsigned integer) if readflags 1 is set)


BESTLAP


Best lap in a race. In qualify itīs the best lap too, so itīs for the start order (format same then in TOTALTIME above).


CARNAME


Thats the full car name in LFS (there are two names the first and bold written name is from the new LFS Versions the second in brackets is from Versions earlier V3 and also the full name):

TYRE


Thats for the tyres to begin or for the tyres in the pit list wich were changed or not (255).
The numbers in fact mean:

TYRE_R1 0
TYRE_R2 1
TYRE_R3 2
TYRE_R4 3
TYRE_ROAD_SUPER 4
TYRE_ROAD_NORMAL 5
TYRE_HYBRID 6
TYRE_KNOBBLY 7
NOT_CHANGED 255



SKINNAME


The skin name of the car


PLATE


Thats the plate of the car (could be even empty)


BESTSPEED


Fastest speed ever driven in a race or qualify.


PLLAPCOUNT


Count of laps a player has driven.


PITCOUNT


Count of pit stops a player did

NOTE: This must not be the count in the pit list because a)in older Versions of LFS there arenīt pit information but if the player has a result, there is a count. Also the pit count could be above the pit list count if you joined mid race. Because I want even there as much information as possible.


ENDPENALTY / PENVALUE


Endpenalty could only been given in a race. Penvalue is in the new list and differs
everytime from the last penvalue.

MENTIONED 1
CONFIRMED 2
PENALTY_DT 4
PENALTY_SG 8
PENALTY_30 16
PENALTY_45 32
DID_NOT_PIT 64


LAPNUMBER


Number of the current lap (1 = first lap...)


LAPPOSITION


Position after the lap (1 = Leader)


LAPTIME


Time of a lap in the format mm:ss:hh:tt


LAPSPEED


This is the speed on/after the lap line


SPLITTIME


Time after a split/sector (not ever a splittime). For the time of the second split: split 2 - split 1


SPLITSPEED


This is the speed on/after a split line


PITTIME


The time of the pit stop (only the work not the time you stand. If you did that longer.
The format is HH:mm:ss:hh:tt (could be only in seconds (unsigned integer) if readflags 1 is set)


WORK


Itīs the work wich has been done wile pit stopping.

PSE_NOTHING 1 PSE_STOP 2
PSE_FR_DAM 4
PSE_FR_WHL 8
PSE_LE_FR_DAM 16
PSE_LE_FR_WHL 32
PSE_RI_FR_DAM 64
PSE_RI_FR_WHL 128
PSE_RE_DAM 256
PSE_RE_WHL 512
PSE_LE_RE_DAM 1024
PSE_LE_RE_WHL 2048
PSE_RI_RE_DAM 4096
PSE_RI_RE_WHL 8192
PSE_BODY_MINOR 16384
PSE_BODY_MAJOR 32768
PSE_SETUP 65536
PSE_REFUEL 131072


YELLOWFLAGS


A counter for the yellow flags given to the player.


BLUEFLAGS


A counter of blue flags given to a player.


DISCONNECTED


It shows if the take over wasnīt done with the "T" button as a feature in LFS but in a race after a reconnect from a team driver (See teamdetection / noplayerreset for it (it has to have value 2)).


(Player) FLAG


Name of the Multiplayer- Server the Race was on. Only availible in Realtime NOT in mpr (multiplayer replay). There and in Singleplayer it is empty

SWAPSIDE 1
GEARCHANGECUT 2
GEARCHANGEBLIP 4
AUTOGEARS 8
RESERVED_1 16
OLD MOUSE 32
HELP_BRAKE 64
HELP_THROTTLE 128
RESERVED_2 256
AUTOCLUTCH 512
MOUSE 1024
KB_NO_HELP 2048
KB_STABILISED 4096




Error Messages




Settings



Error Message Solution
The server ip is not in the correct format (4 numbers between 0-255 and a dot bewteen them) Most times the ip have to be 127.0.0.1 only if you run a server you sometimes use 192.168.1.1 or something similar. The format is general ip format is >0-255<.>0-255<.>0-255<.>0-255<
The admin password can be unset or between 1 and 15 characters Everything written. The password is again only necessary for server.
The client port have to be between 1024 and 65535 (also should be over 49151) Port 0 - 1023 is for important applications and couldnīt or at least shouldnīt be used. 1024 - 49151 are registered for application and itīs not always good to use them. 49152 - 65535 are for private use.
The server port have to be between 1024 and 65535 (also should be over 49151) See answer above.
The value for noplayerreset must be 0, 1 or 2 See herefor the meaning of the numbers.
The value for timeinhundreds must be 0 or 1 See herefor the meaning of the numbers.



Program process



Error Message Solution
This application has failed to start because the application configuration is incorrect. Reinstalling application may fix this problem. If the error message is something like that you need to install the c++ runtime c++ runtime (x86)(there is also a 64 bit version availible).
dbghelp.dll not found You need this application. But its not default installed under 98 and ME. You can download it here. Place it inside you main Live for Stats directory.
The procedure entry point MiniDumpWriteDump could not be located in the dynamic link library dbghelp.dll You use dbghelp.dll but in a version under 5.1. Get a version above 5.1 here. Place it inside you main Live for Stats directory.
IP isnīt correct or the serverport could not be bind Mostly the server port is used by another program or the IP you use is not a correct one.
The clientport could not be bind The clientport is used by another program or service.
The ini file could not be created There is no file "lfss.ini" availible in your Live for Stats folder and it could not be created for a unknown reason. A windows restart should fix it.
LFS is running. Restart Live for Stats for use of the new Settings Some values cannot be changed if LFS runs (ip and the ports). If you changed these settings you have to restart Live for Stats.
Live for Starts is already running You cannot run Live for Stats multiple times.
The taskbar icon could not be created Try to reboot your system. You shouldnīt get this message.



Log file



Error Message Solution
Couldnīt upload a file The server is full or you have no writing rights.
Couldnīt initialize WinINet you donīt need a connection to the internet to call this first WinINet funtion, so I donīt know how you could get this error message.
Couldnīt log into ftp - wrong username, password or no internet connection this error could have many reasons. No connection to the internet, wrong username or password.




Updated 01.04.2007


Đ2006 - 2007 Simon Berger