Roblox UGC 校验报错：上传为什么失败，以及怎么修
你导出配饰、打开 Studio、点上传——迎面一大段关于 cage 顶点的报错。你按自己的理解改完，付掉 80 Robux，提交还是失败。
这个顺序是 Roblox 创作者论坛上最常见的故事，而它的代价被绝大多数教程略过了：上传费按提交次数收，不按成功次数收。
这篇文章做三件事。第一，把创作者真正卡住的地方从他们自己的帖子里汇总出来。第二，用 Roblox 当前的官方规格逐条回答，并附上准确的报错原文，方便你和 Studio 里看到的字串对上号。第三，说明怎么在打开 Studio 之前就在浏览器里拦下这些阻断项。
创作者真正卡在哪
开发者论坛上有四类问题反复出现，而它们大多不是教程会讲的那些。
钱先扣，结果后到。 一个被多人证实的帖子里，创作者的肩部配饰通过了校验、扣了 Robux，提交却以 mesh 尺寸过小失败——反复几次之后约 4000 Robux 不见了，且交易记录里查不到对应条目。跟帖里另有两位创作者报告完全相同的遭遇。不管底层是什么 bug，教训是通用的：校验通过不等于物品能上架，而费用两种情况下都已经付掉了。
报错文字不告诉你该做什么。 有创作者在自认干净的配饰上撞到「Found the following instance tags which are not allowed」。他换了三个插件都没解决。几个月后才有人指出真正的原因：某个插件悄悄给模型里的实例打上了 tag。这条报错技术上完全准确，实践上毫无用处。
分层服装一次次死在 cage 上。 内外 cage 顶点数对不齐、cage UV 不属于模板、服装本体戳出自己的外层 cage。这不是创作者的民间传说——Roblox 在收紧分层配饰的 cage 校验时直接说明，它观察到的问题大多数源于设置不当的 cage。
数字互相打架。 问一句 Roblox 允许多大贴图，三份教程会给你 1024、2048 和 4096 三个答案。这三个数字确实都出现在官方文档里，只是各自回答的是不同的问题——下文会一次讲清。
几乎没人知道的一点：多数检查根本拦不住你
Roblox 的校验系统公布了 16 项具名可视化检查，前缀都是 Measure_。创作者往往把每一条黄色提示都当成上传前必须清掉的障碍。事情不是这样运作的。
16 项里只有 8 项会阻断上传，另外 8 项只是建议，永远不会拦你。
以下是这个二分，直接来自 Roblox 官方文档：
| 检查项 | 会阻断上传吗 |
|---|---|
Measure_Cage_Distance_Head |
阻断 |
Measure_Cage_Mesh_Distance |
阻断 |
Measure_Cage_Mesh_Distance_Avatar |
阻断 |
Measure_Cage_Relevancy |
阻断 |
Measure_Cage_UV |
阻断 |
Measure_Cage_UV_Avatar |
阻断 |
Measure_Mesh_Outside_OuterCage |
阻断 |
Measure_Dynamic_Head |
阻断 |
Measure_Degen_Triangles |
仅警告 |
Measure_Joint_Number |
仅警告 |
Measure_Mesh_Manifold |
仅警告 |
Measure_Texture_Complexity |
仅警告 |
Measure_Texture_Resolution |
仅警告 |
Measure_Triangle_Intersection |
仅警告 |
Measure_UV_Bound |
仅警告 |
Measure_Vertex_Similarity |
仅警告 |
把这份清单再看一遍，规律很明显：8 个阻断项里有 7 个是 cage 检查——cage 与 mesh 的距离、cage UV、cage 改动的相关性、mesh 包含关系。第 8 个针对动态头部，管的是头部 cage 与面部动画数据。退化三角面、自交、流形问题、贴图复杂度低，全部只是质量评分。它们会影响你的物品被如何对待，但不会阻止上传。
有一个必须说清的前提，因为很多人在这里翻车：上面这张表只针对 16 项 Measure_ 质量检查。硬性规格限制——三角面预算、贴图上限、单一 mesh、水密几何、材质设置——由下面的校验类别单独强制执行。Measure_Texture_Resolution 只是建议，并不意味着贴图尺寸没有上限。
规格，一次讲清
以下数字来自 Roblox 自己的规格页面。创作者通常拿到互相矛盾答案的地方，解释写在备注里。
刚性配饰——帽子、头发、道具
| 要求 | 数值 |
|---|---|
| 三角面 | 最多 4k |
| 网格 | 必须是单一 mesh |
| 几何 | 水密，无暴露孔洞或背面 |
| 贴图 | Marketplace 资产最大 2048×2048 |
| 材质 | Plastic |
| 透明度 | 0 |
| 顶点色 | 默认 1, 1, 1 |
| Attachment | 恰好一个，使用对应类型的标准命名 |
| 蒙皮 | 刚性配饰不得包含蒙皮数据 |
包围盒按 attachment 位置和体型分别定义，所以帽子的额度和背部配饰不同，Classic 比例也和 Rthro 不同。如果系统提示你的 mesh 太大，该查的是那张表，而不是三角面数。
分层服装——上衣、裤子、夹克、裙装
| 要求 | 数值 |
|---|---|
| 三角面 | 最多 4k |
| 网格 | 必须是单一 mesh |
| 尺寸 | 上装与下装 8 × 8 × 8 studs；眉毛与睫毛 1.5 × 0.5 × 0.5 |
| 贴图 | Marketplace 资产最大 2048×2048 |
| Cage | 内层 cage 与外层 cage 缺一不可 |
| Cage 命名 | 模型名加后缀 _InnerCage 与 _OuterCage |
| 蒙皮 | 绑定到 R15 骨架，每顶点最多 4 个关节影响 |
| 材质 | Plastic，透明度 0，顶点色 1, 1, 1 |
| 其他 | Accessory 内不得含 Script 或多余 Part |
贴图之争的答案
你见过的三个数字都是真的，它们回答的是三个不同的问题：
- 4096×4096 —— Roblox 引擎对普通 mesh 贴图的支持上限。
- 2048×2048 —— Marketplace 配饰与分层服装贴图的硬上限。做 UGC 只需要看这一个。
- 1024×1024 ——
SurfaceAppearance所用 PBR 贴图的上限。
上传 UGC，就把目标定在 2048 及以下。更高分辨率的贴图无论如何都会被自动降采样以保证性能，所以 4K 源图在头像配饰上换不来任何收益，反而可能丢失细节。
Cage：分层服装真正的死因
既然 8 个阻断项里有 7 个是 cage 检查，你的注意力就该放在这里。
一件分层服装带着两层不可见的网格。内层 cage 定义贴合下方身体的内表面。外层 cage 定义别人的服装穿在你这件之上时所贴合的外表面。Roblox 提供模板 cage，外层 cage 初始与内层完全相同——你要做的是把外层向外调整到完全包住你的服装，内层原封不动。
四条规则解释了绝大多数失败：
永远不要删除 cage 的顶点或 UV。 Roblox 文档明确写着，内外 cage 的顶点与 UV 不得被删除或移除，因为它们用于在 cage 之间匹配坐标。把「用不到」的部分删掉，是最常见的自伤——它会同时打破 Measure_Cage_UV 和顶点数对齐。
让网格待在外层 cage 里面。 如果服装有一部分穿了出去，Measure_Mesh_Outside_OuterCage 会报出逃逸顶点的百分比并阻断上传。正确做法是把外层 cage 在该区域向外推，而不是缩小你的模型。
别让 cage 飘起来或陷进去。 Measure_Cage_Mesh_Distance 双向阻断——cage 离渲染网格太远会拦，cage 顶点陷进网格内部同样会拦。它要的是贴合。
只在服装需要的地方动 cage。 Measure_Cage_Relevancy 衡量你改动的 cage 有多少真正落在配饰上方。「以防万一」地大范围拖动 cage，正是触发它的原因。
命名，一个字都不能差
内层 cage 网格对象必须是配饰模型名加 _InnerCage，外层必须是同名加 _OuterCage。不是 InnerCage，不是 Inner_Cage，也不是你自己起的名字。Roblox 按这个约定匹配，一次改名就足以让一对完全合格的 cage 在导入器眼里消失。
Roblox 现在自带 Studio 校验器——以及它的边界
2026 年 6 月 29 日，Roblox 上线了 Studio Beta 功能 Visualizing UGC Validation。选中身体、动态头部、刚性配饰或分层配饰运行它，错误和警告会连同视口里的可视化叠加一起显示，直接指出问题所在。这是一次实打实的改进，值得打开。
启用方式：File → Beta Features → Visualizing UGC Validation，重启 Studio，在工具栏添加自定义标签页，加入 UGC Validation 工具，然后选中资产运行校验。
两条诚实的限制。它不做修复——只告诉你哪里错了，改还是你自己改。而且它活在 Studio 里，意味着模型必须已经导出、导入、配置完毕，你才会知道 cage 从一开始就是错的。对不少创作者来说，最想提前拦下的失败恰恰发生在这之前。
在进 Studio 之前就拦下来
这正是 Roblox UGC Requirements Checker 填的缺口。在浏览器里拖入 GLB、GLTF 或 FBX，选择配饰或分层服装，约 30 秒后你会拿到一份红/黄/绿报告——分层服装 17 项检查，配饰 11 项——每一条失败下面都附一句人话写的修法。
检查项的分组方式与失败真正聚集的地方一致：cage（是否存在、命名、顶点数、UV、贴合度、相关性）、网格与材质（单一 mesh、4000 三角面、单一材质）、贴图尺寸、R15 蒙皮覆盖，以及网格健康。你可以把内外 cage 与服装叠在一起做 X 光对照——本文前面那张图就是这么来的。
当报告显示 cage 缺失或损坏时（按上面的数字，大多数分层服装都会落在这里），Cage Generator 会重建它们：内层 cage、外层 cage 和 R15 蒙皮，按你的服装贴合生成，返回一个已绑定的 .fbx。然后把这个文件拿回 checker 确认它变绿。
如果你是从零开始做而不是修一个已有文件，Roblox 配饰生成器和分层服装生成器产出的模型本身就落在这些限制之内。
有一点必须直说：预检是近似的。Roblox 上传时的校验才是权威，这里通过也不等于审核会放行你的物品。它真正为你换来的是——你不会再在付款之后才发现几何问题。
上传前检查清单
在花钱之前把这份跑一遍。
- 单一 mesh，水密，无暴露孔洞或背面。
- 三角面低于 4000。
- 单一材质，设为
Plastic，透明度0，顶点色1, 1, 1。 - 贴图 2048×2048 或更小。
- 仅分层服装： 两层 cage 齐备，命名为
_InnerCage与_OuterCage，没有删除任何顶点或 UV。 - 仅分层服装： 服装完全位于外层 cage 内；cage 贴合网格，既不悬空也不内陷。
- 仅分层服装： 已绑定 R15，每顶点最多 4 个影响。
- 仅刚性配饰： 完全不含蒙皮数据，恰好一个命名正确的 attachment。
Accessory内没有多余东西——没有脚本，没有游离的 part，没有插件打上的 tag。- 预留费用： 每次提交 80 Robux，外加对应品类的发布预付款。
弄错了要付多少
Roblox 对任何 2D 或 3D 物品收取每次提交 80 Robux 的上传费。在此之上，非限量物品按品类收取发布预付款：
| 品类 | 发布预付款 |
|---|---|
| 经典服装（T 恤、衬衫、裤子） | 10 Robux |
| 帽子、脸部 | 1,500 Robux |
| 头发 | 1,000 Robux |
| 颈部、肩部、前部、背部、腰部配饰 | 1,000 Robux |
| 夹克、衬衫、毛衣、裤子、连衣裙、半身裙、短裤、鞋 | 600 Robux |
| 头部 | 1,500 Robux |
| 表情动作 | 1,500 Robux |
| 身体 | 2,500 Robux |
这才是先检查的真正理由。一个坏掉的 cage 不是「五分钟改完重试」——它是一笔你已经付掉的费用、一趟必须重来的 Studio 往返，以及一次重新排到队尾的等待。
常见问题
我的 Roblox UGC 为什么没通过校验？
大多数阻断性失败都是 cage 问题。Roblox 公布的 16 项具名校验检查中，8 项会阻断上传——其中 7 项是 cage 检查（cage 与 mesh 距离、cage UV、cage 相关性、mesh 包含关系），第 8 项针对动态头部的 cage 与面部动画数据。另外 8 项是永远不会阻断的质量警告。此外，4k 三角面预算、2048 像素贴图上限、单一 mesh 与水密几何等硬性规格限制，由校验系统另行强制执行。
Roblox UGC 有哪些要求？
刚性配饰与分层服装共享核心限制：单一水密 mesh、不超过 4k 三角面、贴图最大 2048×2048、材质设为 Plastic 且透明度为 0、顶点色为 1, 1, 1。分层服装另需内层与外层 cage，以及每顶点最多 4 个关节影响的 R15 蒙皮。刚性配饰则不得包含任何蒙皮数据，且必须恰好有一个命名正确的 attachment。
Roblox UGC 允许多大的贴图？
Marketplace 的配饰与分层服装上限是 2048×2048。你可能见过的 4096 是引擎对普通 mesh 贴图的支持上限，1024 则是 SurfaceAppearance 所用 PBR 贴图的上限。做 UGC 物品，请保持在 2048 及以下。
Roblox UGC 配饰最多能有多少三角面？
上限是 4k 三角面，刚性配饰与分层服装同样适用。超出会直接导致校验失败，而不是给出警告。
「mesh vertices are outside its outer cage」是什么意思？
意思是你的服装有一部分戳出了本该包住它的外层 cage，Roblox 会阻断上传，因为这样的物品穿戴时会严重变形。修法是把外层 cage 朝穿出去的那片区域向外移动，而不是把模型缩小。
用不到的 cage 顶点为什么不能直接删掉？
因为 Roblox 用 cage 顶点与 UV 在各 cage 之间匹配坐标，官方文档写明它们不得被删除或移除。裁剪模板 cage 是导致 cage UV 与顶点数校验失败最常见的原因之一。
Roblox 自己有 UGC 校验工具吗？
有。Roblox 于 2026 年 6 月 29 日以 Studio Beta 形式发布了 Visualizing UGC Validation。在 File → Beta Features 中启用，重启 Studio，再把 UGC Validation 工具添加到自定义工具栏标签页。它以可视化方式标出错误与警告，但不会修复，且要求模型已经导入 Studio。
上传 UGC 到 Roblox 要花多少钱？
每次提交 80 Robux 上传费，外加按品类计的发布预付款——经典服装 10 Robux，分层服装 600，头发与多数身体配饰 1,000，帽子、脸部、头部与表情动作 1,500，身体 2,500。上传费按提交次数收取，物品是否被接受都一样。
预检通过就能保证物品被接受吗？
不能。浏览器预检是对 Roblox 规则的近似，Roblox 上传时的校验才是权威，内容审核又是另一道独立环节。预检真正的作用是在机械性失败——cage、三角面数、贴图尺寸、蒙皮——让你破费之前把它们拦下来。