Skip to content

Latest commit

 

History

History
122 lines (86 loc) · 14.1 KB

README.md

File metadata and controls

122 lines (86 loc) · 14.1 KB
Raw

[ English / 日本語 ]

VRM Add-on for Blender CI status uv

VRM Add-on for Blender is an add-on to add VRM-related functions into Blender.

Download

  • For Blender 4.2 or later: 🛠️Blender Extensions Platform.
    ⚠️ Due to a change in specifications on Blender Extensions Platform, add-ons currently distributed to Blender Extensions Platform cannot be upgraded. I'm currently working on this issue. In the meantime, if you want to use the latest version, please download the ZIP file from GitHub Releases.
  • For Blender 2.93 to 4.1: 🌐The Official Site.

Tutorials

Installation Create Simple VRM Create Humanoid VRM
Create Physics Based Material Create Anime Style Material Automation with Python Scripts
VRM Animation Development How-To

Overview

This add-on adds VRM-related functions to Blender, such as importing and exporting VRM, adding VRM Humanoid and setting MToon shaders. Bug reports, feature requests, pull requests, etc. are welcome. I have taken over the development after Version 0.79 from the author, @iCyP.

Development

The source code for development is in the main branch. Its src/io_scene_vrm folder is a main body of the add-on. For efficient development, you can create a link to that folder in the Blender addons folder.

For more advanced development, such as running tests, please use astral.sh/uv. See the tutorial for more information.

git checkout main

# Blender 4.2 or later

# Linux
ln -s "$PWD/src/io_scene_vrm" "$HOME/.config/blender/BLENDER_VERSION/extensions/user_default/vrm"
# macOS
ln -s "$PWD/src/io_scene_vrm" "$HOME/Library/Application Support/Blender/BLENDER_VERSION/extensions/user_default/vrm"
# Windows PowerShell
New-Item -ItemType Junction -Path "$Env:APPDATA\Blender Foundation\Blender\BLENDER_VERSION\extensions\user_default\vrm" -Value "$(Get-Location)\src\io_scene_vrm"
# Windows Command Prompt
mklink /j "%APPDATA%\Blender Foundation\Blender\BLENDER_VERSION\extensions\user_default\vrm" src\io_scene_vrm

# Blender 4.1.1 or earlier

# Linux
ln -s "$PWD/src/io_scene_vrm" "$HOME/.config/blender/BLENDER_VERSION/scripts/addons/io_scene_vrm"
# macOS
ln -s "$PWD/src/io_scene_vrm" "$HOME/Library/Application Support/Blender/BLENDER_VERSION/scripts/addons/io_scene_vrm"
# Windows PowerShell
New-Item -ItemType Junction -Path "$Env:APPDATA\Blender Foundation\Blender\BLENDER_VERSION\scripts\addons\io_scene_vrm" -Value "$(Get-Location)\src\io_scene_vrm"
# Windows Command Prompt
mklink /j "%APPDATA%\Blender Foundation\Blender\BLENDER_VERSION\scripts\addons\io_scene_vrm" src\io_scene_vrm

[ English / 日本語 ]

VRM Add-on for Blender CI status uv

BlenderにVRM関連機能を追加するアドオンです。

ダウンロード

  • Blender 4.2以上をお使いの場合: 🛠️Blender Extensions Platform
    ⚠️ Blender Extensions Platformの仕様変更により、現在Blender Extensions Platform上へ最新版のアップデートを配信することができていません。現在対応作業中になります。最新のアドオンが必要な場合はGitHub Releasesからダウンロードしてください.
  • Blender 2.93から4.1をお使いの場合: 🌐オフィシャルWebサイト

チュートリアル

インストール方法 シンプルなVRMを作る 人型のVRMを作る
物理ベースのマテリアル設定 アニメ風のマテリアル設定 Pythonスクリプトによる自動化
VRMアニメーション 改造するには?

概要

BlenderにVRMのインポートやエクスポート、VRM Humanoidの追加やMToonシェーダーの設定などのVRM関連機能を追加するアドオンです。バグ報告、機能要望、Pull Request等歓迎します。バージョン 0.79以降の開発を作者である@iCyPさんから引き継ぎました。

改造するには

開発用のソースコードは mainブランチにあります。ブランチ内の src/io_scene_vrm フォルダがアドオン本体です。 そのフォルダへのリンクをBlenderの addons フォルダ内に作ることで効率的に開発をすることができます。

テストの実行など、より高度な開発をする場合はastral.sh/uvをご利用ください。詳しい情報はチュートリアルにあります。

git checkout main

# Blender 4.2以上の場合

# Linux
ln -s "$PWD/src/io_scene_vrm" "$HOME/.config/blender/BLENDER_VERSION/extensions/user_default/vrm"
# macOS
ln -s "$PWD/src/io_scene_vrm" "$HOME/Library/Application Support/Blender/BLENDER_VERSION/extensions/user_default/vrm"
# Windows PowerShell
New-Item -ItemType Junction -Path "$Env:APPDATA\Blender Foundation\Blender\BLENDER_VERSION\extensions\user_default\vrm" -Value "$(Get-Location)\src\io_scene_vrm"
# Windows Command Prompt
mklink /j "%APPDATA%\Blender Foundation\Blender\BLENDER_VERSION\extensions\user_default\vrm" src\io_scene_vrm

# Blender 4.2未満の場合

# Linux
ln -s "$PWD/src/io_scene_vrm" "$HOME/.config/blender/BLENDER_VERSION/scripts/addons/io_scene_vrm"
# macOS
ln -s "$PWD/src/io_scene_vrm" "$HOME/Library/Application Support/Blender/BLENDER_VERSION/scripts/addons/io_scene_vrm"
# Windows PowerShell
New-Item -ItemType Junction -Path "$Env:APPDATA\Blender Foundation\Blender\BLENDER_VERSION\scripts\addons\io_scene_vrm" -Value "$(Get-Location)\src\io_scene_vrm"
# Windows Command Prompt
mklink /j "%APPDATA%\Blender Foundation\Blender\BLENDER_VERSION\scripts\addons\io_scene_vrm" src\io_scene_vrm