Skip to content

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

License

Notifications You must be signed in to change notification settings

tomasgrusz/terren

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

44 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ”๏ธ 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 [email protected].

Happy mapping! ๐ŸŽจ๐ŸŒŸ