Ball & Marble Controller | Physics Ball movement System & Framework

Physics-Based Rolling Controller for Unity

The Ball-Marble Controller is a production-ready, physics-driven rolling ball system built for Unity. Perfect for marble games, 3D platformers, obstacle courses, and physics-focused experiences, this asset delivers responsive torque-based movement, custom gravity, flexible camera modes, and full mobile input support.

Designed with clean architecture and modular components, it is easy to extend, customize, and integrate into both small prototypes and full-scale games.

Core Features

Physics-Based Ball Movement
Torque-driven rolling using Rigidbody physics
Custom gravity with configurable strength and direction
Reliable jumping with SphereCast ground detection
Speed boost and impulse force support
Uncapped angular velocity for high-speed marble gameplay

Advanced Camera System
Velocity Orbit mode that follows movement direction
Over-the-Shoulder mode for stabilized third-person control
Slope-aware pitch adjustment for uphill and downhill visibility
Smooth damping and collision avoidance to prevent clipping
Runtime camera mode switching

Multiple Input Methods
Keyboard and controller support using Unity Input axes
Mobile-ready touch and swipe input with DPI scaling
Camera-relative movement calculation for intuitive control

Collision and Effects
Impact-based landing particle effects
Predictive collision handling for destructible environments
Configurable physics materials for friction and bounce control

Clean Character Architecture
Central Character hub connecting all subsystems
Shared CharacterComponent base class for easy access
Clear separation between input, physics, camera, and effects