# Release Notes

## Version 1.2.13 (2025-04-03)

* Added **support for SketchUp 2025**.
* Added support for V-Ray 7 when exporting V-Ray proxies
* Transmutr now generates files in the format of SketchUp 2021+, to preserve new data like PBR materials from SketchUp 2025

## Version 1.2.12 (2024-04-11)

* Added **support for SketchUp 2024**.

## Version 1.2.11 (2023-04-25)

Bug fixes

* Fixed the installer not working on older Mac computers.
* Fixed V-Ray proxies not working with V-Ray 6.

## Version 1.2.10 (2023-04-18)

Features

* Added **support for SketchUp 2023**.
* Added **support for ARM-based Mac chipsets** (M1, M2).

Bug fixes

* Fixed translucency maps sometimes not being found.
* Fixed V-Ray proxies not working with V-Ray 6.

## Version 1.2.9 (2022-04-26)

Bug fixes

* Fixed exporting Quixel Megascans assets with variants not working.
* Fixed Transmutr not notifying users about new versions available for download.
* Fixed the “Release Notes” button in the options not opening the correct URL.

{% hint style="danger" %}
**Known issue:** Transmutr does not work in SketchUp 2022 on Mac computers with M1 chips. We're working on M1 support for a future version.
{% endhint %}

## Version 1.2.8 (2022-02-21)

Features

* Added **support for SketchUp 2022**.

Changes

* Improved support for the “Reflection Glossiness” and “Reflection Roughness” material attributes.
* Added a warning message when importing unsupported assets from Megascans, such as standalone materials.
* Added a button in Transmutr and a menu entry in SketchUp to open Transmutr’s manual.

Bug fixes

* Fixed the export step that copies textures sometimes failing silently.
* Fixed some models with n-gons showing artifacts when exported.
* Fixed normal maps not being detected for some models using unconventional attribute names.
* Fixed textures not being properly applied on models loaded without texture coordinates.
* Fixed the Megascans connection not working immediately after changing the port.
* Fixed several crashes that could happen when exporting a model.
* Fixed the “See release notes” button in the options opening the wrong webpage.
* **\[Studio version]** Fixed floating licenses not getting released when closing Transmutr.

## Version 1.2.7 (2021-06-16)

Features

* Added Reflection Glossiness/Roughness.
* Added support for SketchUp 2021.1.

Changes

* Improved the bump/normal setting automatic detection.
* Generate generic UV coordinates if they are missing.

Bug fixes

* Fixed an error that sometimes occurred when copying textures to the destination folder.
* **\[Studio version]** Fix proxy placeholder when using the CLI.
* **\[Studio version]** Fix VRMat path in automations.

## Version 1.2.6 (2021-04-07)

Features

* &#x20;Added offline activation/deactivation for users with a restricted internet connection. Documentation: <https://help.transmutr.com/faq#i-cannot-activate-my-license-due-to-a-restrictive-internet-connection>

Bug fixes

* Fixed V-Ray proxy export failing due to a recent V-Ray updates.
* Fixed the `ply2vrmesh.bin` executable being referred to as `ply2vrmesh.exe` on OSX.

## Version 1.2.5 (2020-12-07)

Features

* Added support for SketchUp 2021.

## Version 1.2.4 (2020-10-21)

Changes

* **\[Studio version]** Adding more automation patterns: DiffuseMapName, DiffuseMapExt, SourceFolderName, SourceFolderParent, SourceFolderParentName.
* **\[Studio version]** Allow overriding options with the CLI.

Bug fixes

* Fixed crash with V-Ray 5.
* Fixed V-Ray TwoSided materials.
* Fixed texture paths in Enscape materials.
* Fixed BottomCenter and TopCenter preview.
* Lookup in nested folders when searching for map paths in VRMats.
* **\[Studio version]** Fixed paths lookup when using the CLI.
* **\[Studio version]** Fixed translucency map path missing in automations.

## Version 1.2.3 (2020-04-24)

Bug fixes

* Fixed BottomCenter and TopCenter not being applied in the preview.
* **\[Studio version]** Fixed automations not being applied when using the CLI.
* **\[Studio version]** Fixed automations being applied twice in some cases.

## Version 1.2.2 (2020-04-06)

Bug fixes

* Fixed Megascans files with variants not exporting.
* Fixed the Download button that shows up when a new version of Transmutr is available.

## Version 1.2.1 (2020-03-31)

Changes

* The "Smooth Angle" setting is now applied to proxies as well.
* Added options to mitigate the artifacts generated by SketchUp when scaling a mesh with small faces (see `Maximum mesh scale correction` and `Mesh scale correction multiplier`).
* **\[Studio version]** Reflection Glossiness and Refraction Glossiness can now be set using automations.

Bug fixes

* Fixed instances not being exported as components.
* Fixed the extension toolbar showing up even after being previously closed by the user.
* Fixed presets not being saved.
* Fixed some colors not being formatted correctly in Enscape materials, which resulted in all parameters being ignored by Enscape.
* Fixed a crash occurring when objects had no materials applied to them.
* Fixed a crash occurring when scanning unauthorized directories.
* Fixed V-Ray proxy export failing in rare cases.
* **\[Studio version]** Fixed automations not being loaded from presets.

## Version 1.2.0 (2020-03-09)

New features

* 🍎 **MacOS support.**
* Transmutr can now **import SKP files**.
* Transmutr can now **edit individual components** directly from an opened SketchUp document.

Changes

* Transmutr now installs for SketchUp 2020.
* Texture maps embedded in FBX files are now extracted.
* Duplicate material names are now renamed automatically.
* It is now possible to choose for which rendering engines materials are exported.

Bug fixes

* Fixed tiny faces not being created in some cases.
* Fixed the generation of VRMesh proxies not reporting errors in case of failure.
* Fixed missing textures not being reported to the user.
* Command-Line Interface: fixed simplified meshes being sometimes assigned the wrong materials.
* Fixed materials with "<" or ">" in their name not loading.
* Fixed a crash that occurred when running several instances of Transmutr simultaneously.
* Fixed the connection to Megascans failing silently when the communication port is already in use.

## Version 1.1.2 (2019-10-24)

New features

* Added an option to add a custom prefix to relative paths

Bug fixes

* Fixed the connection with Megascans Bridge not working for some users
* Fix proxy export with non-ascii paths
* Fixed small issues when smoothing edges

## Version 1.1.1 (2019-09-27)

Changes

* Objects that occur only once are now exported as groups, whereas objects occurring multiple times are exported as component instances.
* Transmutr now produces slightly cleaner hierarchy: the top-most group (root node) is now omitted and its children are added to the model itself.

Bug fixes

* Fixed Megascans assets with variants not being exported.
* Fixed Transmutr producing errors when exporting over existing files.
* Fixed crashes occurring on systems with non-ASCII paths.

## Version 1.1.0 (2019-09-09)

New features

* \[Studio version] Added a **Command-Line Interface** to use Transmutr from a terminal or with your own custom scripts in order to easily process large sets of models. Read the documentation [here](https://help.transmutr.com/manual/command-line-interface).
* \[Studio version] Added **Material Automations** to let you apply your own automatic transformations to materials with a brand new visual scripting interface. Read the documentation [here](https://help.transmutr.com/manual/materials-tab/automations).
* You can now open files in Transmutr from the Windows explorer with `Right-click > Open with`. You can also associate some 3D formats to be automatically opened with Transmutr by clicking the `Always use this app to open .obj/.fbx/.3ds/... files` checkbox.

Bug fixes

* Fixed mesh simplification not being applied in the preview when loading preset settings.
* The scale is now correctly affected when changing the model dimensions in Stats
* Fixed some OBJ files generating parsing errors during loading (this error especially occurred for files exported from Rhino).
* Fixed remote trial extensions not working.

## Version 1.0.6 (2019-08-08)

Bug fixes

* Fixed SketchUp not automatically opening converted files.

## Version 1.0.5 (2019-06-11)

Bug fixes

* Fixed blank screen when windows username contains special chars.

## Version 1.0.4 (2019-06-10)

New features

* Transmutr can now **import STL files**.
* When launched from SketchUp with Thea v2.1 (and above) active, Transmutr will export Thea proxies as **\*.mod.thea** files instead of \*.xml files.

Changes

* Transmutr now reads the "Up Axis" attribute that is sometimes stored in FBX files so that models are automatically rotated as intended.

Bug fixes

* Fixed missing material in V-Ray proxy when placeholder is "Simplified Geometry" or "Full Geometry"
* Fixed texture paths discarded when the drive letter is assigned but disconnected
* Fixed camera clipping plane not being updated when changing modifiers (scale, origin, etc)

## Version 1.0.3 (2019-05-04)

Bug fixes

* Fixed Transmutr files crashing SketchUp 2017 (and below) when saving
* Fixed a bug introduced in v1.0.2 that made some textures black in the preview

## Version 1.0.2 (2019-05-03)

New features

* Added **floating licensing** to dynamically share license seats between employees of the same company, up to a predefined number of concurrent users. Please contact us if you are interested in this type of licensing (Studio licenses only).

Changes

* Transmutr now **scans the directory of the model to search for missing textures**. This is helpful in some cases when the model contains absolute paths that are no longer valid.
* Geometry **simplification should feel faster** on the first simplification, since heavy initialization work is now done as a background process.

Bug fixes

* Fixed the general options being reset to default values when loading a new model after the first one.
* Fixed license keys being considered invalid when manually typed with some variations (eg. lowercase, spaces).
* Fixed a crash that occurred when loading a model with TIFF textures.
* Fixed the preview appearing empty for a few seconds after loading large models.
* Fixed V-Ray issues that occurred when some materials had names containing characters not supported by V-Ray.
* Fixed a rare crash that occurred when loading a FBX model with invalid per-face material data.

## Version 1.0.1 (2019-03-25)

Changes

* The trial is now 7 days long
* Reset the camera position when loading a new model

Bug fixes

* Fix some billboard placeholders having the wrong width depending on the model's orientation
* Fix badly constructed faces from corrupting whole objects

## Version 1.0.0 - Public release (2019-03-21)

Changes

* The 3 days trial is now available
* "Open File" dialogs are now always on top of the main window
* The SketchUp extension is now signed

## Version 0.4.3 (2019-03-20)

Bug fixes

* Fix the simplification damaging UV seams
* Fix loaded presets not being applied immediately

## Version 0.4.2 (2019-03-16)

Changes

* Adding base materials to complement V-Ray 2Sided materials, as a workaround to the issue of texture scale discrepancy in V-Ray Next
* Adding a dummy colorized texture when a material doesn't have a diffuse map but has other maps, to preserver UV mapping
* Enable materials "Normal" setting if the bump map's name contains "norm"

Bug fixes

* Fix FaceSkipping's face count not working
* Fix geometry simplification producing holes in some cases
* Fix emissive color

## Version 0.4.1 (2019-03-14)

Bug fixes

* Fixed power-of-2 textures (512, 1024px...) being flipped in the preview

## Version 0.4.0 (2019-03-13)

New features

* **Brand new simplification engine: much faster, and more reliable**
* Old FBX files (FBX version <2011) can now be opened

Changes

* Renamed "Proxy Preview" to "Placeholder"

Bug fixes

* Fixed textures being flipped vertically in the preview
* Fixed textures being flipped vertically in Thea proxies
* Fixed geometry disappearing in models with tiny faces
* Fixed some textures appearing stretched in the preview
* Fixed Transmutr crashing when opening ill-formed models with invalid texture paths

## Version 0.3.4 (2019-03-04)

New features

* All Proxy Preview types are now available for Artist licenses (adding 'Billboard', 'Simplified Geometry', and 'SketchUp File').
* We can now edit the target face count when using 'Face skipping' proxy preview.
* The model's dimensions are now displayed in the 'Stats' section, and are editable (this will update the Scale multiplier).
* Transmutr now exports Megascans assets with multiple variants.

Changes

* Sped up the import of large models with many objects.
* It is now possible to drag and drop maps between slots.
* Added a security certificate so that Transmutr is less likely to be flagged as malware by antivirus softwares.
* Transmutr will now use the scale factor of FBX files.
* The 'Cancel' button has been renamed to 'New' and asks for confirmation.
* Added an input field next to the Simplification slider.
* The Simplification slider is now non-linear by default, as we usually need high simplification levels. This behavior can be disabled.
* Improved the look of the icon on Windows.

Bug fixes

* Fixed simplification producing many holes in the mesh. Holes can still happen, but they should be much less frequent.
* Fixed some TIFF textures crashing the app because of an unsupported internal compression mode.
* The camera clipping plane now depends on the size of the model. This avoids huge models from disappearing.
* Fixed some faces not being created when triangulated.
* Fixed some groups/components not being created when containing tiny faces.
* Fixed a crash that could occur when creating Thea materials.
* Fixed the UI being slow when having many materials in the Materials tab

## Version 0.3.3 (2019-02-08)

Bug fixes

* Fixed geometry disappearing in models with tiny faces

## Version 0.3.2 (2019-02-07)

Changes

* Transmutr is now smarter when looking for missing maps, it will look in all potential folders. When the user adds a map, Transmutr will look into this folder for all missing maps.
* VRMat is now a material property instead of a material type
* Spaces are trimmed from license key to avoid copy/pasting issues

Bug fixes

* Fixed exploded object when using scale/unit conversion
* Potential fix for SketchUp not being able to connect to Transmutr, when opening it from SketchUp
* Fixed 'Communication Port' option not being saved between sessions
* Fixed wrong material name when created from VRMat
* Fixed several issues with map paths in VRMats

## Version 0.3.1 (2019-01-24)

Changes

* The preview viewport now supports TIFF textures
* V-Ray Materials: “Diffuse Texture Alpha” is enabled if there is no opacity map

Bug fixes

* Fixed SketchUp zoom bug when importing models with tiny faces
* Fixed maps not being copied to the destination folder when exporting Thea proxies
* Fixed opacity maps not being picked up from FBX files
* Fixed TGA textures appearing black in the preview
* Non-planar faces are now triangulated

## Version 0.3.0 (2019-01-17)

New features

* Added Thea proxies
* Transmutr can now be opened directly from SketchUp, the transmuted asset will be automatically added to the model
* Added smoothing edges by angle
* Transmutr now reads basic properties of V-Ray and Corona material in FBX files exported from 3dsmax
* Renaming materials is now possible

Changes

* Binding is now turned off in V-Ray materials created from a VRMat file
* Transmutr no longer automatically triangulates the model. It will be triangulated only when using Geometry Simplification.

## Version 0.2.1 (2019-01-08)

New features

* Added a "Face Skipping" proxy type that only keeps a few faces to get an idea of the model's overall shape
* Added a "Zoom extents" button to make the model fit the viewport

Changes

* Transmutr now adds a dummy colorized texture when the *Diffuse* slot is empty but other textures are in use (bump, opacity, reflection, etc) in order to preserve UV mapping in SketchUp
* Texture files can be drag-and-dropped from the file explorer to the slots of the material panels
* Improved Megascans assets materials
* Added a notification when a new version of Transmutr is available so that users can easily download it
* Added a button in the Options panel to open those Release Notes from the application
* Converting units now sets the appropriate drawing unit in the SketchUp model

Bug fixes

* Fixed missing geometry when importing models with faces that are smaller than SketchUp allows
* Fixed texture mapping when vertices of a same face have identical UV coordinates
* Fixed some edges not being smoothed
* Fixed the unwanted rotation animation that sometimes started when clicking the "Show edges" button
* Fixed Megascans asset imported as white when format is OBJ

## Version 0.2.0 — Beta stage (2018-12-19)

New features

* Added Quixel Megascans integration
* Added "Top Center" origin option

Changes

* Added default filename when saving .skp
* Significantly sped up mesh simplification for high-poly models
* Added an option to prefix material names with the model name
* Added warning when using TIFF bitmaps
* Options: added a button to open the folder that contains log files
* Options: added a button to display GPU info for debugging purposes

Bug fixes

* Fixed the mesh simplification slider
* Fixed the "Cannot load options" error that occurred if the options were not modified by the user
* Fixed normal maps color space in V-Ray
* Fixed browsing for .vrmat files

## Version 0.1.4 (2018-12-10)

New features

* Added Metal material type

Changes

* Added thumbnails to the material panels
* Added an Options dialog
* Added notifications (errors, warnings, etc)
* Tweaked materials

Bug fixes

* Added better support for paths with special characters

## Version 0.1.3 (2018-11-23)

New features

* The material type is automatically assigned based on the material's name (e.g. "...leaf..." ⇒ Translucent)

Changes

* When exporting a \*.vrmesh proxy, the black console window that briefly popped up does not appear anymore
* Copying maps to the destination folder is now optional
* Preset saving and loading buttons have been moved to the header
* It is now possible to unfold multiple materials

Bug fixes

* Fallback to lower-quality graphics when webGL is not available (Work in progress)
* Fixed wrong *up axis* and *origin* transformations for models that already have a transformed root node
* Fixed the \*.vrmesh proxy generation sometimes locking up the export
* Fixed automatically finding \*.vrmat files matching material names
* Fixed faces not being exported for some files
* Fixed material names encoding issues

## Version 0.1.2 (2018-11-16)

New features

* Added Enscape materials

Changes

* Added better feedback when exporting
* Transmutr now also looks for resources with invalid absolute paths in the model's folder
* For Emissive materials, the Diffuse color is now the same as the Emissive color
* Refraction now affects opacity in SketchUp (the lowest value between Refraction and Opacity sets the opacity in SketchUp and Enscape)
* Profile edges are now disabled in generated \*.skp files

Bug fixes

* Fixed most materials in OBJ files having Refraction set to 1

## Version 0.1.1 (2018-11-14)

New features

* Added Thea materials

Changes

* Added the possibility to pan the viewport's camera
* Added a checkbox to show/hide the model's edges in the viewport
* Improved the visibility of the material-picking eyedropper

Bug fixes

* Fixed Transmutr only working with administrator privileges when installed "For all users"

## Version 0.1.0 — Alpha stage (2018-11-08)

Initial preview release to a small number of testers.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.transmutr.com/release-notes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
