Go to: Synopsis. Return value. Related. Flags. Python examples.

Synopsis

loadPlugin( string [string...] , [addCallback=script], [allPlugins=boolean], [name=string], [quiet=boolean], [removeCallback=script])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

loadPlugin is undoable, NOT queryable, and NOT editable.

Load plug-ins into Maya. The parameter(s) to this command are either the names or pathnames of plug-in files. The convention for naming plug-ins is to use a .so extension on Linux, a .mll extension on Windows and .bundle extension on Mac OS X. If no extension is provided then the default extension for the platform will be used. To load a Python plugin you must explicitly supply the '.py' extension.

If the plugin was specified with a pathname then that is where the plugin will be searched for. If no pathname was provided then the current working directory (i.e. the one returned by Maya's 'pwd' command) will be searched, followed by the directories in the MAYA_PLUG_IN_PATH environment variable.

When the plug-in is loaded, the name used in Maya's internal plug-in registry for the plug-in information will be the file name with the extension removed. For example, if you load the plug-in "newNode.mll" the name used in the Maya's registry will be "newNode". This value as well as that value with either a ".so", ".mll" or ".bundle" extension can be used as valid arguments to either the unloadPlugin or pluginInfo commands.

Return value

string[]the internal names of the successfully loaded plug-ins

Related

openMayaPref, pluginInfo, unloadPlugin

Flags

addCallback, allPlugins, name, quiet, removeCallback
Long name (short name) Argument types Properties
name(n) string create
Set a user defined name for the plug-ins that are loaded. If the name is already taken, then a number will be added to the end of the name to make it unique.
allPlugins(a) boolean create
Cause all plug-ins in the search path specified in MAYA_PLUG_IN_PATH to be loaded.
quiet(qt) boolean create
Don't print a warning if you attempt to load a plug-in that is already loaded.
addCallback(ac) script create
Add a MEL or Python callback script to be called after a plug-in is loaded. For MEL, the procedure should have the following signature: global proc procedureName(string $pluginName). For Python, you may specify either a script as a string, or a Python callable object such as a function. If you specify a string, then put the formatting specifier "%s" where you want the name of the plug-in to be inserted. If you specify a callable such as a function, then the name of the plug-in will be passed as an argument.
removeCallback(rc) script create
Removes a procedure which was previously added with -addCallback.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Load the plug-in named "newNode" into Maya.
#
cmds.loadPlugin( 'newNode.py' )

# Load all the plug-ins found in all the directories that are
# included in MAYA_PLUG_IN_PATH.
#
cmds.loadPlugin( allPlugins=True )