# Asset conversion for GTAV Enhanced

In this tutorial, you will learn how to convert your assets from the Legacy version of Grand Theft Auto V to Enhanced, released in 2025.

### What will you need

* CodeWalker30\_dev48 or newer version (available at <https://discord.gg/codewalker>, #releases channel)
* Legacy assets from mods (.ydr. .yft, .ytd, .ydd files are supported)
* OpenRPF for Enhanced <https://www.gta5-mods.com/tools/openrpf-openiv-asi-for-gta-v-enhanced>

{% hint style="info" %}
Double make sure you are using the CodeWalker 30 dev48 or newer version.
{% endhint %}

### Utilizing the Asset Converter

1. Prepare the folder with your Legacy assets&#x20;

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FCZcRbkJZEwvEEFKSzJv5%2F2-ng-files.png?alt=media&#x26;token=9c77b20b-5368-4e13-9a4c-a7fa2ff3a1df" alt=""><figcaption><p>Files of Adder vehicle in Legacy format</p></figcaption></figure>

2. Create a folder for Enhanced assets (in this example - **gen9**)

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FC3YKRhxdttk4xKCTE98M%2F3-gen9-folder.png?alt=media&#x26;token=7d4c8422-ca31-4e99-8202-b0dbe40f7b78" alt=""><figcaption></figcaption></figure>

3. Open up CodeWalker RPF Explorer, and head to Asset Converter

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2F1fS1hdXU4njMbykAWSCp%2F1-runassetconverter-new.gif?alt=media&#x26;token=1fb41432-7dce-4ddd-9933-1211fa96d5a8" alt=""><figcaption><p>Opening Asset Converter via Tools\Asset Converter</p></figcaption></figure>

4. Select a folder with Legacy files

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2Fmw4yaobHjmyeAyYcpHD0%2F4-legacy-folder-select.gif?alt=media&#x26;token=a141c357-6d1f-43ca-939b-adca64390279" alt=""><figcaption><p>Selecting a folder with Legacy files</p></figcaption></figure>

5. Select a folder to save converted files

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FmCTllYYDAOT7OToJzLis%2F5-gen9-folder-select.gif?alt=media&#x26;token=acf898f6-c561-4ddd-b34b-b6fa27bff26e" alt=""><figcaption><p>Selecting a folder to convert files for Enhanced</p></figcaption></figure>

6. Untick **Include subfolders** and click **Process**

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FbE1hBk8XWpY8c1mvKNxA%2F6-conversion-process.gif?alt=media&#x26;token=e0188f89-2f38-4b26-9f99-733be422d22a" alt=""><figcaption><p>Conversion process</p></figcaption></figure>

And it's done! Conversion process was completed and your mod is ready to be used in Enhanced.

***

### OpenRPF

In order to use modified files in the Enhanced version, an OpenRPF file loader is needed. \
Installation process is very simple.

1. Download OpenRPF from the link on the top of this tutorial.
2. Extract ZIP archive.
3. Select dsound.dll and OpenRPF.asi and drag\&drop them to GTAV Enhanced installation folder

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FnxDuc7LIYlgEYKblAuP6%2Fopenrpf-installation.gif?alt=media&#x26;token=18334e8e-eb3c-4665-b7e1-98c2aba0e758" alt=""><figcaption><p>OpenRPF installation process</p></figcaption></figure>

***

### Troubleshooting

There is no rose without thorns, especially in game modding. Some unexpected behaviours can occur when porting content to Enhanced.

#### ERR\_GFX\_STATE

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FFVzPssK3pEZ5tmC1v0l2%2Ferr_gfx_state.png?alt=media&#x26;token=6b1aa2f8-9b7a-4fd9-886f-78692a549683" alt=""><figcaption></figcaption></figure>

**Q**: My car is spawned, when I'm entering the car, I got **ERR\_GFX\_STATE** crash.\
**A**: The issue is in the texture inside .ytd file. A texture starting with `script_rt_` name is saved in incorrect format. For such file, only `D3DFMT_A8R8G8B8` is expected by game.

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FJQe09ZTlT2NRTRsj5Kx6%2Fscript_rt_incorrect_format.png?alt=media&#x26;token=69c31d04-1299-4bae-a845-d7697ec84e64" alt=""><figcaption><p>DXT5/BC3 texture format is the wrong one</p></figcaption></figure>

To fix this issue:

1. Extract texture to .dds

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2F672iSUzbg42btibRnGWW%2Fextract-texture.gif?alt=media&#x26;token=b750378e-7bf0-429e-b6d0-e2185300077f" alt=""><figcaption><p>Process of extracting texture from .ytd file</p></figcaption></figure>

2. Open texture in image editor supporting editing .dds files (i.e. GIMP)
3. Save the texture using **RGBA8** texture format, without mipmaps.

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2Fb29VBIzeebAxzDO04LXs%2Frgba8-texture.png?alt=media&#x26;token=552e9443-842f-42b2-925a-4e4f3ca4cccd" alt=""><figcaption><p>Example of saving texture in GIMP</p></figcaption></figure>

4. Replace texture by the saved one from moments ago and save file.

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2F4d6CqqGiRsmDqJ3DsLIM%2Freplace-texture.gif?alt=media&#x26;token=32a69cd2-1993-4995-b206-bf9892ed3689" alt=""><figcaption><p>Process of replacing texture</p></figcaption></figure>

5. Close and open adder.ytd file.
6. Go to Details tab, find G9\_Flags column and change the value to 2490920, if CW didn't set it by default.

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FZErfIxvPn8EdDU78cUja%2Fg9_flags.png?alt=media&#x26;token=63c38cee-5637-46ab-bf91-7554534551ed" alt=""><figcaption></figcaption></figure>

***

**Q**: Game crashed even when I didn't enter the car.\
**A**: Check the material/geometries amount of the converted vehicle. GTAV Enhanced **has a limit of 128 materials/geometries** per file and exceeding that value leads to crashes.<br>

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FY3QyZjczPX1hfCGAno7U%2Fmany-geometries.png?alt=media&#x26;token=c7a5d7f0-9bb7-4f63-a0e6-a801fa7c40c0" alt=""><figcaption><p>vacca_hi vehicle with more than 128 materials</p></figcaption></figure>

A plausible workaround for that issue is to export \_hi.yft and .yft files to .XML, import them using Sollumz, export to .XML and import these files by CW RPF Explorer.\
\
1\. Select files in CW RPF Explorer, click right mouse button and select Export XML button.

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FaxXK9d82VyKrPN2Zu7xh%2Fexport-xml.gif?alt=media&#x26;token=2d6dcefc-3cd1-4e26-b135-e72fe03f96dc" alt=""><figcaption><p>Exporting files to XML format</p></figcaption></figure>

2. Import XML file in Blender using Sollumz

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FKEtStoHhNayrvkWciRuU%2Fimport-blender.gif?alt=media&#x26;token=8506f14e-ce31-4af2-b95e-5423343fe771" alt=""><figcaption><p>Importing process</p></figcaption></figure>

3. Select the root component from the Layers menu and Export CodeWalker XML

<figure><img src="https://4252508569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcRAM9lBHCqq3QodZ420I%2Fuploads%2FmT49a3p9GzfPscnm0aQC%2Fexport-blender.gif?alt=media&#x26;token=7846a036-0e6a-47b5-a601-4d995446c384" alt=""><figcaption><p>Exporting process</p></figcaption></figure>

4. In CW RPF Explorer, click right mouse button and select Import XML button and select both exported from Blender.

If this process didn't reduce material/geometries amount, then vehicle mod isn't well optimized for games and ask mod author about fixing it for GTAV Enhanced.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sollumz.org/tutorials/asset-conversion-for-gtav-enhanced.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
