Njaecha/BlendshapeCreator
Watch
1
0
Fork
You've already forked BlendshapeCreator
 0
Code Issues Pull requests Projects Releases 4 Packages Wiki Activity Actions
4 releases 4 tags
  • v2.0-beta cdf6d7868b

    Blendshape Creator v2.0 Beta Pre-release

    Njaecha released this 2026-08-16 20:55:01 +00:00 | 5 commits to master since this release

    Releasing this as a public beta first since it has some experimental features.

    Major News:

    Outfit aware BlendShapes

    What does this mean?

    • Previously BSC's BlendShapes did only remember what item or character they are on and that the path to their renderer is. This meant that if the same renderer shows up in multiple outfits on a character there was no way to differentiate them. This was changed.

    What is new?

    • A BlendShape created on a piece of clothing or accessory will no longer leak into different outfits using the same clothing or accessory in the same slot.
    • BlendShapes can now be transferred between outfits by copying the clothing or accessory between outfit slots.
    • BlendShapes on accessories are correctly copied when transferring accessories between slots on the same outfit.
    • BlendShapes are correctly removed from the characters data when switching/removing clothing or accessories, to prevent stale data in the card.

    But most importantly:

    BlendShapes put on clothing pieces or accessories are saved and loaded from coordinate cards.

    Additional notes:

    • This new system means every BlendShape now has an "owner". Infos about each BlendShapes owner can be seen in the "Show Blendshapes Data" menu.
    • Important: Data from previous versions of the Plugin is NOT automatically migrated to have an owner to prevent miss-allocation. If you have characters that use BlendShapes and you want above features please open the "Show Blendshapes Data" menu and click the "Try migrate" button on each BlendShape that should belong to the current outfit slot. When all BlendShapes have been migrated save the card.

    Static mesh conversion (experimental)

    What does this mean?

    • In Unity, BlendShapes can only be displayed by a SkinnedMeshRenderer (SMR). Static meshes (that do not have skinning data (bones)) have previously been excluded from BSC. A new system has been introduced to remedy this.

    What is new?

    • Selecting a static renderer (indicated in yellow) in BSC will now show a new button: "Convert to Skinned". Clicking this will set the mesh up with a SMR and the entry becomes editable like any normal skinned entry.
    • This system is designed to be as transparent as possible to the game and to other plugins. The materials are shared to the added SMR and any settings done to the normal MeshRenderer are relayed to the SMR via another added adapter component.

    In short:

    Accessories and Studio-Items that have previously been marked yellow and could not be used with BSC are not eligible to be customized with BlendShapes!

    Notes:

    • Any renderer converted to skinned with this method will show up twice in Material Editor, once as the normal and once as the skinned variant. I recommend doing edits (enabling, changing shadow casting mode) to the unskinned variant, as changed done to the skinned variant are not automatically synced back the normal one and get lost should you revert the renderer back to unskinned.
    • Because this feature robs the MeshFilter, which holds the mesh on unskinned objects, of its mesh and gives it to the SMR, there might be compatibility problems with other plugins that need to access the mesh and expect it to be in the MeshFilter. It should not be hard for authors of such plugins to prioritize SMRs or look for the unique adapter component, so if you notice problems please let us know!

    Vanilla Blendshape editing (via API only):

    What does this mean?

    • Previously it was only possible to ADD new blendshapes, not overwrite already existing blendshapes. This is now possible for modders.

    In detail:

    • A new API was introduced to ease communication with BSC, providing hassle free register and update of BlendShapes on any SMR.
    • The Update feature can be used to record changes to vanilla BlendShapes.

    Notes:

    • It is NOT currently possible to overwrite vanilla BlendShapes with the "Import BlendShapes" button. The update feature can only be used by other plugins (such as BlendShapeEditor) via the API.
      • If there is demand we can add the feature to update/overwrite existing BlendShapes with the import button.

    Minor News:

    UI Improvements and Bugfixes.

    • Various minor improvements and bugfixes to the UI and Save-Load fixing various bugs and annoyances.
    • This includes a bug that caused BlendShapes to not initially load in Studio.

    Further notes

    This update includes major changes to the codebase including a lot of restructuring. If there are mods that hook into BSC via HarmonyPatches the most likely have to be updated.

    Downloads