Skip to content

从这里开始

如果你已经会写 .mcfunction、知道 scoreboard、storage、实体选择器和 execute,但第一次接触 VVE,这条路线就是为你准备的。你不需要先掌握连续介质力学或自己推导四元数;需要的是先认清数据在哪里、谁拥有状态、一次 tick 的边界在哪里。

推荐学习顺序

01

装好四个组成部分

Math3、线性代数库、VVE 数据包,以及按需使用的 VVE 资源包。

math → math_la → vve
02

完成交互基础课

在同一个沙盒里逐步创建观察场、plate、实例、冲量和模拟器,不跳过中间状态。

/tutorials/fundamentals
03

理解两个数据环

创建前是 plate/proj/model,运行时是 entity/get/store。

_proj ↔ _model · _get ↔ _store
04

读懂一轮物理

运动学预测、碰撞点探测、响应汇总、力学结算、显示同步。

motion → detect → apply → sync
05

构建自己的模块

用 MOT 模板得到骨架,再只改业务字段、碰撞点和显示。

push vve_block_1.0
06

加测试和预算

为落地、速度上界、销毁和性能写可重复的断言。

dps check --strict

先选你的目标

你想做的东西建议起点原因
弹丸、漂浮粒子、轨迹点vve_point_1.0只维护平动,成本最低
立方小物件、骰子vve_block_1.0八顶点碰撞 + 标量惯量,容易理解
长方体或不同轴惯量明显的物体vve_box_object_1.0使用惯性张量
会与其他物体互撞的立方体vve_cublock_1.0同时是刚体和实体介质
会互撞的长方体vve_cubox_1.0张量刚体 + 盒体介质
车、船、可乘坐载具vve_vehicle_1.0加入底盘、座位、转向和动力接口

不要一开始就选功能最多的模型

实体介质、更多碰撞点和惯性张量都会增加成本。只有“其他物体必须撞到它”时,才需要 cublock/cubox;只有形状各轴惯量差异值得表达时,才需要张量模型。

三个阶段的学习成果

入门:能运行

  • 能按顺序初始化依赖;
  • 能创建一个实例并让模拟器推进;
  • 知道网页实验与原版客户端的边界;
  • 出错时先看函数是否存在、目标是否正确、storage/score 是否准备好。

进阶:能改造

  • 能从 _class 修改默认数据模板;
  • 能选择碰撞点与介质探测入口;
  • 能施加冲量/力偶矩,并理解偏心作用点为什么产生旋转;
  • 能把计算状态同步到 display entity。

熟练:能设计

  • 能设计自定义实体介质与响应;
  • 能隔离不同模拟器的常量表;
  • 能使用拆分帧、慢放、静体和局部子系统控制预算;
  • 能用 Datapack Sandbox manifest 固化行为基线。

下一步先完成安装与初始化,然后进入从坐标到刚体闭环。如果只想先看完整结果,可以阅读十分钟看懂骰子

VVE 由小豆 8593 开发;本站是面向学习与查阅的增强文档。