Skip to content

A highly satisfying, controller-only physics sandbox toy with neon aesthetics, destructible glass, and procedural audio. Built with Pygame and Pymunk.

Notifications You must be signed in to change notification settings

DjagbleyEmmanuel/physics-sandbox-toy

Repository files navigation

Physics Sandbox Toy (Linux)

A high-fidelity, highly satisfying, controller-only physics sandbox toy for Linux. Built with Pygame, Pymunk, and Numpy.

This project focuses on "juicy" physics feel, vibrant neon aesthetics, and seamless controller interaction.

✨ Features

  • Advanced Physics: Powered by pymunk, featuring tuned damping, friction, and kinetic response.
  • Destructible Glass: Certain blocks shatter into shards on high-impact collisions.
  • Spring Linker: Connect objects dynamically with glowing springs to build structures or chains.
  • Vortex Mode: A gravitational singularity that pulls and swirls objects into a cosmic dance.
  • Magneto Grab: Directly grab and sling objects using the right stick cursor.
  • Neon Particle System: Glowing sparks and trails react to every collision and explosion.
  • Procedural Audio: Synthesized thuds and shattering sounds generated in real-time.
  • Time Dilation: Slow-motion mode for cinematic physics observation.

💾 Installation

Prerequisites

  • Python 3.10+
  • Linux with a connected Xbox 360 or compatible controller.

Using Source

  1. Initialize a virtual environment:
    python3 -m venv .venv
    source .venv/bin/activate
  2. Install dependencies:
    pip install -r requirements.txt
  3. Run the game:
    python3 main.py

🕹️ Controls (Controller Only)

Input Action
Left Stick Gravity Direction (Smoothed)
Right Stick Force Cursor Position
RT / LT Increase / Decrease Gravity Strength
RB (Bumper) Hold while spawning to Link with Springs
LB (Bumper) Slow Motion (Time Dilation)
A / B Spawn Ball / Box (at Cursor)
X Explosive Impulse
Y Smooth Clear (Fade Out)
Right Click (R3) Magneto Grab (Direct Manipulation)
D-Pad L/R Cycle Modes (Normal, Low Grav, Chaotic, Vortex)
Back/Select Toggle FPS Debug
Start Hard Reset (Clear All)

🕹️ Keyboard Shortcuts

  • ESC: Exit Simulation

Maintained by Priderock Elohimmanuel

About

A highly satisfying, controller-only physics sandbox toy with neon aesthetics, destructible glass, and procedural audio. Built with Pygame and Pymunk.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages