Variables d'environnement Maya

Comprendre les variables d'environnement Maya

Lorsque nous configurons Maya pour des workflows de rendu professionnels, les variables d'environnement deviennent l'un des composants les plus critiques. Que nous travaillions localement ou que nous préparions des scènes pour l'envoi à une ferme de rendu, ces variables contrôlent comment Maya accède aux plugins, scripts, modules et moteurs de rendu.

Nous avons constaté que les variables d'environnement mal configurées causent plus d'échecs de ferme de rendu que tout autre problème. Une scène qui se rend parfaitement localement peut échouer complètement sur un nœud de ferme de rendu parce que la configuration de l'environnement diffère. Ce guide explique comment configurer les variables d'environnement Maya sur toutes les plateformes et assurer la compatibilité avec les systèmes de ferme de rendu.

Que sont les variables d'environnement Maya?

Les variables d'environnement Maya sont des paramètres texte qui contrôlent l'endroit où Maya cherche les ressources. Elles déterminent:

Les emplacements des plugins (MAYA_PLUG_IN_PATH)
Les chemins de recherche des modules (MAYA_MODULE_PATH)
Les répertoires de scripts (MAYA_SCRIPT_PATH)
Les configurations du moteur de rendu
Les emplacements du serveur de licence
Les chemins des outils personnalisés

Nous définissons ces variables dans le fichier maya.env, un fichier de configuration texte brut que Maya lit au démarrage. La syntaxe est simple: NAME=value, mais les détails spécifiques à la plateforme sont importants pour la fiabilité.

Emplacements des répertoires spécifiques à la plateforme

Avant de créer ou de modifier votre fichier maya.env, nous devons localiser le répertoire correct pour votre système d'exploitation.

Windows Sous Windows, le fichier maya.env se trouve dans votre dossier de documents spécifique à la version Maya:

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

Par exemple, si vous exécutez Maya 2026, le chemin serait:

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

macOS Sur les systèmes Mac, Maya stocke la configuration dans le dossier Preferences:

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

Le chemin complet pour Maya 2026 ressemble à:

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

Linux Les installations Linux utilisent le dossier maya du répertoire home:

~/maya/[version]

Ce qui se développe en:

/home/username/maya/2026

Créer et modifier votre fichier maya.env

Le fichier maya.env doit être un fichier texte brut (ASCII), jamais RTF ou un document formaté. Nous recommandons d'utiliser un vrai éditeur de texte comme VSCode, Sublime Text, ou même Notepad sous Windows.

Créez un nouveau fichier nommé exactement maya.env (sans extension de fichier) dans votre emplacement spécifique à la plateforme. Si le répertoire n'existe pas, créez-le d'abord.

Syntaxe des variables d'environnement Maya

Chaque variable d'environnement suit un format simple:

VARIABLE_NAME=value

Une variable par ligne. Pas d'espaces autour du signe égal. Les commentaires commencent par un symbole dièse (#).

# Ceci est un commentaire
MAYA_PLUG_IN_PATH=/path/to/plugins
MAYA_MODULE_PATH=/path/to/modules

Syntaxe des chemins spécifique à la plateforme

La syntaxe des chemins diffère entre les systèmes d'exploitation. Nous devons être prudents ici.

Syntaxe des chemins Windows Windows utilise les antislashs comme séparateurs de chemins et les points-virgules pour séparer les chemins multiples:

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

La substitution de variables sous Windows utilise des signes de pourcentage:

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

Syntaxe des chemins macOS et Linux Les systèmes de type Unix utilisent les barres obliques avant et les deux-points pour séparer les chemins:

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

La substitution de variables utilise des signes dollar:

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

Variables d'environnement essentielles pour notre workflow

Nous avons identifié les variables principales les plus importantes pour l'intégration avec la ferme de rendu:

MAYA_MODULE_PATH Contrôle l'endroit où Maya cherche les modules (collections organisées de plugins, scripts et définitions de shelf). Pour le travail avec une ferme de rendu, cela devrait inclure les emplacements de modules de votre ferme:

# 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 Spécifie les emplacements des plugins. Essentiel pour les moteurs de rendu et les outils spécialisés:

# 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 Détermine où Maya trouve les scripts MEL et 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 du serveur de licence Lorsque vous utilisez une ferme de rendu, pointez vers votre serveur de licence:

MAYA_LICENSE=8000
MAYA_LICENSE_SERVER=license.yourcompany.com

Configuration spécifique à la ferme de rendu

Lorsque nous préparons des scènes pour l'envoi à une ferme de rendu, plusieurs variables supplémentaires deviennent critiques. Nos nœuds fonctionnent sur des serveurs Linux, ils ont donc besoin de chemins spécifiques configurés.

Emplacement du plugin du moteur de rendu Votre moteur de rendu (Arnold, RenderMan, V-Ray, etc.) doit être accessible sur les nœuds de la ferme:

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

Chemins montés par la ferme Si votre ferme monte les lecteurs de projet, configurez ces chemins:

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

Variables de rendu par lot Pour le rendu par lot/headless sur la ferme:

MAYA_BATCH_RENDER_TIMEOUT=3600
MAYA_DISABLE_PARALLEL_BATCH_RENDERING=0

Exemples de configuration Maya.env courants

Exemple 1: Configuration de développement Windows

# Windows Maya 2026 pour le développement local
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

Exemple 2: Configuration de développement macOS

# macOS Maya 2026 pour le développement local
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

Exemple 3: Configuration du nœud de ferme de rendu Linux

# Linux Maya 2026 sur les nœuds de ferme de rendu
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

Dépannage des problèmes de variables d'environnement

Nous avons compilé les problèmes les plus courants que nous voyons quand les variables d'environnement ne fonctionnent pas correctement.

Chemins avec espaces Les chemins Windows contiennent souvent des espaces (Program Files). Ne mettez jamais le chemin entier entre guillemets dans maya.env:

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

# CORRECT
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins

Séparateurs mixtes L'utilisation de barres obliques avant sous Windows ou de barres obliques inverses sous Linux casse les chemins:

# FAUX sous Windows
MAYA_PLUG_IN_PATH=C:/Program Files/Plugins

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

Désaccord de ferme de rendu La configuration locale diffère de la configuration de ferme. Une scène se rend localement mais échoue sur la ferme quand les variables pointent vers des chemins locaux uniquement. Testez toujours les scènes avec des chemins équivalents à la ferme.

Plugin non chargé Si un plugin ne se charge pas malgré des chemins corrects, vérifiez les autorisations de fichier sur la ferme. Certains plugins ont besoin des autorisations exécutables:

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

Espaces dans les valeurs des variables Certaines valeurs (comme les chemins) contiennent des espaces mais la variable elle-même ne supporte pas les guillemets. Cela fonctionne:

MAYA_MODULE_PATH=/path with spaces/modules

Mais les valeurs complexes peuvent nécessiter une évasion sur votre système.

Pratiques recommandées pour les variables d'environnement

Nous recommandons ces pratiques pour assurer la fiabilité:

Gardez votre maya.env organisé et documenté. Ajoutez des commentaires expliquant les chemins non évidentsou les variables que d'autres pourraient ne pas reconnaître.

Testez l'export de scène vers votre ferme de rendu avec les paramètres d'environnement actuels. Vérifiez que tous les plugins et dépendances se résolvent correctement.

Vérifiez votre configuration maya.env. Suivez les modifications quand vous ajoutez des moteurs de rendu ou mettez à jour le logiciel de ferme. Nous stockons la nôtre dans le contrôle de version.

Utilisez la substitution de variables d'environnement si possible. Au lieu de coder en dur les chemins, référencez les variables existantes comme $MAYA_LOCATION ou %MAYA_LOCATION%.

Ne mélangez jamais les chemins locaux et de ferme dans la même variable. Créez des fichiers de configuration séparés pour le développement local et l'envoi à la ferme.

Séparez les scripts et plugins personnels des valeurs par défaut de l'application. Cela rend les mises à jour plus faciles et empêche les conflits.

Tester votre configuration

Après avoir configuré maya.env, testez-la avant d'envoyer des travaux sérieux à la ferme de rendu.

Ouvrez Maya et exécutez cette commande Python dans l'éditeur de script:

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

Cela montre le chemin réellement développé que Maya utilise. Vérifiez que les plugins se chargent correctement: Windows > Settings/Preferences > Plug-in Manager. Vérifiez que vos plugins personnalisés apparaissent dans la liste.

Pour tester la ferme de rendu, envoyez une simple scène de test avec vos plugins personnalisés activés. Cela capture les erreurs de configuration avant d'affecter les scènes de production.

En savoir plus sur la configuration de Maya

Nous vous recommandons de consulter la documentation officielle d'Autodesk Maya pour les détails spécifiques à la version et les options de configuration avancées. La documentation couvre les variables d'environnement de manière exhaustive et se met à jour à chaque version de Maya.

Pour les spécificités d'intégration avec la ferme de rendu, consultez notre guide de démarrage qui couvre la configuration côté ferme et les workflows d'envoi de scènes. Vous pouvez également explorer nos services de rendu cloud 3ds Max et ferme de rendu cloud Arnold pour des solutions de workflow intégrées.

FAQ

Pourquoi Maya ne trouve-t-il pas mon plugin même si le chemin est correct dans maya.env?

Vérifiez que le fichier plugin lui-même a les autorisations de lecture et correspond à votre version de Maya (le plugin pour Maya 2025 ne se chargera pas dans Maya 2026). Vérifiez également que vous éditez le fichier maya.env au bon endroit pour votre version de Maya.

Puis-je utiliser la substitution de variables d'environnement comme $MAYA_LOCATION dans maya.env?

Oui, la substitution de style Windows (%VARIABLE%) et Unix ($VARIABLE%) fonctionne. Cela rend votre configuration portable entre les systèmes.

Dois-je avoir des fichiers maya.env séparés pour différentes versions de Maya?

Oui. Maya stocke les configurations dans des répertoires spécifiques à la version. Chaque version lit son propre fichier maya.env, vous pouvez donc avoir des configurations différentes pour Maya 2025 et Maya 2026.

Que se passe-t-il si j'inclus un chemin qui n'existe pas dans MAYA_PLUG_IN_PATH?

Maya ignore les chemins inexistants sans erreur. Le plugin simplement ne se chargera pas si le chemin est manquant. Vérifiez toujours que les chemins existent avant de tester.

Dois-je inclure les chemins Autodesk par défaut dans mes variables?

Non. Maya inclut automatiquement les chemins par défaut. Les inclure à nouveau cause une recherche redondante et ralentit le démarrage. Ajoutez uniquement les chemins personnalisés et les emplacements tiers.

Conclusion

Configurer correctement les variables d'environnement Maya porte ses fruits lorsque vous travaillez avec des fermes de rendu. Nous vous avons montré la syntaxe spécifique à la plateforme, les variables essentielles pour l'intégration avec la ferme de rendu, et les configurations courantes pour les configurations de développement et de nœuds de ferme.

La clé est de tester en détail avant d'envoyer le travail de production. Les petites erreurs de configuration s'accumulent en échecs d'envoi de ferme de rendu et en temps de rendu gaspillé.

Votre environnement doit refléter vos chemins de système réels, pas les exemples de quelqu'un d'autre. Prenez le temps de mapper votre configuration spécifique par rapport aux modèles que nous avons montré, vérifiez que les chemins existent et contiennent les bons fichiers, et testez toujours d'abord avec une scène simple.

Guide de configuration des variables d'environnement Maya