FAQ - Sollumz/Sollumz GitHub Wiki

Note: The new wiki is at https://docs.sollumz.org/.


Frequently Asked Questions

What is Sollumz capable of?

  • Currently Sollumz is capable of creating and editing models (.YDRs and .YDDs), Including but not limited to, buildings, clothing, peds, props, Etc.
  • Creating and editing archetypes (.YTYP and .YMAP) Including but not limited to MLOs, map placements, item definitions, etc.
  • Supports animations (.YCD) Limited to object animations, ped animations and UV animations.
  • Creating and editing collisions (.YBN and .YDR) static collisions and embedded collisions, etc.

What does Sollumz currently not support?

How do I install Sollumz?

  • Go to https://github.com/Skylumz/Sollumz and press "Code" then download the zip file. Next open Blender then Edit > Preferences > Add-Ons > Install then choose the downloaded zip file from earlier and restart Blender.

How do I import files to Blender with Sollumz?

  • You will need CodeWalker to get the required files to import, make sure you have the LATEST version, find the model you want to export in CodeWalker's RPF explorer and right click -> export as XML. CodeWalker Download

When I import a YDR/YFT/YDD the textures are not loaded

  • Remember to export all the textures used by the model from either the model viewer from CodeWalker RPF Explorer (You MUST open it) or inside CodeWalker Map Viewer, you can find a button called Save all Textures in Material tab, create a new folder with a different name than the model and select it.
  • Then in Blender press V, click Find Missing Files and select the folder where you have all the textures.

My MLO shows up in CodeWalker but not in game?

  • Make sure you have applied the default flags to your bound Bound GeometryBVH of your MLO shell collision. Also make sure you generate a manifest 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, keep your Sollumz up to date.

I'm getting the error AttributeError: 'NoneType' object has no attribute 'sollum_type'

  • All your object's materials must be Sollumz materials to export.

I'm getting the error No objects of type: drawable dictionary or drawable or bound composite to export.

  • Check if your object hierarchy is correct, you can try to fix it going to Sollumz > General Tools > Debug > Fix hierarchy
  • Don't forget to select a proper type for your asset.

I'm getting the error Exception: objectname cannot be converted because it has no mesh data

  • Your object have no geometry to work with, please select an object with geometry.

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 ModuleNotFoundError: No module named 'Sollumz-main.ytyp.operators.Entity'; 'Sollumz-main.ytyp.operators' is not a package

  • Uninstall Sollumz then restart Blender to be able to install a newer version.

I'm getting the error Exception: No materials on object: modelname_geom, will be skipped

  • Your mesh has no geometry, add at least one material to your object to be able to export it.

I'm getting the error KeyError: 'bpy_prop_collection[key]: key "Principled BSDF" not found'

  • Only Principled BSDF shader is supported during material conversion operations, anything else must be converted or recreated using Principled BSDF as base.

I'm getting the error RuntimeError: Error: Tangent space computation needs an UVMap, "(null)" not found, aborting

  • One of your meshes are empty (Drawable Models must have at least one mesh as children).
  • One of your meshes has no UVMaps whatsoever.
  • You can check if your model has a UVMap going to Object Data Properties > UV Maps and make sure you have at least one UVMap.

I created a collision (external or embedded) but it isn't working.

  • Remember to set General (default) flags set to your Bound GeometryBVH object.

I can't add entities to my MLO, I got the following warning: There're no rooms to attach entities to

  • You didn't create any Room for your MLO Archetype
  • PD: Setting Room IDs in your collision materials WON'T magically create any room for you, this must be done manually using the YTYP tools.

I can't find the Center Composite button.

  • This button was removed, you can skip using it.