Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-Hunyuan3DWrapper > Hy3D Set Mesh PBR Textures

ComfyUI Node: Hy3D Set Mesh PBR Textures

Class Name

Hy3DSetMeshPBRTextures

Category
Hunyuan3DWrapper
Author
kijai (Account age: 2948days)
Extension
ComfyUI-Hunyuan3DWrapper
Latest Updated
2026-07-29
Github Stars
1.03K

How to Install ComfyUI-Hunyuan3DWrapper

Install this extension via the ComfyUI Manager by searching for ComfyUI-Hunyuan3DWrapper
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-Hunyuan3DWrapper in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Hy3D Set Mesh PBR Textures Description

Enhances 3D models by applying PBR textures for realistic surface details and lifelike appearance.

Hy3D Set Mesh PBR Textures:

The Hy3DSetMeshPBRTextures node is designed to enhance 3D models by applying Physically Based Rendering (PBR) textures to a mesh. This node is particularly useful for artists and designers who want to add realistic surface details to their 3D models, such as base color, emissive, metallic roughness, normal, and occlusion textures. By converting simple materials to PBR materials, this node ensures that the textures applied to the mesh are more realistic and visually appealing. The node works by taking an existing mesh and an image representing the texture, then mapping this texture onto the mesh's surface. This process allows for a more dynamic and lifelike appearance, making it an essential tool for creating high-quality 3D visualizations.

Hy3D Set Mesh PBR Textures Input Parameters:

trimesh

The trimesh parameter represents the 3D mesh to which the PBR textures will be applied. It is crucial as it serves as the base structure that will be enhanced with textures. The mesh should be in a format that supports PBR materials, and it is typically a triangular mesh, which is a common format in 3D modeling.

image

The image parameter is the texture image that will be applied to the mesh. This image can be in RGB or RGBA format, and it is converted into a format suitable for PBR materials. The quality and resolution of this image directly affect the visual outcome of the textured mesh, so using high-quality images is recommended for the best results.

texture

The texture parameter specifies the type of PBR texture to be applied. Options include base_color, emissive, metallic_roughness, normal, and occlusion. Each option corresponds to a different aspect of the material's appearance, such as color, light emission, surface texture, and shadowing. Selecting the appropriate texture type is essential for achieving the desired visual effect on the mesh.

Hy3D Set Mesh PBR Textures Output Parameters:

trimesh

The output trimesh is the modified 3D mesh with the applied PBR textures. This output retains the original mesh's structure but now includes the enhanced visual details provided by the textures. The result is a more realistic and visually appealing 3D model that can be used in various applications, such as rendering, animation, or virtual reality environments.

Hy3D Set Mesh PBR Textures Usage Tips:

  • Ensure that the input image is of high quality and resolution to achieve the best visual results on the mesh.
  • Choose the appropriate texture type based on the desired visual effect, such as using normal for surface details or emissive for glowing effects.
  • Consider converting simple materials to PBR materials if the mesh does not initially support PBR, as this will enhance the realism of the textures.

Hy3D Set Mesh PBR Textures Common Errors and Solutions:

"Base color texture not found"

  • Explanation: This error occurs when the specified base color texture is missing from the mesh's material.
  • Solution: Ensure that the base color texture is correctly specified and available in the input parameters.

"Emissive texture not found"

  • Explanation: This error indicates that the emissive texture is not present in the mesh's material.
  • Solution: Verify that the emissive texture is correctly assigned and exists in the input data.

"Metallic roughness texture not found"

  • Explanation: This error means that the metallic roughness texture is missing from the mesh's material.
  • Solution: Check that the metallic roughness texture is properly specified and included in the input parameters.

"Normal texture not found"

  • Explanation: This error occurs when the normal texture is not found in the mesh's material.
  • Solution: Ensure that the normal texture is correctly assigned and available in the input data.

"Occlusion texture not found"

  • Explanation: This error indicates that the occlusion texture is missing from the mesh's material.
  • Solution: Verify that the occlusion texture is correctly specified and exists in the input parameters.

Hy3D Set Mesh PBR Textures Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-Hunyuan3DWrapper
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Hy3D Set Mesh PBR Textures