### VRM4U Setup Source: https://github.com/ruyo/vrm4u/wiki/VRM4U Instructions on how to set up the VRM4U plugin in an Unreal Engine project. It involves placing the plugin files in the correct directory. ```text Place the files in MyGame/Plugins/VRM4U/ ``` -------------------------------- ### Plugin Installation Source: https://github.com/ruyo/vrm4u/blob/master/README.md Instructions on how to install the VRM4U plugin into an Unreal Engine project. This involves downloading the plugin and placing it in the project's 'Plugins' folder. ```text + MyProject - MyProject.uproject - Plugins - VRM4U - VRM4U.uplugin ``` -------------------------------- ### Flexible Plugin Placement Source: https://github.com/ruyo/vrm4u/blob/master/README.md Enabled flexible placement of the plugin. Users can now choose where to install the plugin files. ```Unreal Engine プラグインの配置場所を自由にできるようになった。 ``` -------------------------------- ### Real-time Retargeting from Gray Man Source: https://github.com/ruyo/vrm4u/blob/master/README.md Added real-time retargeting functionality from Gray Man. Usage guide available at [使い方](https://ruyo.github.io/VRM4U/03_gray/). ```Unreal Engine グレイマンからのリアルタイムリターゲット機能を追加した [使い方](https://ruyo.github.io/VRM4U/03_gray/) ``` -------------------------------- ### Import UE5.5 Plugin Build Distribution Source: https://github.com/ruyo/vrm4u/blob/master/README.md Starting from version 2024/03/23, distributed binaries for UE5 are generated via plugin builds. ```APIDOC UE5 Plugin Build Distribution: - Change: Distributed binaries for UE5 are now generated via plugin builds. - Release Date: 2024/03/23 ``` -------------------------------- ### UE5.0 Auto-Generation of IKRetargeter Assets Source: https://github.com/ruyo/vrm4u/blob/master/README.md Enabled automatic generation of IKRetargeter assets during import in UE5.0. This streamlines the setup process for retargeting animations. ```Unreal Engine UE5.0 インポート時、IKRetargeter用アセットを自動生成 ``` -------------------------------- ### UE5.0 IKRig Auto-Generation Arm Fix Source: https://github.com/ruyo/vrm4u/blob/master/README.md Corrected the IKRig auto-generation process for UE5.0, specifically addressing an issue where the shoulder was included from the arm. The generation now correctly starts from the upper arm. ```Unreal Engine UE5.0 IKRig自動生成時、Armに肩が入っていたのを、上腕からに修正した ``` -------------------------------- ### VRM4U Dependencies and Licenses Source: https://github.com/ruyo/vrm4u/blob/master/README_en.md Lists the licenses for VRM4U and its dependencies, including JSON for Modern C++ and assimp. It also provides links to the source code repositories. ```APIDOC Licenses: - MIT: VRM4U - MIT: JSON for Modern C++ (https://github.com/nlohmann/json) - 3-clause BSD-License: assimp (https://github.com/assimp/assimp, https://github.com/ruyo/assimp) Source: - https://github.com/ruyo/UnrealEngine_VRM4UPlugin - https://github.com/ruyo/assimp ``` -------------------------------- ### Import UE5.5 Preview Binary Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/10/02 added support for UE5.5 Preview binaries. ```APIDOC UE5.5 Preview Binary Support: - Compatibility Update. - Release Date: 2024/10/02 ``` -------------------------------- ### New FKRig System and Sample Map Source: https://github.com/ruyo/vrm4u/blob/master/README.md Added a new FKRig system and a corresponding sample map. This provides a new way to implement forward kinematics and demonstrates its usage. ```Unreal Engine 新FKRigシステム、サンプルマップを追加した。 ``` -------------------------------- ### Import UE5.6 Preview Binary Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2025/05/14 added support for UE5.6 Preview binaries. ```APIDOC UE5.6 Preview Binary Support: - Compatibility Update. - Release Date: 2025/05/14 ``` -------------------------------- ### Untitled Source: https://github.com/ruyo/vrm4u/blob/master/README.md No description -------------------------------- ### Import UE5.5 Binary Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/06/04 added support for UE5.5 binaries. ```APIDOC UE5.5 Binary Support: - Compatibility Update. - Release Date: 2024/06/04 ``` -------------------------------- ### Import Special Character Replacement Source: https://github.com/ruyo/vrm4u/blob/master/README.md Starting from version 2023/11/27, special characters (spaces, periods) in bone and MorphTarget names are replaced with underscores during import to align with UE standard behavior. This can be disabled in import options. ```APIDOC Import Name Sanitization: - Behavior Change: Special characters (space, '.') in bone/MorphTarget names replaced with '_'. - Reason: Align with UE standard behavior. - Option: Can be disabled during import. - Release Date: 2023/11/27 ``` -------------------------------- ### VRM4U Requirements and Usage Source: https://github.com/ruyo/vrm4u/blob/master/README_en.md Details the requirements for using the VRM4U plugin, including compatible Unreal Engine versions and operating systems. It also provides basic usage instructions, such as dragging and dropping VRM files. ```Unreal Engine C++ Requirement: - UE4.20 - UE4.27 - Windows, Android, iOS, Mac(by ProjectBuild) - **For packaging, please download from UnrealEngine_VRM4UPlugin repository.** Usage: - Drag and drop VRM file. ``` -------------------------------- ### VMC Tracker Sample Source: https://github.com/ruyo/vrm4u/blob/master/README.md Added a sample demonstrating the use of VMC trackers for motion input. This showcases real-time motion capture integration. ```Unreal Engine VMCのトラッカーを利用したサンプルを追加した。 ``` -------------------------------- ### Import UE5.4.1 Binary Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/05/03 added support for UE5.4.1 binaries. ```APIDOC UE5.4.1 Binary Support: - Compatibility Update. - Release Date: 2024/05/03 ``` -------------------------------- ### Import UE5.4 Binary Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/07/28 added support for UE5.4 binaries. ```APIDOC UE5.4 Binary Support: - Compatibility Update. - Release Date: 2024/07/28 ``` -------------------------------- ### Mac Build Setting Switch Source: https://github.com/ruyo/vrm4u/blob/master/README.md Switched the Mac build settings to use StaticLib. This may affect build times and project linking. ```Unreal Engine Macのビルド設定をStaticLibに切り替えた。 ``` -------------------------------- ### Import UE5.6 Binary Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/06/04 added support for UE5.6 binaries. ```APIDOC UE5.6 Binary Support: - Compatibility Update. - Release Date: 2024/06/04 ``` -------------------------------- ### Import UE5.5 Binary Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/11/13 added support for the release version of UE5.5. ```APIDOC UE5.5 Release Version Support: - Compatibility Update. - Release Date: 2024/11/13 ``` -------------------------------- ### Import UE5.4 Preview Version Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/03/23 added support for the preview version of UE5.4. ```APIDOC UE5.4 Preview Version Support: - Compatibility Update. - Release Date: 2024/03/23 ``` -------------------------------- ### Linux Build Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Added support for building the project on Linux. This expands the platform compatibility of VRM4U. ```Unreal Engine Linuxビルドに対応した。 ``` -------------------------------- ### UE5.0 Preview Version Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Added support for the preview version of UE5.0. This ensures compatibility with early access builds of Unreal Engine 5. ```Unreal Engine UE5.0preview版に対応した。 ``` -------------------------------- ### Custom Assimp Source Acquisition Source: https://github.com/ruyo/vrm4u/blob/master/README.md Guidance on obtaining and building the custom Assimp source code, which is necessary for Mac and mobile runtime loading features of the VRM4U plugin. ```text カスタム版assimpは[こちら](https://github.com/ruyo/assimp)より入手ください ``` -------------------------------- ### IKRetargeter Root Motion Setting Source: https://github.com/ruyo/vrm4u/blob/master/README.md In version 2024/04/17, the IKRetargeter was updated to include Root Motion settings. ```APIDOC IKRetargeter Root Motion: - Enhancement: Added Root Motion setting. - Release Date: 2024/04/17 ``` -------------------------------- ### Import UE5 Binary Path Fix Source: https://github.com/ruyo/vrm4u/blob/master/README.md In version 2024/04/02, an incorrect path for UE5 distributed binaries was corrected. ```APIDOC UE5 Binary Path Correction: - Fix: Correct the incorrect path for UE5 distributed binaries. - Release Date: 2024/04/02 ``` -------------------------------- ### IKRig Bone Settings Addition Source: https://github.com/ruyo/vrm4u/blob/master/README.md In version 2024/02/12, IKRig functionality was enhanced with the addition of IKBone settings. ```APIDOC IKRig Bone Settings: - Enhancement: Added IKBone settings. - Release Date: 2024/02/12 ``` -------------------------------- ### Import UE5 Mannequin IK Rig/Retargeter Generation Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/06/17 added the generation of IK Rig and IK Retargeter for UE5 Mannequins. ```APIDOC UE5 Mannequin IK Rig/Retargeter Generation: - Feature: Generate IK Rig and IK Retargeter for UE5 Mannequins. - Release Date: 2024/06/17 ``` -------------------------------- ### mocopi Integration and VMC Protocol Handling Source: https://github.com/ruyo/vrm4u/blob/master/README.md Details enhancements for mocopi data reception and processing, including IP address listing, buffering, and VMC protocol integration for motion capture. ```APIDOC mocopi and VMC Protocol: - Added mocopiReceiver module for receiving mocopi data. - Enabled buffering of mocopi motion data. - Fixed issues with mocopi data causing periodic T-poses. - Corrected misaligned debug display positions in world coordinates for mocopi. - Added functionality to list local IP addresses for the mocopi receiver. - Enabled VMC reception to work without a Widget intermediary. - Fixed issues with VMC reception not working from WBP. - Added a simple Actor to move characters using the VMC protocol. - Enabled VMC protocol to reflect BlendShape and Root coordinates. - Fixed VMC protocol Root coordinate not being reflected correctly. - Added OSC plugin check when opening VMC protocol sample maps. - Fixed VMC protocol not working correctly when receiving from multiple ports. - Enabled Perfect Sync from VMC protocol (handled missing BlendShapeGroups as direct MorphTargets). - Fixed BlendShape for material parameter animation crashing with invalid data. - Fixed VMC received BlendShape not being recordable by TakeRecorder. ``` -------------------------------- ### IKRetargeter A-Pose Addition Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2023/11/27 introduced the automatic addition of A-poses to IKRetargeters. ```APIDOC IKRetargeter A-Pose: - Feature: Automatically add A-pose. - Release Date: 2023/11/27 ``` -------------------------------- ### BSD License for msinttypes Source: https://github.com/ruyo/vrm4u/blob/master/ThirdParty/rapidjson/license.txt This section outlines the BSD License terms for the msinttypes r29 component, which is used as a dependency. It specifies conditions for redistribution and use in source and binary forms, emphasizing the retention of copyright notices and disclaimers. ```BSD Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ``` -------------------------------- ### Import UE4 Import Functionality Fix Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/03/20 fixed an issue where importing in UE4 was not working with the built binaries. ```APIDOC UE4 Import Functionality Fix: - Fix: Resolve import issues in UE4 with built binaries. - Release Date: 2024/03/20 ``` -------------------------------- ### Sample Model Import Fix (UE4.20-4.25) Source: https://github.com/ruyo/vrm4u/blob/master/README.md Fixed an issue where sample models could not be read in UE4.20 to UE4.25. This ensures compatibility with older Unreal Engine versions. ```Unreal Engine サンプルのモデルがUE4.20~4.25で読めないのを修正した。 ``` -------------------------------- ### Assimp Update Source: https://github.com/ruyo/vrm4u/blob/master/README.md Updated the Assimp library to version v5.2.2. This may include performance improvements and support for newer features. ```C++ assimpを更新(v5.2.2) ``` -------------------------------- ### UE5.0 IKRig Asset Generation Source: https://github.com/ruyo/vrm4u/blob/master/README.md Enabled the generation of IKRig assets for UE5.0, supporting both VRM and EpicSkeleton. This provides a standardized way to set up inverse kinematics. ```Unreal Engine UE5.0 IKRigアセットを生成するようにした(VRM, EpicSkeleton両対応) ``` -------------------------------- ### VMC Protocol Root Pose Update Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/05/07 fixed an issue where the root pose from the VMC protocol was not being reflected correctly. ```APIDOC VMC Protocol Root Pose: - Fix: Ensure root pose is correctly applied. - Release Date: 2024/05/07 ``` -------------------------------- ### Retargeting Bone Name and Reference Pose Specification Source: https://github.com/ruyo/vrm4u/blob/master/README.md Enabled specification of bone names and reference poses for retargeting. Added a tool to output the bone name mapping list. ```Unreal Engine リターゲットの骨名やリファレンスポーズを指定できるようにした。骨名の対応リスト出力ツールを追加した。 ``` -------------------------------- ### VMC Protocol Address Initialization Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/10/07 changed the default value for the VMC reception address to 'ANY'. ```APIDOC VMC Reception Address: - Default Value Change: Initial value set to 'ANY'. - Release Date: 2024/10/07 ``` -------------------------------- ### VRM4U Plugin Features Source: https://github.com/ruyo/vrm4u/blob/master/README_en.md This section outlines the key features of the VRM4U plugin for Unreal Engine. It covers animation capabilities such as bone, blendshape, and swing bone generation, material simulation using MToon, and mobile optimization techniques. ```Unreal Engine C++ Import VRM file Animation: - Generate bone, blendshape, swing bone, collision and humanoid rig. - Switch swing bone type PhysicsAsset/VRMSpringBone. Material: - MToon simulated material. No postprocess. Mobile: - Vanilla UE4Editor can use VRM on mobile by using BoneMap reduction. - Available on Forward/Deferred. ``` -------------------------------- ### UE5.0 SSSProfile Initialization Source: https://github.com/ruyo/vrm4u/blob/master/README.md Initialized SSSProfile with default values during import in UE5.0 to prevent noise. This improves the visual quality of subsurface scattering. ```Unreal Engine 5.0でのインポート時、SSSProfileを初期値で作成するようにした。ノイズが出るため。 ``` -------------------------------- ### Import UE5.4 Formal Version Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/04/24 added support for the formal release of UE5.4. ```APIDOC UE5.4 Formal Version Support: - Compatibility Update. - Release Date: 2024/04/24 ``` -------------------------------- ### UEFN Mannequin IK Rig/Retargeter Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2024/06/17 added support for generating IK Rig and IK Retargeter for UEFN Mannequins. ```APIDOC UEFN Mannequin IK Rig/Retargeter: - Feature: Generate IK Rig and IK Retargeter for UEFN Mannequins. - Release Date: 2024/06/17 ``` -------------------------------- ### VRM10 PhysicsAsset Generation Source: https://github.com/ruyo/vrm4u/blob/master/README.md As of version 2025/02/06, the project now supports the generation of PhysicsAssets for VRM10 models. ```APIDOC VRM10 PhysicsAsset Generation: - Feature: Enable PhysicsAsset creation for VRM10 models. - Release Date: 2025/02/06 ``` -------------------------------- ### MIT License for RapidJSON Source: https://github.com/ruyo/vrm4u/blob/master/ThirdParty/rapidjson/license.txt This section details the MIT License terms applicable to the RapidJSON source code and binaries provided by Tencent. It outlines permissions for use, modification, distribution, and sale, requiring the inclusion of the copyright notice and permission notice. ```MIT Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. ``` -------------------------------- ### UE5.0 Preview Support Change Source: https://github.com/ruyo/vrm4u/blob/master/README.md Changed the UE5.0 plugin to the preview support version. Previous preview versions are no longer supported. Use the 20220214 version if needed. ```Unreal Engine **注意)5.0のプラグインをPreview対応版に差し替えました。この先はEA版をサポートしません。必要あれば20220214版をご利用ください。** ``` -------------------------------- ### UE5.0 Retargeting Assets Alignment Source: https://github.com/ruyo/vrm4u/blob/master/README.md Aligned retargeting assets for UE5.0 to match the UE5 standard. Added FullIK settings. Further details can be found at [解説はこちら](https://ruyo.github.io/VRM4U/03_gray/). ```Unreal Engine UE5.0 リターゲット用アセットをUE5基準にあわせた。FullIK設定を追加した。[解説はこちら](https://ruyo.github.io/VRM4U/03_gray/) ``` -------------------------------- ### Import BVH Root Bone Addition Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2025/05/05 added a dummy Root Bone when importing BVH files. ```APIDOC BVH Import Root Bone: - Enhancement: Add a dummy Root Bone. - Release Date: 2025/05/05 ``` -------------------------------- ### UE5.0 Runtime Load Fix Source: https://github.com/ruyo/vrm4u/blob/master/README.md Fixed an issue in UE5.0 where runtime loading via PKG would stop. This ensures that packaged projects can load assets correctly at runtime. ```Unreal Engine UE5.0 PKGでのランタイムロードが停止するのを修正した。 ``` -------------------------------- ### VRM4U MToon Appearance Source: https://github.com/ruyo/vrm4u/wiki/VRM4U Guidance on how to achieve a visual appearance similar to MToon shaders within VRM4U. It suggests using MToonActor* and adjusting material parameters. ```text Refer to the sample map and use MToonActor*. Internal processing is similar to: https://qiita.com/ruyo/items/ec082d81dea3033e1500 To mitigate shading blur, set material parameter mtoon_LightColorAttenuation=1. ``` -------------------------------- ### Material UE5 SSS and Lit Default Fix Source: https://github.com/ruyo/vrm4u/blob/master/README.md In version 2024/10/02, fixes were applied to UE5 materials where SSS and Lit properties were not set by default. ```APIDOC UE5 Material SSS/Lit Defaults: - Fix: Ensure SSS and Lit properties are set by default. - Release Date: 2024/10/02 ``` -------------------------------- ### Import VRMA File Support Source: https://github.com/ruyo/vrm4u/blob/master/README.md Version 2023/08/13 added support for importing VRMA files. ```APIDOC VRMA File Import Support: - Feature: Enable import of VRMA file format. - Release Date: 2023/08/13 ``` -------------------------------- ### MToonAttach Dynamic Material Cleanup Source: https://github.com/ruyo/vrm4u/blob/master/README.md Addressed the issue of unnecessary DynamicMaterial generation in MToonAttach. This optimizes material instances. ```Unreal Engine MToonAttachにて不要なDynamicMaterialが生成されるのを対処した。 ``` -------------------------------- ### A-pose Update Source: https://github.com/ruyo/vrm4u/blob/master/README.md Updated the A-pose to include finger poses, aligning them closer to the Gray Man's posture. This improves the default pose for character rigging and animation. ```Unreal Engine A-poseを更新した。手指までグレイマンに近い姿勢に置き換えた。 ``` -------------------------------- ### Material and Rendering Enhancements Source: https://github.com/ruyo/vrm4u/blob/master/README.md Details improvements to materials, including MatCap settings, eye correction, shadow maps, and shader features like outlines and post-toon effects. ```APIDOC Material and Rendering: - Enabled setting two MatCaps. - Fixed eye correction material center fading to black. - Added ToneCurveAmount for color correction. - Enabled main light color reflection in Unlit materials. - Added dummy data for DirectionalLight when it's absent. - Fixed MToonUnlit becoming black when using SunSky (ensured MToonUnlit works with large light values). - Enabled PostToon to receive DOF effects (RenderAfterDOF set to OFF). - Enabled main light color reflection in Unlit materials. - Added mask and scale to MatCap. - Enabled EyeWhite color scaling. - Enabled EyeWhite to be affected by DOF. - Enabled setting min/max for Metallic, Roughness. - Enabled mask for NormalMap. - Enabled loading of no-outline settings for VRM10. - Fixed outline parts not deforming correctly with FovFix. - Enabled PBR materials to import Normal, Roughness, and Metallic maps. - Enabled PerBoneMotionBlur. - Fixed outline appearing on parts without outlines after parameter settings. - Fixed issues with incorrect data causing crashes in BlendShape for material parameter animation. ``` -------------------------------- ### Older Plugin Source Source: https://github.com/ruyo/vrm4u/blob/master/README.md Information on how to access older versions of the VRM4U plugin source code, specifically for versions prior to November 2023. ```text こちらより昔のソースを取得ください https://github.com/ruyo/UnrealEngine_VRM4UPlugin ``` -------------------------------- ### Import UE5.5 Crash Fix Source: https://github.com/ruyo/vrm4u/blob/master/README.md Multiple versions addressed crashes during import with UE5.5. Version 2024/12/13 provided an initial fix, 2024/12/27 further refined it, and 2025/01/03 included additional corrections. ```APIDOC UE5.5 Import Crash Fixes: - 2024/12/13: Initial fix for import crashes. - 2024/12/27: Further refinement of the fix. - 2025/01/03: Additional corrections for import stability. ``` -------------------------------- ### Import UE5 Runtime Load Distortion Fix Source: https://github.com/ruyo/vrm4u/blob/master/README.md In version 2023/08/13, a fix was implemented for UE5 runtime loading where models were distorting due to skinning weight misalignment. ```APIDOC UE5 Runtime Load Distortion Fix: - Fix: Correct model distortion during runtime load in UE5 caused by skinning weight misalignment. - Release Date: 2023/08/13 ```