Installation

Most GENtools products comes with a simple installer that will install all the necessary files automatically.

If your product came with an executable installer, you can follow the steps below, otherwise please look at the specific product documentation for more information.

  • You should close your Maya application before installing, otherwise you will need to restart Maya to access the tools.

Demonstration Video #

Step-by-Step Instructions #

Double click on the executable to launch the GENtools installer.
If you have multiple Maya versions installed, select which one you want to use.
Click on the checkbox to accept the License Agreement and press the Install button.
If you already have a previous installation, you will be asked if you want to overwrite those files, press Yes to continue.
If a running application is preventing the installer to write files, you will be asked to close the application temporarily to continue.
Wait while the installation is in progress.
After the installation is done, you can close the installer.

Installation Requirements #

Some of our tools might requires some optional components when installing Maya, so make sure to verify that you have installed these components before using them, otherwise you will encounter errors.

Placement Tool

The Placement Tool requires the PyMEL module to be installed, make sure to have it installed or the tool will not work.

If PyMEL is not installed, you will need to either re-install your Maya and make sure the PyMEL checkbox is checked during the installation or you could try to follow the instructions at the link below to install PyMEL manually.
https://knowledge.autodesk.com/support/maya/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/Maya-Scripting/files/GUID-2AA5EFCE-53B1-46A0-8E43-4CD0B2C72FB4-htm.html

Installation Failure #

If you encountered an error during the installation and the installation failed, you can try to run the installer with administrator rights and see if it installs successfully. If it still fails, you can try troubleshooting your installation or installing manually or you may contact us so we can help you with the issue.

Troubleshooting Installation #

If your installation went successfully but your GENtools product is not available after starting Maya, you can verify that the GENtools files are existing on your system.

Also, please make sure you installed the latest version of the GENtools product available in your ArtStation library.

When contacting us for an installation issue, please share with us the informations you gathered by doing the verifications detailed below, which we will ask you to do.

Verify GENtools directory #

Navigate to the path below, and replace MAYA_VERSION with your version of Maya.

\%userprofile%\documents\maya\MAYA_VERSION\scripts

In this directory, check to see if a folder named GENtools is present and verify if the folder is empty or not.

If the GENtools folder is missing or is empty, it means something went wrong with the installation, you may contact us so we can help you with the issue.

Verify userSetup.mel file #

Navigate to the path below, and replace MAYA_VERSION with your version of Maya.

\%userprofile%\documents\maya\MAYA_VERSION\scripts

In this directory, check to see if a file named userSetup.mel is present. Open the file with Notepad and check if you see the line below inside the file.

catchQuiet(python("import GENtools.startup"));

If your GENtools directory exists but the userSetup.mel file is missing or does not contain the line above, you can try to create or edit the file, add the line above and restart Maya.

If it still doesn’t work or something is unclear, you can contact us so that we can help you with your issue.

Starting GENtools manually #

If you verified your GENtools installation and the files appear to be installed correctly but the GENtools Menu is not loading when you start Maya, it might be possible that your userSetup.mel file is being overridden or ignored by something in your configuration.

You should be able to start GENtools manually after Maya has started by running the Python code below from the Command Line or from the Script Editor.

import GENtools.startup

Installing GENtools in a different location #

It can sometimes happen that the path where GENtools is installed cause a problem loading the files in Maya, especially with the plugins files.

If you are having trouble starting GENtools or you are getting errors such as “can’t decode byte 0xc0 in position 9: invalid start byte” , then it is worth a try to move the installation directory elsewhere, preferably to a path without any special characters, space, etc.

After installing GENtools normally, navigate to the path below (replace MAYA_VERSION with your version of Maya).

\%userprofile%\documents\maya\MAYA_VERSION\scripts

In this directory, check for the folder named GENtools and move the folder to the location of your choice, for example:

C:\Maya\Scripts\

You should now be able to start GENtools by running the Python code below from the Command Line or from the Script Editor.

Simply replace with the path inside sys.path.append with the path where you moved the GENtools folder, for example:

import sys;sys.path.append("C:/Maya/Scripts");import GENtools.startup

Finally, if you wish to start GENtools automatically on Maya’s startup, simply add the line below to your userSetup.mel.

Again, remember to replace the path inside sys.path.append with the path where you moved the GENtools folder.

catchQuiet(python("import sys;sys.path.append('C:/Maya/Scripts');import GENtools.startup"));

Installing Manually #

If, for any reasons, you wish to install manually instead of using the GENtools Installer, you can follow the instructions below.

First, you will need to download the provided zip file from the product you want to install in your Artstation library.

Then, you can extract the content of the zip file in the directory of your choice.

Your extracted directory should look like in the image below.
You can now either run the Install.bat file to automate the installation steps or continue following the instructions to do it yourself.

Inside the \Files\scripts directory, copy the GENtools folder to the path below (replace MAYA_VERSION with your version of Maya).

\%userprofile%\documents\maya\MAYA_VERSION\scripts

Inside the \Files\modules directory, copy all the files to the path below (replace MAYA_VERSION with your version of Maya).

\%userprofile%\documents\maya\MAYA_VERSION\modules

Inside the \Files\registry directory, select all the files, right click and click on Merge to add the values to your registry.

Finally, navigate to the path below (replace MAYA_VERSION with your version of Maya).

\%userprofile%\documents\maya\MAYA_VERSION\scripts

In this directory, check to see if a file named userSetup.mel exists, otherwise create the file.
Open the file with Notepad and add the line below inside the file.

catchQuiet(python("import GENtools.startup"));

If Maya was opened, you will will need to restart it to access the tools.