Install / Update

Note

If you’re updating a pre 1.2 project, follow the Scripting Runtime Version install step below before updating the project.

The Unity Tools, as the name implies, are a set of tools that extend Unity to create content for BallisticNG.

First off make sure you have Unity 2018.3.8f1, click here for a direct download link.

2018.3.8f1 is required for compatability. Do not install any other version.

Install

  • Create a new Unity 2018.3.8f1 project
  • Once created navigate to File -> Build Settings -> Player Settings, scroll down to the Scripting Runtime Version and make sure it’s set to .Net 4.x Equivalent
  • Navigate to Assets -> Import Package -> Custom Package and open the BallisticUnityTools.unitypackage file shipped with the game. You can find this file in the Modding folder where the game is installed
  • Import everything

Update

Note

It’s reccomended you make a backup of your Unity project, local and/or remote source control with git would be ideal. If something goes wrong you can restore your backup, or rollback to your last commit with git.

If something does go wrong, do not save anything as this will wipe any saved data that can be restored. Try restarting Unity to see if it fixes your problem. If not, you’ll want to rollback to a backup.

  • Open your Unity project and create a new scene to ensure nothing is open
  • Navigate to Assets -> Import Package -> Custom Package and open the BallisticUnityTools.unitypackage file shipped with the game. You can find this file in the Modding folder where the game is installed
  • Import everything
  • Restart Unity, do not save scenes if prompted to

Something broke?

In older versions of the Unity Tools there was a bug where TRM meshes might be reimported and reconstructed from scratch when importing new versions which broke references in track scenes. This is fixed in recent versions, but in case this happens and you find your tracks are broken after an update then follow these steps:

  • Load the track scene that has been broken
  • Run BallisticNG -> Utilities -> 5.6 to 2017 Scene Updater
  • Save a copy of the scene
  • Create a new scene
  • Load the new copy of your scene
  • Save over your original scene and delete the copy you just made