Requirements
- A modern web browser (Chrome recommended, Firefox/Edge/Safari also work)
- No installation or build step required
Which Version Should I Use?
| If you want to… | Use | Link |
|---|---|---|
| Explore and tweak every parameter | The Generator | Open → |
| Create mascot avatar compositions | The Stencil | Open → |
| Quickly browse seed personalities | The Masked | Open → |
| See the branded landing page | Demo Hub | Open → |
Opening a Simulator
Option 1: Live on GitHub Pages
Click any link above. Every simulator runs entirely in your browser.Option 2: Run Locally
Clone or download the repository and openindex.html, stencil.html, or masked.html directly in your browser.
Quick Start: The Generator
- Open
index.html. The swarm starts growing immediately with seed12345. - Click Random to discover new patterns
- Adjust the sidebar sliders to shape the swarm’s behavior
- Hit Save PNG or Record WebM to capture your pattern
Generator Defaults
| Parameter | Default Value |
|---|---|
| Seed | 12345 |
| Cell Count | 6,000 |
| Speed | 2.8 |
| Sensor Distance | 22 |
| Sensor Angle | 40° |
| Turn Speed | 20° |
| Signal Deposit | 12 |
| Signal Decay | 0.968 |
| Diffusion | 0.25 |
| Attractors | 12 |
| Palette | Shumi Gold |
Quick Start: The Stencil
- Open
stencil.html. The swarm grows behind the mascot automatically. - Use 1 2 3 4 keys (or buttons, top-right) to switch formation modes
- Press and hold Space for a full-intensity blast reveal
- Open ☰ Settings (top-left) to fine-tune parameters
- Click Share to copy a shareable URL
Quick Start: The Masked
- Open
masked.html. A random seed loads automatically. - Click New Seed to explore different palette/texture combinations
- Each seed selects its own palette and texture, so just keep clicking
- Click Save PNG or ● Record to capture