VVE 3 学习手册

面向 Minecraft Java 数据包开发者的 Vanilla Vehicle Engine 3 中文学习站。文档从坐标、显示实体和数据生命周期讲起，逐步进入刚体、碰撞、介质、模拟器、性能调优与 API，并提供完全在浏览器中运行的交互式课程。

在线课程使用 Datapack Sandbox Web Worker 在页面本地执行命令、数据包和 20 TPS 模拟；代码与用户数据不会上传到服务器。

本地运行

需要 Node.js 20 或更高版本：

npm ci
npm run dev

Playground 已作为固定的本地 npm 归档放在 vendor/ 中，VVE 浏览器资源位于 docs/public/vve-packs/，因此克隆本仓库后不需要相邻的 DatapackSandbox 工作区。

验证

npm run typecheck
npm run build
npm run test:e2e

生产输出位于 docs/.vitepress/dist。端到端测试会真实加载 Math3、VVE 数据包及资源包，并运行浏览器内物理课程。

部署到 Vercel

仓库根目录的 vercel.json 已配置 VitePress 构建命令、输出目录、干净 URL 和静态资源缓存规则。将仓库导入 Vercel 后可以直接部署，无需额外环境变量。

也可以使用 Vercel CLI：

vercel link
vercel deploy --prod

上游项目

• Vanilla Vehicle Engine 3
• VVE 3 资源包
• Datapack Sandbox

欢迎通过 GitHub Issues 报告教程问题、浏览器兼容性问题或提出内容建议。