BBModel Preview

在 VSCode 中 3D 预览 Blockbench .bbmodel 文件。

功能

• 解析 .bbmodel JSON 格式，支持 cube 和 mesh 两种元素类型
• 使用 Three.js 进行 3D 渲染（OrbitControls 旋转/缩放/平移）
• 支持内嵌 base64 贴图
• 支持 per-face UV 和 box UV 两种映射模式
• 支持 UV 旋转（0/90/180/270）
• 支持 element/group 层级变换（origin + rotation）
• 支持 inflate / stretch
• 文件保存后自动刷新预览

使用方法

1. 打开任意 .bbmodel 文件
2. 通过以下方式打开预览：
   • 命令面板搜索 Open BBModel Preview
   • 编辑器标题栏的预览按钮
   • 右键菜单 → Open BBModel Preview to the Side

开发

npm install      # 安装依赖
npm run build    # 编译 extension + webview
npm run watch    # 监听模式

按 F5 启动 Extension Development Host 调试。

项目结构

src/extension.ts       插件入口：命令注册、webview 面板管理
webview/bbmodel.ts     BBModel 解析器 → Three.js 几何体
webview/main.ts        webview 入口：Three.js 场景、渲染循环
esbuild.mjs            构建脚本（打包 extension + webview）

已知限制

• 仅支持内嵌 base64 贴图（source 字段），不支持外部文件路径引用
• 不支持动画播放
• 不支持 tint 着色
• 不支持 Bedrock 骨骼绑定（bedrock_binding）