Quick start guide for Havok Physics

This guide aims to get you up and running as quickly as possible with Havok Physics for Unity.

The steps below make use of the Physics Samples publicly available on GitHub (see the Physics Samples documentation for more details).

Adding the Havok Physics for Unity package

1. Get the Physics Samples if you don't already have them.

2. Open the PhysicsSamples project

3. Add the Havok Physics package..

   ..via Package Manager

   1. Open Unity's Package Manager from the Window > Package Manager menu item
   2. Select Packages: Unity Registry, select and install Havok Physics for Unity. Note that the Install button is at the top right of the window.
      

   ..or via zip download

   1. If receiving the packages outside of the package manager unzip Havok.Physics.zip to desired package directory outside of the new clone directory e.g. D:\Packages\
   2. Locally modify the samples project's manifest to add this package as a dependency.

      "dependencies": {
      ...
      "com.havok.physics": "file:D:/Packages/Havok.Physics/com.havok.physics",
      ...
      }
      

4. Ensure the Havok Physics plugin is installed by checking in the Packages subfolder.
   

Change a scene to simulate with Havok Physics for Unity instead of Unity Physics

1. Open the HelloWorld test scene located in Assets\1. Hello World\HelloWorld.
   
2. Toggle on the HelloWorldSubScene subscene in the scene hierarchy.
3. Select the Physics Settings node.
4. In the inspector, change the Simulation Type of the Physics Step component from Unity Physics to Havok Physics.
   
   Note: the Simulation Type in the Physics Step component can also be toggled at runtime as well.
5. Press Play to simulate the scene using the Havok Physics backend.
   
6. In the Game tab use the left mouse button (LMB) to click and drag dynamic rigid bodies. Holding the right mouse button (RMB) activates mouse look and the 'ASWDQE' keys move the camera.

The Havok Physics simulation behavior can be further configured in any scene by using the Havok Configuration component. The simulation can also be analysed with the Visual Debugger.