Skip to main content
Participant
October 9, 2025
Question

Importing Substance files using Blender Python bpy

  • October 9, 2025
  • 2 replies
  • 132 views

I'm trying to load a Substance .sbsar file into Blender 4.2.1 LTS using the 'Adoby Substance 3D add-on for Blender' 2.3.0 using the Python bpy library.

 

file_path = "/Users/xxx/sbsar/lemon_skin.sbsar"

bpy.ops.mesh.primitive_uv_sphere_add(segments=128, ring_count=64)
ob = bpy.data.objects["Sphere"]
ob.select_set(True)
bpy.context.view_layer.objects.active = ob

file_abs = str(Path(file_path).absolute())
file_name = str(Path(file_path).name)
file_parent = str(Path(file_path).parent.absolute()) + "/"
bpy.ops.substance.load_sbsar(filepath=file_abs, files=[{"name":file_name},{"name":file_name}], directory=file_parent)

 

however I get the error:

Substance 3D in Blender: Substance file [lemon_skin.sbsar] located at [/Users/xxx/sbsar/lemon_skin.sbsar] could not be loaded

 

Strangley if I open the 'Substance 3D' panel, click the 'Load' button, then 'Cancel' the file dialog (without selecting anything) the load_sbsar command works!

 

Please can you help.

Kind regards,

Paul 

2 replies

JohnMeta
Participant
February 2, 2026

Can any one pls share the substance integration tool 2.3.0 windows pls

Ymmanuel_F
Participating Frequently
October 13, 2025

Hi, I'm the blender addon developer

That was not the intended use, that is why it doens't work like that, there are some extra configs that are needed

but in the next update i standarized and fixed the load sbsar, so the blender operation should work as you are expecting, this new update is currently in testing and will be released soon

 

If you find issues after the next update please let me know

 

Cheers

Ymmanuel

paul_004Author
Participant
October 14, 2025

Hi Ymmanuel,

 

Thank you for letting me know; I look forward to the next update.  If you would like an early tester let me know; I would be happy to help out.

 

Kind regards,

Paul

paul_004Author
Participant
January 28, 2026

Hi Ymmanuel,

Thank you for release 3.0.0.  Just to confirm that it has resolved my issue loading the texture with bpy.  Now using the new methods:

bpy.ops.substance.ui_sbsar_load(filepath=file_abs, files=[{"name": file_name}, {"name": file_name}], directory=file_parent)
bpy.ops.substance.ui_sbsar_apply()

Kind regargs,

Paul