# XGen Rename Geometry/Scalp

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2Fw94GKgzmjnGVCnR0pgsr%2FxgtRenamePatchGeo.jpg?alt=media&#x26;token=371423bf-a787-4602-88d2-828f7720f6c7" alt=""><figcaption></figcaption></figure></div>

## Overview

In the Classic Guide Workflow, renaming the XGen base mesh is sometimes necessary. This tool is created for XGen artists to facilitate this need efficiently, ensuring smooth production workflow while preserving as much data

{% embed url="https://youtu.be/8tDeWPil9tI" %}

{% hint style="danger" %}
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.
{% endhint %}

<figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2Fdgkdz6LDkxR0mgnCAwQw%2FreameTest.jpg?alt=media&#x26;token=8c435738-19a0-4187-bb3d-d4d44e4630cb" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**If you have any Guide Colors assigned using the Guide Color Tool, renaming procedure will not work. Please delete the 'xgtGuideColor\_' expression from XGen's Expression tab, and recreate the Guide Color layers again.**
{% endhint %}

***

**Steps:** \
In my scene, there is one XGen collection (bear\_col), that is consists with two XGen descriptions (bodyFur\_des, pawFur\_des) and each is bound to a scalp geo (**baseA**, **baseB**).

* In this scene I would like to rename my scalp geo names from **baseA** and **baseB** to **body\_GEO a**nd **paw\_GEO**

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FeXkrlMnfmn8wGO0aeqpV%2Frenamescalp-1_orig.jpg?alt=media&#x26;token=f57f1c4a-56f0-43f6-bf36-5a2d56f7194a" alt=""><figcaption></figcaption></figure></div>

1. Do a Deep Backup

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FPxHfIakMQVHUGWhDZtt9%2Frenamecol-2.jpg?alt=media&#x26;token=3843dd5d-7c2b-4180-b29f-e5b9ad19a2c6" alt=""><figcaption></figcaption></figure></div>

2\. Launch the XGen Guide Scalp Geo Rename Tool.&#x20;

* Select the scalp geo (1)
* Click on Diagnose (2)

<figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FDpd6RO937yWn0RSwtq5U%2Frenamescalp-2_orig.jpg?alt=media&#x26;token=86197f16-3fbc-42ea-a69a-57b3ad95fd9a" alt=""><figcaption></figcaption></figure>

3\. This step is so that you can check to see what files will be renamed.

* Ptex maps associated with the scalp geo such as texture, mask, clump maps, points, etc, will all be listed at the top.
* The .xgen file will be listed at the bottom. Before renaming, please screen through the files to make sure correct files are listed.&#x20;

<figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FelrfJSnNpgpJzH1mADVv%2Frenamescalp-3_orig.jpg?alt=media&#x26;token=b2a9b1fb-14fb-41bd-ba6f-93d570b0cd29" alt=""><figcaption></figcaption></figure>

4\. Enter a new name.&#x20;

* 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

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FX5kPunOFpuhfnDGNYz8W%2Frenamescalp-4_orig.jpg?alt=media&#x26;token=34e9f68b-25f7-4b7f-ac55-00c17894001a" alt=""><figcaption></figcaption></figure></div>

5\. ​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.

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FB2O0PORR1dV2VeGXfANt%2Frenameagreement-1_orig.jpg?alt=media&#x26;token=56780e37-4cfe-43e5-8b33-a59d91bd215d" alt=""><figcaption></figcaption></figure></div>

6\. After clicking on Rename, the tool will go ahead and rename the associated files listed in the diagnostic. If you see the following **error** saying it can not find the 'original' scalp geo name (in my case, it's **baseA**), it is normal and safe. Please click on XGen preview refresh to see if the error persists.

<figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2Fx1YYTgt4G9cJSuOyniHd%2Frenamescalp-5_orig.jpg?alt=media&#x26;token=9005e47f-79fd-4764-802d-2a6a0d67ef50" alt=""><figcaption></figcaption></figure>

7. Please test the scene to see if XGen is still working. Move the Guides, paint a map, refresh preview, etc. If anything goes wrong, please try using the deep back tool to roll back to the previous scene. In my scene, both scalp geos (baseA and baseB) renamed (body\_GEO and paw\_GEO).

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FR7rFc6gk88zzh51dLyEB%2Frenamescalp-6_orig.jpg?alt=media&#x26;token=a69eaad7-454e-4b9c-875d-7e75010895e5" alt=""><figcaption></figcaption></figure></div>

***

