Maya Ortam Değişkenleri Kurulum Rehberi
Genel bakış
Maya Ortam Değişkenlerini Anlamak
Profesyonel render iş akışları için Maya'yı kurarken ortam değişkenleri en kritik bileşenlerden biri haline gelir. İster yerel olarak çalışalım, ister sahneleri render farm'a göndermeye hazırlayalım, bu değişkenler Maya'nın eklentilere, script'lere, modüllere ve render motorlarına nasıl eriştiğini belirler.
Yanlış yapılandırılmış ortam değişkenlerinin, diğer tüm sorunlardan daha fazla render farm hatasına yol açtığını gözlemledik.
Bu değişkenler her sürümle birlikte hafifçe değişir; Maya 2027 cloud render farm rehberimiz 2027 sürümü için gönderim ayrıntılarını ele alır. Yerelde kusursuz render alan bir sahne, ortam kurulumu farklı olduğu için bir render farm node'unda tamamen başarısız olabilir. Bu rehber, Maya ortam değişkenlerini tüm platformlarda yapılandırmayı ve render farm sistemleriyle uyumluluğu sağlamayı adım adım anlatır.
Maya Ortam Değişkenleri Nedir?
Maya ortam değişkenleri, Maya'nın kaynaklara nerede bakacağını belirleyen metin tabanlı ayarlardır. Şunları belirlerler:
- Eklenti konumları (MAYA_PLUG_IN_PATH)
- Modül arama yolları (MAYA_MODULE_PATH)
- Script dizinleri (MAYA_SCRIPT_PATH)
- Render motoru yapılandırmaları
- Lisans sunucusu konumları
- Özel araç yolları
Bu değişkenleri, Maya'nın başlarken okuduğu düz metin yapılandırma dosyası olan maya.env dosyasında tanımlıyoruz. Söz dizimi basittir: NAME=value, ancak güvenilirlik açısından platforma özgü ayrıntılar büyük önem taşır.
Platforma Özgü Dizin Konumları
maya.env dosyanızı oluşturmadan veya düzenlemeden önce, işletim sisteminiz için doğru dizini bulmamız gerekir.
Windows Windows'ta maya.env dosyası, Maya sürümüne özgü Belgeler klasörünüzde bulunur:
C:\Users\[username]\Documents\maya\[version]
Örneğin Maya 2026 kullanıyorsanız yol şöyle olur:
C:\Users\JohnDoe\Documents\maya\2026
macOS Mac sistemlerinde Maya, yapılandırmasını Preferences klasöründe saklar:
/Users/[username]/Library/Preferences/Autodesk/maya/[version]
Maya 2026 için tam yol şöyle görünür:
/Users/johndoe/Library/Preferences/Autodesk/maya/2026
Linux Linux kurulumları, ana dizindeki maya klasörünü kullanır:
~/maya/[version]
Bu yol şuna genişler:
/home/username/maya/2026
maya.env Dosyanızı Oluşturma ve Düzenleme
maya.env dosyası düz metin (ASCII) bir dosya olmalıdır; RTF veya biçimlendirilmiş herhangi bir belge asla kullanılmamalıdır. VSCode, Sublime Text veya Windows'ta Not Defteri gibi uygun bir metin düzenleyici kullanmanızı öneririz.
Platformunuza özgü konumda, tam olarak maya.env adında (dosya uzantısı olmadan) yeni bir dosya oluşturun. Dizin yoksa önce dizini oluşturun.
Maya Ortam Değişkeni Söz Dizimi
Her ortam değişkeni basit bir biçimi izler:
VARIABLE_NAME=value
Her satıra bir değişken yazılır. Eşittir işaretinin çevresinde boşluk bırakılmaz. Yorumlar diyez işaretiyle (#) başlar.
# This is a comment
MAYA_PLUG_IN_PATH=/path/to/plugins
MAYA_MODULE_PATH=/path/to/modules
Platforma Özgü Yol Söz Dizimi
Yol söz dizimi işletim sistemleri arasında farklılık gösterir. Burada dikkatli olmamız gerekir.
Windows Yol Söz Dizimi Windows, yol ayırıcı olarak ters eğik çizgi, birden fazla yolu ayırmak için ise noktalı virgül kullanır:
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins;C:\Custom\Plugins;C:\Renders\Plugins
Windows'ta değişken yerine koyma işlemi yüzde işaretleriyle yapılır:
MAYA_PLUG_IN_PATH=%MAYA_LOCATION%\bin\plug-ins;C:\Custom\Plugins
macOS ve Linux Yol Söz Dizimi Unix tabanlı sistemler eğik çizgi kullanır ve yolları iki nokta üst üste ile ayırır:
MAYA_PLUG_IN_PATH=/usr/local/plugins:/opt/custom/plugins:/home/renders/plugins
Değişken yerine koyma işlemi dolar işaretleriyle yapılır:
MAYA_PLUG_IN_PATH=$MAYA_LOCATION/bin/plug-ins:/opt/custom/plugins
İş Akışımız İçin Temel Ortam Değişkenleri
Render farm entegrasyonu için en önemli olan çekirdek değişkenleri belirledik:
MAYA_MODULE_PATH Maya'nın modülleri (eklentilerin, script'lerin ve raf tanımlarının düzenli koleksiyonları) nerede arayacağını kontrol eder. Render farm çalışmalarında bu değişken, farm'ınızın modül konumlarını içermelidir:
# 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 Eklenti konumlarını belirtir. Render motorları ve özel araçlar için vazgeçilmezdir:
# 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 Maya'nın MEL ve Python script'lerini nerede bulacağını belirler:
# 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
Lisans Sunucusu Değişkenleri Bir render farm kullanırken lisans sunucunuzu belirtin:
MAYA_LICENSE=8000
MAYA_LICENSE_SERVER=license.yourcompany.com
Ortam değişkenleri, bulut gönderimi bütünün yalnızca bir parçasıdır; referans ağacı denetimleri, eklenti sürümü sabitleme ve projeye göreli yol yeniden eşleme dahil olmak üzere tam ön kontrol listesi, yukarıda anlatılan maya.env kurulumunun üzerine inşa edilen Maya bulut rendering iş akışı rehberimizde ele alınmaktadır.
Render Farm'a Özgü Yapılandırma
Sahneleri render farm'a göndermek üzere hazırlarken birkaç ek değişken kritik hale gelir. Node'larımız Linux sunucular üzerinde çalıştığı için belirli yolların yapılandırılması gerekir.
Render Motoru Eklenti Konumu Render motorunuza (Arnold, RenderMan, V-Ray vb.) farm node'larında erişilebilmelidir:
MAYA_PLUG_IN_PATH=/opt/farm/renderers/arnold/bin:/opt/farm/renderers/vray/bin
Farm'a Bağlanan Yollar Farm'ınız proje sürücülerini bağlıyorsa bu yolları yapılandırın:
PROJECT_PATH=/mnt/renders/projects
TEXTURE_PATH=/mnt/shared/textures
CACHE_PATH=/mnt/renders/cache
Batch Rendering Değişkenleri Farm üzerinde batch/headless rendering için:
MAYA_BATCH_RENDER_TIMEOUT=3600
MAYA_DISABLE_PARALLEL_BATCH_RENDERING=0
Yaygın Maya.env Yapılandırma Örnekleri
Örnek 1: Windows Geliştirme Kurulumu
# 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
Örnek 2: macOS Geliştirme Kurulumu
# 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
Örnek 3: Linux Render Farm Node Yapılandırması
# 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
Ortam Değişkeni Sorunlarını Giderme
Ortam değişkenleri hatalı yapılandırıldığında en sık karşılaştığımız sorunları derledik.
Boşluk İçeren Yollar Windows yolları sıklıkla boşluk içerir (Program Files). maya.env içinde yolun tamamını asla tırnak içine almayın:
# WRONG
MAYA_PLUG_IN_PATH="C:\Program Files\Plugins"
# CORRECT
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins
Karışık Ayırıcılar Windows'ta eğik çizgi veya Linux'ta ters eğik çizgi kullanmak yolları bozar:
# WRONG on Windows
MAYA_PLUG_IN_PATH=C:/Program Files/Plugins
# CORRECT on Windows
MAYA_PLUG_IN_PATH=C:\Program Files\Plugins
Render Farm Uyumsuzluğu Yerel kurulum farm kurulumundan farklıdır. Değişkenler yalnızca yerelde geçerli yollara işaret ettiğinde, bir sahne yerelde render alırken farm'da başarısız olur. Sahneleri her zaman farm'a eşdeğer yollarla test edin.
Eklenti Yüklenmiyor Yollar doğru olduğu halde bir eklenti yüklenmiyorsa farm üzerindeki dosya izinlerini kontrol edin. Bazı eklentiler çalıştırma izni gerektirir:
chmod +x /opt/farm/plugins/pluginname.so
Değişken Değerlerinde Boşluklar Bazı değerler (yollar gibi) boşluk içerir, ancak değişkenin kendisi tırnak işaretlerini desteklemez. Bu çalışır:
MAYA_MODULE_PATH=/path with spaces/modules
Ancak karmaşık değerler sisteminizde kaçış karakteri gerektirebilir.
Ortam Değişkenleri İçin Önerilen Uygulamalar
Güvenilirliği sağlamak için şu uygulamaları öneriyoruz:
maya.env dosyanızı düzenli ve belgelenmiş tutun. Açık olmayan yolları veya başkalarının tanımayabileceği değişkenleri açıklayan yorumlar ekleyin.
Sahne dışa aktarımını, mevcut ortam ayarlarıyla render farm'ınıza göre test edin. Tüm eklentilerin ve bağımlılıkların doğru çözümlendiğini doğrulayın.
maya.env yapılandırmanızı sürümleyin. Render motorları eklediğinizde veya farm yazılımını güncellediğinizde değişiklikleri takip edin. Bizim yapılandırmamız sürüm kontrolünde saklanır.
Mümkün olduğunda ortam değişkeni yerine koymayı kullanın. Yolları sabit olarak yazmak yerine $MAYA_LOCATION veya %MAYA_LOCATION% gibi mevcut değişkenlere başvurun.
Yerel ve farm yollarını aynı değişkende asla karıştırmayın. Yerel geliştirme ve farm gönderimi için ayrı yapılandırma dosyaları oluşturun.
Kişisel script'leri ve eklentileri uygulama varsayılanlarından ayırın. Bu, güncellemeleri kolaylaştırır ve çakışmaları önler.
Yapılandırmanızı Test Etme
maya.env dosyasını ayarladıktan sonra, render farm'a ciddi bir iş göndermeden önce test edin.
Maya'yı açın ve Script Editor'da şu Python komutunu çalıştırın:
import os
print(os.getenv('MAYA_MODULE_PATH'))
Bu komut, Maya'nın kullandığı gerçek genişletilmiş yolu gösterir. Eklentilerin doğru yüklendiğini doğrulayın: Windows > Settings/Preferences > Plug-in Manager. Özel eklentilerinizin listede göründüğünü kontrol edin.
Render farm testi için, özel eklentileriniz etkinken basit bir test sahnesi gönderin. Bu, yapılandırma hatalarını üretim sahnelerini etkilemeden yakalar.
Maya Yapılandırması Hakkında Daha Fazla Bilgi
Sürüme özgü ayrıntılar ve gelişmiş yapılandırma seçenekleri için resmi Autodesk Maya dokümantasyonuna göz atmanızı öneririz. Dokümantasyon ortam değişkenlerini kapsamlı biçimde ele alır ve her Maya sürümüyle birlikte güncellenir.
Render farm entegrasyonuna ilişkin ayrıntılar için farm tarafı yapılandırmayı ve sahne gönderimi iş akışlarını kapsayan başlangıç rehberimize bakın. Entegre iş akışı çözümleri için 3ds Max bulut rendering ve Arnold cloud render farm hizmetlerimizi de inceleyebilirsiniz.
SSS
Q: Maya'nın maya.env içindeki yol doğru olduğu halde eklentimi bulamaması neden olur? A: Eklenti dosyasının kendisinin okuma izinlerine sahip olduğunu ve Maya sürümünüzle eşleştiğini kontrol edin (Maya 2025 için hazırlanmış bir eklenti Maya 2026'da yüklenmez). Ayrıca maya.env dosyasını Maya sürümünüz için doğru konumda düzenlediğinizi doğrulayın.
Q: maya.env içinde $MAYA_LOCATION gibi ortam değişkeni yerine koymayı kullanabilir miyim? A: Evet, hem Windows (%VARIABLE%) hem de Unix tarzı ($VARIABLE) yerine koyma çalışır. Bu, yapılandırmanızı sistemler arasında taşınabilir kılar.
Q: Farklı Maya sürümleri için ayrı maya.env dosyalarına ihtiyacım var mı? A: Evet. Maya, yapılandırmaları sürüme özgü dizinlerde saklar. Her sürüm kendi maya.env dosyasını okur; böylece Maya 2025 ve Maya 2026 için farklı yapılandırmalarınız olabilir.
Q: MAYA_PLUG_IN_PATH içine var olmayan bir yol eklersem ne olur? A: Maya, var olmayan yolları hata vermeden atlar. Yol eksikse eklenti yalnızca yüklenmez. Test etmeden önce yolların var olduğunu her zaman doğrulayın.
Q: Değişkenlerime varsayılan Autodesk yollarını dahil etmeli miyim? A: Hayır. Maya varsayılan yolları otomatik olarak ekler. Bunları yeniden eklemek gereksiz aramaya yol açar ve açılışı yavaşlatır. Yalnızca özel yolları ve üçüncü taraf konumlarını ekleyin.
Sonuç
Maya ortam değişkenlerini doğru ayarlamak, render farm'larla çalışırken kendini fazlasıyla amorti eder. Size platforma özgü söz dizimini, render farm entegrasyonu için temel değişkenleri ve geliştirme ile farm node kurulumları için yaygın yapılandırmaları gösterdik.
Önemli olan, üretim işlerini göndermeden önce kapsamlı biçimde test etmektir. Küçük yapılandırma hataları, farm gönderim başarısızlıklarına ve boşa giden render süresine dönüşür.
Ortamınız, başkalarının örneklerini değil, kendi gerçek sistem yollarınızı yansıtmalıdır. Kendi kurulumunuzu gösterdiğimiz kalıplarla eşleştirmeye, yolların var olduğunu ve doğru dosyaları içerdiğini doğrulamaya zaman ayırın ve her zaman önce basit bir sahneyle test edin.
