Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
Added
- Added iOS Build Support check in
Unity Settings for Mobile; when missing, guidance is shown but it does not trigger startup auto-open. - Apply platform-specific texture override settings (compression format and max texture size) from source textures to generated textures.
- Added options to Toon Standard conversion settings.
Generate shadow rampto generate shadow ramp texture.Featuresto select features to apply to the converted material.Mask Textures Size LimitandMask Compression Formatto control max resolution and compression format of mask textures independently.MatCap Texture Settingsto control max resolution and compression format of matcap textures independently. The default max resolution is 256x256.
- Added opt-in/opt-out mode for Toon Standard feature selection.
- Preview wireframe when selecting PhysBones to keep.
- [NDMF] Preview for material conversion and removal of vertex color.
- Added "No Override" option to texture compression format settings, allowing Unity's default ASTC compression settings to control texture format instead of forcing platform-specific overrides. The default texture compression format for
Avatar Converter Settingscomponent is now "No Override". - Added
VQT Fallback Avatarcomponent that automatically sets an avatar as a fallback avatar after upload when performance requirements are met (Good or better rating for mobile platforms). - Show warning logs during mobile upload when Avatar Dynamics categories are rated Very Poor.
- (Experimental) Material conversion from Poiyomi to Toon Standard.
- Material conversion for particle shaders, particle systems, trail renderers and line renderers.
Avatar Converter Settingsnow warns when a MA Sync Parameter Sequence or AAO Trace and Optimize component is missing on the avatar, with a button to add it.- [NDMF] Preview for
Platform GameObject Remover. Renderers under GameObjects to be removed are hidden for the target platform. - Added
Enable Debug Logmenu underTools/VRCQuestTools/Settingsto enable verbose debug logging in real projects.
Changed
- NDMF material conversion previews now appear immediately and finish compressing in the background, so the editor no longer freezes while a preview regenerates.
- Texture compression for ASTC formats now uses the bundled astcenc encoder (Windows/Linux) or a system-installed astcenc (macOS), running on all CPU cores. When astcenc is not available, the previous Unity compressor is used as before.
- Avatar Dynamics Selector now stores keep/remove settings in
Platform Component Removerinstead of the legacy arrays inAvatar Converter Settings. Applying the selector migrates settings and clears the legacy arrays to avoid stale references. - Added a button in PhysBones Remover to apply current keep/remove selections to
Platform Component Remover. - Grouped the component list in Avatar Dynamics Selector and PhysBones Remover by prefab.
- Optimized Avatar Dynamics performance estimation timing in
Avatar Converter Settingsinspector. - Manual conversion from
Avatar Converter Settingsnow keeps the original avatar active and places the converted avatar offset along world +Z from the original avatar. - Changed the initial value of default material conversion settings to Toon Standard.
- Improved the appearance when converting lilToon normal mode MatCap to Toon Standard.
- Unsupported materials to be processed are no longer warned in
Avatar Converter SettingsandMaterial Conversion Settings. - Turned off Auto Referenced in asmdef.
- Improved error messages when converting unsupported lilToon materials.
- Changed to show an error when converting an avatar that uses an unsupported Modular Avatar.
- Changed to use
.vqtmeshasset to remove vertex color in avatar conversion instead of usingVertex Color Removercomponent. - [NDMF] Show an error dialog then abort the build when using unsupported version of NDMF.
- [NDMF] Enabled preview for
Mesh Flipperby default. - Unified Android/iOS terminology to "Mobile" in user-facing strings and UI elements. Android-specific terminology is retained for Unity Build Support settings and internal APIs.
- Manual conversion from
Avatar Converter Settingsnow appliesPlatform GameObject Removersettings and removes marked GameObjects for Android. Convert Avatar for Mobileno longer auto-attachesVQT Network ID Assigner; use the newAssign Network IDsoption inAvatar Converter Settingsadvanced settings instead.- Integrated menu icon settings into
Avatar Converter Settings, and aligned NDMF icon processing withVQT Menu Icon Resizer. - Renamed
Convert Avatar for MobiletoSetup Avatar for Mobileand updated setup to use availability-aware MA/AAO options with disabled already-added items andMA Sync Parameter SequencedefaultingPrimaryPlatformtoPC. - Improved
Avatar Converter Settingsinspector layout.
Fixed
InvalidMaterialSwapNullExceptiondid not properly return the invalid mapping.- Fixed RenderTexture and Material memory leaks in texture generation pipeline during avatar conversion.
- Fixed an issue where texture generation failed when a material used an un-rendered RenderTexture as a texture.
- Limited stack trace lines shown in avatar conversion failure dialog to keep the dialog operable.
- Fixed lilToon to Toon Standard conversion producing overly dark results by deriving occlusion strength from the lilToon shadow colors instead of always applying full-strength occlusion.
- Fixed lilToon to Toon Standard conversion computing gloss/metallic strength from the un-linearized (gamma-space) Reflection Color, which also caused Metallic to be inadvertently gamma-decoded a second time.
Removed
- Removed support for Unity 2019.
- Removed support for VRCSDK earlier than 3.9.0.
- Removed support for lilToon earlier than 1.10.0.
- Removed support for NDMF earlier than 1.5.0.
- Removed VQT Avatar Builder window. Use VRChat SDK Control Panel to build and upload avatars directly, or use the "[NDMF] Build and Test for PC with Android Settings" context menu for local testing.
2.11.7 - 2026-06-27
Fixed
- Fixed an issue where emission may not be applied when converting Poiyomi materials to Toon Lit in some cases.
2.11.6 - 2026-04-29
Fixed
- Fixed an issue where UV tiling (texture scale and offset) of the main texture was not preserved when converting lilToon or Poiyomi materials to Toon Lit.
- Fixed an issue where UV tiling of the main texture, emission map, and occlusion map was not preserved when converting lilToon materials to Toon Standard.
2.11.5 - 2026-01-23
Fixed
- [NDMF] Fixed missing "Streaming Mip Maps" configuration for VQT_Shared_Black textures.
- [NDMF] Fixed VQT_Shared_Black texture not being shared across multiple materials.
2.11.4 - 2025-10-10
Fixed
- Fixed so that lilToon Main Color 2nd/3rd textures are not baked into the main texture when they use UVs other than UV0.
- Fixed an issue where lilToon Main Color 2nd/3rd, when used as decal and animated, were not correctly baked into the main texture. (Requires lilToon 2.3.0 or later)
2.11.3 - 2025-08-17
Fixed
- Fixed an issue where lilToon emission was not correctly converted to Toon Standard.
- Emission was not applied when only Emission 2nd was used.
- Emission became too weak when the main color power was high.
2.11.2 - 2025-08-16
Fixed
- Fixed an issue where materials with emission disabled, when converted to Toon Standard, could unintentionally show emission due to animations.
- Fixed compiler warnings that appeared with NDMF 1.8.0 and later.
2.11.1 - 2025-07-26
Added
- Support for lilToon 2.0.0 and later.
2.11.0 - 2025-06-22
Added
- Settings menus. (by @Tliks)
- Enable Validation Automator
- Enable Texture Format Check on Windows Build
- Help menu to open the documentation site.
Changed
- [NDMF] No longer check texture formats on Windows build target by default. (by @Tliks)
Fixed
- Incorrect indent of Material Replacement settings inspector.
2.10.1 - 2025-06-02
Fixed
- Fixed an issue where Toon Standard min brightness was not set when lilToon did not use shadow. (by @nekobako)
2.10.0 - 2025-05-31
Added
- Toon Standard conversion settings. (VRCSDK 3.8.1 or later)
- There are following limitations:
- Only supports lilToon 1.10.0 and later. For unsupported materials, Toon Lit main texture is only used.
- Missing rim lighting mask. This might lead overbright rim lighting.
- There are following limitations:
- Texture compression format option for converted textures.
- Improved
MA Convert Constraintsintegration.- Add the component when using
Begin Converter Settingsbutton ofAvatar Converter for Android. - Do not remove Unity constraints when
MA Convert Constraintsexists in following situation. (VRCSDK 3.8.1 or later)- Manual conversion.
Unsupported Componentswindow.
- [NDMF] Add the component when build an avatar for mobile platforms with
VQT Avatar Converter Settings.
- Add the component when using
- [NDMF] Add
Autooption to NDMF Phase inVQT Avatar Converter SettingsandVQT Material Conversion Settingscomponents.- This option automatically sets the phase based on the current avatar.
- Default: Optimizing Phase
- VRCFury components exist: Transforming Phase
- This option automatically sets the phase based on the current avatar.
- [NDMF] Added Overall NDMF Mesh Simplifier in the execution order constration.
Changed
- Changed default compression format of
VQT Menu Icon Resizerto ASTC 8x8. - Removed experimental status of
VQT Material Conversion Settings,VQT Material Swap, andVQT Mesh Flippercomponents. - [NDMF] Default NDMF Phase in
VQT Avatar Converter SettingsandVQT Material Conversion Settingscomponents is changed toAuto.
Fixed
- Undo for following operations:
Begin Converter Settingsbutton ofConvert Avatar for Androidwindow.- Component addition in
VQT Avatar Converter Settingsinspector. VQT Vertex Color Removercomponent addition byRemove All Vertex Colorsmenu.
Changed from 2.10.0-beta.5
- Require VRCSDK 3.8.1 or later for Toon Standard conversion.
- Fixed an issue where parameters other than main textures were not applied when converting to Toon Lit.
- Fixed an isuee where metallic smoothness maps were not properly generated.
- [NDMF] Added Overall NDMF Mesh Simplifier in the execution order constration.
2.10.0-beta.5 - 2025-05-29
Changed
- Improved Toon Standard conversion.
- Generate occlusion map when AO map is used in lilToon.
- Improved normal MatCap conversion.
- Convert HDR color to LDR in emission map conversion.
Fixed
- Missing emission map of Toon Standard when lilToon material uses emission mask only.
2.10.0-beta.4 - 2025-05-26
Added
- [NDMF] Add
Autooption to NDMF Phase inVQT Avatar Converter SettingsandVQT Material Conversion Settingscomponents.- This option automatically sets the phase based on the current avatar.
- Default: Optimizing Phase
- VRCFury components exist: Transforming Phase
- This option automatically sets the phase based on the current avatar.
Changed
- Toon Standard mask textures are packed into a single texture as well as possible.
- Improved metallic map and gloss map conversion for Toon Standard materials.
- Removed experimental status of
VQT Material Conversion Settings,VQT Material Swap, andVQT Mesh Flippercomponents. - [NDMF] Default NDMF Phase in
VQT Avatar Converter SettingsandVQT Material Conversion Settingscomponents is changed toAuto.
Fixed
- Tiling and offset of converted Toon Standard textures not applied.
- Normal map
- Mask textures
2.10.0-beta.3 - 2025-05-24
Added
- Improved
MA Convert Constraintsintegration.- Add the component when using
Begin Converter Settingsbutton ofAvatar Converter for Android. - Do not remove Unity constraints when
MA Convert Constraintsexists in following situation. (VRCSDK 3.8.1-beta.1 or later)- Manual conversion.
Unsupported Componentswindow.
- [NDMF] Add the component when build an avatar for mobile platforms with
VQT Avatar Converter Settings.
- Add the component when using
Changed
- Apply following parameters to converted Toon Standard materials.
- MatCap color alpha.
- MatCap main color power.
- Rim lighting color alpha.
Fixed
- Aspect ratio not kept when converting textures for Toon Standard.
- Unexpected shadow ramp when converting materials which don't use shadow to Toon Standard.
- Undo for following operations:
Begin Converter Settingsbutton ofConvert Avatar for Androidwindow.- Component addition in
VQT Avatar Converter Settingsinspector. VQT Vertex Color Removercomponent addition byRemove All Vertex Colorsmenu.
2.10.0-beta.2 - 2025-05-20
Fixed
- Fixed an issue where an error would occur in the Update Converted Android Textures button of
VQT Avatar Converter Settingswhen using materials other than lilToon.
2.10.0-beta.1 - 2025-05-19
Added
- Toon Standard conversion settings. (VRCSDK 3.8.1-beta.4 or later)
- Currenly there are following limitations:
- Only supports lilToon 1.10.0 and later. For unsupported materials, Toon Lit main texture is only used.
- Missing rim lighting mask. This might lead overbright rim lighting.
- Unoptimized mask textures. This may lead increased build size.
- Currenly there are following limitations:
- Texture compression format option for converted textures.
Changed
- Changed default compression format of
VQT Menu Icon Resizerto ASTC 8x8.
2.9.2 - 2025-05-17
Added
- [NDMF] Message to tell the user can use VRCSDK Control Panel to directly upload the avatar at VRCSDK 3.8.1-beta.1 or later.
Changed
- Use the Android shader whitelist of VRCSDK. (by @KaoruBoy)
- Toon Standard shader becomes an allowed shader for Android.
- [NDMF] Timing for the message to confirm "Copyright ownership agreement" when uploading with
VQT Avatar Builderat VRCSDK 3.8.1-beta.2 or later.
2.9.1 - 2025-05-06
Fixed
- Material Replacement accidentally shown in the default material conversion settings.
- [NDMF] Upload progress not properly reset when starting a new upload in
VQT Avatar Builder.
2.9.0 - 2025-04-28
Added
- Feature to check the installation of Android Build Support.
Remove Avatar Dynamicsoption toVQT Avatar Converter Settingscomponent.- [NDMF]
VQT Material Conversion Settingscomponent to set material conversion settings. - [NDMF] Add
NDMF Phaseoption toVQT Mesh Flippercomponent.- Before Polygon Reduction
- After Polygon Reduction
- [NDMF] NDMF Preview for
VQT Mesh Flipper(disabled by default).
Changed
- [NDMF]
VQT Material Swapworks withoutVQT Avatar Converter Settings. - [NDMF]
VQT Mesh Flipperworks in the optimizing phase by default.
Fixed
- Inactive animator's animator controllers not converted.
- Unexpected error logs in
VQT Avatar Converter Settingsinspector. - Avatar conversion error when a Mesh Filter is not attached to a Mesh Renderer game object.
2.8.3 - 2025-04-08
Added
- Error case for missing materials in
VQT Material Swapcomponent. - [NDMF] Message to confirm "Copyright ownership agreement" when uploading with
VQT Avatar Builder.
Fixed
- Unhandled exception when replaced material is not set in
VQT Avatar Converter Settings. - [NDMF] Animation conversion error not reported to the NDMF Console.
- [NDMF] Material conversion error detail was wrongly reported in the NDMF Console.
2.8.2 - 2025-04-01
Fixed
- MatCap Lit conversion not working.
2.8.1 - 2025-03-31
Changed
- Allow to directly set target materials in the additional material conversion settings of
VQT Avatar Converter Settings. - Stopped multiplexed texture generation process and changed it to be processed sequentially as in version 2.7.2.
Fixed
VQT Menu Icon Resizerwas added in manual conversion when NDMF was not installed.- Error when converting VirtualLens2 materials.
- [NDMF] Error when there was no mesh for
VQT Mesh Flipperto target. - [NDMF] Error when the same replacement material was set multiple times in
VQT Material Swap.
2.8.0 - 2025-03-16
Added
- Feature to configure
VQT Menu Icon Resizerduring manual conversion whenVQT Avatar Converter Settingsis set to compress menu icons. - Cache to accelerate the texture generation process.
- VRCQuestTools Settings screen to Unity preferences.
- [NDMF] Support offline testing on Android in VQT Avatar Builder.
Changed
- Accelerated the texture generation process.
- Accelerated the texture generation process for lilToon materials.
- Accelerated the type resolution for optional dependencies.
- [NDMF] Disabled "Read/Write Enabled" for generated textures.
Fixed
- [NDMF] Fixed an issue where an exception would occur when building an avatar for a build target not supported by VRCSDK.
2.7.2 - 2025-03-02
Added
- Support to convert Animator Override Controllers.
Fixed
- Fixed an issue where the original Blend Tree was deleted when converting a Blend Tree embedded in an Animator Controller.
- Fixed an issue where a converted Blend Tree embedded in an Animator Controller was not saved properly afterward.
2.7.1 - 2025-02-26
Changed
- Reverted the texture generation process in Unity 2019 to be the same as in versions prior to 2.6.2.
2.7.0 - 2025-02-25
Added
- [NDMF] Feature to control operational area of
VQT Mesh Flipperby mask textures. - [NDMF] (Experimental)
VQT Material Swapcomponent to swap materials on Android build. (by @Amoenus) - [NDMF]
VQT Menu Icon Resizercomponent to resize menu icons for Android build. - [NDMF] Ability to track when materials subject to Additional Material Conversion Settings have been modified by other plugins.
- Error for unsupported materials in Material Replacement settings.
- Feature to remove extra material slots in the
VQT Avatar Converter Settingscomponent. - Feature to compress menu icons in the
VQT Avatar Converter Settingscomponent. - Feature to convert materials which use lilToon custom shaders. (as well as regular lilToon materials)
- Support for local-only contact senders.
Changed
- Accelerated the texture generation process.
- [NDMF]
VQT Mesh Flipperworks beforeNDMF Mantis LOD Editorin the transforming phase.
2.6.2 - 2025-01-21
Fixed
- Failed to convert lilToon FakeShadow materials.
2.6.1 - 2025-01-19
Added
- Additional information to logs when incorrect material property type is detected in lilToon baking.
Fixed
- Fixed an issue where an error would occur when right-clicking on the hierarchy without selecting a GameObject.
- Fixed an issue where nested Blend Trees were not converted properly.
- Invalid localization files. (by @Amoenus)
2.6.0 - 2024-12-14
Added
- Support for local-only contact receivers.
- Buttons to back to the scene in warning about prefab stage.
- [NDMF] (Experimental)
VQT Mesh Flippercomponent to flip the mesh of the avatar. - [NDMF]
[NDMF] Manual Bake with Android Settingsmenu to the right-click menu of the avatar. - [NDMF] Feature to select an avatar to upload in the
VQT Avatar Builder. - [NDMF] Messages and a dialog to suggest to use
MA Convert Constraintscomponent and non-destructive conversion.
Changed
- [NDMF] Check texture format after TexTransTool.
- [NDMF] Change the inspector of
VQT Avatar Converter Settingsto prioritize non-destructive conversion. - [NDMF] Convert avatars after lilycalInventory in the transforming phase.
Fixed
- Fallback for untranslated phrases not working.
- Fixed an issue where inactive Avatar Dynamics components were not selected by default in
VQT Avatar Converter Settings. - [NDMF] Fixed an issue where unsupported components were removed when using Android build target even if the avatar was not converted.
2.5.5 - 2024-11-16
Fixed
- [NDMF] ArgumentNullException on play mode when the avatar has a newly created Pipeline Manager.
- [NDMF] Fixed an issue where the plugin might fail to load textures which were generated by other plugins.
2.5.4 - 2024-10-09
Changed
- Use same UI layout for Avatar Dynamics Selector and PhysBones Remover.
Fixed
- Missing column for root transform in the Avatar Dynamics Selector.
- [NDMF] Error in the texture format check when the avatar has no expression menu.
2.5.3 - 2024-10-06
Changed
- Rewrite the duplication process of animator controllers.
- This makes better duplication for complicated animator controllers.
Fixed
- Conversion error of FX layers which use GoGo Loco.
2.5.2 - 2024-09-25
Fixed
- [NDMF] Stack overflow error when using recursive expressions menu.
2.5.1 - 2024-09-23
Changed
- [NDMF] Speed up texture format checking.
Fixed
- Accidentally modified original animator controllers when they have wrong object references.
- [NDMF] Failed to convert animator controllers which have sub state machines in some cases.
2.5.0 - 2024-09-07
Added
VQT Network ID Assignerworks without NDMF.- Add
NDMF Phase to Convertoption toVQT Avatar Converter Settingscomponent.- Transforming
- Optimizing
- New localization mechanism based on .po files.
- Russian (Русский) translation. (by @CoderCoV)
- [NDMF] Warning when an avatar which has
VQT Avatar Converter Settingsdoesn't haveVQT Network ID Assigner.
Changed
Convert Avatar for Androidwindow attachesVQT Network ID Assignerto the avatar.- [NDMF] Changed the default execution order of the avatar conversion process to match the behavior prior to 2.4.3 (Transforming).
Removed
- Warning about unassigned Network IDs.
2.4.3 - 2024-08-25
Changed
- Texture generation now uses Unity's imported textures when using other than PNG or JPEG.
- [NDMF] Convert avatars in the optimizing phase for TexTransTool interoperability.
Fixed
- [NDMF] VQT Avatar Builder might put an error when launching Unity.
- [NDMF] Error when replacing multiple materials with the same one in material conversion settings.
- [NDMF] Texture generation error when a material uses other than PNG or JPEG textures.
- [NDMF] Exception occured in the preview configuration window of NDMF 1.5.0 when reloading scripts. (by @ReinaS-64892)
2.4.2 - 2024-08-16
Removed
- Button to convert Unity constraints to VRChat constraints in
VQT Avatar Converter Settings.
2.4.1 - 2024-08-15
Added
- Error message that the converter can't perform in the prefab mode.
Fixed
- [NDMF] Known texture formats were reported as unknown texture formats when using unsupported texture formats for the current platform.
2.4.0 - 2024-08-14
Added
- Support for iOS platform (as well as Android).
- Add warning to suggest converting Unity constraints to VRChat constraints in
VQT Avatar Converter Settings. - [NDMF] Feature to set as a fallback avatar in the VQT Avatar Builder.
- [NDMF] Logo to the NDMF Console.
Changed
MA Visible Head AccessoryandMA World Fixed Objectcomponents are no longer removed when using Modular Avatar 1.9.0 or later.- [NDMF] Changed to display a warning instead of an error when unknown texture formats are used.
- [NDMF] Changed to not check texture formats on unsupported platforms.
Fixed
- Compilation error when using VRChat SDK 3.6.2-constraints.3 or later.
2.3.5 - 2024-07-27
Fixed
- Fix
VQT Avatar Converter Settingsnot working when Final IK exists.
2.3.4 - 2024-07-17
Fixed
- Fix an issue where
Audio Sourcemight not be removed when removing unsupported components.
2.3.3 - 2024-06-03
Changed
- Improved error message when failed to convert lilToon material.
Fixed
- Material animation might not be converted in some cases.
2.3.2 - 2024-05-27
Fixed
- [NDMF] VQT Avatar Builder failed to detect active avatars when multiple scenes are loaded in the hierarchy.
- Automated avatar validation was not working for all avatars when multiple scenes are loaded in the hierarchy.
2.3.1 - 2024-05-09
Fixed
- [NDMF] Fixed an issue where entry transitions for sub state machines were not duplicated correctly when duplicating animator controllers.
- Fix an issue where material animations of sub state machines were not converted.
2.3.0 - 2024-05-05
Added
- [NDMF]
Show Avatar Builder for Androidmenu to upload an avatar for Android build target with NDMF. - [NDMF] Non-destructive avatar conversion with
VQT Avatar Converter Settingscomponent. - [NDMF]
VQT Platform Target Settingscomponent to specify the target platform forVQT Platform Component RemoverandVQT Platform GameObject Removercomponents. - [NDMF] Warning message for using unsupported texture formats.
- [NDMF]
VQT Network ID Assignercomponent to assign Network IDs to the avatar.
Changed
- [NDMF] Duplicate meshes when removing vertex colors. Original meshes keep vertex colors.
- Invert the meaning of checkboxes for
VQT Platform Component RemoverandVQT Platform GameObject Removercomponents. Select checkboxes to keep components or objects.
Removed
- [NDMF]
Build Targetparameter fromVQT Platform Component RemoverandVQT Platform GameObject Removercomponents.
Fixed
- Small textures were generated as 2x2 instead of 4x4 so they were not properly compressed.
2.2.2 - 2024-04-15
Fixed
- Fixed color adjust mask not applied to the converted texture when using lilToon shader.
2.2.1 - 2024-03-29
Added
- Added description for
VQT Platform Component Remover,VQT Platform GameObject RemoverandVQT Vertex Color Removercomponents.
Fixed
- Fixed an issue where the converter fails when the avatar object name ends with dots.
2.2.0 - 2024-02-09
Added
- Add
VQT Platform GameObject Removercomponent to remove game objects depending on the build platform (NDMF is required). - Add warning when using NDMF-required components but NDMF is not installed.
- Add component icon (Unity 2022).