Wiki
验证规则
在签入时执行的资产验证检查 : 9条内置规则、error / warning / info 严重级别、JSON 配置、导出 / 导入 / 重置。
简介
验证规则是在签入时执行的 Unreal 资产检查 : 命名、纹理大小、缺失的依赖项等。它们用于 在内容进入仓库之前自动强制执行工作室规范。配置以仓库为单位进行。
访问权限与角色
规则选项卡对超级管理员以及在其所管理仓库上的 project_admin 开放。
自动初始化
第一次打开一个尚无规则的仓库的规则时，会自动创建 9 条默认规则。因此您始终从一套完整的规则开始，再进行调整。
严重级别
| 严重级别 | 签入时的效果 |
|---|---|
error | 在问题被修复之前阻止签入。 |
warning | 发出警告但允许通过。 |
info | 纯属信息提示。 |
9条内置规则
| 规则 | 默认 | 检查内容 |
|---|---|---|
blueprint_compilation | error | Blueprint 在签入前无错误地编译。 |
naming_convention | warning | 命名前缀（Allar UE5 风格）: T_ 纹理、M_ 材质、BP_ 蓝图、SM_ 静态网格体、WBP_ 控件等。 |
max_texture_size | warning | 纹理最大尺寸 : 默认 4096 × 4096，必须为 2 的幂。 |
material_complexity | warning | 材质复杂度 : 默认最多 256 条指令、16 个纹理采样。 |
import_settings | warning | 符合规范的导入设置（纹理、网格体）。 |
missing_dependency | error | 没有缺失的依赖项（默认忽略引擎内容）。 |
circular_dependency | error | 没有循环依赖（默认搜索深度为 20）。 |
unreferenced_asset | info | 标记未被引用的资产（默认排除地图和控件）。 |
duplicate_asset | warning | 检测重复资产（默认忽略 .umap）。 |
启用与配置
对于每条规则 :
- 开关 : 启用 / 禁用规则。立即保存。
- 严重级别 : error / warning / info 下拉菜单。立即保存。
- 配置（JSON） : 展开规则（箭头）以 JSON 编辑其参数，然后 Save Config。无效的 JSON 会阻止保存并给出错误详情。
示例 : 为移动项目将 max_texture_size 降至 2048，或将 naming_convention 切换为
error 以严格强制执行。
导出、导入、重置
- Export : 下载一个包含所有规则状态（启用、严重级别、配置）的
rules.json文件。 - Import : 重新加载
rules.json并将每个条目应用到对应的规则（未知的键会被忽略）。 - Reset to Defaults : 将所有规则恢复为其默认值。自定义配置将丢失（需要确认）。
导出 / 导入用于将验证策略从一个仓库复制到另一个仓库，或将其离线进行版本管理。
仓库中的 rules.json
已提交的 rules.json 并非任何人都能使其生效
只有当提交的作者持有
manage_rules 能力时，已提交的 .uversion/rules.json 文件才会应用到
仓库策略。否则该文件会被存储，但规则不会更改。这是一道防护 : 在该路径上拥有写入权限的贡献者无法通过提交文件来禁用验证。
常见陷阱
签入被阻止
一条设为 error 的规则失败了。消息会指出是哪一条。修复资产，或者（如果该规则对您的场景过于严格）将其严重
级别降为 warning。
重置抹掉了我的设置
Reset to Defaults 对您的自定义配置具有破坏性。如果您希望能够回退，请先执行 Export。
某条规则似乎什么都没做
检查它是否已启用（开关），如果您期待的是阻止，则检查其严重级别是否为 info。只有 error
会阻止签入。