MotionSmith Surface — Windows Backend
Canonical backend distribution for MotionSmith Surface, the free Blender add-on for mesh texturing and image-to-PBR materials.
Created by Sertan Koç — OneManStudio.
This is a downloadable Windows runtime package, not an inference endpoint or a model checkpoint. It is separate from the Unreal Engine MotionSmith Runtime.
Add-on source · Product page · Documentation · Showcase
Version 0.1.1
Image-only PBR Material, shared Mapping controls, default Keep Existing UVs, and Texture detail normals via DeepBump. The backend includes comfy-mtb and ONNX Runtime; setup downloads the verified DeepBump model separately.
PBR maps preserve the input image layout. For the crate-photo example use Cube Projection UV; other UV layouts need a matching texture atlas.
Install
- Download the Blender add-on. Install the ZIP through Blender Preferences → Add-ons → Install from Disk.
- Enable MotionSmith Surface and click Install in its preferences.
- The setup window searches local fixed disks for ComfyUI and shared model folders. It checks
extra_model_paths.yamland validates candidate weights by size and SHA-256. Compatible existing backends are reused; otherwise a separate Surface backend is installed. - Missing files are downloaded automatically. Interrupted downloads can resume. Verified weights are hard-linked where possible or copied locally across disks.
- Enter the final ComfyUI Directory and Python Executable shown by setup in the add-on's Backend preferences. Save Preferences, then start the server in N → Surface.
The standalone BAT installer runs the same setup without opening Blender first.
Downloads
| File | Purpose |
|---|---|
| motionsmith_surface_0.1.1.zip | Blender add-on, including the automatic installer |
| install_motionsmith_surface.bat | Standalone automatic backend/model setup |
| motionsmith_surface_backend_win64_0.1.1.zip | Model-free Windows runtime; 4,428,090,499 bytes |
| Backend SHA-256 | Checksum for the runtime archive |
Backend SHA-256: d04c5edcedde213d99aea5b1e68e10f1814161c14b209048f977b93daabbac11.
The full download is approximately 21.5 GiB when no backend or models are present. Allow at least 35 GiB free disk space for a fresh installation. Model weights are not inside the backend ZIP.
Workflows
- Texture: select a mesh; use text and/or an image reference to generate views, bake UV textures and assign a material. Presets are optional.
- PBR Material: use one image to estimate Base Color, Normal, Roughness, Metallic and Height. A selected UV-mapped mesh in Object Mode receives the material in its active slot; otherwise the material is created for manual assignment. Height is not connected to displacement automatically.
- Both pages provide cancellation, current-stage progress where available, and recovery of the last completed job.
Runtime contents and requirements
Windows 64-bit, Blender 5.0+ (tested with 5.2), and a compatible NVIDIA CUDA GPU. VRAM use depends on the model, workflow and resolution.
The package includes ComfyUI 0.27.0, Python 3.12.10, PyTorch 2.8.0 + CUDA 12.8, UltraTex, modular UltraTex, Chord, GGUF and comfy-mtb node packages. No personal input/output files or model weights are included.
Model downloads and access
Setup obtains weights from their publishers and saves the filenames required by the add-on. Chord can require Hugging Face sign-in, acceptance of the model terms and a Read token. Setup requests the token through hidden input without writing it to disk. Chord can be skipped while finishing Texture setup.
Licensing
This repository does not apply a single license to every bundled component.
- MotionSmith Surface add-on: GPL-3.0-or-later, as declared in its manifest.
- ComfyUI: GPL-3.0; included runtime dependencies retain their own licenses and notices.
- ComfyUI-UltraTex: MIT; upstream work by Yibo Zhang.
- UltraTex modular nodes: MIT; includes its upstream license notices.
- comfy-mtb: MIT; notices retained in the backend. DeepBump weights are downloaded separately from their upstream repository.
- ComfyUI-GGUF: Apache-2.0.
- ComfyUI-Chord code and Chord weights: Ubisoft Machine Learning License (Research-Only — Copyleft). Commercial use of those licensed materials is prohibited by that license. Its license and notices are retained inside the backend ZIP.
- Separately downloaded FLUX, Qwen, BiRefNet and other weights retain their publishers' terms. Free availability does not override those terms.
The canonical location for Surface releases is this repository. The legacy add-on ZIP under Serqan/MotionSmith-Runtime/blender/MotionSmith-Surface has been removed; use the versioned add-on download above.