NWH Vehicle Physics 2 is a collection of VehicleComponents. All aspects of it are a component - sound components, effect components, etc. - they all inherit from VehicleComponent. The only way that a module is different from an inbuilt component is that it can be added or removed as needed.
Modules carry over state system from the VehicleComponent which means that each module can be turned on or off, enabled or disabled or have LOD set.

• To add a module click on Add Component button at the bottom of the Inspector. Modules must be added to an object that already contains VehicleController.
• Each module is wrapped in a MonoBehaviour wrapper ModuleWrapper. This is a way to work around lack of multiple inheritance in C#. So, to add a module just add its wrapper to the vehicle:

Adding a new module.

• Modules get drawn inside ModuleManager drawer. Go to Modules tab of VehicleController to see all of the available modules. This is to avoid cluttering the inspector with a multitude of different editors. Modules can also be filtered by category to make navigation easier.

Example module wrapper editor.

Module category selector inside ModuleManager.

Each module is wrapped in a MonoBehaviour wrapper called ModuleWrapper. This is a way to get around lack of multiple inhertance in C#.
VehicleModule inherits from VehicleComponent, but it also needs to be serialized and for that it needs to be a MonoBehaviour. The new attribute [SerializeReference] has been present in Unity since 2019.3 and original implementation used that but the amount of bugs and lack of backwards-compatibility with older versions of Unity resulted in the wrappers being used instead.

To add a module use:

 myVehicleController.moduleManager.AddModule<MyModuleWrapperType, MyModuleType>(); 

Example (adding an ABSModule):

 ABSModule absModule = myVehicleController.moduleManager.AddModule<ABSModuleWrapper, ABSModule>(); 

To get a module use:

 myVehicleController.moduleManager.GetModule<ModuleType>(); 

Example (getting ABSModule):

 ABSModule absModule = myVehicleController.moduleManager.GetModule<ABSModule>(); 

Alternatively, module can be retrieved through MonoBehaviour. The next snippet does exactly the same as the snippet above but might be more practical in some cases:

 MyModule module = myVehicleController.GetComponent<MyModuleWrapper>().module as MyModule; 

To remove a module use:

 myVehicleController.moduleManager.RemoveModule<ModuleWrapperType>(); 

Example (removing ABSModule):

 myVehicleController.moduleManager.RemoveModule<ABSModule>(); 

Since modules inherits from VehicleComponent they also work on the same principle:

 myModule.Enable(); 

 myModule.Disable(); 

Note that disabling or enabling a module will have no effect while LODs are active for that module as the LOD system will override the manual settings while active.
To disable LODs for a module use:

 myModule.LodIndex = -1; 

For class reference click here.

• In the Scripts ⇒ Vehicle ⇒ Modules ⇒ ModuleTemplate folder there is an empty example module. Copy ModuleTemplate to create a starting point for a new module.
• Modules can be placed anywhere in the project and do not have to be in the same namespace as included modules.
• Directory structure of a module should be as following:

Example module directory structure.

• Each module must have at least three files:
  • ModuleDrawer (a type of CustomPropertyDrawer) placed in Editor folder.
  • Module file(s).
  • ModuleWrapper
• Each module must have a property drawer. All module drawers inherit from ModuleDrawer which uses NUI editor GUI framework (developed by NWH coding) to render custom property drawers and editors through simplified syntax. This also makes the created module compatible with ModuleManager drawer.