----------------------------------------------------------------------------------------
				Race creator++ v1.2
				    By Flitbed
-----------------------------------------------------------------------------------------
Hi! first of all, thanks for downloading my mod. In this file you'll find useful info of how
to use the mod, and a quick explanation of all features it have.

>>With this mod you can:
-Create races (street, air, sea).
-Manage the AI Behavior for each checkpoint.
-Select the track type (circuit/sprint).
-Edit races (in-game or through .ini files)
-Play races.
-Customize grid	(in-game or through .ini files).
-Many more things.

Optionally, you will find some already created races by me on the "Race pack" folder.
You should put them on "CLEO/Race creator++/Races"

-----------------------------------------------------------------------------------
				Requirements:
-----------------------------------------------------------------------------------

To run this mod you WILL need:
-Latest version of cleo
-Latest version of Cleo+

Cleo+ link: https://www.mixmods.com.br/2022/11/cleoplus/

------------------------------------------------------------------------------------------------------------------------------
				    How to install
------------------------------------------------------------------------------------------------------------------------------

Just like others cleo mods, open the "Mod" folder and drag all the files inside it to your 
cleo folder. This mod make use of .ini files, so avoid installing it through modloader.

------------------------------------------------------------------------------------------------------------------------------
				Creating races in-game
------------------------------------------------------------------------------------------------------------------------------

To do anything, you will need to open the menu of the mod, by default the cheat op open it is
"RCEMNU" but you can change it whenever you want through the ini file "General settings.ini".
Select "Create race" to start, it will create a .ini file in "/CLEO/Race creator++/races".
By default it will be called Race(x).ini, but you can change the name of the .ini file BEFORE
creating your race. DO NOT change the name of the ini file while you are creating/editing a race.

<<<<<<<<<----------------------Checkpoints----------------------->>>>>>>>>>

In the "checkpoints" menu you can add, delete or edit checkpoints.

<--------Adding---------->
While adding checkpoints you can change its radius, the max speed at which the ai will go (useful
for turns, so the opponents will not go at max speed on sharp turns) and the ai behavior (if
they will follow paths or will go directly to the checkpoint you're placing).

NOTES:
--The first checkpoint (0) is only used as the starting line on sprint-type races (they are
not even visible), but on circuit-type races they will be the finish line too.
--Note that due to game limitations, only first and last placed checkpoints will be visible in create mode,
but when you place a checkpoint it will be saved.

<--------Removing--------->

You can remove the last placed checkpoint through "Remove checkpoints".

<---------Editing---------->

Finally you can edit already placed checkpoints in-game. You can select which checkpoint to edit
pressing up an down arrows. You can edit its position, radius, ai speed and ai behavior.

<<<<<<<<<----------------------Vehicles positions----------------------->>>>>>>>>>>

This will be the grid, so where the cars will start the race.

<--------Adding---------->
You can add up to 15 positions in-game (not counting player position). You can add more through
the .ini file of the race if you want, but dont be excessive.

NOTES:
--The first placed position(0) will be the place where the player will start the race.
--Due to game limitations, only 2 positions markers will be showed at the same time(first and last)
--On air races, the position markers will not show up, but the positions will be saved.
--When starting a race, if no positions detected, then the player will start on the checkpoint 0.
--The direction where the player is looking will be saved too, so make sure to be well positioned.

<--------Removing---------->

You can remove the last placed position through "Remove position".

<<<<<<<<<----------------------Race settings----------------------->>>>>>>>>>>

There are settings that can be changed in-game (through "options" menu), and others that can
be only changed through the .ini file.

<--------Race type---------->

You can change this in-game. You can select between street, air, or sea races. In the .ini file
it will appear as "Race type", in the [Settings] section. Valid values are "STREET", "AIR" and "SEA".

<--------Track type---------->
You can change this in-game. You can select between sprint and circuit. In the .ini file it will
appear as "IsCircuit", in the [Settings] section. Valid values are "0" (sprint) and "1" (circuit).

<--------Reward---------->
This can only be changed through the .ini file. By default its 0, and you can change it if
you want a monetary reward when winning the race. In the .ini file it will appear as"Reward",
in the [Settings] section. Any integer value is valid.

<--------Interior---------->
This can only be changed through the .ini file. DO NOT change it unless you know what you are doing.
It only saves the interior ID where the race will start.

<--------Race name---------->
You cant change this in-game, but you can do it changing the name of the .ini file.
(CLEO/Race creator++/Races).

NOTES:
--DO NOT change the .ini name while you are creating/editing the race.

---------------------------------------------------------------------------------------------------
					Editing races
---------------------------------------------------------------------------------------------------

When opening the menu, select "Edit race". A list with all the races created will appear, and when
you select one, all the setting will be loaded and then the same menus as "create race" will appear.

---------------------------------------------------------------------------------------------------
					Starting a race
---------------------------------------------------------------------------------------------------

When opening the menu, select "Start race". A list with all the races created will appear, and when
you select one, all the setting will be loaded. Then a menu with appear, where you can select
the opponents, how many laps you want to do, and more!

<--------"Laps"--------->
If the track is a circuit, then you can change the amount of laps with the left and
right arrows (only if the "Laps" menu item is being selected)

<<<<<<<<<----------------------Grid type----------------------->>>>>>>>>>>

You can customize all the grid, and there are a lot of ways to do it:

<--------"Start race"--------->
When you select it, a menu with categories will appear. Thats it! when you select one, the opponents
will spawn with a car of the selected categorie. If the player is on foot, then a random car
of that categorie will be selected for player. You also will see the "custom categories", yes,
you can also add new categories through the "General settings".ini file. You can also customize what
cars can appear on each default categorie in the same file.

<----"Start one-make race"----->
All the opponents will select the same car the player is using.

<----"Start custom race"----->
This will load all the custom car settings from the race .ini file, that can be changed
through the "customize" section (explained above). If no custom settings detected for a
position, then the racer of that position will select the car the player is using.

<----"Customize"----->
Here you can customize each place of the grid for "custom races". First select which position
you want to change, then select "change car". 
If you press "select player car" then you will be set to free move. Select any car you want,
and choose if you want to save tunes, paintjobs and colours.

You also have the option to write the car ID you want.

When a car is selected, you can choose if you want random tunes or paintjob to be applied.

NOTES:
--When on a race, you can press ctrl + backspace to stop the race.
--There's not a position system to show your current position, but at least when you finish
the race it will tell your final position.
---------------------------------------------------------------------------------------------------

Well, this was only a basic guide in case you are struggling with the mod or something, and ik that
probably theres a lot of gramatical horrors but hey, i think it can help many people out here.

If you found a bug or have any cuestion, tell me.

Thats all folks, have fun!!

Changelog:

V1.2:
-Now the opponents will respawn on the last checkpoint if they are underwater, upside down or
totally stopped for some reason.
-Changed the way how the ai drives on "direct" behavior.
-Fixed sideskirts not saving when selecting a car for custom races.

