https://github.com/paladin-t/beparticles

A particle system for Bitty Engine.
https://github.com/paladin-t/beparticles

bitty bitty-engine lua particle-effects particle-system particles pico-8

Last synced: 6 months ago
JSON representation

A particle system for Bitty Engine.

• Host: GitHub
• URL: https://github.com/paladin-t/beparticles
• Owner: paladin-t
• License: mit
• Created: 2021-08-24T13:16:45.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-01-01T03:26:05.000Z (over 4 years ago)
• Last Synced: 2025-03-25T23:32:40.919Z (about 1 year ago)
• Topics: bitty, bitty-engine, lua, particle-effects, particle-system, particles, pico-8
• Language: Lua
• Homepage: https://paladin-t.github.io/beparticles/
• Size: 2.33 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# beParticles

beParticles is a particle system implemented in pure Lua for [Bitty Engine](https://github.com/paladin-t/bitty/). It is ported from [MaxwellDexter/pico-ps](https://github.com/MaxwellDexter/pico-ps).

The idea is to port the original PICO-8 implementation to Bitty Engine in as few modification as possible, it is done with an extended Luax to regular Lua compiler and a compatibility layer. It makes it easy to synchronize with future version.

Try it out [in browser](https://paladin-t.github.io/beparticles/).

### Features

"beParticles" implements:

* Continuous emissions (default)

* Burst emissions

* Gravity

* Random colors

* Speed over lifetime and speed spread

* Life spread

* Angles and angle spread

* Size over lifetime and size spread

* Emission areas

* Color over life

* Sprite animation

* Random sprites

* Object Pooling

### Glance

Play [in browser](https://paladin-t.github.io/beparticles/).

![](imgs/beParticles1.gif)

![](imgs/beParticles2.gif)

![](imgs/beParticles3.gif)

### Usage

Setup:

1. Clone this repository or download from [releases](https://github.com/paladin-t/beparticles/releases)

2. Open "src" directly or import it to your own projects with [Bitty Engine](https://github.com/paladin-t/bitty/)

3. See code and comments for details

Code:

See [MaxwellDexter/pico-ps](https://github.com/MaxwellDexter/pico-ps) for details.

Note:

Bitty Engine uses the standard Lua coordinates where rotation angle starts from X+ and grows clockwise, with range of values from `0` to `2 * PI`.

![](imgs/polar1.png)

beParticles (pico-ps) starts from X+ but grows anticlockwise, with range of values from `0.0` to `1.0`.

![](imgs/polar2.png)