https://github.com/pakagronglb/boids-3d-flocking-simulation

An interactive 3D Boids simulation built with React Three Fiber. This project demonstrates flocking behavior using Craig Reynolds' Boids algorithm.
https://github.com/pakagronglb/boids-3d-flocking-simulation

3d animation boids simulation threejs vite

Last synced: about 2 months ago
JSON representation

An interactive 3D Boids simulation built with React Three Fiber. This project demonstrates flocking behavior using Craig Reynolds' Boids algorithm.

• Host: GitHub
• URL: https://github.com/pakagronglb/boids-3d-flocking-simulation
• Owner: pakagronglb
• Created: 2025-01-01T10:19:24.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-01T10:27:24.000Z (over 1 year ago)
• Last Synced: 2025-03-02T02:34:18.751Z (over 1 year ago)
• Topics: 3d, animation, boids, simulation, threejs, vite
• Language: JavaScript
• Homepage: https://3d-flocking-simulation.vercel.app
• Size: 6.9 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🎮 Boids Simulation

![underwater](./public/images/underwater.jpeg)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![React](https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)](https://reactjs.org/)

[![Three.js](https://img.shields.io/badge/Three.js-black?style=for-the-badge&logo=three.js&logoColor=white)](https://threejs.org/)

[![R3F](https://img.shields.io/badge/React_Three_Fiber-black?style=for-the-badge&logo=three.js&logoColor=white)](https://docs.pmnd.rs/react-three-fiber/)

An interactive 3D Boids simulation built with React Three Fiber. This project demonstrates flocking behavior using Craig Reynolds' Boids algorithm.

![space](./public/images/space.jpeg)

## 🌟 Features

- Real-time 3D flocking simulation

- Interactive camera controls

- Customisable boid parameters

- Smooth animations and transitions

- Responsive design

## 🚀 Getting Started

### Prerequisites

- Node.js (v14 or higher)

- npm or yarn

### Installation

1. Clone the repository

```bash

git clone https://github.com/pakagronglb/boids-3d-flocking-simulation.git

```

2. Install dependencies

```bash

cd boids-3d-flocking-simulation

npm install

```

3. Run the development server

```bash

npm run dev

```

## 🛠️ Built With

- [React](https://reactjs.org/) - Frontend framework

- [Three.js](https://threejs.org/) - 3D graphics library

- [React Three Fiber](https://docs.pmnd.rs/react-three-fiber/) - React renderer for Three.js

- [Vite](https://vitejs.dev/) - Frontend build tool

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- Special thanks to [Wawa Sensei](https://www.youtube.com/@WawaSensei) for the inspiration and tutorial on Boids simulation

- Based on the tutorial: [Building Boids Simulation](https://www.youtube.com/watch?v=WepzbxlYROs)

- Craig Reynolds for the original Boids algorithm

## 🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/yourusername/boids-simulation/issues).

## 📧 Contact

Your Name - [@pakagronglb](https://github.com/pakagronglb)

Project Link: [https://github.com/pakagronglb/boids-3d-flocking-simulation](https://github.com/pakagronglb/boids-3d-flocking-simulation)