βFAQ
Frequently Asked Questions
Frequently Asked Questions
Sollumz can only import XML files exported from CodeWalker. Make sure you install the latest version of CodeWalker as described here.
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.
Make sure you generate a "_manifest.ymf" file from the CodeWalker project window with your MLO, YMAP, and YTYP in it.
9 out of 10 times it is due to having an outdated Sollumz version. Try updating.
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 sollum type set, otherwise, they will not be recognized by the add-on.
As a last resort, you can select the parent object and use Sollumz Tools > General > Debug > Fix Hierarchy
TypeError: create_uvsphere: keyword "diameter" is invalid for this operator.
Update your Sollumz.
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.
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.
Remember to apply General (default)
flags to your Bound GeometryBVH
object from the Sollumz Tools > Collision Tools > Flag Presets
menu.
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.
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.
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.