Skip to content

Fix/blender5.0 #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
acolasialiuliu wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Fix/blender5.0 #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2f00d05
Enhanced texture handling in material transitions and adapted to Blen…
acolasialiuliu Dec 16, 2025
65ca469
Revise README for VrmToFBXWithTexture plugin
acolasialiuliu Dec 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
285 changes: 269 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,25 +1,278 @@
# Blender Addon - VrmToFBXWithTexture
This Addon can convert Vrm model to FBX with texture, need use VRM-Addon-for-Blender(https://github.com/saturday06/VRM-Addon-for-Blender) addon to import vrm model.
# VrmToFBXWithTexture plugin

## How to Install

Download the python file VrmToFBXWithTexture.py and install via Blenders Addon-Preferences
## Introduction to Plugins

Edit > Preferences > Add-ons > Install... > Select VrmToFBXWithTexture.py

## How to Use
VrmToFBXWithTexture is a Blender plugin for converting and exporting VRM models to FBX format files with textures. This plugin addresses texture loss and material display anomalies that can occur with the default VRM to FBX conversion in Blender 5.0. <img style="margin-right: 30px;" align="left" src="images/VrmToFBXWithTexture.png"/>

This Addon adds 3 new operators which can be found in the Sidebar Menu of 3D Viewport:

<img style="margin-right: 30px;" align="left" src="images/VrmToFBXWithTexture.png"/>
## Features

* **Copy**
* Copy imported vrm model, add to new collection VrmToFBX_Collection, and create new material set for export FBX file. This operation will copy and unpack textures in blender project file to it's location, this won't affect origin texture for the unpacked files are just copies.
* **Export**
* Show export FBX window and auto set for export (enable "embed textures" option, and set "path_mode" to "COPY")
* **Clear**
* Clear all res copied from first step, will not affect origin file.
* **One key for all**
* Do "Copy" -> "Export" -> "Clear" by one click, FBX export path can be set in "Export path:" above.

- **One-click copy VRM model**: Automatically copy imported VRM models to a new collection, preserving materials and textures
- **Intelligent Texture Processing**: Supports multiple texture extraction methods, ensuring that textures from different VRM models are correctly identified and processed
- **FBX Export Optimization**: Automatically sets export parameters, ensuring textures are properly embedded in FBX files
- **Transparent Channel Support**: Automatically detects and processes transparent textures, maintaining the transparency of the model
- **Safe Cleanup**: Provides a cleanup feature to remove temporarily created models, materials, and textures without affecting the original file


## Installation Method


1. Download the 'VrmToFBXWithTexture_fixed.py' file
2. Open Blender
3. Click on 'Edit' -> 'Preferences' in the menu bar
4. Select 'Plugins' in the left panel
5. Click on the 'Install' button in the top right corner
6. Select the downloaded fileVrmToFBXWithTexture_fixed.py
7. Check the box next to the plugin name to enable the plugin


## Instructions for use


### Preparation


1. Import VRM models in Blender (tools such as [VRM Add-on](https://github.com/saturday06/VRM-Addon-for-Blender)) are available)
2. Make sure the model is fully loaded, including materials and textures


### Plugin interface


The plugin panel is located in the right sidebar of the 3D window (press the 'N' key to display), under the "Vrm to FBX" tab.


### Function buttons


#### 1. Copy


- **Function**: Copy the VRM model from the current scene to a new collection
- **Action**: Click the "Copy" button
- **Results**:
- Create a new collection called "VrmToFBX_Collection"
- Create a copy of the model in that collection
- Automatically handles materials and textures to ensure they display correctly in Blender


#### 2. Export


- **Functions**: Export the copied model as an FBX file
- **Actions**: Click the "Export" button
- **Results**:
- A pop-up FBX export window
- Automatically select the replicated model
- Automatically set export parameters (embed textures, path_mode=COPY)
- Select the save path and click "Export FBX"


#### 3. Clear


- **Function**: Clean up copied models and temporary files
- **Action**: Click the "Clear" button
- **Results**:
- Delete the "VrmToFBX_Collection" collection and the models in it
- Delete temporarily created materials and textures
- Clean up temporary folders (only delete files created by plugins)


#### 4. One key for all


- **Function**: Automates the complete process of copy->export-> purge
- **Operation**:
1. Set the FBX save path in the "Export Path" input box
2. Click on the "One key for all" button
- **Results**:
- Automatically copy models
- Export the FBX file to the specified path
- Automatically clean up temporary files


## Considerations


1. **VRM Import**: Ensure that the model has been imported into Blender using a compatible VRM import tool
2. **Texture Processing**: The plugin automatically handles the packaged texture, unpacking it into a temporary location
3. **Export Path**: When using the "One key for all" function, you need to set a valid export path in advance
4. **Version Compatibility**: The plugin is compatible with Blender 5.0 and is compatible with Blender 2.80 and above
5. **Complex Materials**: For complex PBR materials, the plugin extracts the base color texture, and other material properties may need to be manually adjusted


## FAQs


### Problem: The model turns white after copying


Resolved: The plugin has fixed this issue to ensure that the material nodes are properly connected


### Problem: Exported FBX has no textures


**Solved**: The plugin automatically sets the FBX export parameters, ensuring that the texture is embedded in the file


### Problem: Blender Error "Principled BSDF node not found"


**Solution**: The plugin has added a node existence check to automatically create the necessary nodes


## Version information


- **Current Version**: 1.0.1
- **Updated**: 2025-12-16
- **Fixes**:
- Resolved an issue with the Principled BSDF node in Blender 5.0
- Improved texture extraction logic
- Fixed material node connections
- Supports transparent texture processing


## Author Information


- **Original author**:D 3LN
- **Fixes and Improvements**: Liufen 792818521@qq.com


## License


This plugin is licensed under the MIT license and is free to use and modify.


---


**Usage Tips**: If you encounter issues during use, it is recommended to first check that the VRM model is imported correctly and ensure that all textures are loaded correctly.

# VrmToFBXWithTexture 插件

## 插件简介

VrmToFBXWithTexture 是一个 Blender 插件，用于将 VRM 模型转换并导出为带有纹理的 FBX 格式文件。该插件解决了 Blender 5.0 中默认 VRM 到 FBX 转换可能出现的纹理丢失和材质显示异常问题。<img style="margin-right: 30px;" align="left" src="images/VrmToFBXWithTexture.png"/>

## 功能特点

- **一键复制 VRM 模型**：自动复制导入的 VRM 模型到新集合，保留材质和纹理
- **智能纹理处理**：支持多种纹理提取方式，确保正确识别和处理不同 VRM 模型的纹理
- **FBX 导出优化**：自动设置导出参数，确保纹理正确嵌入到 FBX 文件中
- **透明通道支持**：自动检测并处理透明纹理，保持模型的透明效果
- **安全清理**：提供清理功能，移除临时创建的模型、材质和纹理，不影响原始文件

## 安装方法

1. 下载 `VrmToFBXWithTexture_fixed.py` 文件
2. 打开 Blender
3. 点击菜单栏的 `编辑` -> `首选项`
4. 在左侧面板选择 `插件`
5. 点击右上角的 `安装` 按钮
6. 选择下载的 `VrmToFBXWithTexture_fixed.py` 文件
7. 勾选插件名称旁的复选框启用插件

## 使用说明

### 准备工作

1. 在 Blender 中导入 VRM 模型（可使用 [VRM Add-on](https://github.com/saturday06/VRM-Addon-for-Blender) 等工具）
2. 确保模型已完全加载，包括材质和纹理

### 插件界面

插件面板位于 3D 视窗的右侧边栏（按 `N` 键显示），在 "Vrm to FBX" 标签下。

### 功能按钮

#### 1. Copy（复制）

- **功能**：复制当前场景中的 VRM 模型到新集合
- **操作**：点击 "Copy" 按钮
- **结果**：
- 创建名为 "VrmToFBX_Collection" 的新集合
- 在该集合中创建模型副本
- 自动处理材质和纹理，确保在 Blender 中正确显示

#### 2. Export（导出）

- **功能**：导出复制的模型为 FBX 文件
- **操作**：点击 "Export" 按钮
- **结果**：
- 弹出 FBX 导出窗口
- 自动选择复制的模型
- 自动设置导出参数（嵌入纹理，path_mode=COPY）
- 选择保存路径并点击 "导出 FBX"

#### 3. Clear（清除）

- **功能**：清理复制的模型和临时文件
- **操作**：点击 "Clear" 按钮
- **结果**：
- 删除 "VrmToFBX_Collection" 集合及其中的模型
- 删除临时创建的材质和纹理
- 清理临时文件夹（仅删除插件创建的文件）

#### 4. One key for all（一键导出）

- **功能**：自动执行复制 -> 导出 -> 清除的完整流程
- **操作**：
1. 在 "Export Path" 输入框中设置 FBX 保存路径
2. 点击 "One key for all" 按钮
- **结果**：
- 自动复制模型
- 导出 FBX 文件到指定路径
- 自动清理临时文件

## 注意事项

1. **VRM 导入**：确保已使用兼容的 VRM 导入工具将模型导入 Blender
2. **纹理处理**：插件会自动处理打包纹理，将其解包到临时位置
3. **导出路径**：使用 "One key for all" 功能时，需提前设置有效的导出路径
4. **版本兼容**：该插件已适配 Blender 5.0，同时兼容 Blender 2.80 及以上版本
5. **复杂材质**：对于复杂的 PBR 材质，插件会提取基础颜色纹理，其他材质属性可能需要手动调整

## 常见问题

### 问题：模型复制后变成白色

**解决**：插件已修复此问题，确保正确连接材质节点

### 问题：导出的 FBX 没有纹理

**解决**：插件会自动设置 FBX 导出参数，确保纹理嵌入到文件中

### 问题：Blender 报错 "Principled BSDF node not found"

**解决**：插件已添加节点存在性检查，自动创建必要的节点

## 版本信息

- **当前版本**：1.0.1
- **更新日期**：2025-12-16
- **修复内容**：
- 解决 Blender 5.0 中的 Principled BSDF 节点问题
- 改进纹理提取逻辑
- 修复材质节点连接
- 支持透明纹理处理

## 作者信息

- **原作者**：D3LN
- **修复与改进**：Liufen 792818521@qq.com

## 许可证

本插件采用 MIT 许可证，可自由使用和修改。

---

**使用提示**：如果您在使用过程中遇到问题，建议先检查 VRM 模型的导入是否正确，确保所有纹理已正确加载。
55 changes: 46 additions & 9 deletions VrmToFBXWithTexture.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,17 +33,35 @@ def copy_vrm(context):
if not mat.use_nodes:
continue

base_color_img = None

#Defining node variables
nodes = mat.node_tree.nodes
output = next((n for n in nodes if isinstance(n, bpy.types.ShaderNodeOutputMaterial)), None)

# Try to find base color texture by checking links or any texture node
base_color_img = None
# First, try to find by name (original method)
for n in nodes:
if isinstance(n, bpy.types.ShaderNodeTexImage):
if n.name == "Mtoon1BaseColorTexture.Image":
base_color_img = unpack_node_img(n)
break

# If not found, try to find any texture node connected to base color
if base_color_img is None:
for n in nodes:
if isinstance(n, bpy.types.ShaderNodeBsdfPrincipled) or isinstance(n, bpy.types.ShaderNodeBsdfDiffuse):
if n.inputs['Base Color'].is_linked:
link_node = n.inputs['Base Color'].links[0].from_node
if isinstance(link_node, bpy.types.ShaderNodeTexImage):
base_color_img = unpack_node_img(link_node)
break

# If still not found, use any texture node as fallback
if base_color_img is None:
for n in nodes:
if isinstance(n, bpy.types.ShaderNodeTexImage):
base_color_img = unpack_node_img(n)
break

#Checking for Mixshader/Output state
if base_color_img is None or output is None:
Expand All @@ -59,15 +77,34 @@ def copy_vrm(context):
mat_new.use_nodes = True
node_tree_new = mat_new.node_tree
nodes_new = node_tree_new.nodes
output = nodes_new.get('Material Output')
#Creating Principled node
principled = nodes_new.get("Principled BSDF")

# Clear default nodes
for node in nodes_new:
nodes_new.remove(node)

# Create Material Output node
output = nodes_new.new(type='ShaderNodeOutputMaterial')
output.location = (300, 0)

# Create Principled BSDF node
principled = nodes_new.new(type="ShaderNodeBsdfPrincipled")
principled.location = (0, 0)

# Create and set up texture node
base_color = nodes_new.new(type = "ShaderNodeTexImage")
base_color.location = (principled.location[0] - 300, principled.location[1])
base_color.location = (-300, 0)
base_color.image = base_color_img
node_tree_new.links.new(base_color.outputs[0], principled.inputs[0])
node_tree_new.links.new(base_color.outputs[1], principled.inputs[21])

# Connect nodes
node_tree_new.links.new(base_color.outputs[0], principled.inputs['Base Color'])

# If texture has alpha channel, connect to alpha input
if base_color.image and base_color.image.channels == 4:
node_tree_new.links.new(base_color.outputs[1], principled.inputs['Alpha'])
mat_new.blend_method = 'BLEND' # Ensure blend method is set for transparency

# Connect Principled BSDF to Material Output
node_tree_new.links.new(principled.outputs[0], output.inputs['Surface'])

obj_mats[i] = mat_new

Expand Down Expand Up @@ -291,4 +328,4 @@ def unregister():
# This allows you to run the script directly from Blender's Text editor
# to test the add-on without having to install it.
if __name__ == "__main__":
register()
register()