Table of Contents
Substance in Blender Overview
Plugin Overview
The Substance 3D add-on allows you to import Substance materials into Blender. Using the Substance 3D Panel, you can manage and the customize the Substance materials in your project from one location. The add-on generates texture maps from .sbsar files and uses them to create a blender material. These textures are updated automatically when Substance parameters are adjusted.
서브스턴스 3D 애드온을 사용하면 서브스턴스 머티리얼을 블렌더로 가져올 수 있다. 서브스턴스 3D 패널을 사용하면 프로젝트의 서브스턴스 머티리얼을 한 곳에서 관리하고 커스터마이즈할 수 있다. 애드온은 .sbsar 파일에서 텍스처 맵을 생성하고 이를 사용하여 블렌더 머티리얼을 생성하며 이러한 텍스처는 서브스턴스 파라미터를 조정할 때 자동으로 업데이트된다.
Importing a Substance Material
1.
Click on the Load button in the Substance 3D Panel.
서브스턴스 3D 패널에서 Load 버튼을 클릭.
2.
In the window that opens, navigate to the location where your .sbsar files are stored and select one or more. Then click the Load Substance Material button.
창이 열리면 .sbsar 파일이 저장된 위치로 이동하여 하나 이상의 파일을 선택 후 Load Substance Material 버튼을 클릭.
3.
Click on the sphere icon in the material panel to open the drop down and select your Substance material. This will assign the material to the current slot. Alternatively, use the Apply button in the Substance 3D Panel to assign the material in a new material slot that wont override the current assignment.
머티리얼 패널에서 구 아이콘을 클릭하여 드롭다운을 열고 서브스턴스 머티리얼을 선택. 그러면 현재 슬롯에 머티리얼이 할당된다. 또는 머티리얼 3D 패널의 적용 버튼을 사용하여 현재 할당을 덮어쓰지 않는 새 머티리얼 슬롯에 머티리얼을 할당할 수 있다.
Note: If the object has no materials, the Apply button will automatically attach the Substance material.
오브젝트에 머티리얼이 없는 경우 적용 버튼을 클릭하면 자동으로 서브스턴스 머티리얼이 첨부됨.
The Substance 3D Panel
The Substance 3D Panel is used to manage the Substance materials in a project, and adjust their individual parameters. The Graph Parameters section has controls for texture resolution, tiling, randomization, and presets. The outputs section has controls for the image formats of generated textures. The Substance Parameter section is where is where Substance parameters can be adjusted.
서브스턴스 3D 패널은 프로젝트의 서브스턴스 머티리얼을 관리하고 개별 파라미터를 조정하는 데 사용된다. 그래프 파라미터 섹션에는 텍스처 해상도, 타일링, 무작위화 및 사전 설정에 대한 컨트롤이 있고, 출력 섹션에는 생성된 텍스처의 이미지 형식에 대한 컨트롤이 있다. 서브스턴스 파라미터 섹션에서는 서브스턴스 파라미터를 조정할 수 있다.
Preferences
Default behaviors and other settings can be adjusted in the add-on preferences. "Automatically attach the material" can be enabled to automatically attach Substance materials to objects and override the current material assignment. "Automatically highlight the material for selected objects" will change the highlighted material in the Substance 3D Panel if an object with that material is selected. Enabling "Cycles Auto-update textures" will allow textures to be updated in the 3D Viewport while using Cycles render view.
Displacement can be enabled with the toggle for Height in the Outputs section. Here you can also adjust the file format and bit depth of each output.
기본 동작 및 기타 설정은 애드온 환경설정에서 조정할 수 있다. "Automatically attach the material"를 활성화하여 오브젝트에 서브스턴스 재질을 자동으로 첨부하고 현재 재질 할당을 재정의할 수 있다. "Automatically highlight the material for selected objects"는 해당 재질이 있는 오브젝트를 선택하면 서브스턴스 3D 패널에서 강조 표시된 재질을 변경. "Cycles Auto-update textures"를 활성화하면 사이클 렌더링 뷰를 사용하는 동안 3D 뷰포트에서 텍스처를 업데이트할 수 있다.
변위는 출력 섹션의 높이 토글로 활성화할 수 있다. 여기에서 각 출력의 파일 형식과 비트 심도를 조정할 수도 있다.
Find More Substance Materials
Thousands of professionally created materials and other assets are available for download on the Substance 3D Assets page. Many more assets that have been shared by the Community for free can be found on the Substance 3D Community Assets page
전문가가 제작한 수천 개의 머티리얼과 기타 에셋은 서브스턴스 3D 에셋 페이지에서 다운로드할 수 있다. 커뮤니티에서 무료로 공유한 더 많은 에셋은 서브스턴스 3D 커뮤니티 에셋 페이지에서 확인할 수 있다.
Community
For general help, feedback, or to report defects, please join the #substance-blender-beta channel on the Substance Discord server or Adobe communities.
일반적인 도움말, 피드백 또는 결함을 보고하려면 Substance Discord 서버 또는 Adobe 커뮤니티의 #substance-blender-beta 채널에 참여하십시오.
Downloading and Installing the Plugin
Download
The addon can be downloaded from the Substance 3D in Blender. Click Adobe Substance 3D add-on for Blender to signing in with an Adobe account and access the download page. Navigate to the bottom of the page to download the .zip files for the Substance 3D add-on and Substance 3D Integration Tools.
There are two separate .zip files to download and install:
•
Substance 3D add-on for Blender (single download for all platforms)
•
Substance 3D Integration Tools (download Windows, Mac, or Linux version)
Alert:
For Mac users: Users should disable "open safe files after downloading" if they are downloading the add-on with Safari.
Safari web browser defaults to unzipping downloaded .zip files, which need to remain zipped when for installation. To prevent the file from unzipping, update Safari preferences to not open "safe" files after downloading.
1.
Open Safari
2.
Click Preferences
3.
Under the General tab, uncheck the option Open “safe” files after downloading
Install Steps
FIRST TIME INSTALLATION
1. Download the add-on .zip files from the Adobe prerelease page.
2. Open Blender (v. 3.0 or higher).
3. From the top navigation bar, select Edit and then Preferences. Then select the Add-ons tab.
4. Click the Install button.
5. In the file explorer, locate the folder to where the .zip files were downloaded to
6. Select the Substance3DInBlender.zip file and click the Install Add-on button.
7. In the Add-ons section, click the checkbox to enable the add-on and click the drop-down arrow the expand the section.
8. You will be prompted to install the Integration Tools. Click Install from disk to select the Substance3DIntegrationTools.zip and click the Install tools button. If they were not previously downloaded, click Download to open the Adobe prerelease page in your browser and download the tools, then use Install from disk to install them.
9. The addon is now ready to use!
UPDATING ADD-ON AND TOOLS
1. Download the newest release from the Adobe prerelease page.
2. Use the Uninstall Tools button to remove the Substance3D Integration Tools.
3. Use the Remove button to uninstall the add-on
4. Close and restart Blender
5. From the top navigation bar, select Edit and then Preferences. Then select the Add-ons tab.
6. Click the Install button.
7. In the file explorer, locate the folder to where the .zip files were downloaded to
8. Select the Substance3DInBlender.zip file and click the Install Add-on button.
9. In the Add-ons section, click the checkbox to enable the add-on and click the drop-down arrow the expand the section.
10. You will be prompted to install the Integration Tools. Click Install from disk to select the Substance3DIntegrationTools.zip and click the Install tools button. If they were not previously downloaded, click Download to open the Adobe prerelease page in your browser and download the tools, then use Install from disk to install them.
11. The addon is now ready to use!
UPDATING INDIVIDUAL COMPONENTS
When updating the Add-on only:
1.
From the add-on preferences, use the Remove button to uninstall the add-on.
2.
Restart Blender
3.
Navigate to the add-on preferences again and use the Install button to load the new version of the add-on. The previously loaded Integration Tools will remain.
When updating the Integration Tools only:
1.
From the add-on preferences, use the Update Tools button to load the newer version of the Integration Tools. The previously used Add-on will remain.
2.
Restart Blender for changes to take effect.
OR
1.
From the add-on preferences use the Uninstall Tools button to remove the Integration Tools.
2.
Restart Blender
3.
Use the Install from disk button to find and load the newer version of the Integration Tools. The previously used Add-on will remain.
Preferences
The add-on preferences can be found within Blender's preferences window. Navigate to Edit > Preferences > Add-ons, and search for Node: Adobe Substance 3D add-on for Blender.
Report a Bug - Opens the Substance 3D for Blender prerelease page, which has links to the Substance Discord and Adobe Community Forums.
Remove - Deletes the add-on from the system and removes it from the add-on list in Blender.
Uninstall Tools - Removes the installed version of the Substance 3D Integration Tools.
Update Tools - Opens file browser to select the tools zip file and update the tools.
Documentation - Opens the Ecosystem and Plugins documentation page in the browser.
Forums - Opens the Adobe Community Forums in the browser.
Discord Server - Opens the Ecosystem and Plugins Discord server in the browser.
Tiling - Adjust the X, Y, and Z tiling of the material. The lock can be used to unlink the values and adjust them individually.
Resolution - The default resolution for generated textures. The lock can be used to unlinked to set their resolutions independently.
Normal Format - The default format used for normal maps can be changed between DirectX and OpenGL. Read our page here for more information.
Export Image Format - When images generated within Blender are used as image inputs for a Substance material, this format is used to save that image to the temporal folder.
Automatically attach the material - When a Substance material is created, automatically attach the material to the selected object(s) in a new material slot.
Automatically highlight the material for selected objects - Change the highlighted material in the Substance 3D Panel if an object with that material is selected.
Cycles Auto-update textures - Forces texture to updating in the 3D Viewport while using Cycles render view.
SBSAR Library Path - The folder that is opened by default when the Load button to search for a substance file.
Temporal Folder (rename?) - This folder will be the default location where textures are stored before a file is saved for the first time.
Relative Data Path - The location of generated substance assets relative to the .blend file. Unsaved .blend files will always save these assets to the temporary location.
Copy .sbsar files on save to - When enabled, .sbsar files are copied to the specified relative path when the file is saved. This can facilitate sharing projects between devices.
On save, copy textures to - When a file is saved for the first time, textures in the temporary folder will be copied to this location. The $matname variable is used to create subfolders for each material.
Shader Preset - Sets the default shader preset that is used when creating Blender materials from substances files. Can be set to standard for UV based mapping or projection for box, sphere, and cylinder projection-based mapping.
Displacement Midlevel - The default value is the base for displacement in the Displacement Node. Values Higher than the default will push surfaces outwards and values lower than the default will pull surfaces inwards.
Displacement Scale- The default scale value in the Displacement node.
Emissive Intensity - The default value for Emission Strength in the Principled BSDF node.
AO Mix - When Ambient Occlusion is enabled as an output, this value determines the default factor value of the MixRGB node that is used to combine the Base Color and Ambient Occlusion textures.
Outputs - The individual outputs of materials can be enabled or disabled. The default color space, file format, and color depth of individual outputs can be adjusted as well.
Shortcuts - Customize the shortcut keys used to bring up a floating menu, load a Substance material, and apply the current material. Shortcut updates require a restart to take effect.
The Substance 3D Panel
Panel Controls
Create - Opens the file browser to Select a Substance 3D material. By default, this creates a blender material using textures generated from the .sbsar file.
Apply - Attach the selected Substance 3D material to the selected objects in a new material slot. This does not override previous material assignments on the object.
Substance 3D Community Assets - Opens the Substance 3D Community Assets page in the web browser.
Substance 3D Assets - Opens the Substance 3D Assets source page in the web browser.
Duplicate Selected Substance 3D Material - Load a new instance of the selected Substance 3D material. The parameters of different instances of the same Substance material can be adjusted independently of one another.
Refresh - Reloads the Substance 3D material
WARNING:
Using the refresh button will undo any user changes to the shader graph. Copy any user-added nodes before refreshing to paste them into the graph after the refresh.
Remove - Removes the selected Substance 3D material from the panel.
Note:
The Blender material crated from the Substance material will remain in the project. It can deleted or removed from objects manually.
Loaded 3D Substance Materials - Displays a list of the Substance Materials that have been loaded into the .blend file.
Graph Parameters
Output resolution - Dropdowns for the with and height resolution. These can be unlinked to adjusted the values independently.
Randomize and Random Seed - The randomize button generates a new random seed value to change parameters that can use random values. The random seed can also be set manually.
Working with Presets
SBSAR files may be published with presets, which can be found in the Preset dropdown box. To make your own presets, adjust the parameters as desired and use the Save button. There are additional options to export the selected preset as a .sbsprs file, and for deleting the selected preset from the dropdown list. The Load button can be used to import presets from .sbsprs files.
Substance Parameters
Parameters that have been exposed in Substance Designer can be adjusted using the Substance Parameter controls. These parameters are set by the creator of the Substances Material and will vary between materials. Adjusting these parameters will update the generated textures, as indicated by the processing icon next to the material name in the Loaded 3D Substance Materials section.
The file format of output textures can be toggled and changed via the dropdowns.
Technical Parameters
Substance Materials may have set of technical parameters. These are additional controls for color correction and other material adjustments.
Shortcuts and Navigation
A list of shortcuts can be found in at the bottom of the Addon Preferences. The Key-bindings for each shortcut can be customized by entering the desired keys in the Key field. Ctrl, Shift, and Alt can also be enabled for each shortcut.
The default key-bindings are:
•
Floating Menu - CTRL + SHIFT + U
•
Load SBSAR - CTRL + SHIFT + L
•
Apply Current Material - CTRL + SHIFT + U
Workflows
Working with Cycles
By default, parameter changes do not automatically update in the 3D viewport when viewed in Cycles render view. To see updates in Cycles render view, enable Cycles Auto-update textures in Preferences to force updating.
Multigraph .sbsar Files
The add-on supports .sbrar files with multiple substance graphs. When loading a file with multiple graphs, a new Graphs dropdown will appear on the Substance 3D Panel. Unlike with other parameter changes, switching graphs will not automatically update the material. Because of this, the Apply button must be used to assign the material again after changing graphs.
Note:
By default, the Apply button adds the material in a new slot without overriding previous material assignments. Remove previous materials, or use the material dropdown to reassign newly applied materials.
Working with Image Inputs
When using a Substance material that allows custom image inputs, an image selection parameter Substance 3D Panel will allow you to open the file browser for an image (folder icon) or select from an image that exists in your project (image icon drop down).
The Export Image Format preference can be used to to save image inputs generated within Blender to the temporary folder. See the Preferences page for more details.
Shader Network Presets.
The shader preset can be quickly adjusted via the dropdown in the Outputs section of the Substance 3D Panel. These shader presets adjust the way that image textures are applied.Cycles/Eevee Standard uses regular UV texture coordinate mapping. The other three Cycles/Eevee Projection presets use generated texture coordinate mapping for box, sphere, or cylinder projection methods.
Filtering and Adjusting Outputs
The Outputs section of the Substance 3D Panel also has options for filtering outputs. Three buttons next to the shader preset dropdown can be used to filter by enabled outputs (checkmark), shader outputs (sphere), and all available outputs (lines).
Outputs can enabled individually using the checkbox. When an output is enabled, a corresponding output in the texture node group will be created. If that output is supported by the Principled BSDF material node, it will be automatically connected to it. Height will connect to a displacement node and Ambient Occlusion will combine with the base color in a MixRGB node.
The file format dropdown next to the checkmark can be used to set the file type that the output texture is saved as.
Swapping Materials on Objects
Click on the sphere icon in Blender's material properties panel to open a list of materials in your Blende project. Substance materials that have been created in the panel will also appear in the list. Selecting a material from this list will replaces the active material in that material slot.
Displacement
Displacement of the mesh from textures in supported in the Cycles renderer, but not in Eevee. To see displacement, make sure that the Height output is enabled. The add-on will automatically set the material's displacement setting to Displacement and Bump. Viewing the material on an object will now show displacement in the render view. The displacement scale can be adjusted in the material panel or on the displacement node.
For best results, use higher subdivision levels or high-poly meshes for materials with complex displacement details.
Physical size in Blender
Physical Size in Substance materials allows materials to be scaled based on their size in the world. The dimensions are set in Substance applications like Designer and shown in the plugin panel's Physical Size section.
With Physical Size enabled, the materials will tile based on their real-world size in centimeters. The material tiling will remain the same regardless of the objects' scale. The feature can be enabled by switching to the Physical Size shader in the add-on panel. After adjusting the scale of an object, the scale should be applied with ctrl/cmd+A to accurately tile the Physical Size Texture.
Adjusting Physical Size
The values in the mapping node can be adjusted for artistic control over Physical Size tiling. Additionally, an object such as an Empty be used for the Texture Coordinate input to control the texture mapping using the input object's transformations (see example below).
Substance 3D Assets Library
Thousands of professionally created materials and other assets are available for download on the Substance 3D Assets page. Many more assets that have been shared by the Community for free can be found on the Substance 3D Community Assets page.
From the Substance 3D Panel within Blender, you can also click on the Substance 3D Assets and Substance 3D Community Assets buttons to open the web browser to those pages.
Troubleshooting
The system console can be used to diagnose errors encountered while using the add-on. Blender's system console window is opened differently depending on your operating system. For detailed instructions, follow the steps on Blender's system console documentation page. The console output can be helpful when encountering unexpected issues, such as textures not loading or materials stuck in processing.
To report a bug, please join the #substance-blender-beta channel on the Substance Discord server or visit Adobe communities. Relevant information from the console log and any reproductions steps for the issue can be included in reports.
Common Issues and Solutions
•
Not all settings appear in the Substance 3D Panel after updating the add-on and loading a material.
◦
This may happen when removing an older version of the add-on and installing a newer version in the same session, since older files may still be cached in the system.Restarting Blender should allow the changes to take effect.
•
Issues when installing the add-on./ Materials are stuck processing in between sessions. / Materials do not generate textures in between sessions. / Errors when loading .sbsar files.
◦
This may be an issue with the Integration tools installation and is usually fixed by manually removing the tools manually. Visit the Uninstalling the Add-on page for manual removal instructions.
•
Materials do not update in Cycles render view.
◦
By default, the add-on does not update textures in Cycles render view. However, they can be force-updated by enabling Cycles Auto-update textures in the add-on preferences.
•
Parameters appear to revert after saving while in Cycles render view.
◦
This is a known caching issue on the Blender side that is visual only. When saving, no message is being sent to the remote engine to update the generated texture files. The textures will appear normal after leaving Cycles render view and switching back to it.
•
Materials are no longer updating after undoing/changing parameters.
◦
Materials may fail to update after undoing actions. While the parameters will revert to the previous state, the textures will not undo to match. To make the texture update again, use the refresh button to return the parameters to default and reload the textures.
•
Colors set in Substance Designer appear slightly differently in Blender's color picker, and the color values are not the same.
◦
Blender applies a gamma correction to colors for Blender's color picker only. While this causes a discrepancy in the color picker, the colors that appear in textures are accurate to the values set in Substance apps.
•
"wmic is not recognized" console error when loading a material in Windows.
◦
This issue occurs when C:\Windows\System32\wbem\ is not included in PATH system variables. Please refer to documentation for your specific version of Windows.
•
"Bad CPU type is executable" error on Mac.
◦
This issue occurs when Rosetta is not enabled on ARM Mac machines. See Apple's Rosetta page for more information. Additionally, see this installation guide for further instructions.
•
Modifications to the shader graph are undone when using the Refresh button or updating parameters.
◦
The add-on refreshed connections in the graph after changes or refreshes. To work around this, duplicate the blender material created from the .sbsar and give it a new name of your choice. Add your nodes only to the duplicate. The textures will update in the node group while keeping user-added nodes. When refreshing, copy these nodes and paste them back into a new graph after the refresh.
Uninstalling the Add-on
To uninstall the add-on, navigate to Edit > Preferences > Add-ons and expand the section for the add-on.
1.
First remove the integration tools with the Uninstall Tools button.
2.
Then remove the add-on files with the Remove button
3.
Note:
By default, the Apply button adds the material in a new slot without overriding previous material assignments. Remove previous materials, or use the material dropdown to reassign newly applied materials.
If the Substance Integration Tools need to be removed manually, delete the Substance3DIntegrationTools folder from the following directory
•
Windows: C:\Users\(username)\AppData\Roaming\Adobe
•
Mac: /Users/(username)/Library/Application Support/Adobe/Substance3DIntegrationTools
•
Linux: /home/(username)/Adobe/Substance3DIntegrationTools
Substance 3D Add-on for Blender Tutorials
Here is a detailed video tutorial on how to use the Adobe Substance 3D Add-on for Blender
