Live for Speed S2 DEMO ALPHA 0.5L
=================================


www.liveforspeed.net - www.liveforspeed.com


Welcome to Live for Speed!


- THIS IS AN INCOMPLETE ALPHA TEST VERSION OF LFS S2 DEMO

- THIS VERSION CONTAINS ONLY DEMO CONTENT

- FOR MORE INFO ABOUT S2 PLEASE VISIT www.liveforspeed.net


Important :
-----------
This is Live for Speed S2 DEMO ALPHA.

This software comes with no warranties of any kind.

By installing this software you agree that you do so at at your own risk
and you accept full responsibility for any damage caused by the use or
installation of the software.

The producers of the Live for Speed racing simulator make every effort
to ensure the program is safe but can not accept any responsibility
whatsoever for personal injury or death that may arise during the use
of the software, or any damage of any kind to your system including
corrupted files, lost data or damage to hardware.


Installation :
--------------
To install LFS S2, unzip the file into a suitable folder on your
hard drive.  You must ensure that the directory structure is preserved
by using the appropriate option in your unzip utility.  You will know
that it has been correctly unzipped if you see a data folder beside the
LFS.exe program and some more folders inside the data folder.


To run LFS S2 :
---------------
Double-click the program file LFS.exe

Note : Microsoft® DirectX® 8.1 is required and can be downloaded from
www.microsoft.com/windows/directx/downloads/default.asp
DirectX is a registered trademark of Microsoft Corporation


Unlocking the full version :
----------------------------
This ALPHA version only contains DEMO content and cannot be unlocked.
For the full S2 content, you must wait for S2 FULL to be released.
At this time we do not know when the FULL version will be available.


Game controller information :
-----------------------------
To set up one or more game controllers :

1) In LFS options...controls select "Wheel" at the top of the screen
2) Select Combined or Separate axes to match your controller's settings
3) Select the button functions and press buttons to assign
4) Press the button "Axes" to assign axes
5) Click on the function you wish to assign to an axis
6) Move the controller to see which axis to assign
7) Click on the button next to that axis, to assign the function
8) You may need to invert some of the axes by clicking "invert"
9) You can click on "recalibrate" to adjust the calibration limits
10) For axes which need to be centred, click on the C button at centre
11) You may wish to lock calibration after calibrating your controller
12) To use a shifter, select the correct shift mode and assign gears

Force Feedback :

1) You can turn on or off Force Feedback with the on-screen switch
2) If you have more than one FF device you can select the required one


Switching to other programs :
-----------------------------
The ALT-TAB key press is not recommended during a multiplayer game
as after ALT-TAB the game is never called by the operating system
and cannot maintain its connections with the other computers.
Instead, please use the quick key SHIFT-F4 to temporarily run the
game in a window.

SHIFT-F4 - toggle between window / full screen


Command line options :
----------------------
LFS can be run from a command line or another program.
A dedicated host mode is available with no hardware draw : "nogfx".
Before selecting your options, you may find it helpful to run LFS
and try out the options on the Start New Game screen - the required
upload bandwidth for those options is displayed on screen.

1) Host options :

Example :

LFS /host=test host /cars=ALL /dedicated=nogfx /maxguests=4

/host=Host Name      :FIRST IN LIST
/pass=Pass           :if required - password
/admin=Pass          :if required - admin password
/ip=X.X.X.X          :if required - local specified ip address
/port=63392          :a high number below 65536
/mode=demo           :demo / s1 / s2
/usemaster=yes       :no / yes / hidden
/track=Blackwood     :Blackwood / Skid Pad
/config=1            :config : 1-GP / 2-RALLYX in Blackwood
/reversed=no         :no / yes
/weather=1           :weather : 1,2,3 in Blackwood
/cars=[cars]         :see below : "Car Strings"
/maxguests=4         :max number of guests that can join host
/carsmax=5           :max number of cars in a race
/carshost=1          :max number of cars (real+ai) on host pc
/carsguest=1         :max number of cars (real+ai) per guest pc
/pps=4               :smoothness (3-6) number of car updates per second
/qual=0              :qualifying minutes, 0 for no qualifying
/laps=5              :number of lap, 0 for practice
/wind=1              :0 no wind / 1 low wind / 2 high wind
/dedicated=no        :no / yes / nogfx / invisible
/vote=yes            :no / yes : can guests vote to kick or ban
/select=yes          :no / yes : can guests select track
/autokick=no         :no/yes/ban                  (Wrong way drivers)
/start=finish        :fixed/finish/reverse/random (Default race start)

NOTE - alternative way to use the command line options :

A command file xxx.txt can be used instead of a long command line.
The command file would contain the command line parameters.
The parameters can be spread onto several lines.
The command file can contain comments, starting with two slashes //
Then the command line would be simply :

LFS /cfg=xxx.txt (where xxx.txt is the name of the config file)

2) Guest options :

Example : LFS /join=test host

/join=Host Name      :FIRST IN LIST
/pass=Optional Pass  :password if required by host

3) Status file "host63392.txt" - updated whenever info changes :

63392 is the port number of the host.
The file contains the following information:

lfs=0.5L             :version
status=ingame        :offline / online / ingame
guests=4             :current number of guests
maxguests=4          :maximum guests allowed
host=Host Name       :game name as listed on master server
pass=Optional Pass   :host password
usemaster=yes        :no / yes / hidden
trackcfg=BL1         :short name for track and config
cars=[18x"0"or"1"]   :cars allowed on host (0=no / 1=yes)
qual=0               :qualifying minutes
laps=5               :number of laps
conn=Host            :player name
conn=Guest 1         :player name
conn=Guest 2         :player name
...

4) Status file "guest.txt" - exists while connected :

lfs=0.5L             :version
status=online        :status
joined=Host Name     :host name


Host commands :
---------------
You can use text commands to control normal or nogfx dedicated hosts.

Using the normal text message system (pressing T in a normal host or
simply typing into a nogfx host), the message becomes a command if you
start it with a slash character.

Simple commands with no parameter :

/restart             :(re)starts the current race
/qualify             :(re)starts qualifying
/end                 :return to entry screen
/names               :toggle display between player and user names
/exit                :clean exit from nogfx host (host only)
/help                :get list of commands
/reinit              :total restart (removes all connections)

Commands with a parameter - entry screen mode :

/track X             :track and config      (e.g. BL1 / SO3R / FE4)
/weather X           :lighting              (e.g. 1, 2, 3...)
/qual X              :qualifying minutes    (0 = no qualifying)
/laps X              :number of laps        (0 = practice)
/wind X              :0 no / 1 low / 2 high
/autox X             :load autocross layout named X for this track
/axclear             :clear autocross layout

Commands with a parameter - any time :

/axlist X            :get list of layouts for track X - e.g. AU1
/maxguests X         :max number of guests that can join host
/carsmax X           :max number of cars in a race
/carshost X          :max number of cars (real+ai) on host pc
/carsguest X         :max number of cars (real+ai) per guest pc
/pps X               :smoothness (3-6) number of car updates per second
/msg X               :send system message
/autokick X          :no/yes/ban                  (Wrong way drivers)
/start X             :fixed/finish/reverse/random (Default race start)
/pass X              :set new password (blank = no password)

Kick and ban commands - any time :

/kick X              :disconnect user X
/ban X Y             :ban user X for Y days (0 = 12 hours)
/unban X             :remove ban on user X

Host settings commands :

/vote X              :no or yes - guest voting
/select X            :no or yes - guest selection
/cars [cars]         :see below : "Car Strings"

These commands are also available to any user who has connected to the
host using the admin password if one was specified when the host was
started.

To restrict the tracks allowed on a host :

Create a text file named "tracks.txt" in your LFS folder.
List all the tracks and configurations you want to allow.
Type one configuration on each line.
You must use the short name of the tracks :
[first two letters of name] [config number] [reversed]

Example :

BL1
BL2
FE1R


Other text commands :
---------------------
Most of these text commands replicate functions usually controlled by
pressing on-screen buttons but can be useful in other situations, for
example when controlling LFS from an external program using InSim.

Game setup screen only :

/ai [NAME]           :add ai driver (can specify NAME)
/ready               :set ready
/cancel              :cancel ready
/clear               :clear all racers from list
/car XXX             :select car (e.g. XRT) - if not already in race
/setup X             :select setup name X - if not already in race

Mode / replay control :

/spr X               :run a SP replay from entry (front end) screen
/mpr X               :run a MP replay from entry (front end) screen
/end                 :exit from replay back to front end
/sp                  :go into single player from entry screen

Any time :

/speedreduce X       :total speed steer reduction (0 to 1)
/reducehalf X        :speed in m/s for half of reduction
/loadkb X            :load kb settings file (data\misc\X.kbs)
/savekb X            :save kb settings file

To get info from LFS World - /w and /ws commands :

  /w CMD sends command to LFS World for current car/track
  e.g.  /w pb  (Personal Best)  or  /w laps  (Laps)

  /ws TRACK CAR CMD sends command for specified car/track
  e.g.  /ws BL1R XRT pb  (get PB in XR GT TURBO at BL Rev)

  More online DB access commands can be found on the
  "LFS Keys" page at www.liveforspeed.net

To get info from master server - /m command  :

  /m find USER : find a user online
  /m ?         : get a list of master commands


Car Strings :
-------------
The /cars command for the startup command line or for hosts / admins
now uses the three-letter S2 car codes.

Example :

/cars=XFG+XRG        :Allow XF GTI and XR GT
/cars=MRT            :Allow MRT5 only

These Car Groups can be used as well :

ALL    - all cars
ROAD   - road legal cars
RACE   - race cars
TBO    - same as XRT+RB4+FXO
LRF    - same as LX6+RAC+FZ5
GTR    - same as FXR+XRR+FZR

The plus and minus symbols can be used in conjuction with these :

/cars=TBO+LX4        :Allow XRT, RB4, FXO and LX4
/cars=ROAD-UF1       :Allow all road cars except the UF 1000


Replay Analyser File :
----------------------
This feature is provided for use in external analyser applications.
It stores data from one lap of driving.

- USER information :

Press ESC while viewing the car in a replay, on the lap BEFORE the
lap you wish to analyse.  Click on "Output lap data" and enter the
name of the output file.  This file will be saved in a "raf" folder.
Use an external application to open the .raf files (not supplied).

The file will be created when the car crosses the start line and
will be closed when the car crosses it again 1 lap later.

- PROGRAMMER information can be found at www.liveforspeed.net


Translation :
-------------
To create a language pack :

- First run LFS.  This will create a file "English.txt" in a folder
  "data\language".  Please do not edit English.txt as it will be
  overwritten each each time you start LFS.  Instead, make a copy of
  the file with the name of your language replacing "English".

- After creating your new file, it can be edited in a text editor.

- Load your language in Options...Player.

- Reload the language file any time with SHIFT+F5, for convenience.

- The help.txt file can also be edited, in the data\misc folder, copy
  the file help.txt to a new file help_XXX.txt (where XXX.txt is the
  name of your language file).

- Only the ISO character set is supported.  Languages which require
  characters not included in the ISO set are not yet fully supported.


Motion Simulator Support : (OutSim)
--------------------------
The user's car in multiplayer or the viewed car in single player or
single player replay can output information to a motion system while
viewed from an internal view.

This is controlled by four lines in the cfg.txt file :

OutSim Mode 0        :0-off 1-driving 2-driving+replay
OutSim Delay 1       :minimum delay between packets (100ths of a sec)
OutSim IP 0.0.0.0    :IP address to send the UDP packet
OutSim Port 0        :IP port
OutSim ID 0          :if not zero, adds an identifier to the packet

Each update sends the following UDP packet :

unsigned int         :time in milliseconds (to check order)
Angular Velocity     :3 floats
Orientation          :3 floats Heading, Pitch, Roll
Acceleration         :3 floats X, Y, Z
Velocity             :3 floats X, Y, Z
Position             :3 ints X, Y, Z (metres x 65536)
Game ID              :1 int (optional ID - if specified in cfg.txt)

Note 1 : X and Y axes are on the ground, Z is up.

Note 2 : Motion simulators can be dangerous.  The developers of the
Live for Speed racing simulator do not support any motion systems in
particular and cannot accept responsibility for any injuries or death
connected with the use of such machinery.


Thanks :
--------
Thanks to all hosts and racers for your support.


Copyright :
-----------
(c) 2002-2005 Scawen Roberts - Eric Bailey - Victor van Vlaardingen