Changelog¶
What changed in the glTF Importer and Exporter for Maya. More at polypulse3d.com.
2.0.0 - 2026-09-29¶
Added¶
- Drag
INSTALL.pyonto the Maya viewport to install, upgrade, reinstall, or uninstall - If NumPy is missing, click Install NumPy (internet required), then Re-launch Maya if asked. Import, export, Animation Clips, and Material Variants prompt you instead of failing with no explanation
- Report an Issue in the glTF2.0 menu opens the contact page
- Create File and Remove File next to the Material Variants File dropdown, so you can author variants from scratch. Opening the window with an empty list creates Scene1. + adds Scene2, Scene3, and so on. Removing a File leaves Maya materials in the scene
- Each Material Variants row shows Empty or Assigned:N, so you can see which variants still need Assign Variant
- Select Meshes selects the Maya meshes assigned to the chosen variant
- Unassign removes a variant's mesh mapping. Selected meshes are unassigned first; with nothing selected, the variant becomes Empty. Maya materials stay in the scene
- Rename File changes the Material Variants dropdown label. Variants, assignments, and export slots stay on that File
- Duplicate Variant copies the selected variant and its mesh assignments onto a new name in the same File. Maya materials stay in the scene
- Assign All records the current material of every mesh on the selected File onto the chosen variant. Meshes on other Files are left alone
- Reorder variants by dragging the ⋮ handle. That File's list order is the order exported in the glTF
- Click Empty on a variant to assign the meshes selected in the viewport. With nothing selected, Assign Variant is focused so you can finish that step
- Material Variants can be authored from Python or
cmds.gltf2MaterialVariants:createFile,createVariant,assignSelection,setOriginal, andlistStats - mayapy round trip covers two Material Variants imports, saving and reopening the Maya scene, export, and re-import. Same-named variants stay on their own Files
- Material Variants ? button and the README describe how to author a File, assign meshes, set Original, and export order
- Export Empty variants in the Material Variants window includes looks that have no mesh assignments. It is off by default
- Export Log reports Material Variants problems: Empty looks that were omitted, Original with no assignment, and assigned shaders that are missing in the scene
- Export to glTF and GLB, in the same plugin as import
- Materials, animation, cameras, and lights round-trip more reliably
- Draco mesh compression and KTX2 texture compression on export
- Export progress and an Export Log
- Compress Normal Maps in KTX2 settings (off by default so normals stay sharp)
- Create Composition in Animation Clips, kept in sync with Maya’s Time Editor (including Maya’s default
Composition1) - Duplicate clip names get a unique Maya name (
walk→walk_1) - Maya 2027 on Windows, including KTX2
- Gaussian Splats SH Degree on export (0-3, default 3)
- Maya module install for studios that already use Maya modules
Changed¶
- One download per operating system, with
INSTALL.pynext to a single plugin folder - Clearer installer: NumPy at the top, a short status line, then where to install. Uninstall all copies is on the left when a copy already exists
- Status tells you if nothing is installed, an earlier version is installed, this version is already installed, or a newer version is already installed
- The installer opens with Maya package: This user only selected. That is the recommended location
- Material Variants groups File, the variant list, and the action buttons. Display, Assign, Assign All, Select Meshes, and Unassign share one equal-width grid
- Each material variant row has Display, Select Meshes, Duplicate, and Delete icons. Select Meshes stays off while the variant is Empty
- The matching window buttons are gone. Assign Variant, Assign All, Unassign, Create, and Revert to Original stay
- Variant row text and icons are vertically centered in the list item
- The Material Variants heading inside the window is removed. Tooltips use a bold label and one sentence per line
- Icon buttons share one size and one drawn icon style. Create File and Create Variant use the same plus
- If NumPy cannot download, the window says you need internet. After NumPy is installed, you can use the plugin offline
- The installer can add the plugin folder to Maya’s trusted plugin locations so you are less likely to get a separate security prompt per file
- Product name is glTF Importer and Exporter for Maya (PolyPulse3D)
- Separate Windows and macOS downloads
- For glTF (not GLB), Resources defaults to Copy source files
- For web and real-time viewers, use Time Editor Clips with Bake Animation Keyframes on
- Bake Animation Keyframes is on by default for Scene Keys and Time Editor Clips. Turn it off only if you need sparse Graph Editor round-trip
- On macOS, the plugin loads on Maya 2022+. KTX2 is verified for Maya 2026
Fixed¶
- The installer opens on Maya 2024. Option rows no longer call Maya's deleted QProxyStyle, which aborted the window before it appeared
- Export includes Time Editor clips from every composition. Importing two or more files and exporting once no longer keeps only the composition selected in Animation Clips
- A later import keeps the earlier clips on the time slider. The range is the union of every Time Editor clip, so a shorter second file does not cut the first
- Each import takes free Time Editor clip IDs. A second file no longer asks for clip IDs 1, 2, 3 while the first file still owns them
- Scene Keys does not copy another file's AnimSource into a clip whose own AnimSource cannot be found
- Use Direct Clip Definitions still exports Time Editor clips whose names are not in the Define Clips table, so another imported file is not dropped while that checkbox is on
- Deleting the last item in Material Variants no longer restores the imported list, so you can clear it and create your own. Removing a variant still leaves its Maya materials in the scene
- Selecting a File in Material Variants now shows only that file’s variants. A second import of the same glTF no longer appends its variants onto the first File
- Revert to Original applies the selected File’s Original variant to that file’s meshes. It no longer uses a scene-wide index that could miss the file or change another import
- Saving and reopening a Maya scene with two Material Variants Files keeps each File’s export slots. The second File is no longer dropped from the exported glTF
- Importing a second glTF adds that File without wiping variants you authored on the first File, and without mapping both Files onto the same export slots
- Skinned multi-primitive meshes with material variants fall back to the normal import path if unified-mesh variant setup fails, so the File list and export still get the variants
- Removing a Material Variants File drops that File's variant mappings from the exported glTF. Maya materials stay in the scene, and other Files keep their own variants
- Export writes each File's Original variant as the viewer None material when that shader still exists, including after Original is reassigned or the stored default is stale
- Display Variant on a combined skinned mesh assigns each primitive's faces. A missing face set uses the primitive's face range instead of shading the whole shape
- Crash when exporting glTF with textures as separate files
- Start and End in Define Clips accept numbers only, and warn until End is greater than Start
- Empty scenes no longer export leftover clip table rows as animation
- Morphing meshes that were split into extra nodes on export now stay as one mesh
- Morph target weights from the file are kept on import instead of resetting to zero
- Some compressed meshes that imported about 100× too small now come in at the correct size
Known limitations¶
- On macOS, KTX2 is verified for Maya 2026 only
- Gaussian splat import and export need the companion Gaussian Splat plugin from PolyPulse3D (Windows only)
1.3.0 - 2026-01-14¶
Added¶
- Extra logging to help diagnose crashes and slow scenes
Changed¶
- License is MIT
- Default animation playback is 24 fps
- Better texture paths for Sketchfab downloads
Fixed¶
- Mesh instancing with more than one mesh source
- Skin binding
- Stingray PBS emissive intensity
- Sketchfab texture paths
- Maya 2022 compatibility
Removed¶
- Exact inverse-bind-matrix import option
1.2.0¶
First tracked release.