Repolode
terryHu7

terryHu7/homecraft

基于 Three.js 的“我的世界”风格方块化 3D 个人网站模板,访客可在虚拟世界中漫游浏览。

Star
187
Fork
59
未关闭 Issue
1
最近提交
20小时前

这是什么?

Homecraft 是一个用于搭建 3D 个人网站的模板,网站以“我的世界”式方块世界呈现,访客可以在其中自由移动参观。世界里可以布置篮球场、健身房、工作台、泳池等场景,二维网页也能嵌入其中,例如按 F 键打开查看。

项目内置初始模板以及配合 AI 辅助开发的提示词和约束,fork 后即可用 vibe coding 方式定制自己的世界。在项目目录运行 python3 tools/serve.py 即可随机选择端口启动本地服务并自动打开浏览器。完整示例见 examples/terry-home。场景包含昼夜交替和下雪等天气效果,方块风格的渲染开销较小,手机浏览器也能流畅访问。

项目基于 JavaScript 与 Three.js(WebGL)实现。

核心功能

  • 01基于 Three.js 与 WebGL 渲染的可漫游方块世界。
  • 02可在 3D 场景中嵌入传统二维网页。
  • 03内置初始模板及 AI 辅助开发的提示词与约束。
  • 04包含昼夜交替和下雪等天气系统。
  • 05方块风格开销小,手机浏览器也能访问。
  • 06提供本地启动脚本,随机端口并自动打开浏览器。

适用场景

  • 制作可供访客像玩游戏一样探索的互动作品集。
  • 搭建有“串门”感觉的个人主页。
  • 通过完整示例学习 Three.js 场景搭建。
  • 在共享的 3D 传送门中互相收录友情链接。

快速上手

  1. 1

    Fork 本仓库并进入项目目录

  2. 2

    启动本地服务并自动打开浏览器

    python3 tools/serve.py

使用前须知

  • README 未提供包管理器安装方式,需要 fork 后运行 Python 脚本启动。

标签

常见问题

homecraft 是什么?
基于 Three.js 的“我的世界”风格方块化 3D 个人网站模板,访客可在虚拟世界中漫游浏览。 Homecraft 是一个用于搭建 3D 个人网站的模板,网站以“我的世界”式方块世界呈现,访客可以在其中自由移动参观。世界里可以布置篮球场、健身房、工作台、泳池等场景,二维网页也能嵌入其中,例如按 F 键打开查看。
homecraft 可以免费使用吗?用的什么许可证?
homecraft 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
homecraft 还在维护吗?
活跃维护中。homecraft 最近一次提交是在 2026年11月6日。
homecraft 适合用来做什么?
制作可供访客像玩游戏一样探索的互动作品集。 搭建有“串门”感觉的个人主页。 通过完整示例学习 Three.js 场景搭建。 在共享的 3D 传送门中互相收录友情链接。
homecraft 怎么安装和运行?
Fork 本仓库并进入项目目录 启动本地服务并自动打开浏览器: python3 tools/serve.py
在哪里获取 homecraft?
源代码和安装说明在 GitHub 上:https://github.com/terryHu7/homecraft

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目