Be Fun Jewelry

外观

安装、启用与升级 ​

BFJ 当前版本要求 Blender 5.2 或更高版本。当前发布包支持 Windows x64 和 Apple Silicon Mac。

不要使用旧版快捷键脚本

旧手册提供的 Blender 3.5/3.6 快捷键 .py 文件不适用于当前版本，而且包含多个第三方扩展的按键项。不要将这些文件导入 Blender 5.2。

安装前检查 ​

  • 从 BFJ 官方渠道获取与操作系统匹配的当前安装包。
  • Windows 应使用 x64 包；Apple Silicon Mac 应使用 macOS arm64 包。
  • 不要混用不同版本的 BFJ 文件，也不要把开发仓库中的单个目录当作完整产品包。
  • 如果正在升级，先保存重要的 .blend 文件和自定义设置。
  • 完整退出所有 Blender 进程后再运行安装或升级。

安装方式 ​

BFJ 可能以完整安装包或 Blender 扩展包交付。请使用交付页面为该版本指定的方式，不要同时执行两套安装流程。

使用完整安装包 ​

  1. 退出 Blender。
  2. 运行与当前平台匹配的 BFJ 安装包。
  3. 保留安装包要求的目录结构；不要单独移动其中的扩展、运行库或资产目录。
  4. 安装完成后从安装结果提供的入口启动 Blender。
  5. 打开一个空白文件，确认 BFJ 面板和资产可以正常加载。

从 Blender 安装扩展包 ​

仅当交付说明明确提供了可独立安装的扩展包时使用此方法：

  1. 打开 编辑 → 偏好设置 → 获取扩展。
  2. 从右上角菜单选择 从磁盘安装。
  3. 选择与平台和 Blender 版本匹配的 .zip 文件。
  4. 安装完成后切换到已安装扩展，确认 Be Fun Jewelry (BFJ) 已启用。
  5. 重启 Blender，再确认面板、节点资产和相关资源能够加载。

完整产品不一定等于单个扩展 ZIP

BFJ 还可能依赖与扩展同仓库交付的运行库、配置和资产。除非该版本的交付说明明确允许，否则不要只复制或安装某个内部 ZIP。

截图待补

此处将补充 Blender 5.2 “获取扩展 → 从磁盘安装”及“已安装扩展”页面截图。当前页面不引用旧版 Blender 3.x 的“插件”界面。

安装后看不到 BFJ ​

按以下顺序检查：

  1. 在偏好设置的已安装扩展中搜索 BFJ 或 Be Fun Jewelry。
  2. 确认扩展已启用，并查看界面底部或系统控制台是否出现错误。
  3. 确认没有把 Windows 包安装到 macOS，或把 macOS arm64 包安装到 Intel Mac。
  4. 确认 Blender 版本不低于 5.2。
  5. 重启 Blender，在空白文件中再次检查。
  6. 如果扩展能启用但资产为空，不要反复重装单个扩展；应检查完整 BFJ 安装目录是否被移动、删除或被安全软件隔离。

Blender 无法启动 ​

如果 Blender 本身无法打开：

  1. 先尝试启动未加载 BFJ 的官方 Blender，判断是否为 Blender 或系统环境问题。
  2. Windows 上更新到显卡厂商提供的稳定驱动；不要只依赖系统自动安装的旧驱动。
  3. 确认设备满足 Blender 5.2 的系统与图形要求。旧文档中的“支持 OpenGL 3.3 即可”不再是当前判断标准。
  4. 记录弹窗原文，或从终端/命令提示符启动 Blender 以保留启动日志。
  5. 如果只有 BFJ 环境无法启动，保留日志并按如何报告问题提交。

升级或重装 ​

  1. 记录当前 BFJ 和 Blender 版本。
  2. 保存工作文件及必要的自定义设置。
  3. 退出 Blender。
  4. 使用同一官方渠道获取新版本，并按该版本的升级说明操作。
  5. 不要用新文件覆盖旧目录中的部分文件。
  6. 启动后先在空白文件中验证，再打开生产文件。

如果重装后问题仍然存在，不要继续重复安装。转而收集日志，并说明“全新空白文件是否复现”和“禁用其他第三方扩展后是否复现”。