Need help with boids?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

196 Stars 45 Forks 2 Commits 6 Opened issues

Services available


Need anything else?

Contributors list

# 103,636
2 commits

Boids algorithm demonstration

Copyright 2020 Ben Eater

This code is MIT licensed.

What is this?

This is a simple demonstration of the boids algorithm that's featured in this Smarter Every Day video:

This simulation is running on my website if you’d like to check it out.

How does it work?

Each of the boids (bird-oid objects) obeys three simple rules:

1. Coherence

Each boid flies towards the the other boids. But they don't just immediately fly directly at each other. They gradually steer towards each other at a rate that you can adjust with the

variable. In the demo, you can adjust this from 0 to 0.01 with the "coherence" slider.

2. Separation

Each boid also tries to avoid running into the other boids. If it gets too close to another boid it will steer away from it. You can control how quickly it steers with the

variable. In the demo, you can adjust this from 0 to 0.1 with the "separation" slider.

3. Alignment

Finally, each boid tries to match the vector (speed and direction) of the other boids around it. Again, you can control how quickly they try to match vectors using the

variable. In the demo, you can adjust this from 0 to 0.1 with the "coherence" slider.

Visual range

There are a ton of ways to extend this simple model to better simulate the behavior of different animals. An example I showed in the video is to limit the "visual range" of each boid. Real animals can't see the entire flock; they can only see the other animals around them. By adjusting the

variable, you can adjust how far each boid can "see"—that is which other boids it considers when applying the three rules above.

How do I run this code?

It ought to run in any web browser. Download (or clone) the files. Then, just double-clicking on

on most computers will open the simulation in your web browser. You can then edit
to tweak and experiment with the algorithm. Simply save your changes and reload the web browser page to see the effect.

What else can I do?

There are lots of features you could try adding to the code yourself:

  • Add a predator that the boids try to avoid that scatters the flock if it gets too close.
  • Add a strong wind or current to see what effect it has on the flock.
  • Add "perching" behavior. If a boid gets close to the bottom of the screen, have it land and hang out on the ground for a bit before taking off again and rejoining the flock.
  • Make it 3D! The boids' velocity is currently represented as a 2D vector. You could change them to 3D vectors and update the vector math to work. To draw in 3D, you could just change the size of the boids to represent how far away they are.

See this link for more ideas and hints on how to do some of the ideas above.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.