Modding Torque Drift 2

Modding is the way for players to create their own content inside Torque Drift 2's framework. Implemented and controlled through mod.io, players have the freedom to create any drifting maps they can imagine to be played and rated by the greater community. The below FAQ will go into detail on how to set up Torque Drift 2's modding files and the best ways to avoid some of the more common issues.

If you have already or are currently creating a mod with the old Modkit (Version “20231215” or older), please follow this guide to update your Modkit to the new version to ensure your Mods’ compatibility with future updates to Torque Drift 2.

0.8 Modkit

FAQ
How do I use Unreal Engine 5?

Torque Drift 2 runs on Epic Games’ Unreal Engine 5, which is what you will need to download to create and test any of your maps. This information is widely accessible thanks to Epic’s online documentation and YouTube channel but be sure to look for information specifically about 5.3. We will not go through any information on the basics of using Unreal Engine in this documentation as any tutorial we could provide would be better explained through Epic’s current platforms.

How do I setup Unreal Engine 5?

Torque Drift 2 is built using Epic Games’ Unreal Engine 5. Specifically, we have built the game using the 5.3 version for its accessibility to environment art tools which you can download here: unrealengine.com/en-US/download.

After downloading and installing Unreal Engine, please download the Visual Studio launcher here: https://visualstudio.microsoft.com/vs/community/.

Once downloaded and installed, you will need to open the Visual Studio installer and download ‘Visual Studio Community 2022’. When it asks you what kind of workloads you’d like to install, select Desktop Development with C++ and Game Development with C++

How do I setup the Torque Drift 2 UE5 project?

Now that you have both Unreal Engine and Visual Studio, you can download the latest version of the modding project from the link below.

DOWNLOAD HERE

Choose the location where you normally install your games to install the Modkit. If you only have one storage solution, select the C: Drive.

After it has been downloaded & installed successfully, double-click the “TD2_ModKit” uproject file to open the Unreal Engine project. You should now be able to mod the game and create new maps for the world to play!

What do I do with the Initial Popup?

When you first open the project, you will most likely encounter the window below. This is normal and is just the project updating the plugins we use to be compatible with your machine. Click yes on the notification and it should install everything needed.

Why does my game not launch when I test?

We’ve noticed some issues with launching the game from the editor due to the live coding option being on. For peace of mind, be sure to turn this off when you get into the project to ensure you don’t encounter these issues.

How do I create a new map?

Now that you have Unreal Engine setup with the Torque Drift 2 SDK files, you can now start making your own map. To begin this process, go to the top navigation bar of Unreal Engine and press this Torque Drift 2 button.

This should open the Modkit window

From here, you are able to create a brand new mod with the ‘NEW MOD’ button or upload a mod to mod.io using the ‘UPLOAD MOD’ button. Click on the ‘NEW MOD’ button to begin. The window should look like the image below once clicked.

Press the down arrow on ‘Mod Template’ and select the only option there. Type in a name without spaces and a summary. Press the ‘CREATE FROM TEMPLATE’ button which should create a new folder in the same location as below like in the image below.

Each map tutorial gives the same assets whenever you first create the file. By default, these are the level itself, which is what is called when inside the game, and the data asset table, which tells the game what information the player sees on mod.io. The mod folder that was created for you will be where everything unique is pulled into the game so make sure that any new assets you create that aren’t in Torque Drift 2, are placed in these folders. Assets that are not in this folder but are called in the scene will return errors that will make your level unable to be played.

You are now free to create your level however you please. If you are new to Unreal Engine, one of the easiest tools to begin your journey in creating is by using the BSP tools supplied by default.

Documentation can be found here on how to use BSPs: https://docs.unrealengine.com/5.2/en-US/geometry-brush-actors-in-unreal-engine/

How do I test my map?

So you’ve done a couple of passes on the level now and want to test it to make sure you have the desired experience. One of the benefits of our SDK is that we have the entire testing phase set up with a single button press. First, however, you will need to map your unreal engine to the games .exe file.

Before you begin testing, you’ll need to first go to ‘Edit > Editor Preferences > Torque Drift 2 > General Settings’ and change the TD2 Application Path to where your Torque Drift 2 .exe file is.

Once linked, select the three dots at the top of the screen next to the Torque Drift 2 modkit button. It should open a list of maps as shown below. Select the map you wish to test.

After that, all you need to do is press the blank square button next to the Torque Drift 2 modkit button at the top of the screen. Be aware that this can take 5 minutes or more on the initial test of your map where it will build the level and open it in a standalone version of Torque Drift 2.

How do I upload my Mod?

The final step of this process is uploading your mod to mod.io. You can do this at any time during your process and you’re even able to reupload any updates you have but is often completed once you are ready to let the public see your map. When you’re ready, go back to the modkit window and click on the ‘UPLOAD MOD’ button.

Fill in the information for the mod and press the build and upload mod button once completed.

Once clicked, the map will begin packaging in the backend with an icon showing in the bottom right-hand corner of the screen. You can open the packaging log up but clicking the ‘show output log’ but the level will not be ready to be uploaded until the packaging has been completed.

How do I choose where the car spawns in my level?

The Player Start asset that can be found in the “Place Actors” menu should be placed on every map to mark the spawn location for player vehicles. Without one, the map will load the car to a random default location.

Please ensure you place 4 Player Start actors in the scene before uploading your mod, to allow for multiplayer compatibility with your mods

How do I use the default lighting scenarios?

With this new Modkit, we have included a bunch of new default lighting scenarios for players to use if you so desire.

To use these, follow the steps outlined below.

  • Make sure you’re loaded into your Mod Level and have saved before continuing.
  • In your content Browser navigate to “TD2ModKit Content” > “TD2_Generic_Lighting_Scenes”.
  • Select and drag any of the lighting levels into your level viewport.

Congratulations you now have lighting in your level.

Okay, so you followed the previous steps and it’s still not looking how you want it to. That’s okay you can change it to how you like!

The lighting levels can be altered pretty easily. If you need to do so, follow the steps outlined below.

  • Open the Lighting scenario level that you want.
  • Once you are in that lighting scenario level, Highlight and copy the contents of the lighting folder.
  • Now go back to your Mod level
  • Once it has loaded, create a new Lighting Folder in the outliner.
  • Paste the contents into the Lighting Folder in the outliner.
  • You are now free to edit the lighting how you like!
How do I update my existing mod to 5.3?

Preparing your new Modkit

Download your new Modkit from the previous link above and extract the folder in your designated position.

Do not Delete the old Modkit yet, you still need to access the files if you want to import your Mod from the previous version.

Unreal Engine Install

With the new 0.8 update, Torque Drift 2 uses Unreal Engine 5.3 (5.3.2).

Because of this, any Mods created before the 0.8 release will no longer work and need to be updated.

To continue creating mods, please download Unreal Engine 5.3.2. You can download Unreal 5.3.2 here: unrealengine.com/en-US/download.

Updating your Mods

Before you proceed, please ensure that all the files you need for your Mod are in the “Tracks” Content folder.

Open up two Windows Explorer windows. On one of the windows navigate to the “Plugins” folder of your old Modkit folder.

On the other window open up the “Plugins” folder of your new Modkit.

Copy your Mod folder from the old Modkit and paste it into the new Modkit.

Once you’ve done this, you can open the new Modkit. The level should be ready to go.

With this update, you can now create “Multiplayer mods”. Because of this, ensure that your updated tracks include; 4 “Player Start” assets spaced out evenly to ensure a smooth player spawn for all players.