NWH Common

Shared utilities and components used across all NWH packages.

This package provides foundational systems for NWH Physics World - a collection of inter-compatible vehicle simulation assets.

---

Overview

NWH Common is the foundation package used by all NWH physics assets. It provides:

• Input System - Flexible provider-based input architecture
• Camera System - Camera management and control
• NUI Framework - Custom editor GUI framework
• Utilities - Math, geometry, and conversion utilities
• Center of Mass - Rigidbody CoM and inertia control
• Shifting Origin - Large world support

Used By

NWH Common is automatically included with:

• NWH Vehicle Physics 2 (Asset Store | Documentation) - Complete vehicle simulation
• NWH Dynamic Water Physics 2 (Asset Store | Documentation) - Water interaction and boat physics
• NWH Aerodynamics (Asset Store | Documentation) - Flight simulation and aerodynamics
• Wheel Controller 3D (Asset Store | Documentation) - Advanced wheel physics

Key Features

• Provider Pattern Input - Abstracted input supporting Unity Input Manager, Input System, mobile UI, and custom providers
• Camera Management - Easy multi-camera switching and control
• Custom Editors - Consistent, professional inspector UI across all NWH assets
• Math Utilities - Optimized physics and geometry calculations
• Large World Support - Shifting origin for maps exceeding 1000m
• Unity 6 Package - Requires Unity 6000.0.80f1 or newer

Documentation

Manual:

• Input System - Flexible input provider architecture
• Camera System - Camera management and control
• Vehicle Changer - Switching between vehicles, and character enter/exit
• Variable Center of Mass - Rigidbody CoM adjustment
• Utilities - Math, geometry, and conversion helpers
• NUI Framework - Custom editor framework
• Shifting Origin - Large world support
• Changelog - Version history
• Upgrade Notes - Compatibility and migration guidance

Reference:

• API Documentation - Complete API reference available in the navigation menu

Requirements

• Unity 6000.0.80f1 or newer
• Input System 1.11.2
• Universal Render Pipeline 17.0.3

URP is a hard dependency. Settings/URP ships outside Samples~, so its pipeline assets are always imported and cannot be deserialized without URP present. This does not force a project onto URP; the assets only have to be loadable. The other NWH packages pick URP up through their dependency on Common.

NWH Aerodynamics 14.3.0 and Dynamic Water Physics UPM 14.3.0 declare an exact dependency on NWH Common 14.3.0. Keep the three packages on that coordinated release set.

Architecture

NWH Common uses several design patterns:

• Provider Pattern - Input abstraction for flexible input sources
• Static Provider Registry - Provider components register in InputProvider.Instances during Awake() and remain registered until destroyed
• Observer Pattern - LOD system for performance optimization
• Strategy Pattern - Pluggable input providers

Support

For questions, problems, or suggestions:

• Email: [email protected]
• Discord: https://discord.gg/ubFBbM8

This package is automatically installed and updated with NWH physics assets.