文档与教程

从第一次安装到日常使用,这一页就够了。遇到具体问题先去 FAQ,或到 QQ 群 1097972055 或官网 www.assetcrate.net 问我们。

Quickstart

3 分钟上手

目标:把一个模型从工程 A 收进素材箱,再从素材箱放进工程 B。

01

安装

下载 zip 解压,AssetCrate 文件夹放进 <工程>/Plugins/,在 编辑 → 插件 启用后重启编辑器。

02

新建箱

窗口 → 素材箱 打开面板 → 左上角 + 新建箱,选一个工程外的目录,例如 D:\AssetCrate\。

03

收素材

内容浏览器里选中模型(可多选)→ 右键 → 导出到素材箱。依赖会被一起收走,并自动渲染缩略图。

04

用素材

在素材箱面板里搜索 / 点标签找到它 → 双击=导入当前工程;拖到视口=导入并摆进场景。

顺手记住一件事:收素材还有一种更快的方式 —— 直接从内容浏览器把素材拖到素材箱面板上,一样会连依赖一起复制进箱。

Feature guide

功能逐项说明

每一项都对应插件里真实存在的入口。

1. 收集素材(工程 → 箱)

怎么做:内容浏览器里选中资产 → 右键 → 导出到素材箱(单个/多个);或右键 → 导出所有到素材箱(整目录)。也可以直接把资产拖到素材箱面板上。

会发生什么:插件把选中的资产连同它的全部依赖(材质、贴图、材质函数、骨骼、动画…)复制进箱目录。主资产放在条目文件夹第一层,依赖按类型各放一层子文件夹(Materials\ Textures\ StaticMeshes\ Blueprints\ …),并写一份 entry.json 记录来源与依赖清单。

注意点:同一个素材重复收集会更新原条目,不会新建重复条目。未保存的资产会被自动保存后再导出。引擎自带内容和引擎插件内容会被跳过(任何工程里本来就有)。

2. 使用素材(箱 → 工程)

双击条目=导入到当前工程;从面板拖到关卡视口=导入并摆进场景。多选后可批量导入。

导入会在 <工程>/Content/AssetCrate/<素材名>/ 下生成一份引用完好的副本。因为是"先完整导入、再摆进场景",所以不会出现材质丢失的黑模型。

3. 八条找素材的路(搜索、筛选与分类)

同一个面板上共 8 条找素材的路,记不住名字有标签,记不住标签有分类 —— 你不用记,它替你记。常用的组合还能一键复制、一键恢复。

① 分类树:支持任意层级,例如 Trees/Pines/Big。把分类拖到另一个分类上即可调整父子关系;右键可新建 / 重命名 / 移动 / 删除;把素材拖到分类上即完成归类。每级带数量,先看大盘再钻进去。

② 类型筛选:按资产类型一键筛,静态网格体 / 材质 / 蓝图 / 动画各归各。

③ 标签筛选:点左侧任意标签即可筛选,支持多标签叠加;点一下选中,点一下取消。左侧标签按维度分组并带数量。标签可重命名、可合并。

④ 搜索框:名称 / 标签 / 类型 / 路径四维一起搜,模糊匹配,命中越准排越前。

⑤ 收藏:常用素材点星标,一键只看收藏,就是你的"常用清单"。

⑥ 引擎版本筛选:按素材保存时的引擎版本筛,含「与本工程不同」这一档 —— 提前发现"换个引擎就坏"的素材。

⑦ 来源筛选:多项目共用一个箱时,按来源工程筛,带数量统计,一眼知道这条是哪来的。

⑧ 备注:每个条目写一段备注:"这是什么、用在哪、谁做的" —— 三个月后你自己还认得出它。

缩放:Ctrl + 滚轮,或用工具栏缩放框(64–256)。

4. 怎么打标签、写备注(管理素材本身)

给条目贴标签、写备注。标签按外形或用途随手打即可(交通工具、轮船、油轮 可以同时贴在同一个模型上)。

缩略图上的标记表示这条素材已经在当前工程里,一眼就能分清"自己人"和"外部素材"。

5. 打包 zip 发给同事

你这边:在内容浏览器里选中素材 → 右键 → 打包 .zip… → 保存。一条素材一个 zip,里面包含依赖、缩略图,外加一份中英双语使用说明。

同事那边:素材箱面板上点【导入】→ 选中这个 zip。压缩包会自动解压进他的箱,几秒后带着缩略图出现。

他没装插件怎么办:zip 里附了中英双语的 README-HowToUse.txt,照着手动放进箱目录也能用。这是兜底办法,不是主推流程。

注意:视口右键只有「导出到素材箱」「导出所有到素材箱」两项;打包 zip 的入口在内容浏览器右键菜单里。

6. 多个箱 / 团队共享箱

支持多个箱随时切换:私人箱放自己常用的素材,团队箱指向网络盘上的共享目录,大家一起用同一份。

只读的箱会被自动识别并说明原因(例如网络盘权限不足或目录被占用)。

entry.json 采用原子写入 + 乐观并发保护(时间戳与大小双校验),两人同时改同一个条目时不会静默覆盖。

7. 素材箱体检

一键检查三类问题:缺缩略图、重复条目、箱目录与实际记录不一致。素材攒多了以后,定期跑一次能省很多事。

8. 界面语言

简体中文完整 / 英文约 70%(补全中),自动跟随编辑器语言,不需要手动切换。

9. 控制台命令(进阶)

需要批量处理或排查时可以用的命令:

AssetCrate.Export、AssetCrate.Import、AssetCrate.UpgradeLibrary、AssetCrate.ResaveFolder、AssetCrate.ResaveAsset、AssetCrate.RegenerateThumbnails、AssetCrate.SelfTest.*。

旧的 UE4 时代静态网格体首次加载可能会卡几秒到几分钟,用 AssetCrate.ResaveFolder /Game/YourFolder 重存一次即可永久解决。

Cheatsheet

操作速查

打印出来贴显示器旁边的那一页。

你想干嘛怎么做
把素材收进箱内容浏览器选中 → 右键 导出到素材箱/导出所有到素材箱;或直接拖到素材箱面板上
看看它长什么样单击瓦片 → 缩略图 + 大小 + 依赖清单
打开它自己的编辑器双击(模型开模型编辑器、蓝图画布、动画开动画编辑器)
只导入、先不摆双击,或右键 → 导入到当前工程
导入并摆到场景里把瓦片拖进关卡视口
一次导入十几个多选 → 批量导入
发给同事内容浏览器右键 → 打包 .zip…;对方面板点【导入】
搜索搜索框输入名称 / 标签 / 类型 / 路径,四维一起模糊匹配,命中越准排越前;搜索条件可一键复制、一键恢复
按维度筛分类树 / 类型 / 标签 / 收藏 / 引擎版本(含「与本工程不同」)/ 来源工程 —— 共 8 条找素材的路
缩放缩略图Ctrl + 滚轮,或工具栏缩放框(64–256)
换箱 / 改目录面板顶部「更改目录」;「打开文件夹」用资源管理器打开
看额度用了多少面板左下角点「许可」
体检工具栏「体检」→ 检查缺缩略图 / 重复条目 / 目录不一致
Manual

操作说明书 v3.1

17 页 · 13 章 + 附录 · 15 张表 · 7 张图。功能与截图最全的一本,适合通读一遍或当手册查。

文档内容适合什么时候看
操作说明书 v3.117 页,13 章 + 附录,15 表 7 图想系统了解全部功能
本页「3 分钟上手」4 步图文刚装完,想立刻跑通
包内 README安装 + 首次配置只想快速装上
包内 README-HowToUse.txt中英双语,手动放置素材箱的说明收到 zip 的人没装插件时
Changelog

更新日志

v1.2.59 · 2026-11-18 · 当前版本

修复视口导出蓝图 Actor 时导出成网格;导出到素材箱后缩略图不再长时间等待;多引擎共用素材库不再因索引崩溃。完整记录以插件包内 CHANGELOG.md 为准。

类别内容
修复 · 蓝图导出视口选中蓝图 Actor →「导出到素材箱」现在导出蓝图资产本身(依赖自动带上网格/材质);普通 Actor 仍导出组件网格
修复 · 缩略图手动保存小批量时当场渲染(约 0.1~0.2 秒/条),后台不再等全工程编译;生成期间显示「生成中…」
修复 · 索引崩溃索引按引擎版本分开(library_index_5.x.bin)+ 头部版本校验,不匹配就全量扫描重建
兼容UE 5.1~5.8 八个独立包,不能混用

首个公开版本(Unreal Engine 5.8)

首个公开版本(Unreal Engine 5.8)

类别内容
新增 · 收集右键「导出到素材箱」连依赖一起收;箱在工程外的任意磁盘/网络位置;可直接从内容浏览器拖到面板收集;重复收集更新原条目
新增 · 使用双击=导入当前工程;拖到视口=导入并创建到场景;导入生成引用完好的副本
新增 · 面板缩略图墙、搜索(名称/标签/类型/路径)、标签筛选、备注、任意层级分类、缩放(64–256)、透明背景缩略图
新增 · 多箱多个箱(私人 + 团队共享)一键切换;只读箱检测并说明原因;entry.json 原子写入 + 乐观并发保护
新增 · 本地化简体中文完整;英文约 70%;控制台命令 AssetCrate.Export / Import / UpgradeLibrary / ResaveFolder / ResaveAsset / RegenerateThumbnails / SelfTest.*
修复右键菜单不出现、拖拽无反应、未保存资产导不出、缩略图上下颠倒、面板配色与内容浏览器不一致、导入失败、重复条目、Slate 弹窗断言等
已知限制引擎与引擎插件内容会被跳过;旧的 UE4 时代静态网格体首次加载可能卡顿,用 AssetCrate.ResaveFolder 重存一次即可

插件包内的 CHANGELOG.md 含中英对照全文;如需逐条核对,请解压下载包查看。

Troubleshooting

常见排障

菜单里没有「素材箱」

检查目录层级是否为 <工程>/Plugins/AssetCrate/AssetCrate.uplugin;确认已在 编辑 → 插件 启用并重启编辑器;若提示"引擎版本不兼容",说明引擎不在支持范围内。

缩略图没生成 / 是空白的

缩略图由引擎的缩略图渲染器生成,首次进入面板时可能还在后台渲染,稍等几秒或滚动一下。

如果长时间为空,可用工具栏「体检」检查「缺缩略图」,或用命令 AssetCrate.RegenerateThumbnails 重新生成。缩略图缓存存放在箱目录的 Thumbnails\ 下,确认该目录可写。

导入后材质丢失 / 模型是黑的

正常情况下不会发生 —— 拖到视口时插件会先把素材和材质完整导入当前工程再摆进场景。

如果确实出现,请确认箱目录里的材质/贴图文件完整(体检可查"目录与记录不一致"),并且这些文件没有被安全软件隔离。

zip 导入失败

先确认 zip 完整(传输中断会导致解压失败);再确认箱目录可写;另外不要手工改动 zip 内部结构。

如果对方使用的是不同版本的插件,建议双方都升级到当前版本再试。

网络盘上的团队箱很慢 / 提示只读

多个素材、缩略图缓存和 entry.json 读写都发生在箱目录上,网络盘延迟高时会明显变慢。建议把常用素材放本地箱,团队共享箱只放需要共享的部分。

提示只读通常是权限或占用问题:确认当前账号对目录有写权限,且没有其他人正在独占该文件。

没解决?联系我们,或看 完整 FAQ。

免费下载 AssetCrate v1.2.59