# threejs-ballooning

**Repository Path**: webglset/threejs-ballooning

## Basic Information

- **Project Name**: threejs-ballooning
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-03-28
- **Last Updated**: 2021-04-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ballooning with Three.js
This was developed as a study into procedural terrains, buffer geometry optimisation and shadow mappers with Three.js and WebGL.
I had some grand plans for the application, but they were never realised so it's probably more useful to just release it as it is for others to take a look!
There are plenty of issues with it and it's pretty rough having been developed over 2 years ago now, but if it's some use to anyone that's great.

Example at https://alexanderperrin.com.au/triangles/ballooning.

Use the arrow keys or the left and right sides of the screen on touch devices to move the balloon.

## Features
- Procedurally generated infinite terrain & tree placement
- Happy flapping birds
- Shoreline boathouse placement
- Pleasant mountain ballooning
- Statically batched tree rendering
- Runs on desktop and mobile

## Development
Feel free to have a dig around in the code and change things. I've setup a [webpack](https://webpack.js.org/) development environment with hot module replacement that you can use to quickly iterate the application.
- Ensure that you have node and npm installed on your machine. You can follow the official instructions at https://www.npmjs.com/get-npm
- Clone the repository into your desired project folder
- Run `npm install` from within the project folder to install dependencies
- Ensure webpack-cli is either available globally or installed locally (`npm install --save-dev webpack-cli`)
- Run `npm start`. This will spin up a webpack development server running at http://localhost:8080
- Change the code you like and see what happens!

## Building
- Run `npm run build` to build a production ready version of the web app.
- Contents will be processed into /dist, which you can upload to your web server.

## License
MIT

## Warranty
None whatsoever.