https://github.com/kenjinp/hello-terrain

Realtime web terrain engine, for vast virtual worlds. Built for three.js and react-three/fiber.
https://github.com/kenjinp/hello-terrain

game-development gamedev gamedev-tool gamedevelopment heightmap heightmap-terrain react-three-fiber terrain terrain-editing terrain-materials terrain-visualization threejs tsl typescript-react webgpu

Last synced: 3 months ago
JSON representation

Realtime web terrain engine, for vast virtual worlds. Built for three.js and react-three/fiber.

• Host: GitHub
• URL: https://github.com/kenjinp/hello-terrain
• Owner: kenjinp
• Created: 2025-08-16T18:24:54.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2026-02-16T17:27:51.000Z (4 months ago)
• Last Synced: 2026-02-16T23:51:07.648Z (4 months ago)
• Topics: game-development, gamedev, gamedev-tool, gamedevelopment, heightmap, heightmap-terrain, react-three-fiber, terrain, terrain-editing, terrain-materials, terrain-visualization, threejs, tsl, typescript-react, webgpu
• Language: TypeScript
• Homepage: https://hello-terrain.kenny.wtf
• Size: 244 MB
• Stars: 13
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
[![Discord Shield](https://img.shields.io/discord/900742295710728282?style=flat&colorA=000000&colorB=000000&label=&logo=discord&logoColor=ffffff)](https://discord.gg/HgTd2B828n)

[![Three.js](https://img.shields.io/badge/Three.js-000000?style=for-the-badge&logo=three.js&logoColor=white)](https://threejs.org/docs/) [![React-Three-Fiber](https://img.shields.io/badge/React--Three--Fiber-000000?style=for-the-badge&logo=react&logoColor=61DAFB)](https://docs.pmnd.rs/react-three-fiber) [![WebGPU](https://img.shields.io/badge/WebGPU-F34B7D?style=for-the-badge&logo=webgpu&logoColor=white&colorA=000000&colorB=000000)](https://threejs.org/docs/) [![npm version](https://img.shields.io/npm/v/@hello-terrain/three?style=for-the-badge&colorA=000000&colorB=000000)](https://www.npmjs.com/package/@hello-terrain/three)

![A Quadtree Debug Scene using Hello-Terrain](https://kenny.wtf/hello-terrain.webp)

# hello-terrain

Realtime web terrain engine, for vast virtual worlds. Built for [three.js](https://threejs.org/) and [react-three/fiber](https://r3f.docs.pmnd.rs/getting-started/introduction).

## Features

- Performant variable LOD system for huge (earth-scale!) open worlds

- Elevation manipulation, terrain holes, texture painting, overlays, colors, and wetness

- TSL-based elevation and texture assignment nodes

- Composable compute stage plugins

## Getting Started

1. Read the [Introduction](http://hello-terrain.kenny.wtf/docs) to understand the architecture and see how it's used.

2. Read the [Installation](http://hello-terrain.kenny.wtf/docs/installation) instructions.

3. Review the [Examples](http://hello-terrain.kenny.wtf/examples) to get an idea of how to do things.

4. For support, join the [Discord server](https://discord.gg/HgTd2B828n).

## Shoutouts

inspired by [Terrain3D](https://github.com/TokisanGames/Terrain3D) with a quad-tree twist.

This monorepo workspace was generated with [create-krispya](https://github.com/krispya/create-krispya).