How To Convert OBJ To YDR: Complete GTA V And FiveM Asset Pipeline

Converting an OBJ file into a native GTA V YDR drawable asset requires restructuring the raw 3D mesh within Blender using the Sollumz plugin to establish the mandatory Rage Engine hierarchy and shader parameters. Once structured and mapped with compatible embedded textures, the asset is exported as an XML file and compiled into its final binary YDR format using OpenIV. Following this precise pipeline prevents common modding issues such as invisible models, broken collision bounds, and severe server-side texture streaming lag.

Prerequisite Modding Tools and Asset Preparation Checklist

Before attempting to convert a standard Wavefront OBJ file into a Grand Theft Auto V drawable format (YDR), you must gather the specific software toolset and prepare your source files. The Rage Engine requires strict data structures, explicit material shaders, and highly optimized polygon counts that standard 3D formats do not natively support.

• Blender (Version 3.6 LTS or 4.0+): The primary open-source 3D modeling suite used to edit, clean, and map the incoming OBJ geometry.
• Sollumz Addon for Blender: An essential, community-maintained plugin that translates Blender data blocks into native GTA V game files, handles material presets, and structures the asset hierarchy.
• OpenIV Modding Tool: The definitive archiver and editor for GTA V PC files, used to import the intermediate XML files and compile them into binary YDR assets.
• Image Editing Software (Photoshop, GIMP, or Paint.NET): Necessary for preparing texture sheets and exporting them in the DirectDraw Surface (DDS) format with correct compression.
• Polygon Count Standards: Target a maximum of 20,000 polygons for standard props and up to 60,000 polygons for highly detailed static world objects to maintain performance.
• Unit Scale Calibration: Metric system with the default unit scale set to 1.0 (1 meter in Blender equals 1 meter in the Rage Engine).
• Budget and Timeline: The software pipeline is completely free and open-source. A standard conversion takes between 15 to 45 minutes depending on the complexity of the materials and collision bounds.

Step-by-Step Pipeline for Converting OBJ to YDR

Step 1: Clean and Optimize the Source OBJ Mesh

Raw OBJ models downloaded from online repositories or exported from CAD software are rarely optimized for real-time game engines. You must clean the geometry topology and align the transformations before applying any specialized game parameters.

1. Launch Blender and delete all default scene objects including the cube, camera, and light source.
2. Navigate to File, select Import, and click on Wavefront (.obj). Locate your target model and load it into the scene.
3. Select the imported mesh and inspect its scale in the transform properties panel (toggled via the N key). If the scale values are not set to 1.0 on all axes, press Ctrl+A and select Apply All Transforms. This resets the scale to unity and applies any rotation offsets.
4. Tab into Edit Mode, select all vertices by pressing A, and navigate to Mesh, select Clean Up, and click Merge by Distance. Set the merge distance to 0.0001 meters to eliminate duplicate vertices that cause render flickering.
5. In the Object Data Properties panel on the right (represented by a green triangle icon), expand the Geometry Data section and click Clear Custom Split Normals Data. This forces Blender to calculate clean shading gradients.
6. Right-click the model in Object Mode and select Shade Auto Smooth. Set the smoothing angle threshold between 30 and 45 degrees to preserve sharp mechanical edges while smoothing organic surfaces.

Warning: Never skip applying scale and rotation transforms. Failing to reset these values to zero and unity before export will cause your model to render at an incorrect size, float hundreds of meters away from its spawn point, or spin uncontrollably in game.

Step 2: Establish the Sollumz Drawable Hierarchy

GTA V does not read loose meshes. Every object must exist inside a specific container hierarchy consisting of a Drawable parent, a Drawable Model LOD (Level of Detail) group, and a Geometry object. Sollumz automates this structure, but it must be configured manually.

1. Ensure the Sollumz addon is installed and enabled via Blender Preferences. Open the Sollumz panel located in the N-panel tab on the right side of the 3D viewport.
2. Select your cleaned OBJ mesh in the viewport.
3. In the Sollumz tool panel, locate the Drawable Tool section and click the Create Drawable button. This creates a new parent container in your Outliner hierarchy, styled with a custom red icon.
4. Rename this top-level parent container to match your desired in-game asset name, using lowercase letters and underscores only (such as custom_street_lamp).
5. Drag your raw mesh object and drop it inside the newly created Drawable container.
6. In the Sollumz panel, select the mesh, find the Asset Creation menu, and click Convert to Geometry. This action creates a nested structure: Parent Drawable -> Drawable Model (High LOD) -> Geometry.
7. Ensure that the LOD distance properties for your high-detail geometry layer are set to 255.0 to ensure the object remains visible from a standard gameplay distance.

Step 3: Apply GTA V Shaders and Map Textures

The Rage Engine relies on a fixed suite of custom shaders. Standard Blender materials, cycles nodes, or Principled BSDF setups will fail during export. You must convert these materials to Sollumz-compatible game shaders.

1. With your geometry selected, navigate to the material properties tab. Remove any existing materials imported from the original OBJ file.
2. Open the Sollumz Material Tool in the N-panel. Under the shader preset list, choose a shader based on your asset type. For standard matte or glossy props, select gta_default. For assets requiring normal maps and specular reflections, select gta_normal_spec.
3. Click the Create Material button. This adds a clean, game-ready material template to your object's material slots.
4. Scroll down to the Shader Parameters list within the material tab. You will see designated texture slots labeled Diffuse Sampler, Bump Sampler (for normals), and Specular Sampler.
5. Click the open folder icon on the Diffuse Sampler slot and select your diffuse texture map. Ensure your textures are saved as PNG or DDS files, with dimensions that are powers of two (such as 1024x1024 or 2048x2048 pixels).
6. If using a normal map, load it into the Bump Sampler slot and set the color space to Non-Color.
7. Adjust the material parameters: set Specular Intensity to 1.0, Specular Color to white, and adjust the Wetness Reflection parameters to dictate how the asset behaves under in-game rain conditions.

Pro-Tip: For optimal performance and fast server streaming, save your texture files as DDS format using DXT1 compression for maps without alpha transparency, and DXT5 compression for maps with transparent alpha channels.

Step 4: Configure Collision Bounds (Static Collisions)

For players and vehicles to interact physically with your new model rather than passing straight through it, you must generate a collision mesh (bound) and link it directly to your YDR structure.

1. Select your main Geometry mesh in the viewport.
2. In the Sollumz panel, navigate to the Bound Tool section.
3. Select Box, Cylinder, Sphere, or Capsule for simple primitive collision boundaries. For complex, custom shapes, select Poly Mesh.
4. Click the Create Bound Composite button. Sollumz will generate a collision hierarchy with a green parent container named after your asset with the suffix col.
5. If using Poly Mesh, select your original geometry, click Create Bound Geometry, and place this new collision mesh inside the Bound Composite container.
6. Go to the Bound Material properties in the Sollumz panel. Assign a physical material preset to the collision faces, such as plastic, concrete, metal, or wood. This determines the sound effects, bullet impact sparks, and particle debris generated when the object is struck in-game.
7. Parent the Bound Composite container directly to your main YDR Drawable container in the Outliner to bind them together as a single exportable package.

Step 5: Export to XML and Compile in OpenIV

Once your geometry, materials, shaders, and collision bounds are properly structured in the Blender scene, you are ready to export the asset into an intermediate XML format before compiling it into the final binary YDR.

1. Select your top-level parent Drawable container (the red folder icon) in the Blender Outliner.
2. Go to File, select Export, and choose Sollumz XML (.ydr.xml).
3. Select your destination directory and confirm the export. Sollumz will generate a highly structured XML text file containing all mesh indices, UV coordinates, shader attributes, and collision boundary data.
4. Open the OpenIV application and ensure you have selected the Grand Theft Auto V Windows directory.
5. Navigate to your custom server resource folder or a mods folder within your OpenIV game path (such as mods/update/x64/dlcpacks/).
6. Click the Edit Mode button in the top menu bar of OpenIV to enable write access.
7. Drag and drop your exported .ydr.xml file directly into the OpenIV folder view window.
8. OpenIV will read the XML schema, process the geometric arrays, compile the raw textures, and automatically convert the XML file into a solid, compressed binary file ending in .ydr.
9. Double-click the newly compiled .ydr file inside OpenIV to launch the built-in Model Viewer. Verify that the textures display correctly, the shaders react to lighting adjustments, and the collision bounds align perfectly with the visual mesh.

GTA V Asset Optimization and Shader Parameters

Common Conversion Errors and Technical Fixes

The model renders completely black or dark grey in-game

• Root Cause: The mesh lacks vertex colors, has incorrect vertex normals, or is using an incompatible shader type that requires vertex color data that was not generated during the OBJ import process.
• Actionable Fix: Tab into Edit Mode in Blender, select all faces, and recalculate normals by pressing Shift+N. In the Sollumz panel, select your geometry and apply the Paint Vertex Colors utility under the Sollumz styling tools, which applies a neutral white base tint to all vertices.

The model is invisible, but has working collision physics

• Root Cause: The texture dictionary is missing, textures have incorrect names, or the shader parameters contain broken file paths, leading to a rendering failure.
• Actionable Fix: Open the compiled YDR file in OpenIV. Under the Texture Dictionary tab, verify that your diffuse texture is present and named identically to the texture referenced in the shader parameters. If the texture is missing, manually import the texture as a PNG or DDS and save the file.

OpenIV fails to import the XML file and throws a schema error

• Root Cause: The Blender scene hierarchy is broken, or a mesh object has been left loose without a proper Sollumz parent drawable or geometry container.
• Actionable Fix: Inspect your Blender Outliner. Ensure every single geometry mesh is parented to a Sollumz high-LOD group, and that all groups are nested under a single red Drawable parent. Delete any loose cameras, lighting nodes, or non-Sollumz helper empties before exporting.

The asset spawns with massive texture stretching and tearing

• Root Cause: The UV map coordinates were lost or corrupted during the OBJ import step, or the UV map has been assigned to Map Channel 2 instead of Channel 1.
• Actionable Fix: Select your object, navigate to the Data Properties tab, and expand the UV Maps drop-down. Ensure there is only one UV Map present, named UVMap, and that it contains valid un-overlapped UV coordinates coordinates.

Frequently Asked Questions

What is a YDR file and why is it used in FiveM?

A YDR file is the native Rage Engine format used to store drawable objects, which includes props, static world buildings, and custom decorative models. FiveM uses these files directly to stream customized assets to clients in real-time, ensuring that physical collisions, visual structures, and light reflections behave identically to native base-game assets.

Do I need 3ds Max to convert OBJ files to YDR?

While Autodesk 3ds Max was historically the industry standard for GTA modding using GIMS Evo, it is no longer required. The open-source Blender suite coupled with the Sollumz addon offers a modern, fully featured pipeline that handles complex vertex structures, shader assignments, and automated XML exports without licensing fees.

How do I add physical collisions to my custom YDR prop?

Collisions are created by wrapping your mesh in a Sollumz Bound Composite container and generating simplified bound geometries. For simple props, a box or cylinder primitive bound is ideal, while complex shapes require a simplified duplicate of your original mesh converted into a Sollumz Poly Mesh bound.

Why are my textures blurry on the converted model?

Blurry textures are caused by missing mipmaps or incorrect texture scaling. Ensure your textures are saved using power-of-two dimensions and compressed as DDS files with mipmapping enabled in your image editor. This allows the game engine to render lower-resolution versions of the texture when the asset is far away, saving system resources.

Can I convert animated OBJ files to YDR?

No, animated meshes require bone structures, weights, and vertex groups, which are compiled as YDD (Drawables Dictionary) and YFT (Fragment) files for vehicles or characters. Standard YDR files are strictly reserved for static props or simple dynamic objects that rely on simple transform changes.

Optimize Your FiveM Servers with Custom Assets

Take your custom multiplayer servers to the next level by building lightweight, performant world assets. Master these pipeline workflows to ensure your custom content runs flawlessly on any client machine.