Python tools for Maya. Can be installed as custom tools via the script editor.
The tools were developed and tested in Maya 2020.
git clone
or download this repo to your desired location- Add the path to the folder containing the scripts to your
userSetup.py
file. This file is usually located inDocuments\maya\<version>\scripts
. Add the lines in the file.import sys sys.path.append("<Path to the folder>")
- Restart Maya. This will run userSetup.py for the change to the path to take effect.
- In Maya, open Windows > General Editors > Script Editor
- In the script editor, select File > Open Script...
- Browse for the script you wish to install and Open. The script should show up in the editor.
- Select File > Save Script to Shelf..., and give the tool a name of your choice
Browse for a folder containing Substance Painter texture maps and import as an aiStandardSurface.
- Creates the nodes for BaseColor, Normal, Metalness and Roughness maps.
- Uses the appropriate color space (Raw or sRGB) for each map.
This is a commonly required feature, maps exported from Substance Painter can be tedious to apply to objects. This allows a folder of maps to be imported as aiStandardSurface with one click.
- Create custom shelf tool (see above install instructions)
- Click on tool, click Browse to select the folder that contains the maps from Substance Painter
- Click "Import as aiStandardSurface" to import
- Open Hypershade to view the aiStandardSurface nodes and apply the aiStandardSurface to the model
- Press "6" to display texture maps in the viewport for preview
- Does not currently handle the height map
- When browsing for the folder of maps, the maps contained in the folder cannot be viewed
- The maps in the folder must be named in the original _BaseColor or _Normal format in order to be recognized
Simple scripts for the shelf to lock and unlock the translation, rotation and scale of selected objects.
Allows for locking reference objects or cameras with one click rather than selecting each attribute individually.
Simple script to save a backup copy of current file at a chosen location while remaining on the current file.
- Similar to QuickSave in ZBrush, with the difference being the user must choose the location of the new file
- Equivalent to using
Save as
and then re-opening the original file.
Incremental save creates too many files with trivial changes, and it's difficult to find the file you want when rolling back, but backups are still needed for good versions to rollback to if something goes wrong. This is a reliable, simple manual backup for peace of mind before attempting something tricky.
- This only saves the current Maya .mb file. Referenced objects contained in other files would not be saved.
- Create custom shelf tool (see above install instructions)
- Click on tool, select location to save backup file
- Click save. Backup file is saved.
loadSubstanceMaps.py was inspired and references project by Catherine Luo
- Feel free to use to start your own projects!
- Feedback very much appreciated :)