particle-life-sim

A headless Particle Life simulation core: colored particle families follow simple attraction/repulsion rules and self-organize into emergent colonies. Zero dependencies, framework-agnostic — you own the rendering.

Powers the free simulator at particlelife.app — watch emergent behavior in your browser.

Install

npm install particle-life-sim

Use

import { createSimulation } from "particle-life-sim";

const sim = createSimulation({ count: 400, families: 4, width: 800, height: 600, seed: 1 });

function frame() {
  sim.step(0.1);
  // render sim.x[i], sim.y[i], sim.type[i] however you like (canvas, WebGL, SVG...)
  requestAnimationFrame(frame);
}
frame();

Pass your own rules (a families x families matrix in [-1, 1]) for reproducible ecosystems, or omit it for a seeded random one.

API

createSimulation(opts) → { count, families, rules, x, y, vx, vy, type, step(dt) }

Options: count, families, rules, width, height, rMax, friction, forceFactor, seed.

Try it live at particlelife.app.

License

MIT