Welcome to Terren, an innovative open-source project that empowers voxel terrain generation and visualization right from your browser. ๐
Terren harnesses the power of procedural generation, combining rules and noise maps to craft unique voxel terrains. Whether youโre a seasoned developer, a creative enthusiast, or simply curious about the art of world-building, Terren provides a user-friendly platform to unleash your imagination.
With Terren, youโre not limited to pre-defined landscapes โ import your own noise maps to generate terrains that reflect your vision.
[!NOTE] > (coming soon)
Export your creations as images, .glb models for use in 3D applications, or JSON configurations for seamless integration into your projects.
Framework: Next.js, React, TypeScript
UI: @shadcn-ui, TailwindCSS, SCSS, Framer Motion
3D Rendering: Three.js, @react-three/fiber
- Clone the repository
git clone https://github.com/tomasgrusz/terren.git
- Navigate to project folder
cd terren
- Install all dependencies
npm install
# or
yarn install
# or
bun install
- Run the development environment
npm run dev
# or
yarn dev
# or
bun dev
- Open http://localhost:3000 within your browser
All contributions from the community are welcome! If you have a tool, library, or resource that you believe would be valuable to others, please follow these steps to contribute:
- Fork the repository
- Create a new branch
git checkout -b new-feature
- Add your contribution
- Commit your changes
git commit -am 'Add new feature'
- Push to the branch
git push origin new-feature
- Create a new Pull Request
Terren is licensed under the GNU General Public License v3.0. See the LICENSE
file for details.
Have questions or feedback? Create a Github Discussion or drop us an email at [email protected].
Happy mapping! ๐จ๐