从第一次安装到日常使用,这一页就够了。遇到具体问题先去 FAQ,或到 QQ 群 1097972055 或官网 www.assetcrate.net 问我们。
目标:把一个模型从工程 A 收进素材箱,再从素材箱放进工程 B。
下载 zip 解压,AssetCrate 文件夹放进 <工程>/Plugins/,在 编辑 → 插件 启用后重启编辑器。
窗口 → 素材箱 打开面板 → 左上角 + 新建箱,选一个工程外的目录,例如 D:\AssetCrate\。
内容浏览器里选中模型(可多选)→ 右键 → 导出到素材箱。依赖会被一起收走,并自动渲染缩略图。
在素材箱面板里搜索 / 点标签找到它 → 双击=导入当前工程;拖到视口=导入并摆进场景。
顺手记住一件事:收素材还有一种更快的方式 —— 直接从内容浏览器把素材拖到素材箱面板上,一样会连依赖一起复制进箱。
每一项都对应插件里真实存在的入口。
怎么做:内容浏览器里选中资产 → 右键 → 导出到素材箱(单个/多个);或右键 → 导出所有到素材箱(整目录)。也可以直接把资产拖到素材箱面板上。
会发生什么:插件把选中的资产连同它的全部依赖(材质、贴图、材质函数、骨骼、动画…)复制进箱目录。主资产放在条目文件夹第一层,依赖按类型各放一层子文件夹(Materials\ Textures\ StaticMeshes\ Blueprints\ …),并写一份 entry.json 记录来源与依赖清单。
注意点:同一个素材重复收集会更新原条目,不会新建重复条目。未保存的资产会被自动保存后再导出。引擎自带内容和引擎插件内容会被跳过(任何工程里本来就有)。
双击条目=导入到当前工程;从面板拖到关卡视口=导入并摆进场景。多选后可批量导入。
导入会在 <工程>/Content/AssetCrate/<素材名>/ 下生成一份引用完好的副本。因为是"先完整导入、再摆进场景",所以不会出现材质丢失的黑模型。
同一个面板上共 8 条找素材的路,记不住名字有标签,记不住标签有分类 —— 你不用记,它替你记。常用的组合还能一键复制、一键恢复。
① 分类树:支持任意层级,例如 Trees/Pines/Big。把分类拖到另一个分类上即可调整父子关系;右键可新建 / 重命名 / 移动 / 删除;把素材拖到分类上即完成归类。每级带数量,先看大盘再钻进去。
② 类型筛选:按资产类型一键筛,静态网格体 / 材质 / 蓝图 / 动画各归各。
③ 标签筛选:点左侧任意标签即可筛选,支持多标签叠加;点一下选中,点一下取消。左侧标签按维度分组并带数量。标签可重命名、可合并。
④ 搜索框:名称 / 标签 / 类型 / 路径四维一起搜,模糊匹配,命中越准排越前。
⑤ 收藏:常用素材点星标,一键只看收藏,就是你的"常用清单"。
⑥ 引擎版本筛选:按素材保存时的引擎版本筛,含「与本工程不同」这一档 —— 提前发现"换个引擎就坏"的素材。
⑦ 来源筛选:多项目共用一个箱时,按来源工程筛,带数量统计,一眼知道这条是哪来的。
⑧ 备注:每个条目写一段备注:"这是什么、用在哪、谁做的" —— 三个月后你自己还认得出它。
缩放:Ctrl + 滚轮,或用工具栏缩放框(64–256)。
给条目贴标签、写备注。标签按外形或用途随手打即可(交通工具、轮船、油轮 可以同时贴在同一个模型上)。
缩略图上的标记表示这条素材已经在当前工程里,一眼就能分清"自己人"和"外部素材"。
你这边:在内容浏览器里选中素材 → 右键 → 打包 .zip… → 保存。一条素材一个 zip,里面包含依赖、缩略图,外加一份中英双语使用说明。
同事那边:素材箱面板上点【导入】→ 选中这个 zip。压缩包会自动解压进他的箱,几秒后带着缩略图出现。
他没装插件怎么办:zip 里附了中英双语的 README-HowToUse.txt,照着手动放进箱目录也能用。这是兜底办法,不是主推流程。
注意:视口右键只有「导出到素材箱」「导出所有到素材箱」两项;打包 zip 的入口在内容浏览器右键菜单里。
支持多个箱随时切换:私人箱放自己常用的素材,团队箱指向网络盘上的共享目录,大家一起用同一份。
只读的箱会被自动识别并说明原因(例如网络盘权限不足或目录被占用)。
entry.json 采用原子写入 + 乐观并发保护(时间戳与大小双校验),两人同时改同一个条目时不会静默覆盖。
一键检查三类问题:缺缩略图、重复条目、箱目录与实际记录不一致。素材攒多了以后,定期跑一次能省很多事。
简体中文完整 / 英文约 70%(补全中),自动跟随编辑器语言,不需要手动切换。
需要批量处理或排查时可以用的命令:
AssetCrate.Export、AssetCrate.Import、AssetCrate.UpgradeLibrary、AssetCrate.ResaveFolder、AssetCrate.ResaveAsset、AssetCrate.RegenerateThumbnails、AssetCrate.SelfTest.*。
旧的 UE4 时代静态网格体首次加载可能会卡几秒到几分钟,用 AssetCrate.ResaveFolder /Game/YourFolder 重存一次即可永久解决。
打印出来贴显示器旁边的那一页。
| 你想干嘛 | 怎么做 |
|---|---|
| 把素材收进箱 | 内容浏览器选中 → 右键 导出到素材箱/导出所有到素材箱;或直接拖到素材箱面板上 |
| 看看它长什么样 | 单击瓦片 → 缩略图 + 大小 + 依赖清单 |
| 打开它自己的编辑器 | 双击(模型开模型编辑器、蓝图画布、动画开动画编辑器) |
| 只导入、先不摆 | 双击,或右键 → 导入到当前工程 |
| 导入并摆到场景里 | 把瓦片拖进关卡视口 |
| 一次导入十几个 | 多选 → 批量导入 |
| 发给同事 | 内容浏览器右键 → 打包 .zip…;对方面板点【导入】 |
| 搜索 | 搜索框输入名称 / 标签 / 类型 / 路径,四维一起模糊匹配,命中越准排越前;搜索条件可一键复制、一键恢复 |
| 按维度筛 | 分类树 / 类型 / 标签 / 收藏 / 引擎版本(含「与本工程不同」)/ 来源工程 —— 共 8 条找素材的路 |
| 缩放缩略图 | Ctrl + 滚轮,或工具栏缩放框(64–256) |
| 换箱 / 改目录 | 面板顶部「更改目录」;「打开文件夹」用资源管理器打开 |
| 看额度用了多少 | 面板左下角点「许可」 |
| 体检 | 工具栏「体检」→ 检查缺缩略图 / 重复条目 / 目录不一致 |
17 页 · 13 章 + 附录 · 15 张表 · 7 张图。功能与截图最全的一本,适合通读一遍或当手册查。
| 文档 | 内容 | 适合什么时候看 |
|---|---|---|
| 操作说明书 v3.1 | 17 页,13 章 + 附录,15 表 7 图 | 想系统了解全部功能 |
| 本页「3 分钟上手」 | 4 步图文 | 刚装完,想立刻跑通 |
| 包内 README | 安装 + 首次配置 | 只想快速装上 |
| 包内 README-HowToUse.txt | 中英双语,手动放置素材箱的说明 | 收到 zip 的人没装插件时 |
修复视口导出蓝图 Actor 时导出成网格;导出到素材箱后缩略图不再长时间等待;多引擎共用素材库不再因索引崩溃。完整记录以插件包内 CHANGELOG.md 为准。
| 类别 | 内容 |
|---|---|
| 修复 · 蓝图导出 | 视口选中蓝图 Actor →「导出到素材箱」现在导出蓝图资产本身(依赖自动带上网格/材质);普通 Actor 仍导出组件网格 |
| 修复 · 缩略图 | 手动保存小批量时当场渲染(约 0.1~0.2 秒/条),后台不再等全工程编译;生成期间显示「生成中…」 |
| 修复 · 索引崩溃 | 索引按引擎版本分开(library_index_5.x.bin)+ 头部版本校验,不匹配就全量扫描重建 |
| 兼容 | UE 5.1~5.8 八个独立包,不能混用 |
| 类别 | 内容 |
|---|---|
| 新增 · 收集 | 右键「导出到素材箱」连依赖一起收;箱在工程外的任意磁盘/网络位置;可直接从内容浏览器拖到面板收集;重复收集更新原条目 |
| 新增 · 使用 | 双击=导入当前工程;拖到视口=导入并创建到场景;导入生成引用完好的副本 |
| 新增 · 面板 | 缩略图墙、搜索(名称/标签/类型/路径)、标签筛选、备注、任意层级分类、缩放(64–256)、透明背景缩略图 |
| 新增 · 多箱 | 多个箱(私人 + 团队共享)一键切换;只读箱检测并说明原因;entry.json 原子写入 + 乐观并发保护 |
| 新增 · 本地化 | 简体中文完整;英文约 70%;控制台命令 AssetCrate.Export / Import / UpgradeLibrary / ResaveFolder / ResaveAsset / RegenerateThumbnails / SelfTest.* |
| 修复 | 右键菜单不出现、拖拽无反应、未保存资产导不出、缩略图上下颠倒、面板配色与内容浏览器不一致、导入失败、重复条目、Slate 弹窗断言等 |
| 已知限制 | 引擎与引擎插件内容会被跳过;旧的 UE4 时代静态网格体首次加载可能卡顿,用 AssetCrate.ResaveFolder 重存一次即可 |
插件包内的 CHANGELOG.md 含中英对照全文;如需逐条核对,请解压下载包查看。
检查目录层级是否为 <工程>/Plugins/AssetCrate/AssetCrate.uplugin;确认已在 编辑 → 插件 启用并重启编辑器;若提示"引擎版本不兼容",说明引擎不在支持范围内。
缩略图由引擎的缩略图渲染器生成,首次进入面板时可能还在后台渲染,稍等几秒或滚动一下。
如果长时间为空,可用工具栏「体检」检查「缺缩略图」,或用命令 AssetCrate.RegenerateThumbnails 重新生成。缩略图缓存存放在箱目录的 Thumbnails\ 下,确认该目录可写。
正常情况下不会发生 —— 拖到视口时插件会先把素材和材质完整导入当前工程再摆进场景。
如果确实出现,请确认箱目录里的材质/贴图文件完整(体检可查"目录与记录不一致"),并且这些文件没有被安全软件隔离。
先确认 zip 完整(传输中断会导致解压失败);再确认箱目录可写;另外不要手工改动 zip 内部结构。
如果对方使用的是不同版本的插件,建议双方都升级到当前版本再试。
多个素材、缩略图缓存和 entry.json 读写都发生在箱目录上,网络盘延迟高时会明显变慢。建议把常用素材放本地箱,团队共享箱只放需要共享的部分。
提示只读通常是权限或占用问题:确认当前账号对目录有写权限,且没有其他人正在独占该文件。