tomasgrusz / terren

๐Ÿ—บ๏ธ Procedural Voxel Terrain Generator & 3D Visualiser ๐Ÿ”๏ธ Customizable | Browser-based | Open-source

Home Page:https://terren.grusz.dev

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

๐Ÿ”๏ธ Terren ๐Ÿ—บ๏ธ

Welcome to Terren, an innovative open-source project that empowers voxel terrain generation and visualization right from your browser. ๐ŸŒ

๐Ÿ“‹ Description

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.

๐Ÿš€ Demo

terren.grusz.dev

๐Ÿ› ๏ธ Tech Stack

Framework: Next.js, React, TypeScript

UI: @shadcn-ui, TailwindCSS, SCSS, Framer Motion

3D Rendering: Three.js, @react-three/fiber

โ–ถ๏ธ Running Locally

  1. Clone the repository
git clone https://github.com/tomasgrusz/terren.git
  1. Navigate to project folder
cd terren
  1. Install all dependencies
npm install
# or
yarn install
# or
bun install
  1. Run the development environment
npm run dev
# or
yarn dev
# or
bun dev
  1. Open http://localhost:3000 within your browser

๐Ÿซ‚ Contributing

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:

  1. Fork the repository
  2. Create a new branch git checkout -b new-feature
  3. Add your contribution
  4. Commit your changes git commit -am 'Add new feature'
  5. Push to the branch git push origin new-feature
  6. Create a new Pull Request

๐Ÿ›ก๏ธ License

Terren is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

๐Ÿ‘ Feedback

Have questions or feedback? Create a Github Discussion or drop us an email at terren@grusz.dev.

Happy mapping! ๐ŸŽจ๐ŸŒŸ

About

๐Ÿ—บ๏ธ Procedural Voxel Terrain Generator & 3D Visualiser ๐Ÿ”๏ธ Customizable | Browser-based | Open-source

https://terren.grusz.dev

License:GNU General Public License v3.0


Languages

Language:TypeScript 97.2%Language:SCSS 1.3%Language:CSS 1.2%Language:JavaScript 0.2%