> For the complete documentation index, see [llms.txt](https://docs.sollumz.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sollumz.org/support/faq.md).
# FAQ
### When I import a YDR/YFT/YDD the textures are not loaded
* From the CodeWalker RPF Explorer, open the asset with the textures.
* Click the save icon in the top right, then click "Save All Textures"
* In Blender, press the `V` key, then click `Find Missing Files` and select the folder where you saved the textures.
* **Alternatively**, export all textures into a folder with the same name as the file you are importing. For instance, if you wanted to import `adder.yft` with all of its textures, you would export all textures to a folder called `adder` in the same directory. Then, when you import into Sollumz, all textures will be automatically loaded from the `adder` folder.
***
### My MLO shows up in CodeWalker but not in game.
* Make sure you generate a "\_manifest.ymf" file from the CodeWalker project window with your MLO, YMAP, and YTYP in it.
***
### I'm getting an error when importing a file.
* 9 out of 10 times it is due to having an outdated Sollumz version. Try updating.
***
### I'm getting the message `No Sollumz objects in the scene to export!` or `No Sollumz objects selected for export!`
* Check if the "Limit to Selected" export option is ticked. If so, only the selected objects will export.
* Make sure all of your objects have their `Sollumz Type` set, otherwise, they will not be recognized by the add-on.
***
### I'm getting the error `model name has no Sollumz materials! Aborting...`
* You did not add a Sollumz shader and/or a texture to your .model of the object.
* Add a shader and a texture to your object *(see below for information on textures).*
* Alternatively, your mesh object might not have its `Sollumz Type` set to `Drawable Model`.
***
### I'm getting the error `TypeError: create_uvsphere: keyword "diameter" is invalid for this operator.`
* Update your Sollumz.
***
### I'm getting the error `KeyError: 'bpy_prop_collection[key]: key "Image Texture" not found'`
* One of your materials has a missing node connection between Color node and an Image Texture, which is 100% needed in order to export the model.
* Check shading tab to find more.
***
### I'm getting the error `KeyError: 'bpy_prop_collection[key]: key "Principled BSDF" not found'`
* Only the Principled BSDF shader is supported during material conversion operations, anything else must be converted or recreated using Principled BSDF as base.
***
### I created a collision (external or embedded) but it isn't working.
* Remember to apply `General (default)` flags to your `Bound GeometryBVH` object from the `Blender Side Bar > Object > Flag Presets` menu.
* If you have created a separate collision model (ybn) from your drawable model, you need to apply the world coordinates to the poly\_mesh.
***
### I'm having issues importing the file into OpenIV
* Since this plugin was designed around CodeWalker's XML file formats, OpenIV is not explicitly supported. You may experience issues going from Sollumz > CodeWalker > OpenIV. It's highly recommended that you just use CodeWalker.
***
### Why the vertices amount is doubled or tripled after exporting my model?
* Vertices in Blender and in game meshes have different meaning. For Blender, it is basically just a position. For the game, it is position + attributes (normals, colors, UVs, etc). Closer to what Blender calls "Face Corners".
Don't think Blender shows the number of face corners anywhere without python, but after triangulization, it is basically number of faces\*3.
On export, Sollumz removes duplicate face corners when it can, when position and all its attributes are the same. So the final vertex count in the game mesh is somewhere between number of vertices and number of face corners.
Anyways, number of faces is more representative of the model quality/performance, so just use that, not vertices.
***
### My model is invisible after importing to CodeWalker
* Check the UV Maps and Color Attribute names, they have to follow the Sollumz naming convention. Sollumz is warning a user when names don't match.
UV Maps and Color Attribute should be changed to the following
***
## I try to import a XML but nothing happens!
Make sure the "Import To Asset Library" checkbox is unchecked and try to import again.
***
#### I have embedded or linked a ytd to my model but it doesnt show.
Sollumz required textures to be added to shaders. (see Creating Static Meshes)
The texture must be a .dds file. (png, bmp etc will not work.)
The dds must be 'power of 2' ie 512x512, 128x64 etc. You can use any graphics software to edit the size as long as it saves in dds format with mipmaps and as a dtx1 for models.
Maximum recommended size for textures is 2048 to ensure your model is optimised. Download textures from the game for examples and use on your models.
For Clothing textures, see
{% embed url="" %}
***
## Why can't I see CodeWalker XML to import or export files?
Sollumz can now import and export native files as well as XML files. These are referred to as RAGE (Rockstar Advanced Game Engine) assets. This allows you to directly import files without exporting as XML.
For example: db\_apart\_06.ydr or db\_apart\_06.ydr.xml\
\
There is the option in the export window to choose native or CW XML for Legacy (Gen8) or Enhanced (Gen9). Note, some files will still be required to be imported as XML.
***
## Why do my props glow in game at night?
VERTEX PAINTING is required for game assets self-illumination and lighting to show properly by reacting to ambient and moon light.
A prop will glow a pinkish red colour at nightime, or be dark or black in an mlo if it has not had vertex paint applied.
Vertex painting is only one component of modelling. Proper modelling to display assets depends on things like textures, timecyles and vertex paint among other parameters.
The very basic rule for Vertex Painting is GREEN for inside MLOs, and RED for outdoors.
Basic Guide to Paint
Vertex paint is not usually one colour. A mix of colours and gradient provides the best result for lighting in game. Below are some examples of the Ammunation building, both interior and exterior shells.
See the following tutorial for more information
{% embed url="" %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.sollumz.org/support/faq.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
