Skip to content

Latest commit

 

History

History
60 lines (49 loc) · 2.17 KB

File metadata and controls

60 lines (49 loc) · 2.17 KB

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