Variables de entorno de Maya: guía de configuración

Comprender las variables de entorno de Maya

Cuando configuramos Maya para flujos de trabajo de renderizado profesional, las variables de entorno se convierten en uno de los componentes más críticos. Tanto si trabajamos en local como si preparamos escenas para enviarlas a una render farm, estas variables controlan cómo accede Maya a los plugins, los scripts, los módulos y los motores de renderizado.

Hemos comprobado que las variables de entorno mal configuradas provocan más fallos en la render farm que cualquier otro problema.

Estas variables cambian ligeramente con cada versión; nuestra guía sobre la cloud render farm para Maya 2027 explica los detalles del envío para la versión 2027. Una escena que se renderiza perfectamente en local puede fallar por completo en un nodo de la render farm porque la configuración del entorno es distinta. Esta guía explica cómo configurar las variables de entorno de Maya en todas las plataformas y cómo garantizar la compatibilidad con los sistemas de una render farm.

¿Qué son las variables de entorno de Maya?

Las variables de entorno de Maya son ajustes basados en texto que controlan dónde busca Maya sus recursos. Determinan:

Ubicaciones de plugins (MAYA_PLUG_IN_PATH)
Rutas de búsqueda de módulos (MAYA_MODULE_PATH)
Directorios de scripts (MAYA_SCRIPT_PATH)
Configuraciones de los motores de renderizado
Ubicaciones de los servidores de licencias
Rutas de herramientas personalizadas

Definimos estas variables en el archivo maya.env, un archivo de configuración de texto sin formato que Maya lee al iniciarse. La sintaxis es sencilla: NAME=value, pero los detalles específicos de cada plataforma importan mucho para la fiabilidad.

Ubicación de los directorios según la plataforma

Antes de crear o editar su archivo maya.env, debemos localizar el directorio correcto para su sistema operativo.

Windows En Windows, el archivo maya.env se encuentra en la carpeta de documentos específica de la versión de Maya:

C:\Users\[username]\Documents\maya\[version]

Por ejemplo, si usa Maya 2026, la ruta sería:

C:\Users\JohnDoe\Documents\maya\2026

macOS En los sistemas Mac, Maya almacena la configuración en la carpeta Preferences:

/Users/[username]/Library/Preferences/Autodesk/maya/[version]

La ruta completa para Maya 2026 tiene este aspecto:

/Users/johndoe/Library/Preferences/Autodesk/maya/2026

Linux Las instalaciones de Linux usan la carpeta maya del directorio personal:

~/maya/[version]

Que se expande a:

/home/username/maya/2026

Creación y edición del archivo maya.env

El archivo maya.env debe ser un archivo de texto sin formato (ASCII), nunca RTF ni ningún documento con formato. Le recomendamos usar un editor de texto adecuado, como VSCode, Sublime Text o incluso el Bloc de notas en Windows.

Cree un archivo nuevo con el nombre exacto maya.env (sin extensión) en la ubicación correspondiente a su plataforma. Si el directorio no existe, créelo primero.

Sintaxis de las variables de entorno de Maya

Cada variable de entorno sigue un formato sencillo:

VARIABLE_NAME=value

Una variable por línea. Sin espacios alrededor del signo igual. Los comentarios comienzan con el símbolo de almohadilla (#).

# This is a comment
MAYA_PLUG_IN_PATH=/path/to/plugins
MAYA_MODULE_PATH=/path/to/modules

Sintaxis de rutas según la plataforma

La sintaxis de las rutas difiere entre sistemas operativos. Debemos tener cuidado en este punto.

Sintaxis de rutas en Windows Windows usa barras invertidas como separadores de ruta y punto y coma para separar varias rutas:

MAYA_PLUG_IN_PATH=C:\Program Files\Plugins;C:\Custom\Plugins;C:\Renders\Plugins

La sustitución de variables en Windows usa signos de porcentaje:

MAYA_PLUG_IN_PATH=%MAYA_LOCATION%\bin\plug-ins;C:\Custom\Plugins

Sintaxis de rutas en macOS y Linux Los sistemas basados en Unix usan barras diagonales y dos puntos para separar las rutas:

MAYA_PLUG_IN_PATH=/usr/local/plugins:/opt/custom/plugins:/home/renders/plugins

La sustitución de variables usa signos de dólar:

MAYA_PLUG_IN_PATH=$MAYA_LOCATION/bin/plug-ins:/opt/custom/plugins

Variables de entorno esenciales para nuestro flujo de trabajo

Hemos identificado las variables principales más importantes para la integración con una render farm:

MAYA_MODULE_PATH Controla dónde busca Maya los módulos (colecciones organizadas de plugins, scripts y definiciones de shelf). Para el trabajo con una render farm, debe incluir las ubicaciones de módulos de la farm:

# Windows
MAYA_MODULE_PATH=C:\Program Files\Autodesk\Maya2026\modules;C:\Farm\modules

# Mac/Linux
MAYA_MODULE_PATH=/Applications/Autodesk/maya2026/modules:/opt/farm/modules

MAYA_PLUG_IN_PATH Especifica las ubicaciones de los plugins. Es esencial para los motores de renderizado y las herramientas especializadas:

# Windows
MAYA_PLUG_IN_PATH=C:\Program Files\Autodesk\Maya2026\bin\plug-ins;C:\RenderEngine\plugins

# Mac/Linux
MAYA_PLUG_IN_PATH=/Applications/Autodesk/maya2026/plug-ins:/opt/renderengine/plugins

MAYA_SCRIPT_PATH Determina dónde encuentra Maya los scripts de MEL y Python:

# Windows
MAYA_SCRIPT_PATH=C:\Program Files\Autodesk\Maya2026\scripts;C:\Custom\Scripts

# Mac/Linux
MAYA_SCRIPT_PATH=/Applications/Autodesk/maya2026/scripts:/opt/custom/scripts

Variables del servidor de licencias Cuando utilice una render farm, apunte a su servidor de licencias:

MAYA_LICENSE=8000
MAYA_LICENSE_SERVER=license.yourcompany.com

Las variables de entorno son una pieza del conjunto del envío a la nube; la lista de verificación previa completa (que incluye auditorías del árbol de referencias, fijación de versiones de plugins y reasignación de rutas relativas al proyecto) se describe en nuestra guía del flujo de trabajo de renderizado en la nube con Maya, que se apoya en la configuración de maya.env descrita arriba.

Configuración específica de la render farm

Cuando preparamos escenas para enviarlas a una render farm, varias variables adicionales pasan a ser críticas. Nuestros nodos funcionan en servidores Linux, por lo que necesitan rutas específicas configuradas.

Ubicación del plugin del motor de renderizado Su motor de renderizado (Arnold, RenderMan, V-Ray, etc.) debe ser accesible en los nodos de la render farm:

MAYA_PLUG_IN_PATH=/opt/farm/renderers/arnold/bin:/opt/farm/renderers/vray/bin

Rutas montadas en la farm Si la render farm monta unidades de proyecto, configure esas rutas:

PROJECT_PATH=/mnt/renders/projects
TEXTURE_PATH=/mnt/shared/textures
CACHE_PATH=/mnt/renders/cache

Variables de renderizado por lotes Para el renderizado por lotes o sin interfaz gráfica en la render farm:

MAYA_BATCH_RENDER_TIMEOUT=3600
MAYA_DISABLE_PARALLEL_BATCH_RENDERING=0

Ejemplos habituales de configuración de maya.env

Ejemplo 1: configuración de desarrollo en Windows

# Windows Maya 2026 for local development
MAYA_MODULE_PATH=C:\Program Files\Autodesk\Maya2026\modules;C:\Users\artist\Documents\maya\modules
MAYA_PLUG_IN_PATH=C:\Program Files\Autodesk\Maya2026\bin\plug-ins;C:\Tools\plugins;C:\RenderEngine\arnold\bin
MAYA_SCRIPT_PATH=C:\Program Files\Autodesk\Maya2026\scripts;C:\Users\artist\Documents\maya\scripts
MAYA_DISABLE_CNETWORK=1
MAYA_LICENSE_SERVER=192.168.1.100

Ejemplo 2: configuración de desarrollo en macOS

# macOS Maya 2026 for local development
MAYA_MODULE_PATH=/Applications/Autodesk/maya2026/modules:/Users/artist/Library/Preferences/Autodesk/maya/modules
MAYA_PLUG_IN_PATH=/Applications/Autodesk/maya2026/plug-ins:/opt/tools/plugins:/opt/renderers/arnold/bin
MAYA_SCRIPT_PATH=/Applications/Autodesk/maya2026/scripts:/Users/artist/Library/Preferences/Autodesk/maya/scripts
MAYA_LICENSE_SERVER=license.internal.com

Ejemplo 3: configuración de un nodo Linux de la render farm

# Linux Maya 2026 on render farm nodes
MAYA_MODULE_PATH=/opt/autodesk/maya2026/modules:/opt/farm/modules:/opt/renderers/modules
MAYA_PLUG_IN_PATH=/opt/autodesk/maya2026/bin/plug-ins:/opt/farm/plugins:/opt/renderers/arnold/bin:/opt/renderers/vray/bin
MAYA_SCRIPT_PATH=/opt/autodesk/maya2026/scripts:/opt/farm/scripts
PROJECT_PATH=/mnt/renders/projects
TEXTURE_PATH=/mnt/shared/textures
MAYA_LICENSE_SERVER=license.farm.internal
MAYA_DISABLE_PARALLEL_BATCH_RENDERING=0

Solución de problemas con variables de entorno

Hemos recopilado los problemas más habituales que vemos cuando las variables de entorno fallan.

Rutas con espacios Las rutas de Windows suelen contener espacios (Program Files). No entrecomille nunca la ruta completa en maya.env:

# WRONG
MAYA_PLUG_IN_PATH="C:\Program Files\Plugins"

# CORRECT
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins

Separadores mezclados Usar barras diagonales en Windows o barras invertidas en Linux rompe las rutas:

# WRONG on Windows
MAYA_PLUG_IN_PATH=C:/Program Files/Plugins

# CORRECT on Windows
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins

Discrepancia con la render farm La configuración local difiere de la de la farm. Una escena se renderiza en local pero falla en la render farm cuando las variables apuntan a rutas que solo existen en local. Pruebe siempre las escenas con rutas equivalentes a las de la farm.

El plugin no se carga Si un plugin no se carga a pesar de que las rutas son correctas, compruebe los permisos de archivo en la render farm. Algunos plugins necesitan permisos de ejecución:

chmod +x /opt/farm/plugins/pluginname.so

Espacios en los valores de las variables Algunos valores (como las rutas) contienen espacios, pero la propia variable no admite comillas. Esto funciona:

MAYA_MODULE_PATH=/path with spaces/modules

Pero los valores complejos podrían requerir caracteres de escape en su sistema.

Prácticas recomendadas para las variables de entorno

Recomendamos estas prácticas para garantizar la fiabilidad:

Mantenga su maya.env organizado y documentado. Añada comentarios que expliquen las rutas o variables poco evidentes que otras personas podrían no reconocer.

Pruebe la exportación de escenas a su render farm con la configuración de entorno actual. Verifique que todos los plugins y dependencias se resuelven correctamente.

Versione su configuración de maya.env. Registre los cambios cuando añada motores de renderizado o actualice el software de la farm. Nosotros guardamos la nuestra en control de versiones.

Utilice la sustitución de variables de entorno siempre que sea posible. En lugar de codificar las rutas de forma fija, haga referencia a variables existentes como $MAYA_LOCATION o %MAYA_LOCATION%.

No mezcle nunca rutas locales y de la farm en la misma variable. Cree archivos de configuración independientes para el desarrollo local y para el envío a la render farm.

Separe sus scripts y plugins personales de los valores predeterminados de la aplicación. Esto facilita las actualizaciones y evita conflictos.

Prueba de su configuración

Después de configurar maya.env, pruébelo antes de enviar trabajo importante a la render farm.

Abra Maya y ejecute este comando de Python en el Script Editor:

import os
print(os.getenv('MAYA_MODULE_PATH'))

Esto muestra la ruta expandida real que Maya está usando. Verifique que los plugins se cargan correctamente: Windows > Settings/Preferences > Plug-in Manager. Compruebe que sus plugins personalizados aparecen en la lista.

Para probar con la render farm, envíe una escena de prueba sencilla con sus plugins personalizados activados. Así se detectan los errores de configuración antes de que afecten a las escenas de producción.

Más información sobre la configuración de Maya

Le recomendamos consultar la documentación oficial de Autodesk Maya para conocer los detalles específicos de cada versión y las opciones de configuración avanzada. La documentación cubre las variables de entorno de forma exhaustiva y se actualiza con cada versión de Maya.

Para los detalles de la integración con la render farm, consulte nuestra guía de inicio, que explica la configuración del lado de la farm y los flujos de trabajo de envío de escenas. También puede explorar nuestros servicios de renderizado en la nube con 3ds Max y de cloud render farm para Arnold para flujos de trabajo integrados.

FAQ

Q: ¿Por qué Maya no encuentra mi plugin aunque la ruta sea correcta en maya.env? A: Compruebe que el propio archivo del plugin tenga permisos de lectura y que coincida con su versión de Maya (un plugin para Maya 2025 no se cargará en Maya 2026). Verifique también que está editando el archivo maya.env en la ubicación correcta para su versión de Maya.

Q: ¿Puedo usar la sustitución de variables de entorno, como $MAYA_LOCATION, en maya.env? A: Sí, funcionan tanto la sustitución de Windows (%VARIABLE%) como la de estilo Unix ($VARIABLE). Esto hace que su configuración sea portable entre sistemas.

Q: ¿Necesito archivos maya.env distintos para diferentes versiones de Maya? A: Sí. Maya almacena las configuraciones en directorios específicos de cada versión. Cada versión lee su propio archivo maya.env, de modo que puede tener configuraciones diferentes para Maya 2025 y Maya 2026.

Q: ¿Qué ocurre si incluyo en MAYA_PLUG_IN_PATH una ruta que no existe? A: Maya omite las rutas inexistentes sin mostrar ningún error. Simplemente, el plugin no se cargará si falta la ruta. Verifique siempre que las rutas existen antes de probar.

Q: ¿Debo incluir en mis variables las rutas predeterminadas de Autodesk? A: No. Maya incluye automáticamente las rutas predeterminadas. Incluirlas de nuevo provoca búsquedas redundantes y ralentiza el inicio. Añada únicamente rutas personalizadas y ubicaciones de terceros.

Conclusión

Configurar correctamente las variables de entorno de Maya rinde frutos al trabajar con render farms. Le hemos mostrado la sintaxis específica de cada plataforma, las variables esenciales para la integración con una render farm y las configuraciones habituales para el desarrollo y para los nodos de la farm.

La clave está en probar a fondo antes de enviar trabajo de producción. Pequeños errores de configuración se encadenan y acaban provocando fallos en el envío a la farm y tiempo de renderizado desperdiciado.

Su entorno debe reflejar las rutas reales de su sistema, no las de los ejemplos de otras personas. Dedique tiempo a contrastar su configuración concreta con los patrones que hemos mostrado, verifique que las rutas existen y contienen los archivos correctos, y pruebe siempre primero con una escena sencilla.