SimpleAssetNamer 使用文档

支持 Unreal Engine 5.2–5.8

打开 编辑 → 项目设置 → Simple Asset Namer

默认排除路径：

• /Game/__ExternalActors__ - World Partition 自动生成
• /Game/__ExternalObjects__ - World Partition 自动生成
• /Game/Developers - 开发者个人文件夹
• /Game/Collections - 收藏夹

示例：输入 bp-MyActor 或 bp.MyActor → 输出 BP_MyActor

命名格式：前缀_名称_后缀（后缀可选）

默认规则（52 种类型）：

示例：创建蓝图 MyCharacter → 自动重命名为 BP_MyCharacter

右键菜单项位于 Simple Asset Namer 二级子菜单下。

资产右键菜单

1. 选择一个或多个资产
2. 右键 → Simple Asset Namer → Auto Rename

文件夹右键菜单

1. 右键点击文件夹
2. Simple Asset Namer → Auto Rename All Assets

文件夹批量重命名使用三级渐进策略：

总数 < 100 时直接逐个处理。

完成后显示结果窗口，包含三个标签页：

• 成功：成功重命名的资产
• 错误：失败的资产及错误原因
• 跳过：跳过的资产及原因

常见错误：

Q：重命名后资产引用会断吗？

不会。使用 UE 官方 API，自动处理引用并创建重定向器。

Q：可以撤销吗？

可以，支持 Ctrl+Z 撤销。

Q：为什么有些资产没被重命名？

1. 已经是标准名称
2. 该资产类型没有配置命名规则
3. 路径被过滤器规则排除
4. 文件为只读且无法签出

Q：如何添加自定义规则？

设置 → Asset Type Naming Rules → 点击 + 添加新规则。

Q：批量重命名显示很多未知错误怎么办？

先修复重定向器：内容浏览器 → 右键文件夹 → Fix Up Redirectors in Folder，然后重新运行重命名。

如有使用问题或合作需求，请前往联系页面。

• 联系入口： 联系与合作

使用资产类型规则、路径范围和词缀配置，处理新建资产及已有资产的命名。

将插件文件夹复制到项目的 Plugins 目录，重启编辑器。

路径：Edit > Project Settings > Simple Asset Namer

基础配置：

1. General：开启/关闭自动重命名
2. Filter：配置黑名单/白名单路径
3. Delimiter：配置分隔符和旧词缀
4. Naming Rules：为每种资产类型配置前缀和后缀

使用前检查默认规则是否符合项目的命名约定。

• 自动模式：正常工作即可，创建/导入资产时自动命名
• 批量模式：选中文件夹，使用批量重命名功能

命名规则配置：

每种资产类型可以配置独立的前缀和后缀：

USTRUCT(BlueprintType)
struct FAssetNamingRule
{
    FString Prefix;  // 如 "BP"
    FString Suffix;  // 如 "Mat"
};

// 配置示例
TMap<TSoftClassPtr<UObject>, FAssetNamingRule> AssetTypeNamingRules;
// UBlueprint      → Prefix: "BP",  Suffix: ""
// UStaticMesh     → Prefix: "SM",  Suffix: ""
// UMaterialInstance → Prefix: "MI", Suffix: ""
// UTexture2D      → Prefix: "T",   Suffix: ""

核心名称提取：

插件会先分析现有名称结构，提取核心名称，再生成标准命名，而非直接在原名前加前缀：

输入: "bp_MyCharacter"    → 核心: "MyCharacter"  → 输出: "BP_MyCharacter"
输入: "SM-tree-01"        → 核心: "tree-01"      → 输出: "SM_tree_01"
输入: "Blueprint_Player"  → 核心: "Player"       → 输出: "BP_Player"
输入: "MyMaterial_Mat"    → 核心: "MyMaterial"   → 输出: "M_MyMaterial"

提取过程会尝试匹配并移除：

1. 当前类型配置的前缀/后缀
2. 旧词缀列表（LegacyAffixes）中的所有词缀
3. 分隔符识别列表中的分隔符（_、-、.）

黑名单模式（默认）：

排除指定路径下的资产，默认排除 UE 内部目录：

ExcludePaths:
  /Game/__ExternalActors__    // World Partition 自动生成
  /Game/__ExternalObjects__   // World Partition 自动生成
  /Game/Developers            // 开发者个人目录
  /Game/Collections           // 集合目录

白名单模式：

只处理指定路径下的资产，适合渐进式推行命名规范：

IncludePaths:
  /Game/Characters/
  /Game/Items/

// 生成命名时使用的连接符
FString Delimiter = "_";               // BP_MyActor

// 识别现有命名时的分隔符列表
TArray<FString> DelimiterDetectionList = {"_", "-", "."};

// 旧词缀列表（用于识别历史命名的前缀和后缀）
TArray<FString> LegacyAffixes;  // 如 "bp", "Blueprint", "sm", "mat"

• bAutoRenameOnCreate：创建或导入资产时按规则命名。
• bAutoRenameOnRename：手动改名后重新检查命名规则。

批量重命名后会弹出详细的结果对话框，包含：

• 成功数量和明细（原名 → 新名）
• 跳过数量和原因（已是标准名称、无匹配规则、目标已存在等）
• 错误数量和具体信息

选择目标文件夹后使用批量重命名入口。先检查包含或排除路径，再查看成功、跳过与错误明细。批量操作前保留可恢复的版本，并核对重命名后的资产引用。