Variabili Maya | Guida Setup

Comprendere le variabili d'ambiente di Maya

Quando configuriamo Maya per flussi di lavoro di rendering professionali, le variabili d'ambiente diventano uno dei componenti più critici. Che stiamo lavorando localmente o preparando scene per l'invio a una render farm, queste variabili controllano come Maya accede a plugin, script, moduli e motori di rendering.

Abbiamo scoperto che le variabili d'ambiente configurate erroneamente causano più fallimenti su render farm rispetto a qualsiasi altro problema. Una scena che esegue il rendering perfettamente in locale potrebbe fallire completamente su un nodo della render farm perché la configurazione dell'ambiente è diversa. Questa guida illustra come configurare le variabili d'ambiente di Maya su tutte le piattaforme e garantire la compatibilità con i sistemi di render farm.

Cosa sono le variabili d'ambiente di Maya?

Le variabili d'ambiente di Maya sono impostazioni basate su testo che controllano dove Maya cerca le risorse. Determinano:

Posizioni dei plugin (MAYA_PLUG_IN_PATH)
Percorsi di ricerca dei moduli (MAYA_MODULE_PATH)
Directory degli script (MAYA_SCRIPT_PATH)
Configurazioni del motore di rendering
Posizioni dei server di licenza
Percorsi degli strumenti personalizzati

Definiamo queste variabili nel file maya.env.

Posizioni delle directory specifiche della piattaforma

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

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

Linux: ~/maya/[version]

Creazione e modifica

Per creare o modificare il file maya.env, naviga nella directory della tua versione di Maya usando il file manager o il terminale. Se il file non esiste, puoi crearlo con un editor di testo come VSCode, Sublime Text o Notepad.

Importante: assicurati che il file sia denominato esattamente maya.env e che sia salvato in formato di testo ASCII o UTF-8 senza BOM. Non usare RTF o altri formati.

Sintassi

La sintassi di maya.env è semplice e basata su coppie chiave-valore:

VARIABLE_NAME = /path/to/directory
ANOTHER_VARIABLE = /another/path

Ogni variabile deve essere su una riga separata. Usa il segno di uguale (=) per assegnare i valori. Gli spazi attorno al segno di uguale sono facoltativi ma consigliati per leggibilità.

Per Windows, usa le barre rovesciate o le barre normali:

MAYA_PLUG_IN_PATH = C:\Program Files\MyPlugins
MAYA_SCRIPT_PATH = C:/Users/myuser/Documents/scripts

Per macOS e Linux, usa le barre normali:

MAYA_PLUG_IN_PATH = /opt/myPlugins
MAYA_SCRIPT_PATH = ~/scripts

Sintassi dei percorsi

Maya supporta diversi formati di percorso a seconda della piattaforma:

Windows:

Percorsi assoluti: C:\Program Files\Autodesk\Maya2026\bin
Percorsi UNC: \\servername\share\maya
Percorsi con barre normali: C:/Program Files/Autodesk/Maya2026/bin

macOS e Linux:

Percorsi assoluti: /usr/autodesk/maya2026/bin
Percorsi home: ~/maya/scripts (la tilde rappresenta la directory home)

Per separare più percorsi nella stessa variabile, usa il separatore di percorso della piattaforma:

Windows: ; (punto e virgola)
macOS e Linux: : (due punti)

Esempio:

MAYA_PLUG_IN_PATH = /opt/plugins:/usr/local/plugins:~/plugins
MAYA_SCRIPT_PATH = C:\plugins\scripts;C:\users\myuser\scripts

Variabili essenziali

MAYA_PLUG_IN_PATH — Specifica dove Maya cerca i plugin. Maya caricherà automaticamente i plugin .mll (Windows), .so (Linux) e .bundle (macOS) trovati in questi percorsi.

MAYA_PLUG_IN_PATH = /opt/plugins:~/maya/plugins

MAYA_MODULE_PATH — Definisce i percorsi di ricerca per i moduli Maya. I moduli sono pacchetti organizzati che possono contenere plugin, script e dati.

MAYA_MODULE_PATH = /usr/autodesk/modules:~/maya/modules

MAYA_SCRIPT_PATH — Specifica dove Maya cerca gli script MEL e Python. Gli script in questi percorsi sono automaticamente disponibili nei menu e negli editor di script.

MAYA_SCRIPT_PATH = ~/maya/scripts:~/project/scripts

MAYA_SHELF_PATH — Definisce i percorsi per i file shelf personalizzati (barre di strumenti).

MAYA_SHELF_PATH = ~/maya/shelves:~/project/shelves

MAYA_RENDER_DESC_PATH — Controlla dove Maya cerca i descrittori dei motori di rendering come Arnold, V-Ray e Redshift.

MAYA_RENDER_DESC_PATH = /opt/renderers/descriptions

Configurazione per render farm

Quando prepari scene per l'invio a SuperRenders o altre render farm, considera questi fattori importanti:

Percorsi assoluti vs relativi — Usa percorsi assoluti o UNC sui sistemi Windows. I percorsi relativi potrebbero non funzionare su nodi di render farm diversi.
Percorsi di rete — Se i tuoi plugin o script si trovano su un server di rete, usa percorsi UNC o NFS per assicurarti che tutti i nodi vi accedano:

MAYA_PLUG_IN_PATH = \\renderserver\plugins:C:\local\plugins
MAYA_SCRIPT_PATH = /mnt/network/scripts:~/local/scripts

Versioni coerenti — Assicurati che tutti i nodi della render farm utilizzino la stessa versione di Maya e gli stessi plugin. Se una configurazione di variabili d'ambiente funziona in locale, verifica che i percorsi siano accessibili anche sulla render farm.
Render engine setup — Configura le variabili per i tuoi motori di rendering principali:

MAYA_RENDER_DESC_PATH = /opt/arnold/descriptions:/opt/vray/descriptions
REDSHIFT_PLUGIN_PATH = /opt/redshift/plugins

Esempi completi

Configurazione locale di base (Windows):

MAYA_PLUG_IN_PATH = C:\Program Files\Autodesk\Maya2026\plug-ins;C:\Users\artist\Documents\maya\2026\plug-ins
MAYA_SCRIPT_PATH = C:\Users\artist\Documents\maya\2026\scripts;C:\project\maya\scripts
MAYA_MODULE_PATH = C:\Users\artist\Documents\maya\2026\modules
MAYA_SHELF_PATH = C:\Users\artist\Documents\maya\2026\shelves

Configurazione per render farm (Linux):

MAYA_PLUG_IN_PATH = /usr/autodesk/maya2026/plug-ins:/opt/plugins:/home/renderfarm/plugins
MAYA_SCRIPT_PATH = /usr/autodesk/maya2026/scripts:/opt/scripts:/home/renderfarm/scripts
MAYA_MODULE_PATH = /usr/autodesk/maya2026/modules:/opt/modules
MAYA_RENDER_DESC_PATH = /opt/arnold/descriptions:/opt/redshift/descriptions
REDSHIFT_PLUGIN_PATH = /opt/redshift/plugins

Configurazione per macOS con sviluppo locale:

MAYA_PLUG_IN_PATH = /Applications/Autodesk/maya2026/plug-ins:~/maya/plugins:~/Development/mayaPlugins
MAYA_SCRIPT_PATH = ~/maya/scripts:~/Development/scripts:~/project/pipeline/scripts
MAYA_MODULE_PATH = ~/maya/modules:/usr/local/maya/modules
MAYA_SHELF_PATH = ~/maya/shelves

Risoluzione dei problemi

Maya non trova il mio plugin

Se Maya non carica un plugin nonostante sia nel percorso corretto:

Verifica che il percorso sia elencato in MAYA_PLUG_IN_PATH
Controlla i permessi del file — il file deve essere leggibile
Assicurati che la versione del plugin corrisponda alla versione di Maya
Verifica che il plugin sia della giusta architettura (32-bit vs 64-bit)
Consulta i file di log di Maya in ~/maya/[version]/logs per messaggi di errore specifici

Il percorso non viene trovato anche se esiste

Le cause più comuni sono:

Spazi nei percorsi — non è necessario usare virgolette, ma assicurati che il percorso sia corretto
Barre nella direzione sbagliata — usa / su macOS e Linux, \ o / su Windows
Caratteri non ASCII — evita caratteri speciali nei nomi di percorsi e file
Sezioni non montate — su sistemi di render farm, assicurati che i percorsi di rete siano montati

Errori di plugin su render farm

Se uno script funziona localmente ma fallisce sulla render farm:

Verifica che il percorso sia accessibile dal nodo di render farm
Controlla che la stessa versione di Maya sia installata
Assicurati che i percorsi UNC (Windows) o NFS (Linux) siano configurati correttamente
Verifica i permessi di accesso ai file di rete

Pratiche consigliate

Documentazione — Mantieni un documento che elenca tutte le variabili d'ambiente che usi e perché.
Backup — Prima di modificare maya.env, fai sempre una copia di backup.
Versioni separate — Se usi più versioni di Maya, puoi avere maya.env separati per ogni versione nella loro rispettiva directory.
Test incrementali — Quando aggiungi una nuova variabile, testa che non interrompa nulla.
Commenti — Anche se maya.env non supporta commenti nativi, puoi mantenere un file di documentazione separato.
Percorsi coerenti — Usa la stessa struttura di directory su tutte le tue macchine (locali e render farm) per minimizzare i problemi di configurazione.

Test

Per verificare che le tue variabili d'ambiente siano configurate correttamente:

Apri Maya
Apri il Python Command Line (Script Editor in modalità Python)
Esegui questo comando:

import os
print(os.environ.get('MAYA_PLUG_IN_PATH'))
print(os.environ.get('MAYA_SCRIPT_PATH'))

Questo visualizzerà il valore effettivo delle tue variabili d'ambiente in Maya. Se vengono visualizzati valori None, significa che la variabile non è configurata.

In alternativa, nel MEL Editor:

getenv MAYA_PLUG_IN_PATH;
getenv MAYA_SCRIPT_PATH;

Scopri di più

Per una comprensione più profonda delle variabili d'ambiente di Maya e della configurazione di sistema, consulta la Autodesk Maya documentation ufficiale.

FAQ

Perché Maya non trova il mio plugin?

Verifica che il percorso sia elencato correttamente in MAYA_PLUG_IN_PATH, che il file plugin abbia i permessi di lettura corretti e che la versione del plugin corrisponda alla tua versione di Maya.

Posso usare la sostituzione di variabili?

Sì, Maya supporta l'uso di variabili d'ambiente standard del sistema. Ad esempio, su Windows puoi usare %USERPROFILE% e su macOS/Linux $HOME.

Devo mantenere un maya.env separato per ogni versione di Maya?

Sì, ogni versione di Maya ha la sua directory dedicata. Puoi avere un maya.env separato in ogni directory della versione per configurazioni specifiche.

Cosa succede se specifico un percorso che non esiste?

Maya semplicemente ignorerà il percorso che non esiste e continuerà a cercare negli altri percorsi elencati. Non genererà errori.

Devo includere i percorsi predefiniti di Maya?

No. Maya include automaticamente i suoi percorsi predefiniti. Devi solo aggiungere i tuoi percorsi personalizzati e le risorse di terze parti.

Ulteriori Informazioni

Conclusione

La configurazione corretta delle variabili d'ambiente di Maya è essenziale per flussi di lavoro di rendering stabili e professionale. Testando a fondo prima di lavorare su progetti di produzione, assicuri che le tue scene renderizzino correttamente sia localmente che su render farm come SuperRenders.

Prova gratis su SuperRenders per vedere come i nostri sistemi gestiscono automaticamente la configurazione dell'ambiente per il tuo progetto Maya.

Guida alla configurazione delle variabili d'ambiente di Maya