MOT 模板目录
模板位于 VVE 仓库 memory_storage/，用于生成你的模块，不是在运行时直接 function 调用的资源。
骨架模板
| 模板 | 生成能力 | 适用 |
|---|---|---|
vve_point_1.0 | 质点字段、实例、运动/介质主程序 | 弹丸、轨迹、小粒子对象 |
vve_block_1.0 | 标量惯量立方刚体、八点碰撞 | 骰子、方块小物件 |
vve_box_object_1.0 | 张量长方体刚体 | 木板、长条箱体 |
vve_cublock_1.0 | block + 盒体实体介质 | 会互撞的立方体 |
vve_cubox_1.0 | box_object + 盒体实体介质 | 会互撞的长方体 |
vve_fixed_object_1.0 | 固定物体/介质结构 | 平台、固定碰撞几何 |
vve_vehicle_1.0 | 完整载具骨架与座位层次 | 车、船、可乘载具 |
vve_vehicle_lite_1.0 | 更轻的载具组合 | 不需完整结构的载具 |
vve_material_1.0 | 自定义实体介质注册与查询 | 斜面、区域、特殊表面 |
vve_simulator_1.0 | 独立常量、倍率、回调调度 | 自定义物理环境 |
名称带 _b_ 的 block/cublock/cubox 变体包含不同显示/结构约定。使用前 diff 它的 objects 配置和生成文件，不要仅凭名字猜“b = better”。
功能叠加模板
| 模板 | 添加内容 | 前置 |
|---|---|---|
vve_dice_1.0 | 随机姿态、投掷与点数接口 | 已有合适刚体骨架 |
vve_dynamic_cpoint_1.0 | 动态碰撞点生成 | 已有物体模块 |
vve_engine_1.0 | 动力/阻尼控制 | 载具或自定义运动模块 |
vve_response_1.0 | 介质响应组合 | 明确响应字段与覆盖顺序 |
vve_sound_1.0 | 响应驱动声音 | 主程序保留响应读取位置 |
vve_test_1.0 | 标准物理测试 | 完整物体模块 |
vve_test_custom_1.0 | 自定义测试骨架 | 自己填写场景与断言 |
叠加模板可能覆盖同路径文件。每次 push 前提交版本控制或保存 diff；生成后检查主程序是否仍包含你之前的业务修改。
模板构建流程
text
push <template>
run
init
sync
stop
pop对象格式文档中的字段决定生成的 _zero/_proj/_model/_get/_store 对称代码。修改字段后重新 sync，比手工在五个文件中分别补一遍可靠。
选择清单
- 需要物理旋转吗？否 → point。
- 三轴惯量差异重要吗？是 → box_object/cubox。
- 其他动态物体要撞到它吗？是 → cublock/cubox/material。
- 需要流体浮力吗？确保模板主程序提供
main_l与浮力输入。 - 需要乘员/控制吗？vehicle，而不是在 block 上零散拼 seat。
- 需要独立重力/速度倍率吗？另建 simulator。
升级模板
模板升级不是直接把新版本目录覆盖旧业务模块。推荐：
- 用新模板在临时命名空间生成一份干净模块；
- diff 旧生成骨架、新生成骨架和业务修改；
- 迁移字段时同步更新所有转换接口；
- 明确存量实例的 migration 或强制重建；
- 运行物理、生命周期和性能回归；
- 再切换正式命名空间。