¶ Download
Download the module at https://boosty.to/ahoge
Please subscribe for the latest updates and news.
¶ Installation
Unzip the .zip file. You can drag and drop install.mel onto Maya's viewport to install the module.
install.mel changes Maya.env at C:\Users\%username%\Documents\maya\2024
You can change it yourself and not use install.mel.
The
MAYA_MODULE_PATHvariable defines the search paths for Maya module files.
ahoge.mod is the module description file that declares the environment for the Ahoge module. The MAYA_MODULE_PATH should include the path to the folder that contains ahoge.mod
Maya.env would look something like this:
MAYA_MODULE_PATH=%MAYA_MODULE_PATH%;D:/projects/ahoge/ahoge_module
MAYA_MODULE_PATH=$MAYA_MODULE_PATH~/ahoge/ahoge_module
¶ Reinstallation
If Maya.env is already set up when you drag and drop the script from another folder, it changes the path to point to the new folder instead. This way, a new version can be installed from a different location.
install.mel assumes that Ahoge's installation path contains the string 'ahoge_module'. It will not update any lines that do not include this string; instead, it will append a new line.
¶ Uninstallation
Change Maya.env manually, make it so MAYA_MODULE_PATH doesn't point at ahoge_module.
¶ Troubleshooting
Maya.env file is empty by default. External plugins usually set up the environment using system environment variables. If something goes wrong, it's generally safe to clear the Maya.env file and set it up again.
Usually, the Maya.env file is left for the user to configure their environment. However, I don't know everything, so I might be mistaken about that. There might be some plugins that do things differently. If you have a lot of plugins installed, manually installing Ahoge might be the best approach.
¶ Manual Installation
Some users are reporting problems with install.mel. I suspect this may be due to different Windows localizations; for example, some versions of Windows use different delimiters. MEL isn't designed to handle internationalization, so I decided to explain how to install Ahoge without using install.mel and to make the instructions as clear as possible. I will try Ahoge on Chinese Windows later, and I will research the internationalization of environment variables.
In a few steps:
- Unzip the file somewhere, for example
D:/maya_plugins/ahoge_module - Edit Maya.env, using Notepad or any other text editor, at
C:\Users\%username%\Documents\maya\2024where2024is your version of Maya
Maya.env would look something like this:
MAYA_MODULE_PATH=%MAYA_MODULE_PATH%;D:/maya_plugins/ahoge_module
That's it! However, here is an explanation of how it works.
The ahoge_module folder must contain ahoge.mod, and the MAYA_MODULE_PATH environment variable must point to the folder that contains ahoge.mod.
ahoge.mod declares the search paths for Maya so that Maya can find the Maya plugin, scripts, icons, and Arnold plugin. Without its scripts, icons, and plugins, Ahoge won't function properly, so the environment must be set up correctly.