EffectNew
Insect swarm
A swarm of insects or locusts: a dense cloud of jittering dark dots that hangs and drifts, thick at the middle and ragged at the edge.
- Version
- 1.0.0
- Added
- 23 October 2026
- Films
- Not used in a film yet
Parameters
| Name | Type | Default | Range | What it does |
|---|---|---|---|---|
| count (Can change over time) | number | 900 | 50 to 1800 | how many insects are in the swarmCan change over time |
| at | vec2 | 3, -6 | -3000 to 3000 m | where the swarm hangs, metres along the shore and inland of home's door |
| height | number | 2.6 | 0.5 to 200 m | how high above the ground the middle of the swarm is |
| radius | number | 3.2 | 0.5 to 150 m | how far the dense part of the swarm reaches from its middle |
| wander | number | 2.5 | 0 to 100 m | how far the whole cloud drifts about its place; 0 holds it still |
| jitter | number | 0.8 | 0 to 1 | how frantically each insect darts about; 0 is a slow hover |
| viewDistance | number | 11 | 3 to 2000 m | how far the camera is from the swarm; each insect is drawn at least 2 pixels, so it is a dot a few cm wide at 10 m |
| colour | color | #26241c | – | the colour of the insects: dark brown-black |
Use it in a film
film.js
elements: { 'insect-swarm': { count: 900, at: [3, -6] } }Use it from your agent
Ask your agent to put it in a film. It finds the element by name.