Розставлення Директорій Blender

Ця сторінка документує різні директорії, що використовує Blender.

Це може бути корисним для усунення несправностей, автоматизації та кастомізації.

Директорії Користувача

Директорії користувача зберігають уподобання, початкові файли, встановлені розширення, пресети та більше. Типово вони використовують стандартну конфігурацію папок для кожної операційної системи.

Linux

$HOME/.config/blender/5.3/

Якщо $XDG_CONFIG_HOME встановлена змінна середовища:

$XDG_CONFIG_HOME/blender/5.3/

macOS

/Users/$USER/Library/Application Support/Blender/5.3/

Windows

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\5.3\

Портативне Встановлення

Коли ви запускаєте Blender з портативного носія, є можливість зберігати конфігурацію файлів на тому самому носії який ви забираєте з собою.

Щоб увімкнути це, створіть папку з назвою portable в наступних місцях:

  • Windows: Поряд з файлом запуску Blender, в розпакованій папці

  • Linux: Поряд з файлом запуску Blender, в розпакованій папці

  • macOS: В середині пакунку програми в Blender.app/Contents/Resources

Ця папка потім буде зберігати уподобання, початкові файли, встановлені розширення та пресети.

Змінні Середовища

BLENDER_USER_RESOURCES змінна середовища може бути встановлена у кастомізовану директорію, щоб замінити типову директорію користувача.

Системні Директорії

Системні директорії зберігають файли які ідуть разом з пакетом Blender та є потрібними для його функціонування. Це включає скрипти, пресети, основні файли та більше.

Linux

Архів завантажений з blender.org:

./5.3/

Linux пакунок дистрибутиву:

/usr/share/blender/5.3/

macOS

./Blender.app/Contents/Resources/5.3/

Windows

Zip-файл завантажений з blender.org:

./5.3/

Інсталятор завантажений з blender.org:

%ProgramFiles%\Blender Foundation\Blender\5.3\

Встановлення з Microsoft Store:

%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\5.3\

Змінні Середовища

BLENDER_SYSTEM_SCRIPTS та BLENDER_SYSTEM_EXTENSIONS змінні середовища можуть бути використані для пакету додаткових скриптів та розширень, які не є частиною звичайного встановлення Blender.

Інші BLENDER_SYSTEM змінні середовища можуть перезаписати системні шляхи, але це зазвичай не використано на практиці.

Розставлення Шляхів

./autosave

Розміщення автозбережених blend-файлів. (лише Windows, каталог «temp» використовується для інших систем.)

Розташовано в директоріях користувача.

./config

Конфігурація користувача та інформація сесії.

Розташовано в директоріях користувача.

./config/startup.blend

Blend файл для завантаження при запуску.

./config/userpref.blend

Уподобання користувача.

./config/bookmarks.txt

Закладки Перегляду Файлів.

./config/recent-files.txt

Список для меню недавніх файлів.

./config/{APP_TEMPLATE_ID}/startup.blend

Початковий файл запуску для шаблону програми.

./config/{APP_TEMPLATE_ID}/userpref.blend

Файл уподобань користувача для шаблону програми.

./datafiles

Файли даних завантажені під час виконання.

Розташовано в обидвох, в директоріях користувача та системних. Файли даних користувача чи перезапишуть або додадуть файли системних даних.

./datafiles/colormanagement

Типова OpenColorIO конфігурація.

./datafiles/fonts

Шрифти інтерфейсу користувача.

./datafiles/studiolights

Студійні світлі зображення для 3D переглядача.

./extensions

Сховища розширень.

Розташовані в обох директоріях, користувача та системи. Сховища завантажуються з обох директорій.

./scripts

Розширення, пресети, шаблони, інтерфейс користувача, скрипти початкового запуску.

Розташовані в обох директоріях, користувача та системи. Скрипти завантажуються з обох директорій.

./scripts/addons/*.py

Додатки на Python, які можуть вмикатися в уподобаннях Preferences, включаючи підтримку імпорту/експорту форматів, інтеграцію рушіїв рендера та багато зручних утиліт.

./scripts/addons/modules/*.py

Модулі для використовуваних додатків (додається у системний шлях sys.path для Python).

./scripts/addons_core/*.py

Директорія розширень яка використовується для розширень з пакунку.

./scripts/addons_core/modules/*.py

Модулі для addons_core для використання (додані до Python’s sys.path коли вони знайдені).

./scripts/modules/*.py

Модулі для Python, що містять наше ядро API та функції утиліт для інших скриптів для імпорту (додається у системний шлях sys.path для Python).

./scripts/startup/*.py

Скрипти, які автоматично імпортуються при запуску.

./scripts/startup/bl_app_templates_user/{APP_TEMPLATE_ID}

Шаблони програми встановлені в директоріях користувача.

./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}

Шаблони програми автоматично завантажені з системних директорій.

./scripts/presets/{preset}/*.py

Передустави, що використовуються для зберігання визначених користувачем устав для тканин, форматів рендера тощо.

./scripts/templates_py/*.py

Приклади скриптів, які доступні через «Редактор Тексту > Шаблони > Python» – Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Приклади шейдерів на мові OSL, які доступні через «Редактор Тексту > Шаблони > Відкрита Мова Відтінення» – Text Editor ‣ Templates ‣ Open Shading Language.

./python

Дистрибутив Python у комплекті з Blender’ом.

Розташовані в системних директоріях.

Локальна Кеш Директорія

Кеш директорія використовується щоб зберігати стійкі кеші локально. На зараз воно використовується лише для індексування Бібліотека Активів. Операційна система не очікує автоматично чистити це.

Наступний шлях буде використано:

  • Linux:

    $XDG_CACHE_HOME/blender/ якщо $XDG_CACHE_HOME``встановлено, інакше ``$HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Windows:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Temporary Directory – Тимчасова Директорія

Тимчасова директорія використовується для зберігання різних файлів під час прогону (включаючи шари рендера, кеш фізики, буфер копіювання-вставляння та логи крахів).

Тимчасова директорія вибирається, базуючись на наступному пріоритеті:

  • Уподобання Користувача (дивіться File Paths – Шляхи Файлів).

  • Змінні середовища (TEMP на Windows, TMP і TMP_DIR на інших платформах).

  • Директорія /tmp/.