Skip to main content

Asset Replacement

tip

This feature is currently only available in the Nightly builds.

The Asset Replacement sidebar is the fourth topmost tab of the sidebar, which is available on the left side of the screen. From this tab you can configure custom image files to be used as a replacement for Mannequin's built-in assets.

In Mannequin Character Generator, an Asset Replacement Rules is a combination of multiple ssset replacement rule. Each rule represents what source image to be used and what image should be replaced by this source, alongside other additional settings.

A newly created character will only have Default asset replacement rules initially. Use the three dots icon on the right side of the asset replacement rules name to switch between all of the available asset replacement rules. From the drop-down menu that opens, you can also choose to add a new asset replacement rules, rename the current asset replacement rules, delete the current asset replacement rules or manage all of the existing asset replacement rules using a more granular interface.

Saving and loading asset replacement rules are done through .mqna file. Loading an asset replacement rules from a .mqnc file will overwrite your currently active asset replacement rules with the data obtained from the .mqna file. If you want to load an asset replacement rules from file without overwriting your currently active asset replacement rules, then you can click Manage Asset Replacement Rules... on the drop-down menu.

Manage Asset Replacement Rules​

From the Manage Asset Replacement Rules window, you can do various things, such as:

  • Importing asset replacement rules from external file.
  • Exporting asset replacement rules to external file.
  • Sorting all asset replacement rules by name, whether ascending or descending.
  • Delete single or multiple asset replacement rules.
  • Manually adjust their order by moving up, moving down, moving to top or to bottom.

Clicking an asset replacement rules will select it, and clicking again will deselect it. When multiple asset replacement rules are selected, using the export function will save all of those selected asset replacement rules into a single file. Asset Replacement Rules imported from external file through this window will appear as new entries, rather than overwriting existing ones.

Adding A New Rule​

To add a new rule for the current asset replacement rules, click the Add Rule button. A new panel will be created below, representing the newly added rule.

You can enable or disable this rule with the Enable This Rule toggle. You can also remove this rule by clicking the Remove Rule button.

Choosing Target Images​

To choose target image (what image will be replaced), click Add Target button. A list will show up, displaying all of the currently used images. Hover over them to preview which one is which, then click to select. After selecting one, click Target Selected to confirm.

After selecting a target image, it will be listed in the corresponding panel. Use the three dot icon at the right side of each entry to show more options: Change Target, Remove Target, or Copy SVG file To.... It's highly recomennded to use the copy SVG feature as a starting line for your modification. It's also highly recommended to use Inkscape (free & open source) for editing these files, as other apps tend to be unpredictable when working with SVG format.

Depending on what part the target image is representing, L and R toggle will also appear, which control whether the target image will be replaced if it's on the left or right side.

Choosing Source Images​

To choose source image (what image will be used as a replacement), click the folder icon and select your SVG file in the dialog that opens. You can enable Embed Source Image toggle to embed your SVG file into your character file, which will ensure that it works even though the original file is deleted/moved/renamed from your system.

You can also enable Enable Recoloring to recolor your custom SVG file based on Mannequin's recoloring rules. For example, if you have replaced the left hand part then it will be recolored to match your character's skin color settings.

In order for this recoloring to work properly, you must limit the colors used in your SVG file according to these rules:

Part CategoryHighlightBaseShadowStroke
Iris#BD58A5#743174#2B072B-
Inner Mouth#DD6666#CC3333#660000#440000
Other Body Parts#FFEDE1#FFE4D1#F4AD9D#AB5849
Hair, Additional Hair Parts, Brow, Eyelash#6B4839#563426#2D201C#211B15
Clothing, Hair Accessories#4B5D7F#3C4C72#131C43#0C1535

Other colors (same for every category): Backlight #F5F5F5, Pure Black #000000, Pure White #FFFFFF. Pure Black and Pure White will not be recolored by Mannequin.

TL;DR for Beginners​

  1. Click the Add Rule button.
  2. Click the Add Target button.
  3. Choose part to replace, then click the Target Selected button.
  4. Click the three dot icon then Copy SVG file To...
  5. Edit the copied SVG file using Inkscape, make sure to use the same color palette.
  6. Save, then back to Mannequin. Click folder icon then choose your SVG file.
  7. Your edited SVG file will be used as a replacement.