Prefabulous

2.2.0

• Add language selector to the Recalculate Normals and Generate Twist Bones components, for Japanese.
• All Prefabulous Universal components now have a clickable help URL in the inspector.
• If NDMF 1.8 is installed:
  • Add support for Modular Avatar for Resonite.
  • Generate Twist Bones will now generate Unity Constraints instead of VRC Constraints when targeting a non-VRChat platform.
  • Add support for building for other platforms than VRChat and Resonite.

2.2.0-beta.1

• All Prefabulous Universal components now have a clickable help URL in the inspector.
• If NDMF 1.8 is installed:
  • Add support for Modular Avatar for Resonite.
  • Generate Twist Bones will now generate Unity Constraints instead of VRC Constraints when targeting a non-VRChat platform.
  • Add support for building for other platforms than VRChat and Resonite.

2.2.0-alpha.0

Support Modular Avatar for Resonite:

• Add support for cross-application build compatibility being introduced in NDMF 1.8.
• Conditionally compiled when NDMF 1.8.0-alpha.0 is installed:
  • Prefabulous Universal still needs to be compatible with VNyan (Unity 2020) and Warudo (Unity 2021), meaning we still need to support NDMF 1.4 (last known working version in Unity 2020).

2.1.0

• Modify the behaviour of Generate Twist Bones on VRChat projects:
  • If VRChat 3.7.0 or above is installed in the project, we will generate a VRC Aim Constraint component instead of a Unity Aim Constraint.
• To try resolving an execution ordering issue with VRCFury, Delete Polygons, Assign UV Tile, and Replace Textures no longer run in the Optimizing phase.

2.1.0-beta.4

• To try resolving an execution ordering issue with VRCFury, Delete Polygons, Assign UV Tile, and Replace Textures no longer run in the Optimizing phase.

2.1.0-beta.3

• Remove Convert back to Unity Constraints (inter-release):
  • Convert back to Unity Constraints is being moved to a specialized package, to separate Conversion tooling from Universal tooling.

2.1.0-beta.2

☀️ New component: Convert back to Unity Constraints

A new component, Convert back to Unity Constraints, has been added to Prefabulous Universal.

It converts VRC Constraint components back to native Unity Constraints, to the extent applicable.

• VRC-specific features (local axis, freeze to world) are not supported.
• The VRChat SDK assemblies and DLLs do not need to be installed in the project, as long as the types exist, so they could be mere stubs.

2.1.0-beta.1

• Modify the behaviour of Generate Twist Bones on VRChat projects:
  • If VRChat 3.7.0 or above is installed in the project, we will generate a VRC Aim Constraint component instead of a Unity Aim Constraint.

2.0.3

• Compilation should no longer fail in non-VRChat projects that still have the VRC_SDK_VRCSDK3 scripting define around.
  • Components now extend VRChat's IEditorOnly class only if the VRChat Avatars SDK is installed.
• Delete Polygons should now run before AAO.

2.0.2

Fix Assign UV Tile "Entire Mesh" no longer fails to process meshes that were set to EditorOnly.

2.0.1

Hide all Prefabulous icons from the scene in Unity 2022 or above.

2.0.0 Prefabulous Universal

Prefabulous has been split into:

• Prefabulous Universal (this page)
• Prefabulous for VRChat
• Prefabulous for VRM

See update page.

1.11.2

Fix Prefabulous was not able to compile because it was using a deprecated define VRC_SDK_VRCSDK3 that was missing on some users' projects.

1.11.1

Fix Generate Twist Bones help URL no longer points to localhost.

1.11.0

☀️ New component: Generate Twist Bones (Alpha)

A new component, Generate Twist Bones (Alpha), has been added to Prefabulous.

This component will generate twist bones, which improves the look of the elbow joint by twisting the part of the lower arm that is closer to the elbow.

It creates new twist bones with constraints, and automatically repaints the bones weights of all meshes of the avatar which use that bone.

警告

🚧🚧🚧 This component is currently in an alpha phase. 🚧🚧🚧

At the moment, it only fully supports meshes that are part of the base mesh armature.

The current version will not be able to generate twist bones for additional meshes used by VRCFury Armature Link, and may not be able to generate twist bones for additional meshes used by Modular Avatar Merge Armature.

Both are intended to be supported in the future, but it's significantly harder to do so. The component is still released in this state of development as it is beneficial for the bare skin of your avatar.

Thank you for your understanding.

1.10.3

Fix Replace Textures should no longer ignore disabled objects.

1.10.2

This is a technical update for Prefabulous:

• This version now requires Modular Avatar V1.9.9 minimum.
• Modular Avatar V1.9.9 requires NDMF V1.4.0 minimum.
• Integrate Import Expression Parameters with Modular Avatar Information.
  • The number of synced bits used by Import Parameters is now shown in the Modular Avatar Information panel.

1.10.1

Three new components have been added to Prefabulous.

☀️ New component: Replace Textures

This component lets you upload multiple versions of your avatar but with different textures, without needing to duplicate the materials.

It also displays which materials use which textures, although you could also be using lilAvatarUtils for this.

☀️ New component: Convert Blendshape Conventions

This component lets you convert blendshapes from one naming convention to another naming convention, such as converting Unified Expressions blendshapes to ARKit blendshapes.

☀️ New component: Mass Blendshape Sync

This component will synchronize all blendshapes that two meshes share in common.

This is ideally used with renderers that have a massive quantity of blendshapes that need to be synced, such as face tracking.

Other

• All Prefabulous components will now be removed after baking, so that uploading a baked avatar will not bake them twice.
• Blank Gesture Animator now generates one animator layer that VRChat requires, instead of zero layers.
• The dependency to "Animator As Code - NDMF Processor (Alpha)" has been removed.
• Don't warn when using NDMF 1.4.x
• Don't warn when using Modular Avatar 1.9.x

1.9.1

• Update dependencies to allow NDMF 1.3

1.9.0

Update Assign UV Tile

Add "Entire Mesh" mode to "Assign UV Tile":

• UV Tile can now be assigned to an entire MeshRenderer or SkinnedMeshRenderer.
• There is now a mode selection between BlendShapes and EntireMesh.
• If a mesh is used by both a EntireMesh component and a BlendShapes component, EntireMesh is applied first, so that the BlendShapes components can further refine into other UV tiles.

(NDMF Compatibility) Make sure UV Tile assignments are done before any large scale mesh optimization causes a loss of reference:

• Delete Polygons now runs before com.anatawa12.avatar-optimizer
• Assign UV Tile now runs before com.anatawa12.avatar-optimizer

ヒント

"Entire Mesh" should be used alongside an avatar optimization tool that will merge existing meshes, such as d4rkpl4y3r's d4rkAvatarOptimizer or anatawa12's AvatarOptimizer.

Prefabulous does not provide any mesh optimization components that rectifies animation paths at this time.

1.8.0

Update Recalculate Normals

Recalculate Normals should now properly work on avatars that were not posed like the model, or had a different orientation than the model.

1.7.1

Assign UV tile has been rectified to work with shaders like SCSS that expect the UVs to be shifted rather than overridden.

This patch was pushed before any 1.7.0 social media announcement.

1.7.0

☀️ New component: Assign UV Tile

A new component, Assign UV Tile, has been added to Prefabulous.

Sets the UV Tile of vertices that are moved by a blendshape.

This is meant to be used in tandem with shader features, especially Poiyomi Toon UV Tile Discard, and may also be used with SCSS's Inventory System.

Technical notes

Add Assign UV Tile:

• Assign UV Tile will change the UVs of vertices moved by a blendshape.
• This component is built to closely match Poiyomi "UV Tile Discard" feature.
• It uses the same vertex selection algorithm as Delete Polygons.
• The UV tile has an offset of 0.5.

Update Delete Polygons

Delete Polygons now has Keep Partial Polygons option:

• Add "Keep Partial Polygons" option.
• When "Keep Partial Polygons" is enabled, vertices of blendshapes that are marked as such will be preserved if that vertex is still connected to a triangle that has at least one vertex that is not deleted.
• In effect, this preserves polygons that are still connected to the rest of the mesh.
• This might help with some avatar models that rely on the conflict prevention blendshape to intersect polygons with clothing.

1.6.0

☀️ New component: Delete Polygons

A new component, Delete Polygons, has been added to Prefabulous.

Delete polygons affected by conflict prevention blendshapes, and other unused decorations hidden inside the mesh (such as star-shaped eyes and other eye decorations; piercings, bandages, and other accessories).

Technical notes

Add Delete Polygons:

• Delete Polygons will delete polygons associated with moved vertices of a blendshape.
• It will not delete polygons if the vertex of that blendshape is not moved, even if the normal or tangent changes.
• Portions of d4rkpl4y3r's https://github.com/d4rkc0d3r/d4rkAvatarOptimizer (MIT License) is used as a reference for the mesh reconstruction.

Other

Make Recalculate Normals editor animator introspection aware of Prefabulous components:

• Recalculate Normals editor introspects animators from the descriptor, however, it was not aware of Prefabulous Blank/Replace Animator components.
• It no longer introspects playable layers affected by Blank Animator components.
• It no longer introspects playable layers affected by Replace Animator components.
• It now introspects the controllers from Replace Animator components.

Special thanks

• d4rkpl4y3r for the references on mesh reconstruction!

1.5.0

☀️ New component: HaiXT Generate Blendshapes for Face Tracking Extensions

A new component, HaiXT Generate Blendshapes for Face Tracking Extensions, has been added to Prefabulous.

If you have an avatar that already supports face tracking, this will generate additional non-standard blendshapes for use with HaiXT Face Tracking Extensions.

When your eyes are closed, the shape of your eyes will change when you're smiling.

Fixes

• Try to fix compatibility issues with Unity 2019.

Technical notes

Add Generate Blendshapes for Face Tracking Extensions:

• Generate Blendshapes for Face Tracking Extensions can add extension blendshapes to avatar that already support face tracking.
• Add support for generating the HaiXT_EyeClosedInverse_Smile blendshapes.
• The blendshapes will be generated only under these conditions:
  • the face mesh must be called Body, and
  • the avatar must already have EyeClosedLeft or EyeClosedRight blendshapes, and
  • the avatar must NOT already have the HaiXT_EyeClosedInverse_SmileLeft or HaiXT_EyeClosedInverse_SmileRight blendshapes
• All of these evaluations are done right before this NDMF handler executes:
  • These conditions do not need to be true during Edit mode.
  • A non-destructive processor running before this NDMF handler may still be able to cause these conditions to pass, or conversely, invalidate it.

In addition:

• Recalculate Normals NDMF handler is now constrainted to run after PrefabulousHaiGenerateBlendshapesFTEPlugin.

1.4.0

Update Recalculate Normals

Recalculate Normals now has Erase Custom Split Normals option:

• Add "Erase Custom Split Normals" option.
• When "Erase Custom Split Normals" is enabled, the recalculation will perform a second pass where all vertices that have a non-zero delta pos or a non-zero recalculated delta normals will have new deltas calculated: instead of calculating the difference from the base recalculated mesh, it will calculate the difference from the original mesh.
• In effect, this erases custom split normals data for that blendshape.
• Since this only affects some vertices (non-zero delta pos or a non-zero recalculated delta normals), this prevents incorrect delta normals from contaminating unrelated vertices in the mesh.

危険

Enabling Erase Custom Split Normals can lead to worse results in meshes that don't have custom split normals.

Only give this a try on blendshapes where shading defects are clearly visible only after you've tried Recalculate Normals first without this option.

In all other cases, keep this option off!

For more details, please consult the Erase Custom Split Normals documentation.

Update Change Avatar Scale

Change Avatar Scale now uses the Avatar Descriptor view position as the source size:

• ChangeAvatarScale reads the Avatar Descriptor view position Y coordinate and uses it as the source size.
• This is now the default behaviour.
• Old behaviour can be restored by checking "Custom Source Size".

Fixes

• Edit Mesh Anchor Override: Fix NDMF PrefabulousEditAllMeshAnchorOverridePlugin build step is now correctly named "Edit Mesh Anchor Override".
• Update Recalculate Normals conflict prevention filter to include "hidemesh_".
• Fix Recalculate Normals will no longer process the same blendshapes multiple times when they are specified multiple times.

1.3.0

☀️ New component: Recalculate Normals

A new component, Recalculate Normals, has been added to Prefabulous.

This component improves the shading of SkinnedMeshRenderers by recalculating select blendshape normals (and tangents).

Technical notes

• Recalculate Normals will recalculate select blendshape normals of SkinnedMeshRenderers (and tangents).
• Blendshape delta normals (and tangents) are usually zero on avatar uploads.
  • This may cause the avatar shading to look abnormal, especially on blendshapes that flatten part of the body, or significantly push it out.
• This component attempts to recalculate normals of individual blendshapes by doing the following:
  • Bake a static mesh of a SMR mesh when 0 blendshapes are running
  • Build a data structure describing vertices that have same position and normal
  • Use RecalculateNormals. This is done even when 0 blendshapes are active, so that the delta is calculated based on Unity's judgement of what's the normal data at rest.
  • Using that previous data structure, rebuild normal data by averaging and renormalizing vertex normals that had the same position and normal
    • This is done to fix an issue where an artist-authored vertex is part of an UV seam, causing the mesh data to split that vertex into multiple, effectively causing the RecalculateNormals output to have different normals for that vertex.
  • Use RecalculateTangents.
  • Do all of the above again for each blendshape to recalculate, and use that to calculate a delta normal and a delta tangent.
  • Once all blendshapes are processed, effectively rewrite all of the mesh blendshapes with these modifications.

1.2.1

• Fix a compatibility issue with Unity 2022
• Allow installation with VRChat Avatars SDK 3.5.x

1.2.0

First public experimental release.