[RELEASED] Racetrack Builder

@ToothyBirds I've figured out a process to remove unreferenced meshes. It's a bit cumbersome though.

Basically:

1. Remove the "Saved Meshes" script object reference from the Mesh Manager in each scene
2. Make sure you don't have a scene containing a racetrack open (create a new empty scene if necessary). I'm not sure why this is necessary, but it appears to be.
3. Select all your racetrack scenes in your project folder, then right click -> "Select Dependencies".
   This will give you everything referenced by your scenes. The racetrack meshes have numeric names and should be grouped together.
4. From that list, select all the racetrack meshes, then right click -> "Export package" and save it somewhere.
5. Go to your "Meshes/Racetrack Builder" folder, where all your meshes are, and delete them all.
6. Import the package again.

You should be left with just the meshes that are used in your scenes.
You can also select the Racetrack Meshes scriptable object and click "Remove deleted meshes" to tidy up the tracking information.

 

Does anyone know of a good Car Controller asset I can recommend for driving on tracks?

I've just tidied up the documentation and removed references to the Unity Standard Assets package - which has been deprecated for a while now. I would be nice to have something to recommend in it's place.

 

Multi-selecting curves is starting to come together. This makes it much less tedious to set properties on sections of the track, like widening or the "raise terrain" flag.

This will likely be released in the next update.

 

I've created some tutorials in an new simpler format. Each is less than 5 minutes and demonstrates a core technique.

These will become the main videos on the store page (in the next release), as they are a bit more accessible than listening to me talk for 30+ minutes (and some of the older videos are a bit out of date).

 

Apparently I can't have more than 5 videos in one post.
Here's the other 4.

 

This might be a silly question, but would the generated track game run on an Oculus Quest 2?

 

@rickysays
Yes, it should. It was originally implemented for an Oculus Go game (I wanted to make something like Stunt Car Racer in VR), and performance was okay. So I wouldn't expect issues on Quest 2.
Basically it copies regular Unity meshes and warps their shape around the racetrack spline. The output is regular Unity meshes, so there's nothing particularly complex at runtime.

 

Hi Tom, I am interested in your asset for an oval racing title. Is there an option to only have a wall on one side of the track? Everything I have seen shows either no walls or both sides.

I would like to be able to create an oval track, with a wall on the right side only, that connects into an apron or infield surface area. Is this a possibility?

 

Hi,

Create a single wall: yes. Connect to an infield area: not really.

I had a quick play and came up with this:


It's possible to put a wall on one side of the track, but you'd need to create your own track type (aka "mesh template"), which requires a little bit of work. There's a walkthrough in the documentation https://drive.google.com/file/d/1EWZw7EGM01IIfQSoDN7MLY3-YBLev_P-/view (page 34), and a tutorial video Racetrack Builder - Track types - YouTube which is a little out of date (the buttons to apply changes to the track have changed) but the main concepts are still relevant.

You would probably need to supply your own meshes and textures to get a decent looking result, and use the UV generator component to fix the texture seams.

Regarding the apron, there's not really any support for this. The road surface only has a single bank angle - it's not possible to leave the inside flat and bank the outside. You could use a separate mesh for the inside area (not generated by Racetrack Builder), but there would be a texture seam at minimum, as there will be no real relationship or connection between the racetrack and inner meshes.

So it depends on how precise your requirements are.

 

@juhbee

Having said that, I did manage to come up with this:


This is actually two "racetrack" objects, one for the flat inner part, and the other for the banked outer part.
The outer racetrack has a track type where everything is to the right of the spline. The inner has a track type with everything to the left of the spline.

I basically cloned the outside track to get the inside one, then removed the bank angles. Obviously you would need to be careful to keep them identical and aligned from that point.

I configured the UV generator to use world X and world Z to generate the texture coordinates for the top of the track, which eliminates the texture seam.

EDIT:

Turns out I had misconfigured the UV generation and it wasn't actually activating.
Also UV generation aligned to the track direction does actually work without creating a texture seam (if everything is configured carefully)

 

your package is awesome! i just bought it 2 weeks ago, I wonder if have any way to reduce the mesh collider on surface?

 

Tom,

That is actually perfect for my use case - and is a thousand times easier than building in 3D modeling software. I will definitely be using your tool here in my current project. Did you notice any weird physic impacts with the car controller from the two track meshes sharing that seam?

Thank you so much for your help!

 

@Tu-Le

Do you mean make the collision mesh lower resolution?


You can do this by modifying the track type prefabs (or taking a copy and modifying that).

For example:

• Drag the "asphalt poles" prefab into the scene, and rename it
• Select the asphalt mesh
  
  
• Change "Mesh Collider" component's mesh to something lower resolution, like using the same mesh as the visual mesh (which is lower resolution).
  

Now you have a new track type you can drag into the "Template" slot of a curve to generate the track with a lower resolution collision mesh.

 

@juhbee
I tested it with the Unity Standard Assets (deprecated, but still a solid car controller imo).

Sharing the seam is not so much an issue with the car controller. I've seen it cause problems with sphere colliders, as the object will often bounce up when it crosses the seam, but wheel colliders seem a bit more tolerant.

However, the sharp angle at the seam causes problems - it's easy to lose control of the vehicle. Ideally it needs to be smoothed out, but there's no way to do that with racetrack builder that I can think of.

 

thanks!

 

Hi Tom,

This might sound a bit silly but are the units of measurement used in your package as shown in the videos (such as for the length of the curve) based on real life units (metres, miles, radian etc.) ? Is there a documentation or list of units of measurements?

Thank you for your awesome work!

 

Hi @nghiah,

They correspond to the units in Unity, which correspond to metres by default https://docs.unity3d.com/2019.3/Documentation/Manual/BestPracticeMakingBelievableVisuals1.html#:~:text=By%20default%2C%201%20Unity%20unit,systems%20assume%20this%20unit%20size (based on a quick Google).

I wasn't super attentive to scale when I created the supplied track types. They feel about right, but if you need something precisely to scale you may have to modify them or create your own.

 

@TomMulgrew

I'm using unity 2021.3.20 & when I rebuild my track, I get a lot of errors spamming my console.

 

@derkoi

It looks like it's this line in Assets/Racetrack Builder/Scripts/RacetrackBuilder.cs (line 912)

Code (CSharp):

1. Debug.Assert(isCollisionMesh || vertexInfo.Vertices.Length == mesh.tangents.Length);

I believe this assert can safely be removed. I suspect it's from an older version that recalculated tangents explicitly, whereas the current version just calls the Unity built-in Mesh.RecalculateTangents() function.

If you remove or comment out that line, does it appear to work?

 

Hi, Thanks for the quick reply, yes commenting out line 912 stopped the errors.

 

Hi again @TomMulgrew

For some reason I'm getting another error message when I try to move the first track section created on a new track

 

Hi derkoi. Does this error stop it from working?

 

HiTomMulgrew,

First i realy enjoy your asset

My problem is about Layers. I try to make a hover vehicle track (hover physics is very sensible to

the Delta angle between curves. This could need hundreds of curves to have a smooth run so i’m not sure about performances issues...)

So mainly i need 2 Layers. Let’s say Floor to hover above and Wall to prevent from climbing walls,

to manage collisions , FX etc.

So i attached a script to RaceTrack object that acceeds to the object collider and assign Wall as Layer. Same for the floor layer. This works pretty good. No problem.

Sorry it’s a bit long, so i come to the main issue :

I use a follow camera and i want to avoid the ship to be hidden by the barrieres. So i added some statements to my camera script to acceed to the railing objects and disable the renderers.

This also works pretty good. the barrieres are hidden BUT not the small_pole(Clone) Spacing group 1 objects. I can acceed to them and disable the renderers BUT not specifically. They are hidden on the right and the left… But i just want to hide the rendrers i’m colliding with. So my question is :

Is there a way to turn the small_pole(Clone) Spacing group 1 as child of continuous(Clone) Continuous (respectively right/left like collider objects)?

Hope i’ve been enough clear.

Thanks by advance for your answer.

 

Hi @faUnity.

I think I understand what you're saying.
You want the repeating poles to be associated with the collider on the corresponding side, so that you can hide them all in one go(?).


One workaround is to edit the track type (RacetrackMeshTemplate) prefab and move the pole mesh out of the spacing group into the continuous group.


The generated template copy objects then come out like this:


Which might be closer to what you're looking for?

However, this does have some consequences:
1. The pole won't automatically repeat. If you want more than one pole per mesh template copy, you will need to duplicate the mesh (like I've done here with small_pole (1), (2), ...).
2. The pole is now treated like part of the continuous mesh. So instead of repeating the same pole mesh at different positions, it copies the mesh for each pole and warps the vertices, using the same algorithm it uses for the road surface, barriers etc. This could affect scene size and Unity draw call batching (although my guess is it probably doesn't make much difference as the pole meshes are quite basic).
3. The pole cannot have its own collider, unless the collider is a mesh collider. A capsule collider (for example) would have simply been dropped. In this case the small poles don't have their own colliders, so this doesn't apply.

Let me know if this helps. Otherwise, I can think about ways to add some more control to the hierarchy of the objects that Racetrack Builder generates.

 

Hi Tom,
first of all thank you so much for you availability

Yes absolutely. That's the hierarchy and the result i would.
So i modified the prefab like you said


It works but it keeps creating small poles objects out of continuous

I maybe did something wrong i'm still not used to Racetrack Builder...

Thanks for your time.

 

So i made it work BUT ther is a BUT

As you can see it works for the small poles but the left & right Big poles (pillards of the track) are not generated.
And i know why...
So this is what i did :

The prefab:
1. i removed the spaced object.
2. i moved the small_pole object into continuous(child of)
3. i added RacetrackSpacingGroup.cs as component to small_pole object.
This makes errors at the lines below of RacetrackBuilder.cs.
Just to make a try, i disabled those lines in the script.

So it works but this affect the big poles generation (the pic) and i don't (yet) know how it should work with the other templates prefab.
Other thing : the five small_pole objects are located at the same position, as one...

Code (CSharp):

1.                 var subtreeCopy = GameObject.Instantiate(subtree);
2.                 subtreeCopy.transform.parent = templateCopy.transform;
3.                 subtreeCopy.gameObject.isStatic = templateCopy.isStatic;
4.                 subtreeCopy.name += " Spacing group " + spacingGroup.Index;
5.                 var spacedCopy = subtreeCopy.gameObject.AddComponent<RacetrackSpacedCopy>();     // Tag with RacetrackSpacedCopy component
6.                 spacedCopy.SpacingGroupIndex = spacingGroup.Index;
7.  

Code (CSharp):

1.                 subtreeCopy.transform.localPosition = newTemplateFromSubtree.MultiplyPoint(Vector3.zero);
2.                 subtreeCopy.transform.localRotation = newTemplateFromSubtree.rotation;
3.                 subtreeCopy.transform.localScale = newTemplateFromSubtree.lossyScale;
4.  

 

@faUnity make sure not to put an object with a "Racetrack Spacing Group" component in the subtree of an object with a "Racetrack Continuous" component (or vice versa).
"Racetrack Continuous" tells Racetrack Builder that all the meshes in the subtree are continous, and should be warped along the curve.
"Racetrack Spacing Group" tells Racetrack Builder that there are objects in the subtree (marked with "Racetrack Spaced" components) that should be repeated at regular intervals.

The two mechanisms are mutually exclusive, it is undefined behaviour to have an object that is both "continuous" and in a "spacing group".


I've attached a modified "asphalt poles barriers" track type prefab, that might be helpful. Modified as follows:

• Moved small_pole out of "spaced" object (the one inside the "rail barrier" object, not the top level one) into "continuous" object.
• Deleted "spaced" object
• Removed "Racetrack Spaced" component from small_pole
• Duplicated small_pole a few times at different Z offsets.
• Repeated the process for the opposite side

I've left the top level "spaced" object alone. This generates the large poles underneath the track.

This results in the following hierarchy when the racetrack is built:


Is that the result you're trying to get?

 

Hi Tom,

Yes it's perfect!
Thanks a lot for your explanations and the prefab.

Greetings.