Skip to content

README.md

Latest commit

 

History

History
39 lines (27 loc) · 1.25 KB

README.md

File metadata and controls

39 lines (27 loc) · 1.25 KB

BallSimulation

A simple and interactive ball simulation built using Lua, LÖVE2D, and SUIT (Simple UI Toolkit for LÖVE). This project demonstrates basic physics, collision, and UI interaction in a LÖVE2D environment.

image

Features

  • Multiple Bouncing Balls: Watch balls bounce and interact with each other and the environment.
  • Physics Simulation: Basic gravity, collision detection, and response.

Getting Started

Prerequisites

  • LÖVE2D 11.x or newer
  • Lua (optional, if you want to run standalone scripts)
  • SUIT (UI library for LÖVE2D, included as a submodule or in the libs folder)

Running the Simulation

  1. Clone the Repository:

    git clone https://github.com/JameDevOfficial/BallSimulation.git
cd BallSimulation

  2. Run with LÖVE2D:

    • On Windows: Drag the project folder onto love.exe
    • On Mac/Linux: 
      love .

Controls

  • Add Ball: Click on the empty white screen
  • Remove Balls: Click "Clear"
  • Toggle Splitting and Merging: Click "Enable/Disable Splitting/Merging"