Repolode
Submit
terryHu7

terryHu7/homecraft

A Minecraft-style voxel 3D personal website template built with Three.js, where visitors walk through your site as a virtual world.

View on GitHubWebsite
Stars
187
Forks
59
Open issues
1
Last commit
19 hours ago

What is it?

Homecraft is a template for building a personal homepage as a navigable 3D voxel world inspired by Minecraft. Instead of a conventional scrolling page, visitors move around a blocky environment with buildings and scenes such as a basketball court, gym, workbench and pool. Existing 2D web pages can be embedded inside the world and opened in place.

The project includes a starter template with prompts and constraints for AI-assisted editing, so forking the repository lets you customize the world with vibe coding. A bundled script, tools/serve.py, starts a local server on a random port and opens the browser. The full example site is in examples/terry-home. The scene includes day-night cycles and weather effects such as snow, and the blocky style keeps rendering light enough for mobile browsers.

The project is built with JavaScript and WebGL via Three.js, and is released under the MIT license.

Key features

  • 01Walkable Minecraft-style voxel world rendered with Three.js and WebGL.
  • 02Embed traditional 2D web pages inside the 3D scene.
  • 03Includes a starter template with AI prompts and constraints for vibe coding.
  • 04Day-night cycle and weather effects such as snow.
  • 05Runs on mobile browsers thanks to lightweight blocky rendering.
  • 06Local launcher script opens the site on a random port.

Use cases

  • Creating an interactive portfolio that visitors explore like a game world.
  • Building a personal homepage that feels like visiting a friend's place.
  • Learning Three.js scene building through a working example site.
  • Linking friends' personal sites in a shared 3D portal space.

Quick start

  1. 1

    Fork the repository and enter the project directory

  2. 2

    Start the local server and open the browser

    python3 tools/serve.py

Things to know

  • The README does not describe a package-manager install; setup relies on forking and running a Python script.

Topics

#threejs#webgl#voxel#personal-website#portfolio#3d#template#minecraft#3d-portfolio#3d-portfolio-website

FAQ

What is homecraft?
A Minecraft-style voxel 3D personal website template built with Three.js, where visitors walk through your site as a virtual world. Homecraft is a template for building a personal homepage as a navigable 3D voxel world inspired by Minecraft. Instead of a conventional scrolling page, visitors move around a blocky environment with buildings and scenes such as a basketball court, gym, workbench and pool. Existing 2D web pages can be embedded inside the world and opened in place.
Is homecraft free to use? What license does it have?
homecraft is open source under the MIT license. Check the license terms before using it in commercial products.
Is homecraft still maintained?
Actively maintained. The last commit to homecraft was on Nov 6, 2026.
What can I use homecraft for?
Creating an interactive portfolio that visitors explore like a game world. Building a personal homepage that feels like visiting a friend's place. Learning Three.js scene building through a working example site. Linking friends' personal sites in a shared 3D portal space.
How do I install homecraft?
Fork the repository and enter the project directory Start the local server and open the browser: python3 tools/serve.py
Where can I get homecraft?
The source code and installation instructions are on GitHub: https://github.com/terryHu7/homecraft

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

Related projects