ZBrush 文件目录及用户资产结构的重要变更（2026.1及以后版本）

⚠️ 重要

本文包含简要概览与完整技术文档。

• 如果你只需要快速指导，请阅读下方概览部分
• 如需技术细节，请阅读文末 完整技术参考

概览

ZBrush 2026.1.0 对文件及用户内容的存储方式进行了重大调整。

此调整的目标是：

• 在版本更新中保护用户数据
• 统一文件存储位置
• 将用户内容与应用程序文件分离

变更内容

之前版本（2026.0.1及以前）

• 文件可能存放在多个位置
• 许多用户将内容直接存放于安装目录
• 公共文档文件夹被使用

新系统（2026.1.0及以后）

• 所有用户内容统一存储在单一用户专属目录
• 安装目录已设为只读
• ZBrush 不再允许写入安装目录

文件现存位置

默认用户资产目录：

Windows

makefile

C:\Users\[UserName]\AppData\Roaming\Maxon\ZBrush_[HashValue]\

macOS

css

/Users/[UserName]/Library/ApplicationSupport/Maxon/ZBrush_[HashValue]/

macOS可能的替代路径（视系统而定）

css

/Users/[UserName]/Library/Preferences/Maxon/ZBrush_[HashValue]/

打开方法

1. 打开 Preferences（首选项）
2. 选择 Asset Directory（资产目录）
3. 点击 Open Directory（打开目录）

文件应放的位置

所有自定义内容必须放在：

css

[用户资产目录]\ZStartup\

重要行为变化

安装目录

• 已设为只读
• 更新时可能被替换
• 文件不会在此处保留

LightBox

• LightBox 不存储文件
• 仅显示文件夹内容

QuickSave

• 新位置：

css

[用户资产目录]\QuickSave\

更新前准备

1. 确认文件位置
   不要将文件放在：

   makefile

   C:\Program Files\Maxon ZBrush 2026\

2. 确认 LightBox 项目位置
   确保不指向安装目录。
3. 备份重要文件
   • 项目（Projects）
   • 笔刷（Brushes）
   • UI配置（UI）
   • 插件（Plugins）
4. 定位用户资产目录

php

Preferences > Asset Directory > Open Directory

5. 移动自定义内容到正确位置
   从以下位置迁移：

   • Program Files
   • Public Documents
     到：

   css

   [用户资产目录]\ZStartup\

6. 检查 QuickSave 文件

   • 旧位置：

     vbnet

     C:\Users\Public\Documents\ZBrushData[Version]

   • 新位置：

     css

     [用户资产目录]\QuickSave\

7. 理解安装目录行为
   更新时安装目录内容不会保留。
8. 可选：保存并导出 UI 配置
   • 打开 Preferences > Config
   • 点击 Store Config
   • 保存配置并导出 UI布局
     更新后可导入新版本

提示：旧版UI可能因功能或宏变化导致元素不可用，需要调整。

完整技术参考

用户内容与文件夹结构

LightBox 提供直观浏览不同资产（Alpha、QuickSave等），但其背后有文件夹结构，方便管理自定义资产或迁移安装。

文件夹结构变化

2026.0.1及以前

• 支持在多个文件夹中放置自定义内容

自2026.1.0起

• 文件夹结构调整为单一目录模式，类似其他创意软件

安装目录 Maxon ZBrush(版本)/ZData/ZStartup 仍含插件和资产，但已禁止写入。所有自定义资产必须放在用户目录。

打开方法：

php

Preferences > Asset Directory > Open Directory

Windows

makefile

C:\Users\[UserName]\AppData\Roaming\Maxon\ZBrush_[HashValue]\

macOS

css

/Users/[UserName]/Library/ApplicationSupport/Maxon/ZBrush_[HashValue]/

注意：部分macOS可能路径为：

css

/Users/[UserName]/Library/Preferences/Maxon/ZBrush_[HashValue]/

创建环境变量

通过 ZBRUSH_USER_ASSETS_DIR 环境变量可更改资产目录，例如：

javascript

Z:/ZBrush/

启动资产变化

启动时会加载用户资产目录中的内容，例如材料、笔刷、插件等。

自定义用户资产迁移表

临时数据

Windows

makefile

C:\Users\[UserName]\AppData\Local\Temp\ZBrushData[Version]

macOS

java

/private/var/

搜索 ZBrushData2026

最终说明

• ZBrush 已采用用户资产目录体系
• 安装目录不用于存储工作文件
• 所有自定义内容必须放入用户资产目录