版本: 0.971 | 环境: Substance 3D Painter 10.1+ | 引擎: Unreal Engine 5.4+(开发基于 5.7)

SPsync 是 Adobe Substance 3D Painter 插件,实现与 Unreal Engine 的双向同步,包括纹理导出/回传、材质自动创建、网格导入、实时相机同步,以及与 UE 侧 AssetCustoms 插件的跨工具自动化协作。

注意:SPsync(SP 侧)与 AssetCustoms(UE 侧)是独立发布的两个插件。SPsync 独立使用时可完成 SP→UE 单向同步;配合 AssetCustoms 使用时支持 UE→SP→UE 完整往返流程。

●くろまるSeamless Integration: Through the plug-in, assets in Substance Painter can be synchronized to Unreal Engine with one click, reducing manual operations and intermediate steps. 示例图片

●くろまるReal-time Viewport Synchronization: Real-time synchronization between Substance Painter and Unreal Engine viewports is achieved, and artists can directly view the effects in the engine, improving work efficiency. 示例图片

●くろまるAutomation and Flexibility: Supports automatic creation of materials and synchronization of maps, and provides flexible output path settings and material configuration options to meet the needs of different projects. 示例图片

IMAGE ALT TEXT HERE

• Output textures according to presets
• Save corresponding paths in the engine
• Automatically output models
• Automatically create materials
• Automatically assemble models
• One-click synchronization of textures
• Synchronize viewports
• UDIM support
• UE→SP one-click send (via AssetCustoms): auto-create project, import textures, build layers
• Config Profile driven mapping: read SM/MI metadata → dynamic channel mapping
• Grayscale Conversion Filter: auto-split packed textures (MRO) in SP
• Round-Trip Sync: auto-detect UE metadata → export in original format → refresh UE textures
• High Poly Bake: select high-poly FBX → auto-bake Normal/AO/Curvature/Position/Thickness mesh maps, then switch back to paint mode
• Texture Size Control: max_resolution (int POT) pipeline-wide control
• Resolution Authority Separation: texture_size from actual export file dimensions, SP clamp [128, 4096]

• UE menu Edit>Editor Preferences>Use Less CPU when in Background > Uncheck Edit>Project Settings>Python Remote Execution>Enable Remote Execution > Check

  UDIM support Edit>Project Settings>Engine>Rendering>Enable virtual texture support Check Edit>Project Settings>Engine>Rendering>Enable virtual texture for Opacity Mask Check

• Copy it to this "C:\Users\username\Documents\Adobe\Adobe Substance 3D Painter\python\plugins" directory

Substance 3D Painter 10.1
Unreal 5.4+ (developed on 5.7)
For UE→SP features: AssetCustoms plugin installed in UE project

a. Turn off the Use Less CPU when in Background option in Editor Preferences to prevent UE from freezing when synchronizing the viewport.

示例图片

b. Turn on Enable Remote Execution in Project Settings to support remote execution of Python scripts.

示例图片

c. If UDIM support is required, you need to turn on Enable virtual texture support and Enable virtual textures for Opacity Mask under Project Settings->Rendering to support virtual textures.

示例图片

a. Python>Plugins Folder to open the python plugin directory.

示例图片

b. Unzip to the Plugins directory and restart SP.

示例图片

c. Make sure SPsync is enabled.

示例图片
示例图片

d. Plugin window

示例图片

a. You need to open the project and wait for the relevant assets to be loaded. Otherwise, the UI is frozen.
示例图片
b. In addition to the built-in or created output presets, the first preset is the preset that adapts to the automatically assembled material. If you select other presets, the material and mounting model will not be automatically created. By default, one material corresponds to four map channels.
示例图片

The output map is named: T + _model name + _material name + _suffix name

c. Click Selet Path to set the path under the Content directory in the UE project.
示例图片
You can right-click and navigate to the relevant directory in the resource manager page in UE.
示例图片

d. By default, Auto Export Texture is checked. When this option is checked, the output command provided by SP is used.
示例图片
示例图片
In addition to exporting textures in the specified path, the related textures will also be automatically synchronized to the set engine directory.

e. Under the material module, if Create Materials is checked, while synchronizing the texture, the material will be automatically created according to the settings, and the output texture will be linked to the material. If there is a material with the same name in the current output directory, it will not be created again and the settings will not be overwritten. In non-UDIM mode, only one parent material will be created, and the rest are material instances. In UDIM mode, they are all separate materials. The default blending type of the material is Opaque. If there is an Opacity channel in the Texture Set, the material blending mode is Masked. If there is a Translucency channel, the material blending mode is Translucent. The default Masked type material has the Dither jitter mode enabled.
The naming method of materials in UE is: M (Material)/MI (Material Instance) + _Model Name + _Material Name 示例图片

f. Click the SYNC button to directly synchronize the texture to the corresponding directory of the engine. If there is an existing file with the same name, it will be overwritten.
示例图片

g. Click SYNC(Mesh) to synchronize the model, material, and texture to the corresponding directory of the engine. At the same time, generate a model in front of the viewport in the engine, at a certain distance from the ground. The model import is set to the forward direction in the X direction, and the scaling value is the parameter in Scale. The default is 100. It can be adjusted according to actual conditions.
示例图片
示例图片

h. Click View Sync to synchronize the current SP viewport with the viewport in UE. It is convenient to view the effect of the asset in the current engine environment. Click again to turn off synchronization. When synchronizing, UE will automatically enter the game View mode. You can switch it through the "g" shortcut key in the engine.
示例图片

SPsync works with the UE-side AssetCustoms plugin for UE→SP→UE round-trip workflows. The two plugins are published independently.

AssetCustoms (UE) SPsync (SP)
───────────── ──────────
sp_bridge.py sp_receive.py
├── collect_material_info() → JSON ├── receive_from_ue(json)
├── export_mesh_fbx() │ ├── project.create(mesh)
├── export_textures() │ ├── import textures + build layers
├── update_texture_sizes_from_exports() │ ├── Grayscale Conversion Filter
└── send_to_sp() ──HTTP POST──────────────────►│ └── set_resolution (clamp [128,4096])
 │
sp_remote.py (HTTP → :60041) sp_channel_map.py
 ├── map UE→SP channel bindings
 ├── sizeLog2 export control
 └── roundtrip export config
 │
 sp_sync_export.py
 └── SYNC → roundtrip mode → refresh UE

• UE→SP: HTTP POST base64(python_script) → SP Remote Scripting API (localhost:60041)
• SP→UE: Remote Execution TCP protocol (localhost:6776)

• 191 pytest tests passed (2026年03月26日)
• Coverage: channel mapping, roundtrip export config, metadata, grayscale filter, texture size control, resolution clamp

• Email : yangskin@163.com
• BiliBili : https://space.bilibili.com/249466