Description

This is my collection of scripts for Autodesk Maya – These scripts were created with the aim of automating, enhancing or simply filling the missing details of what I find lacking in Maya.

After installing the script collection, you’ll find a pull-down menu that provides easy access to a variety of tools. This menu contains sub-menus that have been organized to contain related tools, for example: modeling, rigging, utilities, etc…

For help on how to use these scripts, click on the “Help” button at the top right of their window (within Maya) or check their documentation by going to the "docs" folder. For changelog read the text at the top of the script file (just open the “.py” or “.mel” file using any text editor, such as notepad)

All of these items are supplied as is. You alone are solely responsible for any issues. Use at your own risk. Hopefully these scripts are helpful to you as they are to me.

Tested using Autodesk Maya 2022 (Windows 10)

Organization

docs: contains documentation about the scripts

mel-scripts: contains scripts written in MEL

python-scripts: contains scripts written in Python

Installation

TL;DR : Download files, then open "setup.bat".
You can also click here to watch a video tutorial. (Manual installation is slightly different now, I'll upload a new video soon)

It's possible to use most scripts without installing the whole package. Most of them are standalone and will work on their own, but for a better experience it's recommended that you include all scripts. This way you won't miss any dependencies.

PS: for "gt_utilities" you will have to uncomment a function at the bottom of the script, as it wouldn't make sense to call all of them at once.

The text below explains how to install it on a Windows PC, in case you're looking for MacOS or Linux check the "docs" folder.

Auto Installation

This script collection comes with an auto installer (setup.bat) you can simply download it, run the setup and reopen Maya. Here is how you do it in more details:

1. Close Maya (in case it's opened).
2. Download the latest release (or clone this repository).
3. Un-zip (Decompress) the file you downloaded. (the setup won't work if it's still compressed)
4. Open "setup.bat". (It will show you the options - "Install, Uninstall and About")
5. Type "1" to "Install", then press enter.
6. Open Autodesk Maya.

If you want, you can now delete the downloaded/extracted files (as they have already been installed)

Manual Installation

In case you need/want to manually install the scripts. It's also a pretty straightforward process.

1. Close Maya (in case it's opened).
2. Download the latest release (or clone this repository).
3. Un-zip (Decompress) the file you downloaded.
4. Move all the contents from the folders "mel-scripts" to your scripts folder (usually located under the path below): C:\Users\USERNAME\Documents\maya\VERSION\scripts\
5. Move all the contents from the folders "python-scripts" to a folder called "gt_tools" inside your scripts folder: C:\Users\USERNAME\Documents\maya\VERSION\scripts\gt_tools\
6. In case you don't want to replace an already existing "userSetup.mel" script (inside your scripts folder), you can easily merge them by opening the existing one and adding the line: source "gt_tools_menu.mel";
(This command adds the menu when Maya opens)
7. Open Autodesk Maya.

Updating

Simply install it again. The auto setup will overwrite all files essentially updating them.
If updating a major version, it's recommended that you uninstall it first before installing it again. This will eliminate any unnecessary files.
In case updating it manually, make sure to overwrite (replace) the files when moving them to the scripts folder.

Uninstallation

Auto Uninstallation

1. Close Maya (in case it's opened).
2. Download the latest release (or clone this repository).
3. Un-zip (Decompress) the file you downloaded.
4. Open "setup.bat". (It will show you the options - "Install, Uninstall and About")
5. Type "2" to "Uninstall", then press enter.
6. Open Autodesk Maya.

Manual Uninstallation

1. Close Maya (in case it's opened).
2. Navigate to your scripts folder, usually located under the following path: C:\Users\USERNAME\Documents\maya\VERSION\scripts\
3. Delete "gt_tools_menu.mel" and the folder "gt_tools"
4. Open your "userSetup.mel" script (inside your scripts folder), and remove the line: source "gt_tools_menu.mel";
5. Open Autodesk Maya.

Frequently Asked Questions

• How do I update GT Tools to a new version?
  A: Simply uninstall and install it again.
• What do I do if I have multiple "userSetup.mel" files? One inside "maya/####/scripts" and another one inside "maya/scripts"
  A: The "userSetup.mel" file gets executed when you open Maya, but Maya supports only one file. In case you have two files it will give priority to the file located inside "maya/####/scripts", so manage your initialization commands there.
• Where are the other scripts you had in this repository?
  A: I moved all other scripts that are not part of GT Tools to another repository. Here is the link: TrevisanGMW/maya-scripts

Contributors

If you'd like to contribute, please fork the repository and make changes as you'd like.
Pull requests are warmly welcome.

Don't know how to code but want to contribute? You could buy me a coffee! ☕

Licensing

The MIT License 2020 - Guilherme Trevisan