RBR Setup Manager 3.2 for RBR 1.02
**********************************

A simple app to copy/move car setup files to and from the RBR SavedGames
folder. It automatically renames the files to conform with the RBR XslotNNN_
naming convention.

It also enables you to edit the setups using the context menu Properties
option or by double clicking the list entry.

Note:
Requires .NET Framework v2, and RichardBurnsRally_SSE.exe 1.02 in the current
directory.


Installation
************

Unzip all the contents of the installation archive into your Richard Burns
Rally installation folder (where RichardBurnsRally_SSE.exe is located).


Operation
*********

Run the app

1. Configure the Library folder using the context menu Settings dialog. This
is simply a file system folder which will hold the master copies of all your
setups.

2. Configure the RBR folder using the context menu Settings dialog (probably
c:\Program Files\SCI Games\Richard Burns Rally or something like). It will
automatically look in the SavedGames subfolder to locate the Setups used in
RBR.

3. Use drag and drop to move/copy setup files between folders in the Library
and the RBR SavedGames folder. The Library folder structure can be extended
with sub folders to house different cars/surfaces/weathers as you wish. The
naming convention that you adopt is entirely up to you. When a Setup file is
moved/copied to the RBR folder, the visible Library name is appended to the
appropriate RBR prefix.

For example: File 'Tarmac Wet.lsp' could be renamed '0slot1_Tarmac Wet.lsp'
(depending on car/slot).

4. There is no restriction on which files you can copy to which RBR Car. You
must be careful to match the setup file to the car. The RBR Car label
(extended using the CarName entry from the Cars\Cars.INI) will remind you
which cars belong where.

5. Click Properties on the context menu to display and edit the setup. During
editing, the setup can be associated with the car physics data. Select one of
the predefined physics folders or browse to the appropriate car subfolder of
an RBR physics folder. If you select a predefined one it will use the files
located in the "physics" folder (if unpacked) or the packed physics file
(physics.rbz), whichever is found first. Actually it uses RBR's algorithms to
locate and read the physics data. The unpacked physics files can be located
anywhere. They do not have to be the actual physics files used by RBR for
driving. The setup editor uses the car physics files to provide range checks
and default values. The physics files are not modified in any way by the setup
editing, and do not have any lasting relationship with the setup.

The setup files can be edited without referring to the physics files, although
this is no recommended, but some fields will be disabled. All others can be
freely edited.

6. You can sort the setup list views by clicking on the column headers. Each
consecutive click on the same column header toggles the sort order
(ascending/descending).


Translation (I18N)
******************
To change the language of the application, simply change the value of the
section name in the [language] section of the RbrSetupManager.resources.ini
file to an appropriate value. The section value has to match an existing
section containing the translated text strings.
For translation into languages other than english or german have a look into
this file for instructions.


Restrictions
************

1. Can NOT be run from inside RBR. You will need to prepare the RBR folder
before running RBR. This is actually fine for on-line utilities such as
RBR-Online and RBRNet. When using RBR-Online for testing, it is best to keep
the setup open and use the apply button in the setup editor to save changes.
Do the run, tweak the setup, apply, and run again.
If you run RBR in windowed mode, you may switch from RBR to the setup editor
and back without freezing RBR.

2. Requires .NET Framework v2. A big download, but you know you will have to
go there in the end.

3. Requires RichardBurnsRally_SSE.exe 1.02 located in the current directory.


Update History
**************

Version 3.2 2021-03-21
----------------------
* fixed editing of viscous coupling differentials

Version 3.1 2021-02-23
----------------------
* fixed deletion of setup file after user canceled confirmation

Version 3.0 2021-01-03
----------------------
* support NGP6
* removed AllCars.ini, read car names from Cars\Cars.ini file
* Italian translation by Lorenzo

Version 2.4 2015-05-30
----------------------
* added tooltips
* double click to open setup
* Polish translation by Wojtek

Version 2.3 2015-02-21
----------------------
* fixed save/restore of window positions

Version 2.2 2014-09-18
----------------------
* added support for online plugins

Version 2.1 2014-08-14
----------------------
* damping with 2 decimal digits

Version 2.00
------------
* calculate and show the block length of the helper spring
* fixed units
* fixed decimal digits of some values
* fixed naming of some values

Version 1.10
------------
* use RBR's logic of incrementing/decrementing values
* only write changed values
* improved accuracy of differential velocity values

Version 1.9
-----------
* min/max/default values of differential locks
* fixed rounding issues of minimum values

Version 1.8
-----------
* ad-hoc calculation of geometry values
* disable visual styles of the differential settings progress bars
* icon

Version 1.7
-----------
* read physics and default setups from physics.rbz (predefined folders).
* sorting of the list views.
* show setup slot in list view.
* i18n.

Version 1.6
-----------
* calculate caster/camber/toe and ride height.
* show min/max/default values
* show invalid values colored in red
* fix invalid values on request
* use RBR's algorithms to read and write setup data (requires
  RichardBurnsRally_SSE.exe in the current directory).

Version 1.5
-----------
* Fixed handling of floating point values (decimal separator).
* Fixed navigating in the differential maps.
* Handle an infinite number of setup slots (removed 3 slots restriction).
* Fixed error when loading of file fails.


Please mail all repeatable bugs to guenter.schlupf at gmx.net, together
with the incriminating setup file and, if relevant, physics folders.

And finally...

... thanks to Andy from the UK for letting me continue his great work.

WorkerBee

vim: set nocindent :
