Repolode
Submit
jasonkneen

jasonkneen/tiny-world-builder

A browser-based 3D voxel world editor for building, sculpting, flying through, and sharing small worlds.

View on GitHubWebsite
Stars
1,606
Forks
214
Open issues
5
Last commit
14 hours ago

What is it?

Tiny World Builder is a self-contained 3D voxel editor that runs entirely in the browser. You place terrain such as grass, water, stone, sand, and lava, add objects like houses, trees, fences, bridges, crops, and animals, and reshape the ground by raising, lowering, and painting it into cliffs and rivers.

The editor offers several camera modes, including isometric, soft, and perspective, so a world can be viewed from any angle. Worlds can be saved in named local slots, exported, remixed, and shared. A Mesh Terrain sculptor provides an optional fine voxel layer for sculpting smoother landscape shapes with per-voxel materials.

The project includes a seeded vehicle runtime where delivery vehicles follow road networks and reroute around placed objects. It is built as a static site with vanilla JavaScript and Three.js, and can be deployed to Vercel or Netlify.

Key features

  • 01Place terrain, objects, crops, and animals on a voxel grid.
  • 02Raise, lower, and paint terrain to form cliffs and rivers.
  • 03Switch between isometric, soft, and perspective cameras.
  • 04Save multiple named worlds locally and export or share them.
  • 05Optional Mesh Terrain sculptor with per-voxel materials.
  • 06Seeded vehicle demo with road routing and traffic avoidance.

Use cases

  • Prototyping small voxel-style game levels or diorama scenes in the browser.
  • Exploring how adjacency-aware tiles like roads, fences, and houses connect automatically.
  • Testing route planning and traffic behavior on a generated road network.
  • Hosting a self-contained, static 3D world builder on your own site.

Quick start

  1. 1

    Start the local dev server

    npm run dev
  2. 2

    Open the builder at localhost:3000/tiny-world-builder

  3. 3

    Or open the static file directly without a dev server

    open index.html

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires network users to receive source for modified deployments.
  • Wallet login on a real deployment requires setting TINYWORLD_WALLET_SESSION_SECRET in Netlify first.

Topics

#voxel#three-js#3d-editor#webgl#world-builder#javascript#game-development#build#minecraft

FAQ

What is tiny-world-builder?
A browser-based 3D voxel world editor for building, sculpting, flying through, and sharing small worlds. Tiny World Builder is a self-contained 3D voxel editor that runs entirely in the browser. You place terrain such as grass, water, stone, sand, and lava, add objects like houses, trees, fences, bridges, crops, and animals, and reshape the ground by raising, lowering, and painting it into cliffs and rivers.
Is tiny-world-builder free to use? What license does it have?
tiny-world-builder is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is tiny-world-builder still maintained?
Actively maintained. The last commit to tiny-world-builder was on Oct 19, 2026.
What can I use tiny-world-builder for?
Prototyping small voxel-style game levels or diorama scenes in the browser. Exploring how adjacency-aware tiles like roads, fences, and houses connect automatically. Testing route planning and traffic behavior on a generated road network. Hosting a self-contained, static 3D world builder on your own site.
How do I install tiny-world-builder?
Start the local dev server: npm run dev Open the builder at localhost:3000/tiny-world-builder Or open the static file directly without a dev server: open index.html
Where can I get tiny-world-builder?
The source code and installation instructions are on GitHub: https://github.com/jasonkneen/tiny-world-builder

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects