#mgear   #rigging   #configuration   #maya

How to Install mGear on Mac

Hey everyone. This is a post explaining how to install mGear for Maya on MacOS. Several people were having trouble installing on their Mac, so I decided to make this post and video.

It's almost identical to installing on Windows, except there is an extra step to take with quarantine restrictions on MacOS Catalina and higher. Downloaded plugins need to be marked as safe before we can use them.

You could follow these steps in Windows too. Your preferences folder will be in a different location. And you will not need to do the quarantine command.

The extremely short version:

Option A: Copy everything under "release" to your "modules" folder in Maya prefs.

Option B: Edit your "Maya.env" file and add MAYA_MODULE_PATH = YOUR/PATH/TO/RELEASE

Here's a video showing how. The steps are also written below.

  1. Download the latest mGear here https://github.com/mgear-dev/mgear_dist/releases
  2. Unzip the file.
  3. Open Terminal.app and type the following command:
    sudo xattr -r -d com.apple.quarantine /PATH/TO/YOUR/MGEAR/DIRECTORY/
    You can drag the mGear folder into Terminal to paste the full path.
  4. Under the mGear folder, you will see a "release" folder. You need to move all the things under releases into your "modules" folder under Maya preferences. You might not have a "modules" folder. If not, you can just make a new folder. Here's my example path:
    /Users/chrislesage/Library/Preferences/Autodesk/maya/2020/prefs/modules
  5. That's it! You don't need to edit the .mod file or anything. You should be able to open up Maya and see the "mgear" menu up top. If not, you can ask for help in the mGear Forums here. But please list every step you took so we can help.

Alternate Method using MAYA_MODULE_PATH

This second method is how I install mGear. It makes it easy to deploy across multiple artists on a studio network.

Instead of moving files to your preferences, you can just install mGear anywhere you want on your computer, or on your studio's network path.

  1. Open Maya.env or create the file if it doesn't exist. My example:
    /Users/chrislesage/Library/Preferences/Autodesk/maya/2020/Maya.env
  2. In that file, add the line:
    MAYA_MODULE_PATH = /Users/chrislesage/Downloads/mgear_3.6.0/release

Notice that you have to point to the "release" directory, not the mGear directory, and not the mGear.mod file.

It doesn't have to be named "release". You just have to point to the directory where the mGear.mod file is located. Again, move it wherever you like.

Hope that helps! Enjoy mGear!



Author image
Chris Lesage is a freelance rigging TD and tools developer. He's worked on productions like Kena: Bridge of Spirits, The Little Prince, Majora's Mask Terrible Fate, Playmobil, and more.

⬅ Previous Post: