Demo Scenes

Start creating characters with the fully functional demo scenes.

The demo scenes are only meant to be used in the Editor and Editor Play Mode. To use the system for Runtime applications, you will need to integrate it into your own custom code.

Run a Demo Scene

The included demo scenes are meant to help you create premade characters. They feature code which can be referenced or incorporated into your own systems.

Editor Demos

There are two Demo Scenes which are meant to run in Editor Play Mode. These tools have a fully functioning interface to add and remove Wearables, swap Materials, adjust Morphs, change cosmetics, and export prefabs, sets or data. They function almost identically, except that they use different Modular Character Managers.

• The Managers

• The Scenes

The Managers

Character Builder Demo

The Character Builder demo uses the "Clean Manager", which is derived from the Modular Character Manager. This Manager instantiates Wearables each time they’re added, and destroys them when they’re removed.

The Clean Manager is best used when you are creating a one-off character prefab which will remain as-is, with little to no changes.

Character Closet Demo

The Character Closet demo uses the "Hidden Cache Manager", which is derived from the Modular Character Manager. This Manager instantiates Wearables as they’re equipped, but rather than destroying the them when they’re removed, they are kept hidden. The system then enables and disables Wearable meshes as they’re added/removed rather than instantiating and destroying. This is more efficient, not only because instantiating and destroying is performance intensive, but it also eliminates the need to re-weight Wearables to the armature hierarchy each time they’re equipped.

The Hidden Cache Manager is best used when clothing will be swapped often

The Scenes

• Loading a Character

• The Wearable Page

• The Cosmetic Page

• The Morph Page

• The Character Page

• Scene Controls

Loading A Character

Before you start, make sure you've imported all of your Base Packs and AddOn Packs, and linked the Wearable Databases to the Character Styles (see Setup).

Before you run a scene, add the Character Styles you want to use to the CharacterBuilderUI (in the case of the Character Builder Demo), or the CharacterClosetUI (in the case of the Character Closet Demo) gameobject in the Hierarchy. The component on this object contains a field to assign an array of Character Styles, called "Styles to Load". These are the ones you will be using in the scene, so add each Character Style you want to use.

Now run the scene of your choice (the reference images are taken from the Character Builder demo). They function essentially the same way. Upon entering Play Mode, you will be greeted by a bare-bones scene. Your only choice at this point is to load a character prefab. (The options available to you are pulled directly from the "Styles to Load" array where you added Character Styles).

The Scene view at start. Your only options are to exit or load a Character.

Select the character you wish to load from the dropdown menu and click "Load New Character". An unclothed prefab of that character will be loaded.

The Wearable Page

The Wearable Page contains an interface that allows you to add Wearables to your character. You can also remove Wearables and change their Materials. This data is pulled from the Wearable Database(s) assigned to the loaded Character Style.

Selecting a top category will drill down to sub-categories. Each sub-category represents a slot in the Manager, and clicking on one will load a menu of options for that slot.

The Wearable Menu controls

The Cosmetic Page

The Cosmetic Page contains an interface for changing skin tone, makeup options, eye styles and eyebrow styles. This data is pulled from the loaded Character Style.

The Cosmetic Menu controls

The Morph Page

The Morph Page contains an interface for adjusting the morph values on a Character. You can make adjustments to the eyes, nose, mouth, chest, waist, glutes, and overall body (along eyelash and nail length). These sliders are explicitly set and linked to the Character Morphs because all Modular Characters have the same morph options.

The Morph Menu controls

The Character Page

The Character Page allows you to load a new character, exit the scene, or save the Character in a variety of ways.

The Character Menu controls

A Character Name must be defined before you can save prefabs, presets, or JSON data. When loading JSON data, the Character Name refers to the name of the JSON file you wish to load.

There are several different ways you can save your current character. There is a default save location for these files, but you can specify your own on the CharacterBuilderUI (in the case of the Character Builder Demo), or the CharacterClosetUI (in the case of the Character Closet Demo) component in the Inspector. Leave them blank to use the default locations.

Hover over the field titles to see the default save location for each type of save.

• Save Prefab: Save a copy of the current character as a prefab to the "Prefab Save Path".

• Save Preset: Saves the current configuration as a Wearable Set Object to the "Set Save Path".

• Save Data to JSON File: Saves the current configuration as a JSON file to the "Data Save Path" (using the Wearable Set Data class).

• Load Character From JSON File: Converts the specified JSON file to a Wearable Set and applies it to the current character. (Loads from the "Data Save Path")

Scene Controls

When you load a character, you will have access to various controls for the scene. You can zoom in on the character's face, rotate the character, cycle through idle or walk animations, and change facial expressions.

Scene Controls

Runtime Demo

Coming in Version 1.1

The Runtime Demo Scenes will work in project Builds. It saves and loads Wearable Set Data to and from the Persistent Path. This enables you to allow your players to create their own custom characters. This demo scene uses the Clean Manager and functions exactly like the Editor Demos, aside from the removal of prefab/preset save options, and addition of Save Slots. The slots can be saved to, overwritten or loaded from.

Save files for Character Styles that are not included in the Demo will not be loaded.

Character Styles that are not included in the Demo will not be loaded. Before you run a scene, you must add the Character Styles you want to use to the CharacterBuilderUI gameobject in the Hierarchy. The component on this object contains a field to assign an array of Character Styles, called "Styles to Load". These are the ones you will be using in the scene, so add each Character Style you want to use.

Save files will only load the Wearables and Cosmetics that are present in the project.

If you save a file with addon packs that are not included in the Build, they will not be added when you equip a saved set. The best way to avoid this is to ensure that your Add-Ons are properly added to the Character Style before you Build.

If you are unsure how to use Add-On Packs, please check out the tutorial on my website.

Editor Tools

There are two Demo Scenes containing Editor tools. These tools do not require the Editor to be in Play Mode to run. They can be used right in the Inspector window.

• Add Wearable Tool

• Add Wearable Set Tool

Add Wearable Tool

The Add Wearable tool allows you to add one Wearable at a time to a blank rig. It does not account for variants or defaults. The purpose of this tool is to allow you to construct a character is exactly the Wearables you wish to use. To use the tool, select the "Getting Started" gameobject in the Hierarchy. It contains a component called "Create Wearable Helper". Drag a blank rig prefab to the field indicated. This blank rig prefab will be located in Assets > Stellar Game Assets > Modular Character System > Demo Assets > Prefabs > Add Wearable Helper Prefab. Make sure to choose the one for the character you want to use. Click "Create Blank Rig" and...nothing will appear to happen. That's because ONLY the rig for the character has been instantiated. You can confirm this in the Hierarchy. Select the rig in the Hierarchy and you will notice a component called "Add Wearable Helper". The transform data should already be populated, along with cosmetics. However, you can update the cosmetic materials to control which skin, eye and brow styles are instantiated with the Wearables. Now you're ready to add a Wearable to the rig. Simply drag a Wearable asset to the "Wearable to Equip" field and click "Add Wearable". Added Wearables will appear in a list below the Add Wearable button, with an option to remove it. To save your creation, drag it into the project folder of your choice.

Add Wearable Set Tool

The Add Wearable Set tool allows you to add an entire Wearable Set to a character prefab. It does not account for variants or defaults. The purpose of this tool is to allow you to construct a character from a previously saved Wearable Set Object asset. To use the tool, select the "AddWearableSet" gameobject in the Hierarchy. It contains a component called "Add Wearable Set". If you've already dragged the Character prefab into the scene, and added a Character Manager, drag it to the Wearable Manager field. If you haven't yet added a Character prefab to the scene, you can generate one but adding the Character Style you wish to instantiate into the "Style to Load" field. Doing so will allow you to choose the type of Manager you want to add, in addition to whether or not the Manager will enable dynamic morphs. Make your selections and click "Create New Character". The Wearable Manager field will automatically be assigned when the prefab is instantiated. The inspector has updated again and now you can either load a new prefab (to start over), or add a Wearable Set. Simply assign a Wearable Set Object asset to the field and click "Add Wearable Set". To save your creation as a prefab, drag the character into a folder of your choice.

T