ArchiveXL: dynamic materials

How to use ArchiveXL's new material property interpolation


Published: May 01 2024 by manavortex Last documented update: May 01 2024 by manavortex


  • ArchiveXL >= 1.13 โ€” this will not work with older versions

Assumed skill level

  • You have a general understanding of how materials work (or read up on it under Material assignment)

  • You have a Wolvenkit project and a mesh as well as a bunch of .mlsetups

Why is this better than .mi files?

Because it's even lazier: For a mesh with 15 appearances, you need...

legacydynamic materials




mlmask files



mlsetup fil,es









#chunkMaterials lists



The problem

Normally, your materials look like this: a bunch of different appearances with the same .mlmask, but one .mlsetup file for each colour:

The more variations you have, the more duplication you have, because you need to register a materialEntry for each material, and then create a material for each of those. Traditionally, you do that by duplicating the last entry and changing the depot path. Tedious and not fun, right?

This is where the new technique kicks in.

Step 1: Dynamic material assignments

We start by changing our chunkMaterial names. By appending the suffix @dynamic, we're telling ArchiveXL to map them to the CMeshMaterialEntry with the same name.

Instead of 15 materialEntries, we're down to one.

Step 2: the material instance

Now, we need to adjust the material instances. We can delete all but one, since our @dynamic will contain everything that we need.

Since that one won't change, we can leave the MultilayerMask alone. For the MultilayerSetup, we need to change both the DepotPath:

  • By making the depot path start with a *, we tell ArchiveXL that this is a dynamic material

  • The value for {material} will be passed from the appearance, like this:

... and the rest just works.

You can use dynamic interpolation in pretty much everything โ€” base material paths or material properties. Just remember to set your Flags to Soft, or it will fail.

Step 3: Appearance expansion

But wait, there's more. After using dynamic materials, we've been able to reduce the number of material entries and instances, but there is still a lot of repetition between the appearances - if you've followed this guide so far, each of your appearances has a chunkMaterials list that looks the same as all the others except for the different material name. It would be great if we could get rid of that repetition, and we can, with Appearance Expansion.

And it's very simple to do. You simply assign empty chunkMaterials lists to all your appearances except the first one, and ArchiveXL will automatically use the first appearance as a template and generate the chunkMaterials list by substituting the appearance name:

Now, you only have to maintain one chunk list, and the rest of your appearances are simplified down to a single name and nothing else.

Last updated