Morph System Manager
Introduction
The Morph System Manager is an essential tool within the Atavism framework designed for game developers. It’s specifically tailored for X.9 to expose blendshapes on character models, enabling the saving of these shapes into the Atavism Database. This module will guide you through the process of setting up and using the Morph System Manager.
Requirements
- Models with blendshapes for characters.
- HNGamer’s Atavism Morph System Manager and Customization Manager (included in Atavism by default).
Infinity PBR Modules are Obsolete
These modules are obsolete and should not be used. There is no support for these modules. Please remove these and the scripting defines before proceeding with this install. Delete any folder under the HNGamers folder structure that mentions the Infinity Integration, there are two versions, one with V3 at the end.
Also open your Project Player settings and delete these two scripting defines. They are no longer needed.
Installation and Setup
- Installing the Morph Manager:
- To install, you can either use the ‘Atavism Prepare Character’ feature or manually add the Morph Manager and the Customization Manager to your characters. Remember, the Customization Manager is a prerequisite.
- Initializing Morph Shapes:
- Upon adding the Morph System Manager to your character, click on the ‘Initialize Morph Shapes’ button to load blendshapes.
- This process will populate the ‘Morph Shape Objects’ with all the blendshapes found in your model.
- Saving Morph Shapes:
- Since 9.0.7 we have been able to save Morph Shapes to the resources folder. This allows setting any shape value you want, then saving it for loading in the future.
Configuring Morph Shapes
- Managing Morph Shape Objects:
- Once the shapes are loaded, you’ll see them listed under ‘Morph Shape Objects’.
- Expand these objects to view and modify their values.
- The ‘Visible Shapes’ count indicates the number of shapes that will be available for player adjustment in the Character Panel.
- Filtering and Adjusting Shapes:
- If your model’s blendshape names contain specific prefixes, use the prefix fields in the manager to filter these out for better organization.
- Shapes with the ‘Minus’ designation are automatically set to be invisible in the list, streamlining the customization process for players.
- Customizing Shape Ranges:
- Each shape can be adjusted for minimum and maximum values, allowing you to control the range of adjustments players can make.
- This feature ensures that character customizations stay within realistic or desired limits.
Equipment Display Support
- Starting in 9.0.6 support for Equipment displays to enable and disable blendshapes was added.
- Add the text asset to the equipment display to have it affect the character on load and unload.
Code Overview
- The Morph System Manager automates the handling of blendshapes for any character to which it’s added. This includes loading shapes, filtering names, and setting visibility.