用途:为 VIVERSE 就绪的 Three.js 与 React Three Fiber 应用提供开发、调试与发布指导。React 应用使用 @react-three/viverse,原生 Three.js 使用 @pmndrs/viverse。
主要能力:先检查应用结构与包管理器,判断任务需要 React Three Fiber 还是原生 Three.js;按需查阅内置参考文档:getting-started.md(安装、首个场景)、components-and-hooks.md(React 组件、hook、action、角色、物理、动画 API)、gameplay-quality.md(游戏架构与可玩验证)、tutorials/index.md、custom-character-controller.md(自定义人形控制器)、without-react.md(原生用法)、publishing.md(VIVERSE CLI、构建输出、应用创建与发布)。
关键约定:以角色为先,普通游戏默认使用 <SimpleCharacter />(React)或 new SimpleCharacter(...)(原生),保持角色可见,除非用户要求占位或非化身角色;静态碰撞几何放入 BvhPhysicsBody;优先通过受支持的选项和 action 绑定调整移动、相机、物理、动画与输入。第三人称射击、大逃杀或动作战斗等需求按自定义控制器处理,需使用 VIVERSE 角色模型加载、骨骼挂点与动画 action/layer,不要用基础几何体拼出玩家模型。
验证与限制:用浏览器实时运行验证玩法,而非仅检查静态状态;不复制过时依赖版本,绿地方案应查询当前已发布版本。本地开发不要设置 clientId,不要索取 VIVERSE 密码、令牌或密钥。BvhPhysicsBody 内的静态 BVH 内容创建后不应结构性变化。发布前先构建,再按 publishing.md 操作。