Polaris Physics Framework: Planetary Gravity & Magnets

A deterministic 2D and 3D physics framework for custom planetary gravity, magnetic levitation, and dynamic force fields using native Unity Rigidbodies.

• Supports both 2D (Box2D) and 3D (PhysX) native Unity physics engines.
• FieldAttractor and FieldBody core components with zero external dependencies.
• Selectable Field Types: Gravity (Constant Pull) and Magnetic (North/South Polarity).
• Customizable Falloff Exponents: Constant (0), Linear (1), Inverse-Square (2), and Inverse-Cube (3).
• Dynamic Surface Alignment: AutoAlignUp automatically calculates tangents for spherical walking.
• Optimized for mass scale: Supports 800+ dynamic bodies operating simultaneously via standard FixedUpdate logic.
• Fully exposed C# API for runtime manipulation of forces, radii, and polarities.

Supported OS:Windows, macOS, Linux, WebGL, Android, iOS.

Render Pipelines:Built-in, URP, and HDRP (Core physics logic is completely render-pipeline agnostic).

Dependencies:Unity 2021.3 or higher.

Polaris is a modular, high-performance physics framework that replaces Unity’s default linear gravity with dynamic, customizable force fields. Designed for both 2D and 3D projects, it allows you to easily implement complex physical behaviors—like spherical planetary gravity, magnetic levitation tracks, and localized tractor beams—without writing complex vector math.

Built directly on top of Unity's native Rigidbody and Rigidbody2D components, Polaris ensures immediate compatibility with your existing colliders, character controllers, and third-party movement scripts. Simply drop a FieldBody component onto your dynamic objects and a FieldAttractor onto your gravity sources to establish instant physical relationships.

Whether you are building a 360-degree platformer, a space exploration game with realistic orbital mechanics, or a puzzle game requiring real-time directional gravity shifts, Polaris provides the lightweight, highly optimized architecture to drive your mechanics.

Core Use Cases:

• Planetary Platforming: Automatic surface alignment rotates characters to seamlessly walk around spheres and transition smoothly between multiple gravity wells.
• Magnetic Levitation: Inverse-cube falloff settings allow for perfectly stable hover mechanics and repulsion tracks.
• Swarm Mechanics: Highly optimized component structure handles 800+ active rigidbodies for vacuum, resource routing, or flocking behaviors.
• Directional Gravity: Shift global gravity in real-time for puzzle rooms or dynamic hazards.

Package Includes:

• Full, cleanly organized C# source code.
• 5 production-ready showcase scenes demonstrating core 2D and 3D mechanics.
• Comprehensive documentation with API scripting examples.