Skip to content

A procedural planet builder, powered by VueJS + ThreeJS!

License

Notifications You must be signed in to change notification settings

EepyBerry/lagrange

Lagrange - Procedural Planet Builder πŸͺ

A WebGL project using VueJS and ThreeJS!
Lagrange is a browser application to help you create your own planets, using procedural noise as a foundation to build upon.

πŸͺβœ¨ Check out the app here! ✨πŸͺ

(note: this is something I am working on during my free time, which means that update frequency will vary!)

πŸš€ Latest version: "Ecosystems"!

  • ⭐ Introduces a fully fledged biome system, using temperature- & humidity-based positioning!
  • ⭐ Surface noise now works properly in Linux-based browsers!
  • ⭐ Smaller performance fixes all around, including fewer GLSL uniforms & varyings!

πŸ–ΌοΈ Showcase

planet:Kormeg planet:Meriana planet:Hoven
planet:Rakken IV planet:Rilgar planet:Xu'Alatl

⚠️ Requirements

IMPORTANT: to properly run the application, WebGL 2.0 browser support is required!
The following website will give you more information on your WebGL capabilites: WebGL Report

Please check both of them thoroughly before submitting an issue, thanks! <3

βš™οΈ Installation & building

For more details on the commands themselves, check the package.json file.

Run locally

Clone the repository then use the following commands:

  • Install dependencies: npm install
  • Run the application locally: npm run dev / npm run dev-host

Lagrange runs on port 5173 by default; dev-host exposes the application to the local network.

Build project

Building is done with the following command:

  • npm run build

Vite copies the output to the dist folder, creating it first if need be.

πŸ“‹ Current feature set

Codex (landing page)

  • πŸ“‹ Create, import & export your planets!
  • πŸ”Ž See previews of your creations!

Editor

  • β˜€οΈ Lighting parameters! (sunlight, ambient light)
  • 🌍 Planet & Rendering parameters! (transform, water level, PBR settings)
  • πŸ—ΊοΈ Surface parameters! (bump mapping, noise settings, color ramp)
  • ⛰️ Biome parameters! (temperature/humidity mapping, per-biome min/max values & color)
  • ☁️ Clouds parameters! (transform, color, opacity ramp)
  • 🌈 Atmosphere parameters! (density, color mixing modes)

⏰ Planned features

  • Dark side "night lights"!
  • Cracks & Craters!
  • Gas Giants!
  • Rings & Asteroid belts!
  • Galactic Map, to organize them around stars!

✨ Inspirations

This project is heavily inspired by the awesome projects below:

πŸ““ Licensing

Original assets and source code from this project are provided under a BSD 3-Clause "New" or "Revised" License.
Please consult the license file for full information.

Content from other parties is provided under their respective license, and attribution is given at the top of the aforementioned content.

🀝 Contributing

If you want to contribute code, feel free to submit your PRs!

Please make sure to respect the following:

  1. fork the project
  2. create a branch from develop
  3. request your branch to be merged into develop