XGen Rename Collection

Overview

This tool allows XGen artists to rename a collection when the base mesh name needs to change. It's ideal for studios adapting projects from others to fit their naming conventions. Designed to integrate easily into production workflows.

Before using this tool, it's HIGHLY RECOMMANDED to try it with a test file first to see if it works on your machine. You can download the 'renameTest.zip' file and use that scene for testing this tool.

If you have assigned Guide Colors using the Guide Color Tool, the renaming procedure will not function. Please remove the 'xgtGuideColor_' expression from XGen's Expression tab and recreate the Guide Color layers

---

Steps: ​ In my scene, there is one XGen collection (hair_col), that is consists with two XGen descriptions (hairA_des, hairB_des) and each is bound to a scalp geo (baseA, baseB).

• In this scene I would like to rename my XGen Collection name from hair_col to bear_col

1. Do a Deep Backup

1. Open the XGen Guide Collection Rename Tool. Select the XGen Collection in the list that you wish to rename

3. Enter a new name.

• The tool will go through a series of naming checks. If the renaming failed, please follow the warning messages.

• The name can not exist in any nodes in scene

• The name can not be the same as existing 'collection' or 'description' folders inside your current scene folder.

• The name can only start with alphabets

4. A prompt window will show up, by clicking Yes, you agree that due to many reasons, renaming can cause issues with XGen and you will be responsible for the damage caused to your work, if any.

1. If successful, the XGen collection name will be renamed.

1. Test the scene to see if XGen is still working. Move the Guides, paint a map, refresh preview, etc. If anything goes wrong, please roll back the file using the deep backup tool.

---