[OpenSource] Twinmotion Material Match Table Editor

Since there's an embedded Twinmotion app in Revit 2024,

we started to use the renderer to simplify our rendering workflow,

but instead of using direct-link option for syncing whole model any time,

we found by split the model as demand and then exported them individually to Datasmith file, we'll have better control of the hierarchy for categories, design options, or even for linking-model.

the problem is the material will not always update to the in-scene material when re-importing datasmith model.

After searched and studied on the official document, we found there's a solution by creating a match table for the User Library in Twinmotion and the material name of the exported Datasmith model.

Twinmotion 2023.1 Substitution Table Overview (epicgames.com)

So then we developed a tool to handle all the copy & paste & name-checking chores.

PS. although the post using Revit model as an example, any 3D DCC program ( like SketchUp, Rhinoceros) which supports Datasmith file converter should also be able to use this method.

--

• Link:

Web App Version:

https://zefreestijl.github.io/TM_SubstTable_Editor/

..

Desktop App Version (by Electron):

https://github.com/zefreestijl/TM_SubstTable_Editor/releases/tag/app

--

• Steps:

1. Loading Material Library CSV File from Twinmotion:

.

.

--

2. Loading Previously Exported Match Table Excel File:

.

--

3. Data Comparison Note:

.

.

--

4. Save the Exported Xsl File to CSV

Before Importing datasmith model with the matched data table, we have to convert the Xsl file to CSV-UTF8 first.

(still working on exporting directly to the csv in UTF8 enconding inside the Table Editor App..)

.

--

5. Result Before & After Material Matches when Importing a New Datasmith Model