实现边界与版本

本站核对基线

项目	基线
VVE 数据包	3.0.1，仓库当前实现
Minecraft 主实验	26.2
数据包格式	107.1（VVE 声明区间覆盖至 107）
VVE 声明支持	1.21.5–26.2
Sandbox	本地 DatapackSandbox 工作区构建
资源包	VVE 3 配套资源包当前实现

本站没有修改 VVE 数据包源码。在线骰子使用单独的实验包：它创建演示场地，并对 Sandbox 视窗中的稳定落地采取兼容性静体策略；这不属于 VVE 原包公共 API。

VVE 不是完整游戏物理

它提供可组合的质点/刚体/介质近似，但不会自动实现：

• 连续碰撞检测；
• 任意显示网格的三角形碰撞；
• 所有原版实体 AI 与玩家物理；
• 红石、区块加载和完整服务端生命周期；
• 任何两个 display entity 之间的自动碰撞；
• 自动为业务模型选择质量、惯量和睡眠阈值。

Sandbox 的边界

Datapack Sandbox 用于确定性函数与资源实验。它不会引入 Mojang 服务端代码，渲染也明确标记 visualParity: false。当前网页 Worker 是轻量命令模型，尚不能运行 Math3/VVE 的全部 scoreboard/execute/data 组合；完整 VVE 示例以 JVM 沙盒和真实客户端为准。以下场景必须在目标客户端/服务端复验：

• 依赖未建模原版命令副作用；
• 区块、AI、红石或复杂玩家交互；
• 自定义字体 provider、客户端 shader、light map、后处理；
• 原版像素级截图要求；
• 大规模真实服务器 tick 与网络同步。

文档如何处理不完整实现

旧 VVE docs 中“运动慢放/拆解、降频/静体、局部子物理系统”页面为空。本站根据源码补足：

• slow key/mov、simulator rate/inv_dt 是已有实现；
• sim_slow 是状态存储，不是自动调度器；
• force/sync 是已有的阶段拆分入口，但不同模型完整度需逐个核对；
• 静体、通用降频和局部子系统是业务设计策略，没有被描述成不存在的统一函数。

升级检查清单

升级 VVE 或 Minecraft 时：

1. 检查 pack.mcmeta 与资源目录；
2. diff memory_storage 模板版本与生成文件；
3. diff 函数头部接口注释和数据字段；
4. 检查展示实体 NBT、物品组件与资源模型格式；
5. 运行固定初态的 snapshot/trace 回归；
6. 对落地稳定、物体间碰撞、慢放和模拟器倍率做重点测试；
7. 在真实客户端复验资源包与视觉。

来源与署名

• VVE 3 与原始文档：xiaodou8593/vve3.0
• VVE 资源包：xiaodou8593/vve3.0_rp
• Math3 系列依赖由同一作者维护。

本站以源码和仓库自带 docs 为事实来源，重新组织为面向学习的路径，并补充调用契约、调试、测试和实现边界。若本文与目标版本函数头注释冲突，以你实际安装版本的源码为准。