Asset Naming Convention Checker

Asset Naming Convention Checker

Module: Tech · Category: QA · Tool ID: AssetNamingChecker

Validates asset names against configurable prefix rules: SM_ for Static Meshes, SK_ for Skeletal Meshes, T_ for Textures, M_ for Materials, etc. Detects spaces and special characters. Generates suggested corrected names. Supports per-asset rename plus batch-rename-all-violations.

---

When to use it

• Pre-shipping QA — confirming naming conventions are consistent
• Onboarding to a project with poor naming — bulk-fix violations
• After importing third-party packs — usually full of non-standard names

When not to use it

• Don’t expect this to handle complex naming rules — basic prefix + special character validation; for richer rules use a custom tool

---

Opening the tool

1. Open the EQLabs Hub and search for Naming (or browse to Tech → QA)
2. Click the tool card
3. Click Scan

---

Interface tour

Field	What it does	Default
Scan Path	Folder to scan	/Game
Check Prefixes	Toggle prefix rule check	true
Check Spaces	Toggle space detection	true
Check Special Chars	Toggle special-char detection	true
Type Filter combo	Show only one asset type
Name Filter	Substring filter on asset name
Scan	Walks the path
Copy Results	Plain-text dump
Batch Rename	Renames every violation to its suggested name
Stats	Total scanned / violation count
Violations list	Per-row: severity, asset name, type, expected prefix, issue, suggested name, rename action

Severity coding

Severity	Meaning
Error	Special characters in name (often breaks cooking)
Warning	Wrong / missing prefix, spaces
Info	Minor issue

Built-in prefix rules

SM_ (Static Mesh), SK_ (Skeletal Mesh), T_ (Texture), M_ (Material), MI_ (Material Instance), BP_ (Blueprint), WBP_ (Widget BP), A_ (Animation), MNT_ (Montage), PA_ (PoseAsset), NS_ (Niagara System), SC_ (SoundCue), SW_ (SoundWave), etc.

---

Workflow

Cleanup pass

1. Set Scan Path
2. Click Scan
3. Filter by type / name
4. Click Batch Rename to fix all violations at once

Per-asset review

1. Walk the violations list
2. For each row, click the per-row Rename action to apply just that fix
3. Skip rows where the suggested name doesn’t match what you actually want

---

Settings reference

Field	Default
Scan Path	/Game
Check Prefixes / Spaces / Special Chars	all true

Settings file: [Project]/Saved/EQLabs/Settings/AssetNamingChecker.json

---

Output

• Asset rename operations — modifies asset names + updates references
• Clipboard — Copy Results
• Undo — wrapped in ScopedTransaction per-rename

---

Tips & gotchas

• Renames update references — UE’s asset rename automatically fixes up referrers, but commit before bulk renames just in case
• Suggested name uses <Prefix>_<OriginalCleanName> — review before bulk applying; suggestions can be wrong for unusual base names
• Special characters cause cook failures — these are Errors and should be fixed first

---

Related tools

• Project Doctor Suite — broader project audit
• USD Interchange Repair Kit — for fixing imports

---